2.5.2.9.1 Machine Translate SharePoint Documents

This use case describes how a client application interacts with SharePoint to translate documents stored in document libraries.

The following diagram illustrates the process of translating documents.

Process for translating documents in a document library

Figure 19: Process for translating documents in a document library

Preconditions

  • Translation Services has been set up.

  • A SharePoint site with source and target document libraries has been set up.

  • The source library contains files in a format supported by Translation Services.

Steps for a queued translation job

  1. The client application submits a translation job with several documents from the source library.

  2. The translation job is stored in the job queue.

  3. When Translation Services has capacity, the translation job is fetched from the queue and sent to the machine translation engine.

  4. The machine translation engine downloads documents from the source document library.

  5. The machine translation engine translates the documents.

  6. The machine translation engine stores the translated documents in the target document library.

Steps for an immediate translation job

  1. The client application submits an immediate translation job with a single document from the source library.

  2. The machine translation engine downloads the document from the source document library.

  3. The machine translation engine translates the document.

  4. The machine translation engine stores the translated document in the target document library.

Error

  • If the user that initiated the translation job does not have read access to the source document library or does not have write access to the target document library, the translation will fail.

Post-conditions

  • The target document library contains machine translated versions of documents from the source document library.