Creating synonyms of internal values

You can create synonyms of internal values so that you can present different values to users based on your business needs.

Procedure

  1. Open the Domains application.
  2. Find the synonym domain for which you want to add a synonym value, for example WOSTATUS.
  3. Click Edit Detail. In the Synonym Domain table window, the set of current values: the Internal Value is used by the system and must be unique. The Value and its description are what users see.
  4. Click New Row and enter values in the fields:
    Field Description
    Internal Value Specify the internal value for which you want a synonym.

    For example, in the WOSTATUS domain, if you want to create a synonym for WAPPR called WAIT, you would specify the WAPPR internal value.

    Value Specify the synonym value you want a user to see.

    For example, WAIT.

    Description Type a description of the synonym to differentiate it from the existing value.
  5. Optional: In the Default field, select the check box if you want the system to use the new synonym value by default. Each internal value can have only one default synonym value.

    For example, the system inserts WAPPR (Waiting for Approval) as the status when you create a work order. You add a synonym value, WAIT. If you want the system to insert WAIT instead of WAPPR, then make WAIT the default.

  6. Optional: Apply a domain value to a specific organization or site by specifying values in the Organization and Site fields. Domains are applied at the system level by default.

    You might want to leave the Organization and/or Site fields empty for all values so that users in all organizations and sites can access them. Or you could specify organization and/or site for all values so that only users in the specified organizations and/or sites can access them.

    If you create a synonym value and specify a site or organization, and then click OK, the system automatically inserts duplicate rows for the other values. The duplicate rows have the site or organization you specified for the new value that you created. For example, the MRTYPE domain has three values: RECURRING, STANDARD, and TRANSFER (each with an internal value of the same name). If you create a synonym value, REGULAR, with the internal value of STANDARD and specify Organization B, the system automatically creates (when you click OK) the additional synonym values RECURRING and TRANSFER with Organization B specified.
    Important: After you have implemented the system and inserted records, you generally must not add a synonym value with a site or organization specified. This action can invalidate existing data. If you must add a synonym value with a site or organization specified, you must also add synonym values for all the existing values that are in the database. For example, if you added a synonym value for STANDARD with an organization or site specified, you must also add synonym values for RECURRING and TRANSFER (if they have been used on records) with the same organization or site specified.
  7. Click New Row to add more synonyms.
  8. Click OK.


Feedback