BizTalk Mapper Extensions UtilityPack for BizTalk Server 2013 Updated to v1.7.0.0

Posted: January 21, 2014 in BizTalk
Tags: , ,

Exciting news… Version 1.7.0.0 of BizTalk Mapper Extensions UtilityPack for BizTalk Server 2013 is now available!

But before talking about the change-log of this version there is another subject that I want to talk first… This project as a new member that was responsible for all the new functionalities available in this version, my friend René Brauwers.

René is a senior Microsoft integration specialist at Motion10 with its head office in the Netherlands (www.motion10.nl). His career started in 2000 as a web developer/designer on the Microsoft platform. At the end of 2002 he got involved in the EAI/BPM world where he started of with WebMethods and did this for the next 3 years. In 2005 he changed his focus back to the Microsoft integration stack and as such got introduced to BizTalk Server 2004. Since 2005 he has been working with almost all versions of BizTalk Server and the last few years he has been specializing in Cloud integration with the Windows Azure platform and hybrid integration scenarios. René has his own blog http://blog.brauwers.nl on which he shares his BizTalk, .NET and Azure experiences.

Here’s the change-log for this release:

  • Two new functoids:
    • String Remove Leading Zeros Functoid
    • Get Windows Azure ACS Wrap Token Functoid
  • New deployment process using PowerShell script
  • New documentation
What’s new in this version?

Although BizTalk Server provides many functoids to support a range of diverse operations when working with strings or working/connecting with Windows Azure, we are limited to the number of existing operations. This new version will provide a new library that enables you to obtain an authentication token from the Windows Azure Access Control Service and new String operations.

This version will also provide a new simplify deployment process using PowerShell script.

Get Windows Azure ACS Wrap Token Functoid

This functoid allows you to obtain an ACS WRAP access token in order to access a Windows Azure BizTalk Services Bridge or Windows Azure Service Bus resources. Note this token needs to be added to the outbound request message Http Header. In order to do so use the Authorization key and assign it’s value as ‘WRAP access_token={RECEIVED TOKEN}’

Parameters:

The functoid takes four mandatory input parameters:

  • A string issuerName – Issuername belonging to the BizTalk Service namespace or Windows Azure Service Bus namespace
  • A string issuerKey – Issuerkey belonging to the BizTalk Service namespace or Windows Azure Service Bus namespace
  • A string endPoint – Full Uri pointing to the BizTalk Service Bridge or Windows Azure Service Bus queue/topic
  • A string windowsAzureACSNamespace – BizTalk Service or Service Bus ACS namespace name

NOTE:

Service Bus ACS namespace should be in format {namespace}-sb.
In case of doubt please log in to the Windows Azure Management Portal. Select Service Bus. Make a note of the name of the namespace to use and append –sb to it. You now have your ACS namespace (i.e. acme-sb)

BizTalk Services ACS namespace should be in format {namespace}{number}-bts
In case of doubt please log in to the Windows Azure Management Portal. Select BizTalk Services. Select the correct BizTalk Service and select Connection Information. A window will pop up containing the namespace (i.e. acme123-bts)

The output of the functoid is a string, Example:  net.windows.servicebus.action=Listen%2cManage%2cSend&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2facsnamespace-bts.accesscontrol.windows.net%2f&Audience=http%3a%2f%2fnamespace.biztalk.windows.net%2fdefault%2f%2fRCVINBOUND&ExpiresOn=1390169379&Issuer=https%3a%2f%2fnamespace2786-bts.accesscontrol.windows.net%2f&HMACSHA256=pHxuXvfPSkvq4TRyB5F%2fj%1fUtC1m3TyQKEJ6%2bkO8mhQg%3

The output should then be added to the Authorization http header of the outbound message. Example: [“Authorization”] = String.Format(“WRAP access_token=\”{0}\””, <YOUR TOKEN>);

Get-Windows-Azure-ACS-Wrap-Token-Functoid

String Remove Leading Zeros Functoid

This functoid allows you to remove any leading zeros from an input string.

Parameters:

The functoid has one mandatory parameter:

  • Input string which contains leading zeros which need to be removed.

The output of the functoid is an integer which is equal to the input instance but than with the leading zeros removed.

String-Remove-Leading-Zeros-Functoid

You can found and download Source Code, Application Binaries and Documentation in CodePlex BizTalk Mapper Extensions UtilityPack home page:

BizTalk Mapper Extensions UtilityPack
CodePlex

 

or from MSDN Code Gallery:

BizTalk Mapper Extensions UtilityPack for BizTalk Server 2013 (628.8 KB)
Microsoft | MSDN Code Gallery

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s