Workflow Table (4.2)
- Jenni Wallin
- Yuri Au Yong
Â
The workflow table is located at the bottom of the workflow template.
There must always be at least one valid and runnable workflow per workflow configuration, otherwise it will not be valid.
The three leftmost columns gather the workflow meta data: Valid, ID, and Name. A workflow table always contains these columns. The ID is automatically generated starting at 1. The ID is unique within the workflow configuration. The Name is generated based on the ID, for example 'Workflow_1'. The names can be edited, however, if two workflows have exactly the same name a validation error will occur.
The workflow table is populated depending on settings made in the Workflow Properties dialog, in the Workflow Table tab. For example adding rows and field type settings is done there and will propagate changes in the workflow table.
Apart from the three first columns, columns in the table represent fields of Default and Per Workflow type. See Workflow Properties (4.2)Â for further information about the field types.
You can also configure your own fields to be referenced by your APL code, which can be updated. The fields are configured in the Workflow Properties and referenced by the APL command dynamicFieldGet. The fields can be of either boolean, int, or string type, and you can configure different categories for the fields, for an easier overview.
Example of a workflow table
If there is a default value for a field, it is displayed in the table as <default value>. If no default value is set in the agent in the template, < > is displayed. If the field is of a Per Workflow type and not yet defined, the symbol is shown in the cell pointing out that the cell is not valid.
Note!
When using an External Reference profile or a SAP RFC profile, all workflows in the table must use the same profile.
Different icons that can appear in the workflow table:
Icon | Description |
|---|---|
 | Workflow is not yet validated |
Workflow is valid and runnable | |
Workflow is invalid | |
The cell is invalid. | |
The field contains an External Reference. |
The order of table rows can be switched to not ordered, ascending or descending by clicking on the header one or multiple times.
Info!
Number fields will be numerically ordered and other fields will be ordered alphabetically.
If External References are used, ordering will be done alphabetically by External Reference name. If the column is for a number field, numbers will be numerically ordered and separately grouped from the alphabetically ordered External References cells.
Table Toolbar
The workflow table toolbar presents you with options to manipulate each workflow and any data within the rows. The following are the buttons found on the bar:
With no workflows selected | |
|---|---|
Option | Description |
Search | Allows you to search the text of all columns. The Valid column is excluded from the search as it only have icons for values. |
Add workflow | Creates a new workflow by adding a row into the workflow table. The button opens the Add Workflow dialog and allows you to rename the workflow. If you have set some of the agent configuration to be configurable per workflow in the Workflow Properties (4.2) then you will be able to configure those fields. |
Export | Opens an export dialog where you select and save workflow configurations in a file. With this export file you transfer and update workflow table data either on your current machine or on a different client. The export file can be created in the following format:
The Exported fields that contain profiles are given a unique string identifier. The ID and Name fields are exported as well. In the export file, External References are enclosed in braces ({}) and preceded by a dollar symbol ($), for example |
Import | Opens an import dialog where you can import an exported file. This file might contain, for example, data that has been saved in the workflow table, locally or on a different client. This command supports the following file format:
Selecting Keep old workflows will result in the contents of the file being appended into the workflow table. Selecting Save before import will save the workflow configuration before proceeding with the import. This is so you can rollback to the previous version in case the import goes wrong. Importing a table may result in any of the following scenarios:
|
With one workflow selected | |
Option | Description |
Clear selection(s) | Clears the currently selected row so that it is not selected anymore. |
Edit | Opens the Edit Workflow dialog where you are able to edit the agent configuration field values that have been set to be configurable per workflow. For more on what per workflow is, refer to Workflow Properties (4.2). |
Delete | Removes the entire workflow and all configurations associated with the selected row. If removed, the ID number of that workflow will never again return within that workflow configuration. |
Validation Message | Opens an Information dialog where a message regarding the validity of the template, workflow, and cell is shown. |
With many workflows selected | |
Option | Description |
Clear selection(s) | Clears all currently selected row(s). |
Delete | Removes the entire workflow and all configurations associated with the selected rows. If removed, the ID number of that workflow will never again return within that workflow configuration. |
Right-Click Menu
Item | Description |
|---|---|
Edit | Opens the Edit Workflow dialog where you are able to edit the agent configuration field values that have been set to be configurable per workflow. For more on what per workflow is, refer to Workflow Properties (4.2). |
Delete | Removes the entire Workflow that is associated with the selected row. If removed, the ID number of that workflow will never again return within that workflow configuration. To remove more than one workflow, select all the relevant rows. |
Validation Message | Opens an Information dialog where a message regarding the validity of the template, workflow, and cell is shown. |
Â