Understanding the Text Catalog

This topic provides an overview of the text catalog and lists common elements.

The text catalog, which is used by several PeopleSoft Enterprise applications, stores standard text that appears on the self-service pages, including page labels, field labels, button names, links, page instructions, and warnings. You can modify the text by using the Text Catalog feature.

Entries in the text catalog feature are context-sensitive, meaning that a particular piece of text on a page can vary depending upon the page's usage or context. In Enterprise Learning Management, you can define different text for self-service pages according to learning environment.

Context-sensitivity is accomplished through the use of keys that enable the application to retrieve applicable text catalog entries.

Although you can have multiple versions of the same text, you do not have to set up a separate entry for every possible scenario. You can create one generic entry where all key values are blank, and then add entries for the situations that vary from the norm. Blank key values function as wildcards.

Warning! When the system looks for a match, it stops searching if the search keys narrow the possible choices to a single row—the lower-order search keys are ignored. If you do not set things up correctly, the system may return the wrong results. Plan ahead before making changes, particularly for complex scenarios. Random changes can lead to errors that are difficult to debug later.

You can test changes by using the Test Text Catalog page. To test an entry, enter the text ID that is associated with the text, plus any combination of key values, and click the Test button to view the text that the system retrieves for the keys values you entered.

To update a text entry, you need its ID. Use the Display Text ID option on the Configure Text Catalog page to find this information. When you activate this option, the text IDs appear in place of the corresponding text on self-service pages and warnings.

To view the correct text IDs, you need to create the conditions that cause the page or warning to appear. For example, you might need to sign in as a user who is assigned to a particular learning environment.

Note: You may want to activate this option, print a copy of the self-service pages, and then deactivate it. This provides a hardcopy reference of all the text IDs used on each self-service page.

Field or Control

Description

Text ID

The unique identifier that you entered to access entries in the text catalog.

Effective Date

The date on which a particular text catalog entry becomes active. Delivered text is defined as system data in the Enterprise Learning Management database and has an effective date of 1/1/1900.

Important! To prevent future updates to Enterprise Learning Management from overwriting any text entries that you add or modify, use a later effective date when you add new text entries, and insert a new effective date when you modify delivered text.