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 under Upload customized PO file.

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 Anthology Student web app. The default value is No. This setting does not allow editing of label names in the web app Data Dictionary. It allows only to use labels that have already been modified from the legacy Data Dictionary tables. When you change this General setting option, allow some time to review the changes and then clear the cache. Note: The UI labels in the help system are based on the labels provided in the system's 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 Settings 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.

    Date Added Closed The date when the item or person was added or the status change was entered.

    Date ModifiedClosed The date when the item was changed. On some pages, it also includes the timestamp for the time.

    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.

    Modified ByClosed The name of the person who changed the item.

    NameClosed The descriptive name of the item.

  3. Take the appropriate action.

    Action Steps to follow
    Download the PO file

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

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

    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 downloaded PO file is saved in the database. The file is not removed when an upgrade occurs.
    Upload a 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 PO file.

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

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

    3. Select the Upload button. Anthology Student confirms that the Internationalization 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 updates the corresponding UI labels. When the PO file is 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 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 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.