IDP Connector

Integrate ProcessMaker IDP into your business Processes.

Overview

IDP connector integrates ProcessMaker IDP into ProcessMaker Platform. ProcessMaker IDP is ProcessMaker's intelligent document processing (IDP) solution.

Package and Permissions Required

The IDP package must be installed to use the IDP connector.

Furthermore, your user account or group membership must have the following permissions to configure an IDP connector to the Process model unless your user account has the Make this user a Super Admin setting selected:

• Processes: Edit Processes

• Processes: View Processes

See the Process permissions or ask your Administrator for assistance.

Add an IDP Connector to the Process Model

A package and permissions are required to do this.

Follow these steps to add an IDP connector to the Process model:

1. View your Processes. The Processes page displays.

2. Create a new Process or click the Open Modeler iconto edit the selected Process model. Process Modeler displays.
3. Locate the IDP connector's icon in the Elements and Connectors palette that is to the left of the Process Modeler canvas.
4. Drag the connector into the Process model canvas where you want to place it. If a Pool element is in your Process model, the IDP connector cannot be placed outside of the Pool element.

The IDP Connector

After adding the IDP connector, consider adding the following Boundary-type Process model elements to design business solutions when your best-case scenarios don't happen:

• Boundary Timer Event element (Don't know what that is?)

• Boundary Error Event element (Don't know what that is?)

• Boundary Signal Event element (Don't know what that is?)

• Boundary Conditional Event element (Don't know what that is?)

• Boundary Message Event element (Don't know what that is?)

After the connector is placed into the Process model, you may adjust its location in the following ways:

• Move the connector by dragging it to a new location.

• Select the connector with other elements and/or connectors, and then move them collectively by dragging them to new locations in relation to one another.

• Align and/or distribute the connector in relation to other selected elements and/or connectors.

Moving a IDP connector has the following limitations in regards to the following Process model elements:

• Pool element: If the connector is inside of a Pool element, it cannot be moved outside of the Pool element. If you attempt to do so, Process Modeler places the connector inside the Pool element closest to where you attempt to move it.

• Lane element: If the connector is inside of a Lane element, it can be moved to another Lane element in the same Pool element. However, the connector cannot be moved outside of the Pool element.

Customize the Appearance of an IDP Connector

Customize the IDP connector's appearance in the following ways:

• Customize the color of the connector, icon, and label, which by default display as black-colored. See Change an IDP Connector's Color.

• Customize the icon that displays in the connector. IDP connectors display theicon in the shape by default. See Change an IDP Connector's Icon.

After an IDP connector is added to a Process model, optionally customize these aspects of its appearance. Each IDP connector's appearance may only be changed individually.

Change an IDP Connector's Color

An IDP connector's shape, icon, and label are black-colored by default.

A package and permissions are required to do this.

Follow these steps to change the color for an IDP connector:

1. View your Processes. The Processes page displays.

2. Click the Open Modeler iconto edit the selected Process model. Process Modeler displays.
3. Select the IDP connector to customize. Available options display above the selected connector.

4. Click the Open Color Palette icon. The color palette displays.
5. Do one of the following to change the color:

   • Select a color swatch: Select one of the color swatches from the color palette. The connector's shape, icon and label change to that color.

   • Specify a custom color: Click theicon to display the color selector, and then select a color, enter the Hex color code, or enter the red, green, blue, and alpha color values for the custom color. The connector's shape, icon and label change to that color.
6. Click theicon to reset the connector, icon, and label to its default color.

Change an IDP Connector's Icon

IDP connectors display the icon in the shape by default.

A package and permissions are required to do this.

Follow these steps to change the icon for an IDP connector:

1. View your Processes. The Processes page displays.

2. Click the Open Modeler iconto edit the selected Process model. Process Modeler displays.
3. Select the IDP connector to customize. Available options display above the selected connector.

4. Click the Open Color Palette icon. The color palette displays.
5. Click theicon. The Select a custom icon screen displays.
6. From the Search drop-down menu, select the icon to display. The connector's icon changes to the selected icon.

To reset the connector to its default icon, click the Reset to Default button from the Select a custom icon screen.

Copy an IDP Connector

Copying an IDP connector copies the original along with its current settings, making it easier and faster to continue designing without adding default elements or connectors with their default settings.

The copied IDP connector displays below the original. Any Sequence Flow and/or Message Flow elements incoming to or outgoing from the original are not copied.

A package and permissions are required to do this.

Follow these steps to copy an IDP connector in your Process model:

1. ​View your Processes. The Processes page displays.

2. Click the Open Modeler iconto edit the selected Process model. Process Modeler displays.
3. Select the IDP connector to copy. Available options display above the selected connector.
4. Click the Copy Element icon. The Process model connector copies.

Delete an IDP Connector

Deleting a Process model connector also deletes any Sequence Flow and/or Message Flow elements incoming to or outgoing from that element. For example, if a Process model connector is deleted that has both incoming and outgoing Sequence Flow elements, the Sequence Flow elements must be reconnected for the remaining elements/connectors.

A package and permissions are required to do this.

Follow these steps to delete an IDP connector from your Process model:

1. ​View your Processes. The Processes page displays.

2. Click the Open Modeler iconto edit the selected Process model. Process Modeler displays.
3. Select the DocuSign connector to delete. Available options display above the selected connector.
4. Click the Delete icon. The Process model connector deletes.

Settings

The IDP connector has the following panels that contain settings:

• Configuration panel

  • Edit the connector name

  • Enter the Request variable containing the file(s) for processing

  • Enter the document type to process

  • Configure to which ProcessMaker IDP folder to store the processed document(s)

• Loop Activity panel

  • Specify characteristics to perform multiple instances of the connector

• Advanced panel

  • Edit the node's identifier value

Configuration Panel

Edit the Connector Name

A connector name is a human-readable reference for a Process model control. Process Modeler automatically assigns the name of a Process model connector with its connector type. However, a connector's name can be changed.

A package and permissions are required to do this.

Follow these steps to edit the name for an IDP connector:

1. Select the IDP connector from the Process model in which to edit its name. Panels to configure this connector display.

2. Expand the Configuration panel if it is not presently expanded. The Name setting displays.
3. In the Name setting, edit the selected connector's name and then press Enter.

Enter the Request Variable Containing the File(s) for Processing

A package and permissions are required to do this.

During a Request, an IDP connector references a Request variable that stores the document(s) for processing. This Request variable may be that of a File Upload control to which the document(s) were included during a Task.

Follow these steps to enter the name of the Request variable that stores the document(s) this IDP connector processes:

1. Select the IDP connector from the Process model in which to edit the Request variable that stores the document(s) for processing. Panels to configure this connector display.

2. Expand the Configuration panel if it is not presently expanded, and then locate the Variable Name setting.
3. In the Variable Name setting, enter the the Request variable name that stores the document(s) for processing, and then press Enter.

Enter the Document Type to Process

Use a Request variable to indicate the name of the Document_Type Domain's Name setting value in ProcessMaker IDP that the IDP connector uses to process the document(s). This setting does not refer to a file type, such as PDF or DOCX. Instead, this setting refers to the name of the document type in ProcessMaker IDP that has been previously trained to process document(s) in your Dossier. Note that this setting requires the Document_Type Domain's Name setting value, not its Pretty Name setting value. Reference this Request variable using mustache syntax.

Determine Which Document Type to Use for this IDP Connector

If necessary, log on to your ProcessMaker IDP instance to determine which Domain document type with which to process the document(s) for this IDP connector. Note that ProcessMaker IDP Administrator permissions are required to do this.

Follow these steps to determine which Domain in ProcessMaker IDP is used to train your documents in your Dossier:

1. Log on to ProcessMaker IDP. If you need assistance logging on, contact your ProcessMaker IDP Administrator for assistance.

2. Click the initials of your user account in the lower-left in ProcessMaker IDP, and then select the Go to Doculayer Admin option.
3. Click the Domains option from the left-side navigation pane.

   The Domains page displays.
4. Locate the Document_Type domain, click its options menu, and then select the Edit option.

   The Edit Domain page displays for the Document_Type Domain.
5. Click the Enum values option from the left-side pane. The Enum values for Domain page displays the enumeration values for the Document_Type Domain.
6. Browse the list of values for the Document_Type Domain, and then locate the Document_Type Domain value that this IDP connector uses to process documents.

7. Click the options menu for your document type, and then select the Edit option.
8. Make note of the Name value for your document type. Use this value for the IDP connector's Document Type setting. An example is highlight below. Do not use the Pretty Name setting value for your document type.

A package and permissions are required to do this.

Follow these steps to reference the trained Entity name's in ProcessMaker IDP with which to process the document(s):

1. Select the IDP connector from the Process model in which to edit the Entity name. Panels to configure this connector display.

2. Expand the Configuration panel if it is not presently expanded, and then locate the Document Type setting.
3. Enter using mustache syntax the Request variable that indicates the Entity in ProcessMaker IDP that the IDP connector uses to process the document(s).

Configure to Which ProcessMaker IDP Folder to Store the Processed Document(s)

Configure to which existing ProcessMaker IDP folder to store the processed document(s). Configure this folder in one of two ways:

• Enter a Request variable that contains reference to the folder.

• Select the folder from the Select Destination drop-down menu. Note the following:

  • The folder must already exist in ProcessMaker IDP. This setting does not create the folder.

  • In the IDP tab within Settings, the destination folder(s) must be configured to be available for use in ProcessMaker Platform.

A package and permissions are required to do this.

Follow these steps to configure to which existing ProcessMaker IDP folder to store the processed document(s):

1. Select the IDP connector from the Process model in which to indicate the folder. Panels to configure this connector display.

2. Expand the Configuration panel if it is not presently expanded, and then locate the Select Destination setting. The Use Request Variable option is not selected by default, allowing to select the folder.
3. Do one of the following:

   • Use a Request Variable to configure the folder:

     1. Select the Use Request Variable setting. An edit box replaces the drop-down menu.

     2. In the edit box, enter the Request variable name without mustache syntax that specifies the folder name and then press Enter.

   • Select the folder:

     1. Ensure that the destination folder is configured in settings for IDP.

     2. Ensure that the Use Request Variable setting is not selected.

     3. From the drop-down menu, select to which ProcessMaker IDP folder to store processed documents.

Loop Characteristics Panel Settings

Specify Characteristics to Perform Multiple Instances of the Connector

Use the Loop Characteristics panel settings to specify how to perform multiple instances of this connector. The following loop modes are available for this connector:

• No Loop Mode: Select the No Loop Mode option to perform this connector's function only once.

• Loop: Select the Loop option to sequentially repeat this connector's function multiple times until an exit condition is True. This is useful when a function should be performed multiple times with the same set of data, such as, processing a credit card payment. This loop mode has the following characteristics:

  • The connector's function is repeated until the exit condition is True or the maximum iterations limit is reached.

  • At any given time, only one instance of the connector is active. The subsequent instance does not begin until the current instance completes.

  • The same exit condition evaluates at the end of each instance; however, value(s) of the Request variable(s) used in the exit condition can change during an instance resulting in the exit condition to eventually evaluate as True.

  • If any one instance of that function does not complete, workflow pauses.

  • All active instances are terminated if an interrupting boundary-type event element triggers.

  • ProcessMaker IDP does not allow multiple documents of the same name in the one folder. Therefore, an IDP connector cannot send more than one copy of a document to a folder while in a loop mode. To address this issue, use a different IDP connector to process the same document to a different ProcessMaker IDP folder.

  • An element configured in this mode shows the Loop icon in Process Modeler.
• Multi-instance (Parallel): Select the Multi-instance (Parallel) option to perform this connector's Task multiple times in parallel a fixed number of times. This is useful when performing any action in bulk, such as sending an email to several people. This loop mode has the following characteristics:

  • Instances of the connector are governed by the size of an array-type Request variable where a new instance is created for each item in this variable. For example, an array with 10 items will create 10 parallel instances of this function that each contains data from its respective array index.

  • All instances begin simultaneously when this connector triggers; however, they perform their function independently of each other.

  • The function as a whole completes when all instances are complete.

  • The output from each instance can either be saved in the source Request variable or a new array-type Request variable.

  • All active instances terminate if an interrupting boundary-type event element triggers.

  • A connector configured in this mode shows the Multi-instance (Parallel) icon in Process Modeler.
• Multi-instance (Sequential): Select the Multi-instance (Sequential) option to perform this connector's function multiple times sequentially a fixed number of times or until an exit condition is True. This is useful when sequentially repeating a function multiple times but with a different set of data each time. This loop mode has the following characteristics:

  • Instances of the function are governed by the size an array-type Request variable where a new instance is created for each item in this variable. For example, an array with 10 items will create 10 parallel instances of this function that each contains data from its respect array index.

  • At any given time, only one instance of the function is active. The subsequent instance does not begin until the current instance completes.

  • At the end of each instance an exit condition evaluates and the loop activity halts if the exit condition is True.

  • The function as a whole completes when all instances are complete.

  • The output from each instance can either be saved in the source Request variable or a new array-type Request variable.

  • All active instances terminate if an interrupting boundary-type event element triggers.

  • A connector configured in this mode shows the Multi-instance (Sequential) iconin Process Modeler.

A package and permissions are required to do this.

Follow these steps to specify characteristics to perform multiple instances of the connector:‌

1. Select the connector from the Process model in which to specify multiple instance characteristics. Panels to configure this element display.

2. Expand the Loop Characteristics panel. The Loop Characteristics setting displays. By default, Loop Activity is set to No Loop Mode and the function is performed only once.

   
3. From the Loop Mode setting, select one of the following options to perform this connector's function more than once.

   • Loop: Select the Loop option. The settings for this loop mode display:

     

     Follow these steps:

     1. In the Maximum Iterations setting, enter an integer value representing the maximum number of times this Task should be performed.

     2. In the Exit Condition setting, enter a condition in FEEL syntax. When this condition is True the loop activity is halted.

   • Multi-instance (Parallel): Select the Multi-instance (Parallel) option. The settings for this loop mode display:

     

     Follow these steps:

     1. In the Request Variable Array setting, enter the name of an array-type Request variable. The size of this array will determine how many times this loop iterates.

     2. In the Output Data Variable setting, enter the name of an array-type Request variable in which to store the results of all instances. Each instance of the loop saves to a separate JSON object within the array of the specified Request variable. If the Output Data Variable setting is not configured, then the output data replaces the source data in the Request Variable Array.

   • Multi-instance (Sequential): Select the Multi-instance (Sequential) option. The settings for this loop mode display:

     

     Follow these steps:

     1. In the Request Variable Array setting, enter the name of an array-type Request variable. The size of this array will determine how many times this loop iterates.

     2. In the Exit Condition setting, enter a condition in FEEL syntax. When this condition is True the loop activity is halted.

     3. In the Output Data Variable setting, enter the name of an array-type Request variable in which to store the results of all instances. Each instance of the loop saves to a separate JSON object within the array of the specified Request variable. If the Output Data Variable setting is not configured, then the output data replaces the source data in the Request Variable Array.

Advanced Panel Settings

Edit the Node's Identifier Value

A Process node represents a component of a Process model, whether that is a BPMN element or a connector. Process Modeler automatically assigns a unique value to each Process node added to a Process model. A Process node's identifier value can be changed if it is unique to all other nodes in the Process model, including the Process model's identifier value.

A package and permissions are required to do this.

All identifier values for all nodes in the Process model must be unique.

Follow these steps to edit the identifier value for an IDP connector:

1. Select the IDP connector from the Process model in which to edit its identifier value. Panels to configure this connector display.

2. Expand the Advanced panel if it is not presently expanded. The Node Identifier setting displays. This is a required setting.

   
3. In the Node Identifier setting, edit the IDP connector's identifier to a unique value from all nodes in the Process model and then press Enter.

Related Topics

pageIDP SettingspageIDP PackagepageWhat is a Connector?pageWhat is a Package?