If you click on a process name in the Persistent States tab, an overview table with all persistent state objects is displayed.
Working With the Persistent State Objects Table
The table displays all available persistent state objects. On top of the page you can find a breadcrumb navigation that allows you to to switch back to the Persistent States tab in the service details:
For each persistent state object, the following information is shown:
|
Process Name |
Name of the process in which the instance was created. |
|---|---|
|
Service State |
Name of the state(s) in which this object currently resides. The names of all persistent state elements are displayed in normalized UML: all white spaces are replaced by underscores ('_'). A single persistent state object can be in various states at once. The name of the final state will never be seen because by entering the final state the object ceases to exist. However, while destroying the object, the state machine is in the state --8<--. Think of --8<-- as an internal state name for the final state. So every object will reach this state before it gets deleted from the database. The state name --8<-- is strange by design to prevent a clash with other state names. If the state engine has a low load you will perhaps never see objects in this state. If the state engine is very busy you can see a lot of such objects - but this is no problem. |
|
Stalled |
Shows if the object is stalled. Field is empty, if this is not the case. In addition, stalled persistent state objects are displayed in red. Refer to Stalled Persistent State Objects for more information. |
|
Instance ID |
Unique primary key that identifies an instance. |
|
Created |
Creation date and time of the persistent state object. |
|
Updated |
Date and time when the object was last updated. |
General Note on the Persistent State Object Table
Some functionality of the persistent state object table is limited, if your service uses a Runtime version older than 2026.2 or a Compiler version older than 8.12.0. In these cases:
-
Send Signal to all objects is not possible and the corresponding icon is not displayed. You can still send signals to single objects via the object details view.
-
The table pagination in the footer is not working. As a result, the number of rows per page displayed in the footer does not match the actual number of records. The table always displays all available data.
Filtering the Persistent State Objects Table
The persistent state objects table may contain a large amount of data. You can use the extended filter in the upper part of the table to minimize the list. Two different filters are at your disposal:
States Filter
Use the States filter to see only instances in a specific state. The selected states are displayed above the table so that you can see which filters are active at any time:
A single persistent state object can be in various states at once.
Attributes Filter
The Attributes filter allows you to filter instances in even greater detail:
The following options are available:
|
Filter Field |
Usage |
Default |
Possible Options |
|---|---|---|---|
|
Creation from... |
Enter a date/time range to filter by the creation date of the instance. Use the calender to enter the date and time. |
- |
any datetime |
|
Creation to... |
|||
|
Last Update from... |
Enter a date/time range to filter by the date the instance was last updated. Use the calendar to enter the date and time. |
- |
any datetime |
|
Last Update to... |
|||
|
Attribute |
Select one of the available attributes from the list. |
first available attribute |
all custom attributes from your service |
|
Operator |
Select the operator you want to use. |
= |
= != > >= < <= like unlike |
|
String for Attribute |
Enter your search term for this attribute. Your entries in the attributes filter result in an SQL query. For the like operator, you can therefore use the wildcard characters % (zero, one, or multiple characters) and _ (a single character). |
- |
any string |
|
Condition |
Specify the filter condition.
|
AND |
AND
|
|
Cancel |
Click here to close the filter pop-up. Your changes will not be saved. |
- |
- |
|
+ Attributes |
Use this option to add more attributes to the filter. You can also use the + at the end of an attributes row to add another attribute. Use the - to remove an attribute from the list:
|
- |
- |
|
Apply Filter |
Click here to apply your attributes filter. |
- |
- |
An applied Attributes filter is displayed above the persistent state objects table so that you can see which filters are active at any time:
You can use the footer to toggle between pages. In the footer, you can also specify the count of rows to be displayed for the table (Rows per page):
Reloading the Persistent State Objects Table
To refresh the persistent state objects table, use option Reload on top of the table:
Sending Signals
You can send a signal to all persistent state objects in a specific state or to a single object. Refer to Sending Signals to Persistent State Objects for details.
Inspecting Persistent State Object Details
If you want to inspect a single object, click on the corresponding table row. Refer to Inspecting Persistent State Object Details for further information.
Deleting Persistent State Objects
Use option Delete to remove persistent state objects. For more information on deleting single and multiple objects, refer to Deleting Persistent State Objects.