Chapter 21. Process instance filtering in Business Central

Procedure

1. In Business Central, go to Menu Manage Process Instances.

2. On the Manage Process Instances page, click the filter icon on the left of the page to expand the Filters pane and select the filters you want to use:

   • State: Filter process instances based on their state (Active, Aborted, Completed, Pending, and Suspended).
   • Errors: Filter process instances that contain at least one or no errors.
   • Filter By: Filter process instances based on Id, Initiator, Correlation Key, or Description attribute.
   • Name: Filter process instances based on process definition name.
   • Definition ID: The ID of the instance definition.
   • Deployment ID: The ID of the instance deployment.
   • SLA Compliance: SLA compliance status (Aborted, Met, N/A, Pending, and Violated).
   • Parent Process ID: The ID of the parent process instance.
   • Start Date: Filter process instances based on their creation date.
   • Last update: Filter process instances based on their last modified date.

Procedure

1. In Business Central, click Menu Manage Process Instances.
2. On the Manage Process Instances page, click the Advanced Filters icon.
3. In the Advanced Filters pane, enter the name and description of the filter, and click Add New.
4. Select an attribute from the Select column drop-down list, for example, processName. The content of the drop-down changes to processName != value1.
5. Click the drop-down again and choose the required logical query. For the processName attribute, choose equals to.

6. Change the value of the text field to the name of the process you want to filter.

   Note

   The processName must match the value defined in the business process of the project.

7. Click Save and the processes are filtered according to the filter definition.

8. Click the star icon to open the Saved Filters pane.

   In the Saved Filters pane, you can view all the saved advanced filters.

Procedure

1. In Business Central, go to Menu Manage Process Instances.

2. On the Manage Process Instances page, click the star icon on the left of the page to expand the Saved Filters panel.

   In the Saved Filters panel, you can view the saved advanced filters.

   Default filter selection for Process Instances

   

3. In the Saved Filters panel, set a saved process instance filter as the default filter.

Procedure

1. In Business Central, go to Menu Manage Process Instances.
2. On the Manage Process Instances page, click the filter icon on the left of the page to expand the Filters panel.

3. In the Filters panel, select the Definition Id.

   The filter is applied on the current process instance list.

4. Click Show/hide columns on the upper right of the process instances list and the process instance variables of the specified process id will be displayed.

5. Click the star icon to open the Saved Filters panel.

   In the Saved Filters panel, you can view all the saved advanced filters.

Procedure

1. In Business Central, go to Menu Manage Process Instances.
2. On the Manage Process Instances page, click the advanced filters icon to expand the Advanced Filters panel.
3. In the Advanced Filters panel, enter the name and description of the filter, and click Add New.
4. From the Select column list, select the processId attribute. The value will change to processId != value1.
5. From the Select column list, select equals to for the logical query.
6. In the text field, enter the name of the process id.
7. Click Save and the filter is applied on the current process instance list.
8. Click Show/hide columns on the upper right of the process instances list and the process instance variables of the specified process id will be displayed.

9. Click the star icon to open the Saved Filters panel.

   In the Saved Filters panel, you can view all the saved advanced filters.