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.

Prerequisites

Trados account
Contentstack account
Access to the Contentstack Organization/Stack as the Owner/Admin

Let's follow this step-by-step guide to install and configure the Trados app within your stack.

Steps for Execution

Retrieve Configuration Details from Trados
Install and Configure the Trados app in Contentstack Marketplace
Use Trados within your Stack

Retrieve Configuration Details from Trados

To get your configuration details for Trados, follow the steps given below:
1. Log in to the Trados account using your Trados account credentials.
2. In the top-right corner of the Dashboard, click the My Account icon and then click My Applications.
3. Now, click the Add New button to create a new application.
4. Enter the Application Name (mandatory), Description (optional), and Website URL (optional), and then click the Save changes button.
  You can now see the Edit a Connected Application screen.
5. Scroll down to get the Trados app Client-Id and Secret.Secret is generated after the Production Status is approved by the Trados authority.
  After getting the Client-Id and Secret, copy and paste the information to your clipboard.
  
  You can see your application in the Trados dashboard.
Install and Configure the Trados app in Contentstack Marketplace

To install the app in Contentstack, log in to your Contentstack account and follow the steps below:
1. From the left-hand side primary navigation, click the Marketplace icon.
2. Click Apps from the left panel.
3. Within the Marketplace, you can see all the available apps. Hover over the Trados app and click Install.
4. In the pop-up window, select the stack where you want to install the Trados app, accept the Terms of Service, and click the Authorize and Install button.
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.
  3. Contentstack Fields:
    1. Select the Roles which provide access to create and delete a project in the Contentstack Trados Dashboard Widget.
      By default, Admin can manipulate the app configuration settings and create and delete project(s) from the Dashboard.
    2. Click the Enable Additional Settings toggle button to define the scope of your fields for translation.
  4. Click the Next button.
  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:
      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.
      
      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.
      
      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.
    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.
    4. JSON RTE 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.
      
      Warning: Do not change the toggle button during Project Translation, as it may disrupt the Translation process.
      
      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.
  8. If the webhook is enabled for your app, you can view the webhook logs under the Webhook tab.
    Additional Resource: For 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.
Use Trados within your Stack

To use the Trados application in your stack, you can use the Dashboard Widget.
1. Log in to your Contentstack account.
2. Go to the stack dashboard to view the Trados app Dashboard Widget within your CMS.
3. Click + New Project to create a project for translation.
4. 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.
  
  Note: 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.
  
  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.
  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.
  - Target language(s) are fetched from Trados Project Templates.
  - You can translate up to 500 entries (including the locale versions) at once.
5. In the Trados Dashboard, you can see the project Name, translation Status, and the Target Language in which the release content is translated.
  You can see different statuses on the Trados app Dashboard Widget as the status of the translation project keeps changing with the translation process.
6. After the translation is completed, the status changes to Translated. Hover over the project, and you see the Remove and Delete icons.
  - 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.
7. 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.
8. 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 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.
    Note: Deleting a project does not delete the translated entries.
9. In the left navigation panel, navigate to the Releases and select the translated release.
10. Click the entry to view the translated content.
Note: The Trados app does not support Select, Date, Boolean, and Custom fields for content translation. You can add these fields in the Exclusions section in the configuration settings.