Contentstack on Contentstack: Omnichannel Personalization | Save your spot!
CS-log-dark.svg

Trados App Installation Guide

Trados is a computer-assisted translation software suite created by the company RWS, which helps language professionals manage and streamline their translation projects. It includes tools for communication, workflow management, terminology management, text analysis, and quality assurance.

With the Contentstack Marketplace Trados app, you can easily translate your Releases content (entries) into multiple languages and provide localized versions within your Contentstack entries. You can create a project using the Trados app Dashboard Widget and view the translation status of your projects.

Note The Trados app has been migrated to a Full Page UI location. We are deprecating the Stack Dashboard UI location soon.

Prerequisites

Follow this step-by-step guide to install and configure the Trados app within your stack.

Steps for Execution

  1. Retrieve your credentials from Trados
  2. Install and Configure the Trados app in Marketplace
  3. Use Trados within your Stack

  1. Retrieve your Credentials from Trados

    To get your credentials for Trados, log in to the Trados account and follow the steps given below:

    1. In the top-right corner of the Dashboard, click the My Account icon and then click My Applications.
      Click to enlarge
    2. Now, click the Add New button to create a new application.
      Click to enlarge
    3. Enter the Application Name (mandatory), Description (optional), Website URL (optional), and then click the Save changes button.
      Click to enlarge

      You can now see the Edit a Connected Application screen.

      Click to enlarge
    4. Scroll down to get the Trados app Client-Id and Secret.
      Click to enlarge
      Secret is generated after the Production Status is approved by the Trados authority.
      Click to enlarge

      After getting the Client-Id and Secret, copy and paste the information to your clipboard.

      You can see your application in the Trados dashboard.

      Click to enlarge

  2. Install and Configure the Trados app in Marketplace

    To install the app in Contentstack, log in to your Contentstack account and follow the steps below:

    1. Navigate to the “App Switcher” icon in the top-right corner and click Marketplace.
      Click to enlarge
    2. Click Apps from the left panel.
    3. Within the Marketplace, you can see the available apps. Hover over the Trados app and click Install.
      Click to enlarge
    4. In the popup window, select the stack where you want to install the Trados app, accept the Terms of Service, and click the Authorize and Install button.
      Click to enlarge
    5. On the Configuration screen, enter the following details:
      1. Trados Credentials:
        1. Enter the Username and Password of your Trados account.
        2. Enter the Client ID and Client Secret retrieved from your Trados account in step 1.
      2. Click the Next button.
        Click to enlarge
      3. Contentstack Fields:
        1. Select the Roles that can create and delete projects within Contentstack Trados.

          By default, Admins can manage app configuration settings and perform these actions.

        2. To define which fields should be available for translation, click the Enable Additional Settings toggle.
      4. Click the Next button.
        Click to enlarge
      5. Additional Settings:
        You can include or exclude specific fields from translation for specific content types, or apply global exclusions across all content types.
        1. Manage Fields:Click the Manage Fields button to open the Content Type Settings modal.
          Click to enlarge

          In the Content Type Settings modal, use the dropdown to search and select a content type, then choose the field UIDs you want to include or exclude for translation.

          Click to enlarge

          Once done, click the Save button to apply your selections.

        2. Field(s) to Exclude from All Content Types for Translation:

          In this field, enter the UID(s) of fields you want to exclude globally. These fields will not be included in the translation process for any content type.

          Click to enlarge
        3. Language Configuration: In the Language Configuration section, map the content translation languages for Contentstack and Trados. All the entries from Trados languages will be localized into Contentstack languages. For any target languages not selected, the app uses the default language code of the stack.

          Click the + Add Language button to add and map Contentstack languages with their relevant Trados languages.

          Click to enlarge
        4. Field Configuration: The JSON RTE to HTML conversion feature enables the transformation of the JSON RTE object into a single HTML code block. This simplifies the translation process for translators by making the content easier to interpret and process within Trados.

          Enabling the Enable JSON RTE Object to HTML Conversion toggle button, allows the conversion of complex JSON data structures into HTML, making the content more accessible and manageable.

          Click to enlarge

          WarningDo not change the toggle button during Project Translation, as it may disrupt the Translation process.

        5. Reference Handling: In the Reference Handling section, enable this option to automatically include referenced entries and assets in translated releases. This ensures that all nested or linked content is also localized and published together with the main entry.
          Click to enlarge

        Once done, click the Finish button.

        You can reset your configuration by clicking the Reset Configuration button.

      6. After configuring all the details, click the Save button.
      7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.
        Click to enlarge
      8. If the webhook is enabled for your app, you can view the webhook logs under the Webhook tab.

        Additional ResourceFor more information on UI location and webhooks, please refer to the Installed Apps guide.

      9. Click the Open Stack button to start using the Trados application.

  3. Use the Trados App within your Stack

    To use the Trados app in your stack, you can use Full Page Location and Stack Dashboard.

    Use Trados as a Full Page App

    To use the Trados app, log in to your Contentstack account and follow the steps below:

    1. Navigate to stack, click Apps from the header, and select the Trados app.
      Click to enlarge
    2. Click + New Project to create a project for translation.
      Click to enlarge
    3. In the Create Project modal, provide the following details:
      1. Enter the Project Name and Description.
      2. Choose the Project Option from the dropdown.

        Additional Resource: Project Option lets you select a pre-configured Trados template, which automates the process of translating content quickly and accurately.

        You can configure the templates in the Resources section of your Trados account. You must enable the JSON file type in the Trados template configurations. Go to your Trados account > Resources section, click File Type Configurations, select your configuration, and then enable the JSON file type and save.

        Click to enlarge

        Note When you select a template from the Project Option dropdown, if the template contains additional fields, they are automatically added to the modal before creating the project.

      3. Select the Releases you want to send for translation.
      4. Provide the new release name in the Create Release textbox. This release will include all the translated entries.
      5. Choose the Source Language and Target Language from the respective dropdowns.

        Note You can also add multiple target languages for translation.

      6. After adding all the details, click the Create Project button.
        Click to enlarge

        Note

        • The Trados app does not support assets in Contentstack Releases. All assets must be removed from the release before adding it to the translation project.
        • Target languages are fetched from Trados Project Templates.
  4. After creating a project, you can see the project Name, translation Status, and the Target Language in which the release content is translated.
    Click to enlarge

    You can see different statuses such as Preparing, In Progress, Pending, etc. on the Trados app as the status of the translation project keeps changing with the translation process.

    Click to enlarge

    Also, you can quickly search projects using the project name or filter them by status and target language.

  5. After the translation is completed, the status changes to Translated. Hover over the project, and you see the Remove from Contentstack, Delete from Trados, and Project Details icons.
    Click to enlarge
    • Click the Remove from Contentstack icon to remove the project from Contentstack.
    • Click the Delete from Trados icon to delete the project from Trados and Contentstack.
    • Click the Project Details icon to get all the details of the translated project.
      Click to enlarge

    Note

    • Trados marks the project as complete on deleting the project.
    • Deleting a project does not delete the translated entries.
  6. After the In Progress state, the translation status changes to Execution. If the project is delayed during the translation, hover over the project, and click the Retry icon to start the translation again.
    Click to enlarge
  7. When the error occurs during the translation, the status changes to Error while Translating. Hover over the project, and you can see the Error, Copy Project, Retry, and Delete from Trados icons.
    Click to enlarge
    • Click the Error icon to view error details along with entry version logs.
    • Click the Copy Project icon to copy the failed translation and recreate the project.
    • Click the Retry icon to start the translation again.
    • Click the Delete from Trados icon to delete the project from Trados and Contentstack.

      Note Deleting a project does not delete the translated entries.

  8. To view the translated entries, navigate to Releases and select the translated release.
    Click to enlarge
  9. Click the entry to view the translated content.
    Click to enlarge

    Note To add the referenced assets in the translated release, you can enable the Reference Handling toggle button during app configuration in step 2.

Use Trados within your Stack Dashboard

Note This section will be deprecated soon. Use the Trados Full Page app to manage translation projects.

To use the Trados app, log in to your Contentstack account and follow the steps below:>

  1. Go to the stack to view the Trados app Dashboard Widget within your CMS.
    Click to enlarge
  2. Click + New Project to create a project for translation.
    Click to enlarge
  3. In the Create Project Modal, enter the Project Name, and Description, choose the Project Option, select the Releases to be translated, provide the new release name in the Create Release field, choose the target Language, and then click the Create Project button.

    Project Option lets you select a pre-configured Trados template, which automates the process of translating content quickly and accurately.

    NoteYou can configure the templates in the Resources section of your Trados account. You must enable the JSON file type in the Trados template configurations. Go to your Trados account > Resources section, click File Type Configurations, select your configuration, and then enable the JSON file type and save.

    Click to enlarge

    You can provide a release name in the Create Release field; this new release will contain all the translated entries.

    You can also add multiple languages for translation.

    Click to enlarge
    Note
    • The Trados app does not support Assets in Contentstack Releases. All the assets must be removed from the release before adding it to the translation project.
    • You can translate up to 500 entries (including the locale versions) at once.
  4. In the Trados Dashboard, you can see the project Name, translation Status, and the Target Language in which the release content is translated.
    Click to enlarge

    You can see different statuses on the Trados app Dashboard Widget as the status of the translation project keeps changing with the translation process.

    Click to enlarge
  5. After the translation is completed, the status changes to Translated. Hover over the project, and you see the Remove and Delete icons.
    Click to enlarge
    • Click the Remove icon to remove the project from Contentstack.
    • Click the Delete icon to delete the project from Trados and Contentstack.
      Note
      • Trados marks the project as complete on deleting the project.
      • Deleting a project does not delete the translated entries.
  6. After the In Progress state, the translation status changes to Execution. If the project is delayed during the translation, hover over the project, and click the Retry icon to start the translation again.
    Click to enlarge
  7. When the error occurs during the translation, the status changes to Error while Translating. Hover over the project, and you can see the Error, Retry, and Delete icons.
    Click to enlarge
    • Click the Error icon to see the error details.
    • Click the Retry icon to start the translation again.
    • Click the Delete icon to delete the project from Trados and Contentstack.

      NoteDeleting a project does not delete the translated entries.

  8. In the left navigation panel, navigate to the Releases and select the translated release.
    Click to enlarge
  9. Click the entry to view the translated content.
    Click to enlarge

Note

  • The Trados app does not support Select, Number, Date, File, URL, Link, Taxonomy, Boolean, and Custom fields for content translation.
  • Also, Trados does not support the non-localizeable fields.