The Edit query dialog

ClosedTo access this dialog:

  1. Using the XBOUND Management Center, open a console containing the Validation Designer. (For information about working with consoles, see XBOUND Help.)
  2. Under Process Navigation, select a process.
  3. Click the Check out button ().

  4. Select File > Queries.
  5. Click Add. Or select a query and click Edit.

Use these settings to create or edit database queries:

Name

Name of the query.

Display name

Display name of the query (shown in the Display name column of the work area for master data).

Connection

Pre-configured connection to the database.

Table

Lists all tables available in the selected database.

Search type

Indicates how searches are performed.

  • Exact search: The value of the table column must equal the value of the XBOUND field.

  • Substring search: The table column must contain the value of the XBOUND field.

If Exact search is selected, these wildcards can be used in the search expressions:

* or %

Zero or more characters.

Example search of names: ROB* or ROB% returns all data sets in which Name begins with ROB.

?

One character.

Example search of names: ROB?ER* returns all data sets in which Name begins with RO, followed by any single character, followed by ER, followed by zero or more characters.

Return type

Indicates which query results are returned.

  • All results: All search results are returned.

  • Unique results: A search result is returned only if it is unique.

  • First result: Only the first result is returned.

Max. row count

Maximum number of the returned results. If the query returns more results than the number specified here, only this specified number of results are returned. (This increases performance.)

Allow duplicates

If selected, duplicate entries in the database are searched. If not, they are ignored.

Column options

These options mark the corresponding checkboxes in all rows below.

  • Show all

  • Apply all

  • Filter all

Settings per column

  • DB column: Name of the table column.

  • Display name: Name of the table column in the Master data query dialog.

  • Type: The XBOUND-compliant data type of the column.

  • Show: Indicates whether the table column is displayed in the Master data query dialog.

  • Apply: Indicates whether the value of the table column is to be transferred into the assigned XBOUND field or cell.

  • Filter: Indicates whether the value of the XBOUND field or cell is to be used for filtering this table column (WHERE clause).

  • XBOUND Field/Table Column: Assignment of XBOUND fields/table columns to the database table columns. You can type the name of a field, a field group, or a table column here. The system suggests values that match what you typed (though you do not need to use them). When the query is executed, the system searches for a field by this name in the current document. Syntax:  

    • Field: Field name

    • Field group: Field group name followed by a period (.) and the field name. Example: InsuranceData.FirstName. Can be nested in different levels.

    • Table column: Table name followed by a greater-than sign (>) and the column name. Example: Positions>Articlenumber.

  • Test value: Type a value here for testing the query. This value is not stored.

Save and test button

Checks the query settings specified in this dialog and saves them. The query is executed using the entered test values, and the results are displayed in the Test query dialog.

If the Apply or Filter columns are activated, an XBOUND field must be assigned.

If one of the displayed queries is incorrectly configured, the incorrect property is highlighted in red. This can happen if the field definition that is used in the query has been deleted, for example.

Querying master data: Overview

Validation Designer plug-in