Managing Translations

Manager Contents

Contents Introduction Translation Parameters Scope of Translations Copying Translations to Other Interface Preferences Page Header/Footer Translations Introduction The optional Translations feature allows translations to be defined for Interface Preferences so as to translate field captions, descriptions and a variety of other static text to other languages. Translations are accessed from the Manage Translations link that appears near the top of the Edit Interface Preference page. Translations are defined by specifying the Original Caption for the field(s) to be translated, along with a Translated Caption and Translated Description. CATSWeb then automatically performs the translation at runtime. If a Modify Form Field Property configurable action or other event hook is active that changes a field's caption or description, that configurable action or event hook will take precedence over a Translation. In other words, the final caption or description will be the value specified by the configurable action or event hook, without further translation.  Translation Parameters Translations have the following parameters: Original Caption- The caption, caption text, link text, section break text, or other test to be translated. Translations are performed (or not performed) based on the Original Caption in its entirety. For example, if a translation is defined for the Original Caption "Department", fields with a caption of "Department" will be translated, but fields with a caption of "Department Name" will not be translated. A second translation for "Department Name" would be needed in this example. Translated Caption - The new (translated) caption or text. Translated Description - The new (translated) description.  Back to Top Scope of Translations When Translations are defined, they are applied in the following locations: Field captions and descriptions in forms Option group values in forms (ex: Open, Closed, etc.)  Section break text  in forms Drill down link text  in forms  Column headers in data tables, such as query and filter result tables , hot lists, etc.  Legend values for filters, hot lists and similar data tables (ex: Open, Due Today, etc.) Utility links Workflow links Page titles and subtitles Display part titles, subtitles and window titles Various (but not all) static links provided by the CATSWeb system Translations are not applied to these locations (among others): Data values - Data values are never translated. However, the data value labels in option groups (ex: "Open", "Closed", etc.) are translated. The underlying numeric data value remains the same. Text containing data values - CATSWeb often displays text that is either entirely a data value, or a combination of static text and data values (ex: "Basic Issue Form #123"). Text like this is not translated since data values are involved. Note that CATSWeb category values ("form names") are considered to be data values. Message boxes - The text in message boxes is not translated. The text for System Section Breaks, since that text is definable in the Interface Preference itself.  Back to Top Copying Translations to Other Interface Preferences Translations from one Interface Preference may be copied to other Interface Preferences by way of the Copy Translations form that is present at the bottom of the Interface Preferences listing. Choose the Interface Preference to copy Translations from and to. The Copy Method setting determines how the translations will be copied: Augment - Translations already present for the target ("to") Interface Preference are left in place and not modified. Translations that exist only for the source ("from") Interface Preference are copied to the target ("to") Interface Preference to augment those that were already present.  Replace- All Translations for the target ("to") Interface Preference are first deleted. The Translations from the source ("from") Interface Preference are then copied to the target ("to") Interface Preference. The Interface Preferences will then have an identical set of Translations. Back to Top     Page Header/Footer Translations CATSWeb page headers and footers contain a number of special text elements (strings) that are subject to translation when they are present in the header or footer. Their presence is determined by the options installed in the system, user permissions, context, configuration settings, etc. The table below lists these special text elements so that administrators may define translations for all of them, if so desired: Page Header/Footer Text Element (string) Advanced Advanced Search Home Manage Logout My CATSWeb About Web Services Top Help Affiliate user User is logged in may have has pending personal tasks no personal tasks pending personal tasks Go To Issue Action Subtask Search View Agreements Date/Time Printed Printed By Back to Top