Calling a .NET Library Function From a Flow

Last Updated: 08/11/2016 Introduced in Verision: 2.0

The .NET Library contains a wide range of common functions, classes, and methods that can expedite the development process.

To call a .NET Library function from a flow, in the Flow Designer, expand the category Integration > .NET Libraries, and drag a component to the workspace.

Example

In the example, we will create a flow that calls the Copy method to copy text entered into a form . . .

basicFormDebug

 

. . . and display it in another form.

endFormDebug

 

Two forms have been created for this example, Basic Form and EndForm.

To begin, we navigate to a Designer folder and click the Create Flow button.

createFlow

 

We give the flow a name and click OK to open it in the Flow Designer.

nameFlow

 

We start building our flow by adding the form that will capture the text to copy.

In the Flow Designer start-up window, in the category  All Steps[Catalog] > Forms [Interaction] > [Current Folder], we select a Basic Form component and click Add to add it to the workspace.

 

 flowStarts

We then add the method that will copy the text.

We expand the category Integration > .NET Libraries > System > String (Class) and drag a Copy (Method) component to the workspace.

dragCopyStep

 

Finally, we add the form that will displays the copied text.

We expand the category Forms [End] > [Current Folder], and drag an EndForm 1 component to the workspace.

dragEndForm

 

All of the steps display alert icons until we connect the outcome paths in the flow.

We connect the Start step to the Basic Form step, the form that first opens when the flow runs. We connect the Basic Form step to the Copy step, which will copy the text. We connect the Copy step to the EndForm step, which will then display the copied text. Since this is all the flow should do, we connect the EndForm step to the End step.

Now that the paths are connected, we configure two of the components.

First we select the Copy step and click the Show Mapping Editor link.

showMappingForCopy

 

In the Mapping Editor, we connect the form output, the text collected in the Basic Form, to the str input and click OK.

mappStrToCopy

 

Next, we map the objects for the EndForm.

We select the EndForm step and click the Show Mapping Editor link.

showMappForEndForm

 

In the Mapping Editor, we connect the Copy1_output to the end form’s input and click OK.

mappingForEndForm

 

This completes the flow, so we save it and run it in the Debugger to test it.

Note that in Decisions version 3.5 and above, you will need to click Test Flow to access the Debugger.

3.5 Test Flow Shot

We click the Form tab to open the Basic Form. We enter text in the field, and click OK.

basicFormDebug

 

After the flow completes, the copied text displays on the EndForm on the Form tab.

endFormDebug

 

We click the Diagram tab to see the flow’s execution.

debugDiagram

 

Additional Resources