Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added links

Search configurations are used in Nexus PRIME to search in data pools and identity templates, and to set up search filters and results. Search dialogs can also be integrated into processes, or be shown in batch orders and related object field. Permissions need to be adapted to the intended use and roles. Searches can be done on multiple levels, and for example show card data for all employee cards of a certain employee. 

This article describes how to create or edit a search configuration in Nexus PRIME Designer

Prerequisites

Expand
titlePrerequisites

Before setting up the search configuration, make sure that the following things apply:

  • Installed PRIME
  • Available identity template or data pool as reference for the search configuration
  • If needed: Available report configuration, to allow users to export the search results to a pdf report

Step-by-step instruction

Expand
titleLog in to PRIME Designer as admin
  1. Log in to PRIME Designer as an admin user.


Expand
titleAdd search configuration
  1. In PRIME Designer, go to Home > Search Configurations.
  2. To add a new search configuration:

    1. Click +New.

    2. Enter a Name and Select a Reference, either an identity template or a data pool.

    3. Click Save+Edit.
      The Search Configuration panel is shown. The fields of the selected data pool or identity template are listed under Search Criteria. The search dialog as it will roughly appear in PRIME Explorer is shown on the right, under Extended Search. On the left of it is the search mask, on the right the search results.
  3. To edit an existing search configuration, double-click on its name.


Expand
titleSet multi-level search

Search over multiple levels means that a search can be done over multiple data pools or core templates.

For example, to search for all employee cards of an employee employee usually has an employee card. When Search over multiple levels is selected with Search Depth = 1 in the Employee data pool, I can find.

To set multi-level search:

  1. Select Search over multiple levels.
  2. Set Search Depth. Search Depth = 1 means that data from related objects can be shown in the search results. The maximum value is 3.
  3. Set Result Reference Type to core template or data pool, and select a Result Reference Name
    The selected data pool or core template is shown in the Search criteria field.


Expand
titleAdd search mask

To add a search criterion to the search mask:

  1. On the General tab, drag-and-drop the search criterion, for example Birth date, from Search criteria to the left field in Search.
  2. Select an initial search condition, for example begins with or greater or equal.
  3. Optionally, enter an initital search value, for example Jun 7, 2017.
  4. To change the search properties of the field, click Edit (pen symbol).
  5. In Change search field properties, check Hidden, to hide the criterion from the search mask. A hidden field needs an initial search value. To use a variable value from another data pool in the search mask, select the data pool in Selection list and select a Value. Click OK.
  6. Repeat steps 1-5 for all search criteria needed in the search mask.
  7. Click Save to save your settings.


Expand
titleAdd search results

To add a search criterion to the list of search results:

  1. To show a search criterion, for example First Name, in the search results, drag-and-drop it from Search criteria to the right field in Search.
  2. To move a column in the search result table, drag-and-drop it to a new location.
  3. Click on a column heading to set the sort order based on that column. To change sort order between ascending/descending, click on the column heading again.
  4. Click Save to save your settings.


Expand
titleChange order of search dialogs

To change the order in which the search dialogs will show up in the PRIME Explorer:

  1. Click Sort Sequence.
  2. Select a search dialog and use the arrow buttons on the left to move the dialog name up or down.
  3. Click Save.


Expand
titleSet report formats

To set available report formats:

  1. Click Configure function 'Export search results'.
  2. In Choose export formats, check CSV format to make csv export available. Select a PDF format to make pdf export available and define the layout of a pdf export.
  3. Click OK to save the settings.


Expand
titleSet search purpose

To define where the search configuration is to be used, the purpose must be set:

  1. Go to the Purpose tab.
  2. Select one or more of these alternatives:
    • Simple Search - A search field appears on the Start tab in PRIME Explorer. This option is not supported for external data sources.
    • Extended Search - The search configuration is available on the Search tab in PRIME Explorer.
    • Batch Orders - The search configuration is available on the Batch Orders tab in PRIME Explorer.
      This option is not supported for external data sources.
    • Object Relations - The search configuration is displayed in the Related objects field for a certain object.


Expand
titleSet permissions

To set the permissions to execute the search configuration:

  1. Go to the Permissions tab.
  2. Click Execute in the left field.
  3. To add permission for a specific user, click the Add User button to the right, and select the user name in the selection box.
  4. To add permission for a role, click the Add Role button to the right, and select the role in the selection box.
  5. To delete a permission, mark the role or user in the list and click Delete.
  6. Click Save to save the settings.


This article is valid from Nexus PRIME 3.5.

Related information