Azure Function: Rest-to-Soap Translation
Azure Functions is an event driven application platform with the capabilities to implement code that are triggered by events occurring in Azure, a third party service, or on-premise systems. With a wide range of triggering options, developers can leverage Azure Functions to trigger pre-compiled executables. This Function is executed by using Azure Functions HTTP Trigger method. The HTTP trigger lets you invoke a function with an HTTP request. You can use an HTTP trigger to build serverless APIs and respond to webhooks. For more depth knowledge about HTTP Triggers please see the Azure documentation here: https://docs.microsoft.com/en-us/azure/azure-functions/functions-bindings-http-webhook?tabs=csharp"
Blue Prism developers can leverage Azure Functions when working with REST and SOAP payloads. Currently Blue Prism only accepts SOAP payloads. If you are a REST only workshop, this Azure Function contains the code that receives your REST payload, converts to JSON, and then converts that JSON into an XML document formatted for SOAP payload so that Blue Prism can accept it.
Requirements to leverage Azure Functions with Blue Prism:
- Blue Prism Software installed. Version 6.4+
- Microsoft Azure account
- Visual Studio 2017+ with ability to publish Azure Functions from Visual Studio
Installation and Use
Find the documentation for getting an Azure Function started with Visual Studio here: https://docs.microsoft.com/en-us/azure/azure-functions/functions-create-your-first-function-visual-studio The documentation above is a great guide for in depth tutorials on creating a Function to publish with Visual Studio.
The Azure Function has been pre-built and is located here as a Visual Studio solution: https://github.com/blue-prism/Azure-Function-Rest-To-SoapTranslation
- Open the solution in Visual Studio
- Right click on RestToSoapFunction under the Solution and click Publish
Once the solution is published to your Azure account, the next step is to make note of the Site URL and Function Keys. More in-depth information on Keys is found here: https://docs.microsoft.com/en-us/azure/azure-functions/functions-bindings-http-webhook?tabs=csharp#authorization-keys
Once a Function key has been established, the next step is to execute the Function. For this you will need to make note of the published URL which is available in Visual Studio or in Azure. This, along with your REST payload is what you will use to trigger the Function which has been deployed with to execute with Azure Function's HTTP Trigger.