Import raw reason codes

The ability to import raw reason codes from an XML file allows you to more easily create a large number of raw reason codes than adding them using Object Editor. It also allows you to import raw reason codes that were exported from another UCO.

For an explanation of the raw reason code XML file structure and a sample file, see Raw reason codes XML file format and Sample Raw Reason Codes XML File.

1. With the UCO opened in Object Editor, on the General tab select the raw reason code in the list before or after which you want to insert the imported raw reason codes.

   If you want to insert the imported raw reason codes at the beginning or end of the current list, it does not matter what raw reason code is selected.

2. Click the Import button.

   

   The Import dialog box appears.

3. Navigate to and select the raw reason code XML file that you want to import.

4. Click Open.

   The Import Preferences dialog box appears.

   

5. Select where you want to insert the imported raw reason codes in the current list (that is, at the beginning or end of the list, or before or after the selected raw reason code).

6. Select how to handle imported raw reason codes that have the same name as existing codes:

   Skip: Do not import

   Do not import the duplicate raw reason code.

   Overwrite existing Raw Reason Code

   Overwrite the existing duplicate raw reason code with the imported code.

   Rename importing Raw Reason Code

   Append the text string in the box to the imported raw reason code, so that the name is not duplicated.

7. After selecting the insert and duplicate actions, click OK.

   The contents of the XML file are validated. This validation includes the syntax of the expression, but not the validity of a contained attribute reference in the expression. An expression’s contained attribute reference will be validated when a Save operation is performed, or by clicking the Validate Expression button above the Expression box. See Enter a raw reason code System Platform script expression and Validation of expression syntax and references.

   If there are validation errors, see Import validation errors.

   If there are no file validation errors, the raw reason codes are imported into the object. The import process will take approximately 5 seconds per 1000 raw reason code records in the XML file.

   When the import has successfully completed, a message appears that includes the number of raw reason codes imported.

   

8. Click OK to dismiss the message.

   The imported raw reason codes appear in the list at the specified location.