How can I configure Worldserver to export my project tasks automatically in the background and make the export packages available to the translator? I would like to avoid the manual export since it is time consuming, especially for bigger projects.
The Automatic Action/Step Generate Translation Kit can be added to a Workflow to perform an export in the background and attach the exported package to a project attribute which can then be downloaded by the translator or reviewer.
1- The first step is to create a Project Attribute. To create a Project Attribute, go to
Management > Administration > Customization
2- Next to Custom Component Type, select Attributes and click Add to create a new Project Attribute. The Add Custom Attributes Component window will open up and you need to select the correct configuration. This is an example of such attribute:
3- The next step is to create a dedicated folder in Explorer where the exported package will be stored. Open Explorer and add such folder in the location of your choice.
4- Once the Project Attribute is created, open the relevant Workflow(s) in the Workflow Editor and add the Generate Translation Kit to it. It is common sense to add such Step before the Translate step and - if needed - also before other human steps where translation/review in a CAT tool such as SDL Trados Studio 2019 (recommended) is needed. This is an example of a simple workflow where the Generate Translation Kit is added before the Translate and the Review step:
5- The Generate Translation Kit Automatic Action needs to be configured according to follow parameters:
Translation Kit format: select the desired export format. WSXZ, XLIFF and XLZ are available. Note that the XLZ format is no longer supported and we also do not recommend to use the XLIFF format, especially not in a live tm mode system. We recommend that the WSXZ format is selected.
Output directory: this is the directory where the dedicated folder has been created, see also Step #3. Important: you need to refer to the AIS properties of the mount under which the folder has been created and not to the Explorer directory alone. Check under
Management > Asset Interface System > AIS Mounts
and use the Directory path to point to the folder created in Step #3.
File Attachment Attribute Name: here you need to enter the INTERNAL attribute name. Make sure you do not enter the EXTERNAL attribute name because it will not work. If you are unsure what the internal attribute name is, double check the attribute settings (see Step #2).
Kit Exporter Type: select Tasks
Note: if you select Tasks, the next Workflow step MUST be a human step, otherwise you will run into an error as described in this article:
Worldserver - Error at 'Generate Translation Kit' Workflow Step 'Only human steps can be claimed! '
If you select Kit Exporter Type: Assets, the exported WSXZ package will be named after the project, for instance: project_Test Generate Translation Kit_1_1529_Dutch (Netherlands)_workbench.wsxz. However, once you open the package in SDL Trados Studio, it will display with a generic project name isuch as Adhoc_Project_xxxxxxx_xxxxxx"(where the first 8 digits stand for the date of the export and the last 6 digits are random). Here is an example:
The Return package will automatically be named to Adhoc Project_xxxxxxx_xxxxxx.sdlrpx.wsxz and while the import will still work, the fact that the project name is not displayed might be confusing to translators.
Another side effect of working with WSXZ packages exported with the option Assets instead of Tasks is that the import of Return packages is not recorded in the Task History, although the import had no error.
6- Now add the Generate Translation Kit to your Workflow and Save your changes.
We recommend that a Test project is run to test the Generate Translation Kit step and confirm that it is configured correctly.