BizTalk Mapper Extensions UtilityPack: Configuration Functoids for BizTalk Server 2020

This post was originally published here

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

Configuration Functoids

This library includes a suite of functoids that make read configuration parameter values, or config settings, from different sources (locations) and that you can use inside 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 there is no section specified, the functoid reads from the 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 System Environment Variable.
- The functoid takes one mandatory input parameters:
  - A string that represents the key that you want to read from System Environment Variable
- The output of the functoid is a string with the value of the configuration parameters from 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 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 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 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.
- 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 specify vocabulary on the Business
  Rule Engine.

BizTalk Mapper Extensions UtilityPack

BizTalk Mapper Extensions UtilityPack is a set of libraries with several useful functoids to include and use it in a map, which will provide an extension of BizTalk Mapper capabilities.