Create External Form Reference
  • Updated on 10 Jan 2017
  • 2 minutes to read
  • Print
  • Dark
    Light

Create External Form Reference

  • Print
  • Dark
    Light

This tutorial demonstrates how to use External Form Reference in Decisions . External Form Reference feature introduced in Decisions 4.0. This feature allows workflow designers to create a setup for External Form and save it as an Entity . Then, this External Form Reference may be reused in different Flows .
Example:
In this example we are going to create an External Form Reference and demonstrate how to use it in a Workflow process.
Note: in this example we are going to use a simple External Form from the following document .
We begin in the Designer Folder with clicking Create Form > Create External Form Reference on the Folder Actions Panel.
2018-03-29_125658.png

2017-12-21_144755-1.png

In the resulting window we Name ourExternal Form Reference .
2017-12-21_144757-1.png

From the URL Source drop-down we may pick Specified (hard-coded URL) , FlowInput (URL from Flow Data) , or FlowConstant (URL from System Constants) . In this example we pick Specified .
2017-12-21_145304-1.png

Then, we provide Default URL for our External Form.
Under Service Definition we can check Generate Service checkbox if we need system to generate Service for the Form .
2017-12-21_145304-2.png

Under Service Outcomes we need to define at least one outcome from our External Form. We may also provide several outcomes. We clickAdd New to define Service Outcome . In the resulting window we provide Outcome Name . Mention, we may define Parameters for the Outcome if we expect our External Form to return some data. When finished we click Ok to save the Outcome and continue.
2017-12-21_145525-2.png

Under Expose Data On Service we can define data that we need to send to the External Form from the Workflow . In this example we simply define Test (String) to send to the External Form.
2017-12-21_150548-1.png

From Return URL Type we can pick Html , Auto or Silverlight .
2017-12-21_150707-1.png

Finally we have the following check-box settings:

  • Set Custom Callback URL Parameter Name
  • URL Encode the Callback URL
  • Open In New Window

When finished, we click Ok to save our External Form Reference and continue.
2017-12-21_150955-1.png

Back in the Designer Folder we can see that system created External Form Reference entity.
2017-12-21_151032-1.png

Next, we are going to demonstrate how to useExternal Form Reference in the Workflow process.
We click Create Flow on the Folder Actions Panel.
2018-03-30_102917.png

In the resulting window we Name the Flow and click Ok to proceed to the Flow Designer.
2017-12-21_151128-1.png

2017-12-21_151233-1.png

In the Flow Designer we add our Simple External Form (External Form Reference) from Flows, Rules, Forms and Reports > Forms [Interaction] > [Current Folder] category on the outcome from the Start Step in our Flow .
2017-12-21_151323-1.png

Then, we define Constant Test Input to send to our External Form.
2017-12-21_151456-1.png

Finally, we connect the outcome from Simple External Form step to the End Step in our Flow . This completes our Flow . We can save the Flow and closeFlow Designer.
2017-12-21_151618-1.png

In the Designer Folder we locate our Flow and click Run Flow from Action menu on the thumbnail .
2017-12-21_151720-1.png

Our External Form opens in a new window. We submit the form…
externalFormPopsUp.png

…And this completes our Flow .
flowCompletionInstructions.png

Was this article helpful?