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

Posted: January 21, 2014  |  Categories: BizTalk Maps

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

But before talking about the changelog 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 off 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 changelog 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 simplified deployment process using a 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 its 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 the 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 the 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 then with the leading zeros removed.

String Remove Leading Zeros Functoid

Download

You can download Source Code and Application Binaries here:
BizTalk Mapper Extensions UtilityPack GitHub RepositoryBizTalk Mapper Extensions UtilityPack
GitHub

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

Leave a Reply

Your email address will not be published.

BizTalk360
BizTalk Server

Over 650+ customers across
30+ countries depend on BizTalk360

Learn More
Serverless360
Azure

Operate efficiently with enterprise-grade Azure monitoring,
tracing, remediation & governance in one platform

Learn More

Back to Top