If you like to search for processes or activities by technical criteria and descriptors, go to the Process Search view in the Control Center perspective.
If you like to search for processes, select Processes in the Search For drop-down list.
Figure: Select Search for Processes
In the Process Criteria section you can choose the following filter criteria:
Note that all these fields except Process and Priority are disabled if you choose Activities from the Search For drop-down list.
Figure: Search For Processes
These fields can be left empty, if they should not to be used as filter. If you want to provide new search criteria, click the Reset button.
To enter the start and end time of the interval, you can use the calendar, which opens if you click on the date entry fields accordingly.
The State field offers the following possible states:
Figure: Choose the State of the Processes.
In the Process entry field select the processes to be searched for. To include all processes in the search, select All Processes.
Per default, process definitions that are not business relevant are suppressed in the Process drop-down list. These processes are marked as "Is Auxiliary Process" in the modeler. Refer to chapter Working with Process Definitions of the Infinity Process Platform Documentation - Modeling Guide Working with Process Definitions of the Modeling Guide for details.
To switch to show or hide auxiliary processes in the drop-down list, click the Show / Hide Auxiliary Process icon above the list.
Figure: Click to show auxiliary processes.
Note the following states:
You can specify the process priority as filter criteria. By default, the search is performed for All priorities.
The Case Owner option is enabled only when the Case Root Processes option is selected from the Hierarchy option. When you start entering a name, a list is provided with all available case owner names matching the typed characters.
Figure: Edit Case Owner Field
If you specify the case owner, the End Time (From and To) fields are disabled. If an owner is specified, search is performed for all Case processes.
Figure: Case Owner Field
Click the Search button to start the search and open the Processes table.
The Processes table lists the process instances filtered according to the filtering entered as described above.
For details on the columns and functionality of process tables, refer to chapter Process Tables.
For detailed information about a specific process, click this process in the Process column to open the Process Details view, which is described in detail in chapter Viewing Process Details.
Figure: Processes Result Set
If you like to search for processes, select Activities in the Search For drop-down list.
Figure: Select Search for Activities
In the Activity Criteria section you can choose the following filter criteria:
Figure: Search For Activities
Activity searches are dependent upon the selected process criteria. After setting the criteria you can start the search by clicking the Search button in the lower left corner of the criteria section. If you want to provide new search criteria, click the Reset button.
The Started (From and To) and Modify Time (From and To) fields determine the start and modify time of the activity time interval to be used as filter criteria. Specify valid date range for the search. These fields can be left empty, if they should not to be used as filter.
To enter the start and modify time of the interval, you can use the calendar, which opens if you click on the date entry fields accordingly.
In the Activities section, all activities are displayed in alphabetical order, which the logged-in user has the declarative security permissions Read Process Instance Data and Read Activity Instance Data for. These permissions are defined in the modeler for the process definition and the activity accordingly. Please refer to section Authorization of chapter Specifying Activity Properties and section Authorization of chapter Working with Process Definitions in the Business Process Modeling Handbook for detailed information on the Read Activity Instance Data and Read Process Instance Data permissions accordingly.
Choose the activities you like to use as search criteria in the list. To select all activities, choose the All Activities entry (default selection).
Figure: Select Activities to search for.
You can filter the activities displayed to be included or excluded in the activity searches. The following icons are provided to switch between the displayed types:
Clicking one of these icons shows (icon enabled) or hides (icon disabled) the according activity types. By default, interactive activities are displayed.
In the State field, choose the state of the activities to search for. The following states are provided in the drop-down list:
Figure: Choose the State of the Activities.
The Criticality drop-down list contains each currently defined criticality label. By default, All is selected.
The following criticality categories are provided by default:
Figure: Choose the Criticality.
Criticality categories can be defined in the Criticality Configuration View. Refer to chapter Criticality Configuration View for details.
To search for an activity directly via its OID, enter the activity OID in the Activity OID field.
Figure: Search via Activity OID
To search for an activity by the performer name, enter the first few letters in the Performer text box. As soon as you enter the text, the user name is searched automatically and the list is displayed. You can select the performer from the list.
Figure: Search via Performer
Please note that the search is per default case-sensitive with the exception of the first letter. You can change to case-insensitive search by setting the property Carnot.Client.Search.CaseSensitive in your carnot.properties file to false.
Click the Search button to start the search and open the Activities table.
The Activities table lists the activities filtered according to the filtering entered as described above. For a detailed description on the columns and functionality of the activity table, refer to chapter Activity Tables.
Figure: Selected Activities
For detailed information about a specific activity, click this activity in the Activity column to open the Process Details view, which is described in detail in chapter Viewing Process Details.
In this section, you can filter the list of process instances by the descriptor values defined as IN data paths in the selected process definitions.
If you search for processes, descriptors that are used by all the selected processes (except the Case Process) are displayed with a search entry field. Note that the Case Process is not included in the selected processes check, please refer to section Searching for Cases for details.
The according data path declared as descriptors are displayed. Refer to the chapter Working with Data Paths of the Infinity Process Platform Documentation - Modeling Guide section Descriptors of chapter Working with Data Paths for detailed information on the usage of descriptors.
Figure: Enter Descriptors as Search Criteria
The criteria for descriptors displayed for several processes is that their DataPathId, dataQualifiedId, and accessPath matches. The selected processes do not have to belong to the same model. They can also reference the same data of a provider model. E.g., if a process a in model A references data of the same provider model as process b in model B, descriptors in these processes using this data are displayed if the Id and data path are the same.
In the following example, two processes, Customer Order and Notification Process have both a descriptor defined with the following settings:
Figure: Descriptor set in the process definition
When selecting processes Customer Order and Notification Process in the Process Search view, the Descriptor field displays for the common descriptor CustomerName.
Figure: Common Descriptors displayed in the Process Search
If the Suppress Display of Blank Descriptors in Common Tables option is selected in the Configuration Panel then the descriptor that have no value are not displayed in the Descriptor column.
You can enter a search string to match the descriptors you like to use as filter criteria. Refer to section Entering a Descriptor Search Filter for details on using the descriptor search.
Figure: Using a wildcard for the search.
Please note that only structured data and primitive data types are supported as data path for descriptors used in the process search. All other data types specified as descriptor cannot be used as descriptor filters.
Enumeration types are displayed with a drop-down list to select the value from.
To filter the search for descriptors of String types, enter a search pattern you want the descriptors to be filtered by in the entry field. You can use the wildcard "*" in combination with string. Note that using wildcards for numbers, even that occur in strings, is not supported. However descriptor based search is possible for structured and primitive data types except boolean field of them. If the field is left empty, all data path are used.
Figure: Enter a Descriptor Search Pattern
All processes matching the descriptor search will be displayed.
Please note that the search is per default case sensitive. You can change to case insensitive search by setting the property Carnot.Client.Search.CaseSensitive in your carnot.properties file to false.
If you like to search for a descriptor of primitive type
Date and Time or
Date and Time Plus Time Zone, you can enter a time frame accordingly. A From and a
To field are provided, where you can select a date. To open the provided calendar, click on the entry
Figure: Searching for a Date descriptor
You can specify the filter criteria as:
For more information on descriptors and key descriptors, please refer to the chapter Working with Data Paths in the Infinity Process Platform Documentation - Developer Handbook. to the Working with Data Paths chapter of the Developers Handbook.
The descriptors criteria changes as per the process and hierarchy filters.
If you select All Processes option from the Process list and Case Root Processes option from the Hierarchy option, the Descriptors pane displays only case descriptors.
Figure: Case Root Processes - Descriptors
If you select a process with descriptors from the Process list and Case Root Processes option from the Hierarchy option, the Descriptors pane displays the descriptors of the process and the case to which it is attached.
Figure: Process with Descriptors and a Case
If you select two root processes which have some common descriptors from the Process list and Case Root Processes option is selected from the Hierarchy option, the Descriptors pane displays the common descriptors of those two processes and the case descriptors.
The following table displays the search criteria and expected search result:
|Selected Process Option||Selected Hierarchy Option||Case Owner||Descriptor||Expected Search Result|
|All Processes (default)||All Processes (Default)||Disabled||Common Descriptors||Returns process instances (root and sub-processes) matching search criteria and the cases to which they belong.|
|Process Definition(s)||All Processes (Default)||Disabled||Descriptors in the selected process definition (or common descriptors if multiple selected)||Returns process instances (root and sub-processes) in the selected process definition(s) that match search criteria and the cases to which they belong.|
|All Processes (default)||Case Root Processes||Enabled and Blank||Case Name, Case Description, + Common Descriptors||Returns only cases matching search criteria|
|Process Definition(s)||Case Root Processes||Enabled and Blank||Case Name, Case Description, + Descriptors in the selected process definition (or common descriptors if multiple selected)||Returns only cases matching search criteria.|
|All Processes (default) OR selected process definition(s)||Case Root Processes||Enabled and Specified||Case Name, Case Description, + Common Descriptors||Returns only cases matching Case Owner AND Started, State, and Priority. The End Time fields are disabled and not considered.|
|All Processes (default)||Root Processes (Excluding Cases)||Disabled||Common Descriptors||Returns only root process instances (that are not cases) matching search criteria.|
|Process Definition(s)||Root Processes (Excluding Cases)||Disabled||Descriptors in the selected process definition (or common descriptors if multiple selected)||Returns only root process instances (that are not Cases) matching search criteria.|
The search result for cases displays the case root processes in the search result.
Figure: Process with Descriptors and a Case
The case process details, toolbar actions and actions column for any case process instance are same as for process search result. Note that you cannot perform the Abort Process and Start operation on any case process. For more information, please refer to the Abort Process and Start section of the Case Details View chapter.
You can view when the oldest process instance was started after archiving audit trail. To view the start time of the oldest process instance, hover the mouse over the information icon displayed next to the Search For text box. The timestamp is displayed in the tooltip text.
Figure: Timestamp of Oldest Process Instance
In case you have added an archive audit trail URL in the Configuration Panel for Process Search, an additional button Search Archive is available to start a search against the specified archive audit trail. Please refer to chapter Defining the Archive Audit Trail URL for Process Search for details on how to configure the URL.
Figure: Search Archive Button
Clicking this button starts a search against the archive based on the current search criteria and the results are shown in a separate Process Search view tab.
This tab will be reused for successive archived searches. Note that you have to manually close the process search view from the archived window before launching another archived search from the main IPP window.