Integrating With WCF ServicesLast Updated: 07/15/2016 Introduced in Verision: 3.0 |
This tutorial demonstrates how to integrate with WCF Service in Decisions and use a Reference to this Service in a Workflow.
Example:
In this example we are going to integrate with Bing’s Geocode WCF Service and use this integration in a Workflow.
We begin with creating a Reference to the WCF Service in Decisions. In the Portal we navigate to System > Integrations > External Services Folder and click Add WCF Service Reference button on Folder Actions Panel.
Our Service Integration page looks as following… This is Bing Geocode Service.
In the Portal in Add WCF Service Reference window we Name our Service Reference, and past URL to our Service in URL field. Then, we should be able to pick an Endpoint for our Service.
When finished, we can click Ok to Save our WCF Service Reference.
System creates WCF Service Reference in our External Services Folder.
Next, we are going to use this Bing Geocode Service in a Workflow. In the Designer Folder we click Create Flow on the Folder Actions Panel.
In the resulting window we Name the Flow and click Create to proceed to the Flow Designer.
In the Flow Designer we add Show Form step from the Favorite Steps category.
Then, we Name our Form and click Create to proceed to the Form Designer.
This Form is designed to get two User Inputs: ZIP Code and Country. When finished, we can Save the Form and close Form Designer.
Next, we are going to call our Geocode Service in our Flow. When we created WCF Service Reference in Decisions, System has analyzed Service methods and generated Steps for using in Flow Designer. We add Geocode step from Integrations > My Integrations > WCF Services > [WCF Service Reference Name] category.
Then, we connect Failed outcome from Geocode step to the End Step in our Flow. On the Done outcome we add another Show Form step from the Favorite Steps category.
Next, we Name our Form and click Create to proceed to the Form Designer.
This Form is designed to display some of the information Geocode Service outputs based on the User Input. When finished, we can save and close Form Designer.
Then, we connect Done outcome from our second Form Step to the End Step in our Flow. Select Geocode step on the work-space to set it up. For the request Inputs we use Build Data Mapping type and click Show Mapping Editor.
In the Mapping Editor we Build Data for the Address and Select Value of the Country for the CountryRegion, and Select Value of ZIP for PostalCode property. Then, we Build Data for the Credentials, use Text Merge.Plain Mapping type for Token property and click Show Editor.
In the Merge Text Editor we paste our Bing Key and click Ok to save and continue.
Next, we can save and close Mapping Editor. This completes our Flow. We click Test Flow link on the top panel of the Flow Designer to test our Flow.
First Form opens in the Debugger and we input ZIP Code and Country. Then, we click Done.
Second Form opens and we can see the Results based on Geocode Service method. Click Done.
Flow executes with no issues.
