Develop > Tailoring > Data management > Data Policy > Specify a referenced table for a field

Specify a referenced table for a field

The Data Policy for a table can define a referenced table for a field in the table. A referenced table is the table that is referenced by the current field. From a business logic perspective, the current field must be used to store the same data as the unique key field of the referenced table. For example, in the out-of-box cm3r Data Policy record, the device table is defined as the referenced table of the assets field (the Affected Configuration Item field). Once you have specified a referenced table, Service Manager creates a link that points from the current field to the unique key field of the referenced table.

Furthermore, the referenced table must have a Display Field defined. The current field displays the values of the display field, instead of values of the unique key field of the referenced table. For example, the Affected Configuration Item field in a Change record displays the CI display names (stored in the display.name field), instead of the CI Identifier values (stored in the logical.name field).

This functionality automatically updates the CI data in the reference modules (such as Change, and Incident) when a CI name is updated in the Configuration module so that data integrity is maintained across the modules.

To specify a referenced table for a field, follow these steps:

  1. Click Tailoring > Data Policy.
  2. Open the corresponding Data Policy record. For example, for the affected.item field in the cm3r table, open the cm3r Data Policy record.
  3. Select the Field Settings tab.
  4. Select the field, and select a value from the drop-down list in the Referenced Table column. For example, select device.

    Note Currently, only the device table can be used as a referenced table.

  5. Click Save to save the Data Policy record.

    In this example, Service Manager creates a link between the field and the logical.name field of the device table, if the link does not already exist. In the link record, the logical.name field is the target field.

Next, you need to specify a display field for the referenced table. This is the field of the referenced table whose values will be displayed in the current field. The current field derives data from the display field based on the unique key field of the referenced table. For details, see Specify a display field for a referenced table.

Related concepts

Environment configuration
Data Policy expressions
Data Policy and the object record
Data Policy and encryption

Related tasks

Access Data Policy
Specify a display field for a referenced table