Setting up the FTPS automation connector

You must set up the FTPS automation connector so that the connector can retrieve the content from your FTPS, create a cloud localization project, and then transfer the localized content back to your FTPS.

Before you begin

Before you can set up the FTPS automation connector, you must perform a series of prerequisites in both Trados and your FTPS.

In Trados, do the following:

  1. Create a project template. Make sure the project template contains the target languages into which you want to localize your content.
  2. Request a service user from RWS consultants.
In your FTPS, do the following:
  1. Create a source folder. This is where your source files are extracted from. Within the source folder, create sub-folders for each target language you need (such as de-DE or fr-FR – Get familiar with language codes). Add your files to the correct target language sub-folder. For example, if you add a file called Test to both the de-DE and fr-FR sub-folders, the file will be translated into German and French. If you do not add a file under any specific target language sub-folder, then that file will be translated into all the languages available for the project template. Also, multiple projects will be created if you add multiple files. However, if you want these files to be added to a single project, include them in a *.ZIP archive. You need to provide the path to the source folder under Connectors > Connectors Configuration, in the Source Folder Path field.
  2. Create a processing folder. This is where your source files are moved after the project starts. You need to provide the path to this folder under Connectors > Connectors Configuration, in the Processing Folder Path field. This is used only for the Point to Point strategy.
  3. Create a target folder. This is where the localized files are uploaded. You need to provide the path to this folder under Connectors > Connectors Configuration, in the Success Folder Path field.
  4. Create a folder for exceptions. This is where your errors are transferred. You need to provide the path to this folder under Connectors > Connectors Configuration, in the Exception Folder Path field. This is used only for the Point to Point strategy.
  5. Store the content in your source folder in a *.ZIP archive or files and make sure the *.ZIP archive contains only the file types (file extensions) specified in the file type configuration of the cloud project template. If you do not add a file under any specific target language sub-folder, then that file will be translated into all the languages available for the project template. Also, multiple projects will be created if you add multiple files. However, if you want these files to be added to a single project, include them in a *.ZIP archive. You need to provide the path to the source folder under Connectors > Connectors Configuration, in the Source Folder Path field.

About this task

While Trados supports the creation of project templates and projects which have the same source and target language, we strongly recommend that you do not submit such projects via connectors. Your content tool or your CMS application may not support the retrieval of files which have the same source and target language.

Procedure

  1. Log in to Trados.
  2. In the menu at the top, select Resources.
  3. Select Connectors > Translation Configuration.
    This is where your perform the Trados setup.
  4. Select New Translation Configuration and provide the following information:
    1. In the Location list, select the appropriate location.
      Each location has its own connector types. Make sure that the connector type you want to select is available in the selected location.
    2. In the Connector Type list, select Automatic Connectors.
    3. In the Name box, enter a specific name for this configuration.
    4. In the Description box, enter additional information about the configuration.
    5. In the Service User box, select the service user created by the RWS team.
    6. In the Project Template ID list, select the appropriate project template ID.
    7. Select Add.
    If you select Connectors > Translation Configurations, you can see the configuration you just set up. If needed, you can edit or delete the configuration.
  5. Select Connectors > Connectors Configuration.
    This is where your perform the connector setup.
  6. Select New Connector Configuration and provide the following information:
    1. In the Location list, select the appropriate location.
      Each location has its own connector types. Make sure that the connector type you want to select is available in the selected location.
    2. In the Connector Type list, select FTPS.
    3. In the Name box, enter a specific name for your FTPS environment.
    4. In the Source Folder Path box, enter the location from which the automatic connector can extract the source files.
    5. In the Processing Folder Path box, enter the location where you want the source files to be moved after the translation project starts. This is used only for the Point to Point strategy.
    6. In the Success Folder Path box, enter the location where you want the translated files to be uploaded. The name can contain only the \ symbol (for example, Folder\Output).
    7. In the Exception Source Folder Path box, enter the folder location for errors. The name can contain only the \ symbol (for example, Folder\Exception). This is used only for the Point to Point strategy.
    8. In the Description box, enter additional information about the configuration.
    9. Expand the Connect section and enter values under Connect Username (the user name for your FTP environment), Connect Host Url (your FTPS URL, such as ftps://yourhost.com), and Connect Password (the password of your FTPS environment).
    10. Select Add.
    If you select Connectors > Connectors Configuration, you can see the configuration you just set up. If needed, you can edit or delete the configuration.A screenshot of the connector setup page.
  7. Select Connectors > Automation Configuration.
    This is where your perform the project setup.
  8. Select New Automation Configuration and provide the following information:
    1. In the Localization Name box, enter the name of the project that will be created automatically and which will be listed under Connectors > Automation Projects.
    2. In the Project naming pattern box, enter the name of the project that will be created automatically and which will be listed in the LC Projects view.
    3. In the Location list, select the appropriate location.
      Each location has its own connector types. Make sure that the connector type you want to select is available in the selected location.
    4. Select the Auto integrate translations checkbox if you want to have your files reintegrated automatically and if you want your project automatically marked as Completed once all the files are translated. This operation is triggered when the project is in a TCR-like status (an automated job is executed every minute, checking if there are any projects to be completed).
    5. Select the Scheduler checkbox if you want the system to automatically check whether there are new files or updated files in your FTPS, in the Source Folder Path. If you choose this option, specify a start date, an end date, and an interval for this automatic process. The interval refers to the frequency at which the check is performed. The minimum interval is 120 minutes.
    6. In the Connectors Configuration list, select the configuration you defined under Connectors > Connectors Configuration.
    7. In the Translation Configurations list, select the configuration you defined under Connectors > Translation Configuration.
    8. In the Project Strategy list, select the strategy that you want to use for your project. If you do not select a strategy, the Point to Point strategy is applied by default.
    • Select the Scan file name for target language checkbox if you want the automation to detect the target language directly from the file name (at any position). The detected language can also be associated with the language mapping feature. However, you can use this feature only if you use the Multilingual strategy.
    • Select the Delivery on target file generated checkbox if you want the automation to deliver the target files as soon as they are translated and not wait for the entire project to be translated. This option is available only for the Multilingual strategy.
  9. Select Save.

Results

If you select Connectors > Automation Configuration, you can see the configuration you just set up. Once the configuration is created and saved, you can edit it, delete it, or start it. When you start an automation configuration, you start the localization project itself. After the automation configuration is started (namely, after the project is started), you can reuse it if you change the Localization Name and Project naming pattern. After you do this, the Start button becomes Save & Start and you can start the configuration. You cannot reuse scheduled configurations, however. To edit an automation configuration, you need to stop it first.