Managing Artifact Labels in Task Manager

Administrators can enter translated labels in different languages for artifact properties like a Task’s Name or description using the Artifact Labels page. These labels will be displayed to users based on their language preference. If an Artifact Label hasn't been entered for the user’s preferred language, then the original label entered in the artifact property, or default artifact label, is shown.

Note:

  • You must have the Task Manager - Artifacts – Manage role to access the Artifact Labels. Additionally, the Enable Artifact Labels option must be enabled. For more information, see Enabling Artifact Labels .
  • The Artifact Labels list is automatically updated during the nightly maintenance window. Newly created artifacts appear within the Artifact Labels list after the nightly maintenance window has completed.

    Artifacts that have the exact label for a property appear only once within the listing. For example, a task named "Task 1" appears in multiple monthly schedules. The Artifact Labels list shows only one entry for a Task with the Name - "Task 1" and shares all entered language labels.

    Editing an artifact property, such as renaming a task, creates a new entry within the artifact label list, which requires new language labels to be entered.

    Deleted artifacts are removed from the Artifact Label list when all instances of the artifact have been removed from the service. For example, all tasks named "Task 1" need to be deleted from all the monthly schedules before it's removed from the artifact label list.

View Artifact Labels

To view artifact labels:

  1. Go to Application > Task Manager and click the Artifact Labels icon on the left.

    The Manage Artifact Labels page displays a list of artifact labels with the following information:

    • Artifact Type: Type of artifact such as Schedule, Task, and Template.
    • Property: The artifact property such as Name or Description.
    • Default: Default label entered on the artifact.
    • English: Text to be displayed in English language.
    • Created By: Indicates the user that created the default artifact label.
    • Last Updated By: Indicates the last user to update the artifact label.

    Optionally, you can click the Customize Columns Customize Columns icon and add or remove the required columns. Columns for each supported language is available. When you click Customize Columns, the Columns window is displayed. To show a column, in the Hide section, mouse grab the Two Line Icon icon for the column name that you want to show and then drag and drop to the required position in the Show section. To show a column, in the Hide section, mouse grab the Two Line Icon icon for the column name that you want to hide and then drag and drop to the required position in the Hide section. You can also use the following shorcut keys:

    • Focus on a row, then use F2 followed by Space to select or deselect it.
    • With focus on a row, use CTRL+X, followed by the Up or Down arrow keys to move to another row, then use CTRL+V to move the initial row above the current row.
  2. Use the Search field and the filter clips to search for a required artifact label.

Edit a Artifact Label

To edit an artifact label:

  1. On the Artifact Labels page, select the artifact label that you want to edit and click Edit.

    The Edit Languages panel is displayed with a field for each supported language.

  2. Specify the translated text for the required language and click Save.

Edit Artifact Labels in Bulk

To edit the artifact labels in bulk, you can export the artifact list, update the file, and then import the file. Any translations in the import file updates the existing translations in the UI.

To export the list of artifact labels:

  1. On the Artifacts page, click Export.

    The displayed artifact labels are exported to a CSV file and downloaded to your system.

    Optionally, you can limit the export to the artifact labels you want to edit by using the search bar and filter chips.

  2. In the exported file, add new artifact labels within the language columns, and save the file.

    The exported file includes four columns that indicate the Artifact Type Id (ArtifactTypeID), Object Type (ObjectType), Property (Property), and the Default Label (DefaultLabel). The values within the rows in these columns can't be modified. Also, you can't remove these four columns.

    Additionally, there are columns for each supported language (LangXx). You can remove the language column that you won't update with artifact labels.

    The following table provides the language column codes.

    Language Column Codes
    LangAr = Arabic LangHe = Hebrew LangPtBr = Portuguese (Brazil)
    LangCs = Czech LangHu = Hungarian LangRo= Romanian
    LangDa= Danish LangIt = Italian LangRu= Russian
    LangDe= German LangJa = Japanese LangSv = Swedish
    LangEn = English LangKo= Korean LangTh= Thai
    LangEs = Spanish LangNl = Dutch LangTr = Turkish
    LangFi = Finnish LangNo = Norwegian LangZhCn = Chinese (Simplified)
    LangFr = French LangPl = Polish LangZhTw = Chinese (Traditional)
    LangFrCa = French (Canada) LangPt = Portuguese
  3. To import the translated artifact labels, click Import and select the updated CSV file that contains the translated artifact labels.

    Initially a message at the bottom of the page is displayed indicating import has started.

    After some time, import completed successfully is displayed. You can click View Details to view the following import details:

    • File name
    • Type of import
    • Importer’s name
    • Start time of the import operation
    • End time of the import operation
    • Status of the import:
      • If Success, the number of objects created, deleted, and updated are displayed
      • If Failed, the error and the details are displayed
  4. Click Refresh to refresh the list of artifact labels.