Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone
Panel
panelIconIdb8439a10-d7ad-4525-90ab-e3b921609e84
panelIcon:Square_9:
panelIconText:Square_9:
bgColor#F4F5F7

The Condition node is available in GlobalCapture and GlobalAction.

Use the Condition Node to build conditional decision making into a workflow process.  Decisions can be based upon process data, fields, and searches. Each condition node supports simple boolean logic or complex logic that allows for multiple outputs.

Violet colored, diamond shaped condition node.

Start by a Condition Node from the Nodes Pane to the Design Canvas.

The GlobalCapture Design canvas with the Condition node highlighted to move to the design canvas.

Condition Node Settings

Title

A Title is required. A good Title is important because it shows up in the process history and can help with troubleshooting workflow errors. Your Title should be concise and informative.

Description

Provide a Description of your condition. Detail the purpose of the condition, the operations, etc. Description are helpful when revisiting the workflow in the future and by those who did not design the workflow but need to make modifications. The Description will appear in the process history.

Conditional Node setting with the basic tab selected and no configuration entered.

Basic Settings

Basic settings allow for simple boolean logic. The condition is evaluated as True or False and follows the appropriate path.

Condition node basic settings configure to check for a maximum number of pages.Image Removed
Options to set the path as the true or false path.Image RemovedNode connections for the True and False paths leading to different nodes.Image Removed
  1. Select a Type from the drop down list.

Type dropdown list exposed with process property, process field, and Batch search options visible.Image Removed

Process Property

Types of Rules

Process Property - Process properties are properties collected by the system about every document moving through a workflow. These properties represent information about the workflow such as Page Count, Batch ID, Original File Name, etc. These properties can be access and used for conditional routing.

Process Field -Process Fields are user created fields in GlobalCapture and GlobalSearch that can be used to store data. These fields can be used in a wide variety of ways such as: storing data extracted from the document, keeping a count of the number of loops executed, storing workflow tracking information, etc.

Field (GlobalAction Only) - Fields are only available in GlobalAction and are a list of fields in the GlobalSearch database to which the GlobalAction workflow is associated.

Batch Search - Batch Searches are GlobalCapture Searches. When using a Batch Search in your Basic Condition node configuration, if the search returns results, the document moving through the workflow will follow the True path. If the Batch Search returns no results, it will follow the false path.

Search (GlobalAction Only) - Searches are GlobalSearch Searches. When using a Search in your Basic Condition node configuration, if the search returns results, the document moving through the workflow will follow the True path. If the Search returns no results, it will follow the false path.

Note

The number of results returned by the search and any data associated with those results is not considered. Using a Batch Search simply checks to see if any documents are returned.

Basic Settings

Basic settings allow for simple boolean logic. The condition is evaluated as True or False and follows the appropriate path.

Condition node basic settings configure to check for a maximum number of pages.Image Added
Options to set the path as the true or false path.Image AddedNode connections for the True and False paths leading to different nodes.Image Added
  1. Select a Type from the drop down list.

Type dropdown list exposed with process property, process field, and Batch search options visible.Image Added

Configure a Basic Condition Using a Process Property

  1. Select the Property from the Process Property drop down list.

  2. Select the appropriate operator from the Condition drop down list. The conditions will vary based on the process property selected.

  3. Enter the Value to compare the select property to. This value can be another Process Property, a Process Field, a Field, or a hardcoded value. For conditions where a Value is not needed, such as Is Empty, the Value input will disappear.

Process property dropdown list exposed with available system values.
The value input is available when a condition that needs a value is selected.
No value input is exposed when the condition does not require it.
  1. Click Save.

Info

To enter a variable into the Value field:

  1. Process Properties - Type a { to see list of Process Properties.

  2. Process Fields - Type {p_ to see a list of Process Fields.

  3. Fields (GlobalAction Only) - Type {f_ to see a list of Fields.

Process Field

Process Fields are user created fields in GlobalCapture and GlobalSearch that can be used to store data. These fields can be used in a wide variety of ways such as: storing data extracted from the document, keeping a count of the number of loops executed, storing workflow tracking information, etc.

Configure a Basic Condition Using a Process Field

  1. Select the Process Field from the Based on Process Field drop down list. This list will contain all Process Fields listed in the Process Field pane.

  2. Select the appropriate operator from the Condition drop down list. The conditions will vary based on the process property selected.

  3. Enter the Value to compare the select property to. This value can be another Process Property, a Process Field, a Field, or a hardcoded value. For conditions where a Value is not needed, such as Is Empty, the Value input will disappear.

Process field dropdown list exposed with values from the process field workflow pane.List for process fields added to the workflow.
The value input is available when a condition that needs a value is selected.
No value input is exposed when the condition does not require it.
Info

To enter a variable into the Value field:

  1. Process Properties - Type a { to see list of Process Properties.

  2. Process Fields - Type {p_ to see a list of Process Fields.

  3. Fields (GlobalAction Only) - Type {f_ to see a list of Fields.

Field (GlobalAction Only)

Fields are only available in GlobalAction and are a list of fields in the GlobalSearch database to which the GlobalAction workflow is associated.

Configure a Basic Condition Using a Field

  1. Select the Field from the Based on Field drop down list. This list will contain all Fields in the GlobalSearch database.

  2. Select the appropriate operator from the Condition drop down list. The conditions will vary based on the process property selected.

  3. Enter the Value to compare the select property to. This value can be another Process Property, a Process Field, a Field, or a hardcoded value. For conditions where a Value is not needed, such as Is Empty, the Value input will disappear.

Field dropdown list exposed with values from the GlobalSearch database.

The value input is available when a condition that needs a value is selected.
No value input is exposed when the condition does not require it.

Batch Search

Batch Searches are GlobalCapture Searches. When using a Batch Search in your Basic Condition node configuration, if the search returns results, the document moving through the workflow will follow the True path. If the Batch Search returns no results, it will follow the false path.

NoteThe number of results returned by the search and any data associated with those results is not considered. Using a Batch Search simply checks to see if any documents are returned.

Configure a Basic Condition Using a Batch Search

  1. Select a Search from the Based on Search drop down list. This is a list of available GlobalCapture Searches to which you are secured.

Based on search dropdown containing list of secured searches exposed.
  1. Any Search Prompts that are available in the search will appear below the Based on Search field. Enter data to narrow down the results that will be returned.

Info

Leaving the Search Prompts empty will return all documents for that search.

  1. Click Save.

Search prompts for AP GlobalCapture Invoices over 5000 dollars search.
Search (GlobalAction Only)

Searches are GlobalSearch Searches. When using a Search in your Basic Condition node configuration, if the search returns results, the document moving through the workflow will follow the True path. If the Search returns no results, it will follow the false path.

Note

The number of results returned by the search and any data associated with those results is not considered. Using a Search simply checks to see if any documents are returned.

Configure a Basic Condition Using a Search

  1. Select a Search from the Based on Search drop down list. This is a list of available GlobalSearch Searches to which you are secured.

List of available GlobalSearch searches.
  1. Any Search Prompts that are available in the search will appear below the Based on Search field. Enter data to narrow down the results that will be returned.

Info

Leaving the Search Prompts empty will return all documents for that search.

  1. Click Save.

Search prompts for AP GlobalCapture Invoices over 5000 dollars search.

Basic Condition Examples

Advanced Settings

Advanced settings allows you to configure the Condition node to accommodate more than just 2 outputs (True and False). While conditions are still evaluated as True or False, multiple conditions can be configured to create a path for the document to follow when the condition is evaluated as True. A single False path (No Conditions Met) is automatically created to be followed when no conditions evaluate as True.

When the Advanced tab is selected any available links are displayed. From here, you can rearrange the order of the links, create new links, or edit, copy, and delete links.

Condition with 3 True outputs and one false output.Image Added
Advanced tab selected in the Conditional Node settings with a list of 3 conditional links.Image Added
Note

Links are evaluated from top to bottom in the order specified. Links can be re-ordered via drag and drop after more that one link is created.

Conditional Links Pane

Conditional links pane with each option highlighted for explanation of function.  From left to right are priority, reorder, name, edit, copy, delete.  Above delete is add new condition.Image Added
  1. Priority - Indicates the order in which the conditions will be evaluated. Conditions are always evaluated from top to bottom in the Conditional Links list. The Priority can be changed by moving the link up or down the list using Reorder or by changing the Priority in the Conditional Link Builder.

  2. Reorder ( menus.pngImage Added ) - When multiple conditions are available, Reorder the priorities of the links by dragging the Reorder icon for the selected condition up or down the Conditional Links list.

  3. Title - The Title of your path. This is what is displayed in your workflow when making the connection to the next node. Ensure your title is clear to improve ease of workflow construction and maintenance.

  4. Edit ( pencil.pngImage Added ) - Opens the Conditional Link Builder to make changes to an existing condition.

  5. Copy ( copy.pngImage Added ) - Duplicates the existing condition. The duplicated conditional will open in the link builder and default to the bottom of the list unless the priority is changed.

  6. Delete ( bin.pngImage Added ) - Deletes the Conditional Link.

  7. Add Conditional Link ( plus.pngImage Added ) - Creates a new Conditional Link. The new link will open in the link builder and default to the bottom of the list unless the priority is changed.

When a new link is created, or an existing link is copied or edited, the Condition Link Builder appears.

Conditional Link Builder

Condition Link builder options for title, priority, and rules.Image Added

Title - The Title of your path. This is what is displayed in your workflow when making the connection to the next node. Ensure your title is clear to improve ease of workflow construction and maintenance.

Priority - Indicates the order in which the conditions will be evaluated. Clicking the priority will display a list of Links with the new link at the bottom. Use the hamburger ( menus.pngImage Added ) icon to move the Links up and down the priority list.

Output - This displays a written summary of your rule configuration. This is useful in understanding the construction of your rule and how when it will be evaluated as true.

Rule Pane - The Rule Pane is where you configure your rule. It consists of the AND/OR operator, the Add Rule button, the Add Group button, and the Refresh button. The Refresh button refreshes the searches and fields list to accommodate any changes without have to refresh the browser page.

Priority order popup displays a list of links in the execution order.  change the order using the hamburger icon.Image Added

Understanding Rules and Groups

Each condition link is constructed of Rules. Rules can be combined into Groups to construct more advanced boolean conditions. Rules can be constructed of anyType and joined using AND and OR logic. The rules within each group must all have the same operator but subgroups can had a different operator then the parent.

Info

Groups have a max depth of 5, the current depth of a given group is noted in the bottom left corner.

Adding a Rule to the Rule Pane

Understanding Table Fields Rules and Groups

Adding a Rule using Table Fields to the Rule Pane

Advanced Condition Examples

Conditions

Conditions are operators that compare the selected field or property to a value. The list of conditions will vary depending on the field type (Character, Numeric, Decimal, Date) of the process property.

Equals

Greater than or Equal To

Less than or Equal To

Does Not Equal

Is Empty

Is Not Empty

Regex Match

Condition dropdown list exposed with available operators.
Advanced Condition Examples