Introduction

This documentation demonstrates how to use the Project Automation API, which provides programmatic access to the project automation functionality of Trados Studio. In addition to code snippets covering common use cases, a fully-documented command-line sample application demonstrates how to automate project creation and batch tasks.

What you can do with this SDK

The Project Automation API automates common project management tasks: file analysis, pre-translation, generation of finalized target documents, and more. You can build fully-fledged, customized workflow systems on top of it. Example applications include:

• Developing a Command-line application that traverses a folder / sub-folder structure to analyze or pre-translate the translatable documents contained therein.
• Develop an application that creates custom analysis reports for importing into an accounting system.
• Develop an application for fully automating the project creation process, e.g. create multiple projects according to a template with one mouse-click.
• Schedule automated project package creation and assigning manual tasks to a number of users. The application can then upload the packages to an FTP server or forward them via e-mail.
• An application that is timed to automatically loop through a folder into which translators/editors have delivered their return packages. The application then imports the return packages, thereby updating the corresponding projects, generates an updated project statistics report, which is then forwarded to the responsible project manager.
• An application that loops through a number of translated bilingual (SDLXliff) documents and that batch-updates the corresponding master translation memories on a regular basis.
• An application for testing whether a set of native documents can be converted to a translatable (SDLXliff) format prior to creating a project. The application loops through a folder structure, identifies any translatable documents and converts them SDLXliff. Upon failure, a report is generated that states the file and (if applicable) the reason why the conversion failed (e.g. a Microsoft Word document has the track changes functionality switched on)
• An application that loops through multiple projects and generates the finalized target files, which are then automatically forwarded to the end customer via e-mail or uploaded to an FTP share. In case of any failure to generate the target documents, an automated mail can be send to the project manager.

Note

In specific use-cases, you may need to use the Project Automation API in conjunction with the Translation Memory API. For instance, when extracting information like the number of translation units and the languages supported by the translation memory.
You can find a practical example of how to use the Translation Memory API to retrieve such details and then create a project based on the TM language direction.

Important

If you are building a standalone application that consumes Project Automation APIs that require a license, you must call LicenseManager.ReleaseLicense() before the application exits.

Otherwise, a license will be blocked on the user's machine for additional time after the application is closed. The duration of this extension varies depending on the license type:

• When using a network license, the license will be blocked for an additional 5 minutes.
• When using a subscription license, the license will be blocked for an additional 30 minutes.
• When using a standalone local license (license key) this limitation does not apply.

The LicenseManager class is located in the assembly Sdl.TranslationStudioAutomation.Licensing.