9.24.4.4 Searching the ECS
- Jenni Wallin
- Former user (Deleted)
- Karthik Bangalore
- Former user (Deleted)
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 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 ECS can be either UDRs or batches. Depending on the selected type, different search options are available.
Common Search Options
The following search options are available for both UDRs and batches in ECS:
| Search Option | Description |
|---|---|
Saved filters | This field contains any saved filters you may have created. For more information about how to create a filter, see the section below, Saving Search Settings as a Filter. |
Workflow | The name of the workflow that sent the entry to ECS. |
Agent | The name of the agent that sent the entry to ECS. |
Error Code | An Error Code that has been defined in ECS Inspector. See 9.24.4.6 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 Batch 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 could be used to refine the search in ECS. |
Insert Period | Use this Search option to search for UDRs/batches that were inserted into ECS during a specific time period, either by specifying a start and end time, or by using any of the predefined intervals, e g last hour, today, this week, etc. |
Reprocessing Group | Contains a list of all reprocessing groups. Unassigned (UDR/Batch) will list all entries not associated with any reprocessing group. |
Reprocessing State | The entry state, which can be New, or Reprocessed. Only entries in state New may be collected. |
Search Options for Batches
The following search options are only available when searching for Batches in ECS:
| Search Option | Description |
|---|---|
Cancel Agent | The name of the agent that cancelled the batch. |
Cancel Message | The error message that was 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 search options are only available when searching for UDRs in ECS:
| Search Option | Description |
|---|---|
UDR Type | The type of UDR you want to search for. |
Tag | If you have tagged any UDRs, this option can be used for displaying only UDRs with the stated tag. |
Reprocessing State Change Period | Use this Search option to search for UDRs that last changed state during a specific time period, either by specifying a start and end time, or by using any of the predefined intervals, e g today, this week, etc. |
Search Fields | If you select this check box, you can enter specific values for different UDR labels that you have configured, see 9.24.4.2 Configuring Searchable Fields in the ECS. Only UDRs containing the specified values will then be displayed in the ECS Inspector. Example For example, with the following setting:
Only UDRs with IMSI 2446888776 will be 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 will be displayed as a tooltip. In order for a UDR to pass the filter, all the defined values have to match. Example For 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.
Warning!
If you have included search criteria that refers to parameters that have been defined in your system, such as error codes, tags, search fields, etc, these filters will not work properly in case you delete any of the defined parameters.
To save a filter:
Set the search options you want to have and click on the Save... button.
A dialog opens asking you to enter a name for the filter.
Entering Filter Name
Enter a name in the ECS Filter Name field and click OK.
The dialog will close and the new filter will appear in the Saved Filters field.
The next time you want to use the same search settings, click on the filter name in the Saved Filters field and the saved search settings will be displayed.
Hint!
Any saved filters can be renamed or deleted by selecting the filter and then clicking on the Rename or Delete buttons.