Rigi TMS Connector for Transifex
Rigi TMS Connector links a Rigi project to a Transifex project and enables a quick and convenient updating of the Transifex project with new or edited strings from Rigi.
This solution is especially useful for continuous projects.
We recommend using the Rigi CLI tool to update your Rigi project with new strings. For details, see the Rigi CLI tool section.
To link a Rigi project with a Transifex project using the Rigi TMS Connector, perform the following steps:
In Transifex, perform the following steps:
Create a new file-based project with the required source and target languages.
Important
Do not add any files for translation to a Transifex project!
The source language in a Transifex project does not have to match the source language in the linked Rigi project. When the TMS Connector imports the XLIFF file from Rigi into Transifex, the source language selected in the Transifex project is automatically assigned to the texts. When the file is reimported to Rigi, the original source language from the Rigi project will be reassigned to the source strings.
Generate and copy an API token.
On your Rigi server, perform the following steps:
Open the project you want to link to a Transifex project.
In the project menu on the right, select Settings > TMS Connection.
From the Configure Translation Management System dropdown menu, select Transifex. The Transifex Connection Settings section will be displayed.
In the API Key field, paste the API token you have created in Step 2.b.
Click the Connect to Transifex button. Additional sections will be displayed below.
In the Select Project section, select the Transifex project you want to link. The Language Mapping section will be displayed below.
In the Synchronization Settings section, specify whether you want to update the linked Transifex project automatically or manually.
In the Language Mapping section, review the mapping statuses:
Mapping statuses
The source language will get the Source status. This language pair cannot be edited.
If the TMS Connector has mapped a target language from the Rigi project to a Transifex language, it will have the Auto Mapped status.
If the TMS Connector could not map a target language, its status will be Not Mapped. You can assign the correct language from a Transifex project by selecting it from the Transifex Language dropdown.
Adding languages
The TMS Connector can only map languages selected in Rigi and Transifex projects. To add a new target language, you must add it to the linked projects in both Rigi and Transifex.
Click the Save button. The status of the correctly mapped languages will change to Pending. At this point, mapping statuses are saved in the TMS Connector, but no files have been sent to Transifex yet.
To send strings to the linked Transifex project, click the Send strings to Transifex button below.
After the connector uploads the Rigi XLIFF files to the Transifex project, the status of the languages that are properly mapped will change to Established.
The Desynchronized mapping status is displayed when the mapping has been deleted after files have already been sent to a Transifex project.
After the workflow for a specific language combination is completed in Transifex, the updated XLIFF file for this combination will be uploaded back to the Rigi project.
Unmapped languages in a Transifex project
If a Transifex project has more languages than the linked Rigi project, translations will be created for ALL languages listed in the Transifex project. However, only the mapped languages will be imported back to Rigi.
Delete the connection
To delete the established connection and all the related settings, click the Delete button in the Danger zone section at the bottom of the TMS Connection display. This action cannot be undone.
