Internationalizations

You can use the Internationalizations page to configure the default language for Anthology Student and modify or rename labels and messages for the items associated with a language. For example, you can change the name of a field to make it more specific.

When Internationalization is configured, Anthology Student displays a globe icon Internationalization icon on the command bar to show the list of languages configured and the language in use. You can select the icon and select a language from the list.

US English is set as the default language and locale in Anthology Student.

To change form labels and messages, follow this process.

  1. Download a Portable Object (.po) file from Anthology Student.

  2. Use a text editor to edit the .po file to change any respective labels (msgstr).

  3. Save the modified .po file.

  4. Upload the modified .po file and save the changes in Anthology Student.

An example of a label change is provided below.

Prerequisites

You must have System - Settings - Internationalization - Manage authorization.

To customize and modify the label names, the system administrator must set the Use Data Dictionary for Form LabelsClosed Select Yes to use the legacy data dictionary configuration for form labels. To modify the labels, go to the data dictionary in the legacy interface of Anthology Student and change those labels. Select No to use only internationalization resources (if configured). To customize English and Spanish labels, download the PO file, modify the label text, and upload the modified PO file in the standard interface of Anthology Student. When you change this General setting option, allow for some time to review the changes and then clear the cache. Note: The UI labels in the Anthology Student Help are based on the labels provided in the system default English internationalization configuration file. option to No (Select the Settings tile > expand System > select General.) and then clear the cache. You must log out, log in again, and then navigate to Internationalizations to customize label names.

Access Method

Select the Setting tile > expand System > select Internationalizations.

Procedure to Add or Edit Items

  1. If you want to:

    • Add a new list item, select the New button on the toolbar

    • Edit an existing list item, select the name in the list

  2. Review, specify, or change the following values.

    ActiveClosed Specifies whether the associated record is active.

    DefaultClosed The associated record is set as default. For example, the default address, the default enrollment.

    LocaleClosed Indicates the language that you want to set as the default language. The en-US locale is defined and active by default. It may not be deactivated but additional locales may be defined and set as the default. The default locale is loaded in the absence of a user-specific language preference.

    NameClosed The descriptive name of the item.

  3. Take the appropriate action.

    Action Steps to follow
    Download PO file

    1.  Select the Download button in the grid toolbar. Anthology Student displays the Download .po file dialog box.

    2.   Select the Download button. Anthology Student displays the Save As dialog box.

    3.  Browse to the appropriate location and save the PO fileClosed Indicates a Portable Object file which is an industry standard file that includes the message key (msgid) and value (msgstr) specific to a given language..

    The PO file once uploaded, is saved in the database. The file is not removed when an upgrade occurs.
    Upload customized PO file

    You can customize the PO file.

    The PO file includes a header that identifies the application, the language, and a msgid/msgstr entry for every user-facing string used in Anthology Student. Some entries include only msgid and msgstr pairs and others include additional msgctxt entries. Entries with msgctxt include the default English value in the msgstr entry. These values are there to help the translator and should be replaced with the proper translated term.

    Example:

    The following .entry in the PO file changes the student profile label from “Alien Number” to “International ID”.

    #:Cmc.Nexus.Common.Contracts.dll\Cmc.Nexus.Common.EntityResources.resourcesmsgctxt "Cmc.Nexus.Common.Contracts"

        msgid "StudentEntity_AlienNumber_DisplayName"                                    
        msgstr "Alien Number"  < label string to change to “International ID”

    You can upload the customized the PO file.

    1.  Select the Upload button in the grid toolbar. Anthology Student displays the Upload .po file dialog box.

    2.  Browse to the appropriate location and select the PO file.

    3.   Select the Upload button. Anthology Student displays a confirmation message that the Internationalizations records were saved, followed by a second message stating that the Gettext file was processed successfully. You must log out and log in to view the updated value.

    When a PO file is uploaded (saved), Anthology Student makes the corresponding updates to labels. When subsequently downloaded later, the file will be just as uploaded and is, therefore, suitable for further translation work.

  1. If you want to save and: 

    • Continue making changes, select the Save button

    • Close, select the Save & Close button

    • Add another item to the list, select the Save & New button

Delete or Deactivate Internationalizations

You can use the Internationalizations page to delete and deactivate configured locales.

  • Deleting an item permanently removes it. No record of deleted list items is maintained in Anthology Student.

  • Deactivating an item keeps a record of it in Anthology Student (preferred). It can no longer be assigned to a student or record but remains assigned as it was previously.

If an item: 

  • Is not associated with a student or record, you can delete or deactivate it

  • Is associated with a student or record, you can only deactivate it

  • Is associated with Automated Awarding, you cannot delete or deactivate it

Procedure to Delete Items

  1. Highlight the item in the list.

  2. Select the Delete button on the toolbar.

The item is:

  • Removed from the list on the page and the list is redisplayed

  • No longer available to select on the forms that contain the list

Procedures for Deactivating Items

There is more than one method for deactivating an item.

Method Procedure to Follow Result
Using a toolbar button

1.  Highlight one item in the list.

2.  Select the Deactivate button on the toolbar.

The item: 

•   Remains displayed in the list with No in the Active column

•   Is also no longer available to select on the forms that contain the list

Editing the item

1.  Select the name of the item in the list.

2.  In the Active drop-down, select No.

3.  Select the Save and Close button.

Because the item is not removed, you can also make it active again by selecting the Activate button.