Searching the ECS
The Search ECS dialog allows the user to filter out and locate erroneous UDRs and batches in the ECS. Any search settings you make can also be saved as filters that you can use for future searches. The Search ECS dialog is displayed when the Search option is selected in the ECS Inspector. Select UDRs or Batches to display UDR or batch specific options.
Search ECS dialog
Search Options
The entries in the ECS can be either UDRs or batches. Depending on the selected type, different search options are available.
Common Search Options
The following settings are available for both UDRs and batches in the ECS.
Search Option | Description |
---|---|
Saved Filters | This is the column to the left in the dialog. This column lists any previously saved filters. For more information about how to create a filter, see section Saving Search Settings as a Filter below. |
Workflow | The name of the workflow that sent the entry to the ECS. |
Agent | The name of the agent that sent the entry to the ECS. |
Error Code | An Error Code that has been defined in the ECS Inspector. See ECS Error Codes for further information. |
Error Case | A list displaying the Error Cases associated with the selected Error Code. If the entry is too long to fit in the field, the field can be expanded by enlarging the ECS Inspector in order to display the entire error case text. An Error Case is a string, associated with a defined Error Code. Error Cases can only be appended via APL code: udrAddError( <UDR>,
<Error Code>,
<Error Case> ); Note!When Batches is selected, the |
MIM | It is possible to configure a workflow to send descriptive MIM values with the actual data (in the Workflow Properties window). This can be used to refine the search in the ECS. |
Insert Period | Select this checkbox to search for UDRs or batches that have been inserted into the ECS during a specific time period. Choose User Defined and specify start time (From) and end time (To), or use one of the predefined intervals, e.g. Last Hour, Today, This Week. |
Reprocessing Group | Contains a list of all reprocessing groups. Unassigned UDRs or Batches list all entries not associated with any reprocessing group. |
Reprocessing State | Filter based on state, which can be New or Reprocessed. Only entries in state New may be collected. |
Search Options for Batches
The following settings are only available when searching for batches in the ECS
Search Option | Description |
---|---|
Cancel Agent | The name of the agent that cancelled the batch. |
Cancel Message | The error message sent as an argument with the |
Error UDR Type | The type of Error UDR that can optionally be sent with a batch, containing important MIM information (or any other desired information when the UDR is populated via APL). |
Search Options for UDRs
The following settings are only available when searching for UDRs in the ECS.
Search Option | Description |
---|---|
UDR Type | The type of UDR you want to search for. |
Tag | If you have tagged UDRs, this option can be used for displaying only UDRs with the stated tag. |
Reprocessing State Change Period | Select this checkbox to search for UDRs that last changed state (to New or Reprocessed) during a specific time period. Choose User Defined and specify start time (From) and end time (To), or use one of the predefined intervals, e.g. Last Hour, Today, This Week. |
Search Fields | If you have selected to search for UDRs, there is an Advanced tab, where you can select to Search Fields. Here, you can enter specific values for different UDR labels that you have configured, see Configuring Searchable Fields in the ECS. Only UDRs containing the specified values will be displayed in the ECS Inspector. ExampleFor example, with the following setting: Only UDRs with IMSI 2446888776 are displayed in the ECS Inspector, provided that the label IMSI has been mapped to the IMSI field in the UDRs. Wild cards and intervals can also be used when entering the values for the fields; "*" can be used for matching any or no characters, and intervals can be set by using brackets "[ ]". When using the * or [ ], the following rules apply:
If a setting for a value is not correct, an error message is displayed as a tooltip. In order for a UDR to pass the filter, all the defined values have to match. ExampleFor example, with the following setting: Only UDRs with:
will be displayed. |
Saving Search Settings as a Filter
When the search settings have been made, you can select to save these settings as a filter.
To save a filter:
Set the search options you want and click Save (bottom left corner button).
A dialog opens asking you to enter a name for the filter.
Entering Filter Name
Enter a name in the Filter Name field and click OK.
The dialog closes and the new filter appears in the Saved Filters list.
The next time you want to use the same search settings, click the filter name in the Saved Filters list and the saved search settings are displayed.