BizTalk Mapper Extensions UtilityPack: Configuration Functoids for BizTalk Server 2020

Let’s continue the migration of the BizTalk Mapper Extensions UtilityPack project and provide an overview of another set of libraries available for BizTalk Server 2020: Configuration Functoids.

Configuration Functoids

This library includes a suite of functoids that read configuration parameter values (config settings) from different sources (locations) and that you can use inside a BizTalk mapper.

This project includes the following Custom Functoids:

• BTSNTSvc Config Get Functoid: This functoid allows you to get configuration parameters from BTSNTsvc.exe.config. If no section is specified, the functoid reads from AppSettings.
  • The functoid takes two mandatory input parameters:
    • A string that represents the key name that you want to read from BTSNTsvc.exe.config.
    • A string that represents the section (can be an empty String) from the BTSNTsvc.exe.config that you want to read the key name.
  • The output of the functoid is a string with the value of the configuration parameters from BTSNTsvc.exe.config.
• System Environment Variable Get Functoid: This functoid allows you to get configuration parameters from the machine’s System Environment Variable.
  • The functoid takes one mandatory input parameter:
    • A string that represents the key that you want to read from the System Environment Variable.
  • The output of the functoid is a string with the value of the configuration parameters from the System Environment Variable of the machine.
• Custom Config Get Functoid: This functoid allows you to get configuration parameters from a custom configuration file.
  • The functoid takes two mandatory input parameters:
    • A string that represents the key (variable name) that you want to read from a custom configuration file.
    • A string that represents the path to the custom configuration file that you want to read the key.
  • The output of the functoid is a string with the value of the configuration parameters from a custom configuration file.
• Windows Registry Config Get Functoid: This functoid allows you to get configuration parameters from the Windows Registry.
  • The functoid takes two mandatory input parameters:
    • A string that represents the name or path of the subkey to open.
    • A string that represents the name of the value to retrieve from the registry. This string is not case-sensitive.
  • The output of the functoid is a string with the value of the configuration parameters from the registry.
• Windows Registry Config Get Functoid: This functoid allows you to get configuration parameters from the Windows Registry.
  • The functoid takes two mandatory input parameters:
    • A string that represents the name or path of the subkey to open.
    • A string that represents the name of the value to retrieve from the registry. This string is not case-sensitive.
  • The output of the functoid is a string with the value of the configuration parameters from the registry.
• SSO Config Get Functoid: This functoid allows you to get configuration parameters from the SSO Database.
  • The functoid takes two mandatory input parameters:
    • A string that represents the name of the affiliate application to represent the configuration container to access
    • A string that represents the property name to read from the SSO application.
  • The output of the functoid is a string with the value of the configuration parameters from SSO.
• Rule Engine Config Get Functoid: This functoid allows you to obtain a definition value from a Vocabulary in the Business Rules Engine.
  • The functoid takes two mandatory input parameters:
    • A string that represents the definition name (e.g., Value1).
    • A string that represents the vocabulary name (i.e., Config).
  • The output of the functoid is a string with the value of the definition name from a specified vocabulary on the Business Rule Engine.

BizTalk Mapper Extensions Utility Pack

BizTalk Mapper Extensions Utility Pack is a set of libraries that includes several useful functoids to include in a map, extending BizTalk Mapper’s capabilities.

Download

You can download the source code and application binaries from GitHub:

Hope you find this helpful! If you liked the content or found it useful and would like to support me in writing more, consider buying (or helping to buy) a Star Wars Lego set for my son. 

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. View all posts by Sandro Pereira