Translate

Translates the text content of document into another language, generating a PDF output document in the target language.

Inherits from: Unattended Activity

Properties

The following 10 properties are defined.

Property Name Description
General
API Key Type: String

Specifies the API Key for the Microsoft Azure Translator Text API. Note that the correct API Region provided with API Key is required to validate the key. Need to try this feature out? At the time of this writing, Microsoft provides 2,000,000 characters of translation at no charge when a new account is created. New Azure accounts can be created here.

Target Language Type: Culture Data

Indicates the language documents should be translated to.

Source Languages Type: List of Culture Data

Specifies an optional filter designating specific languages which should be translated. If any languages are specified, then only documents with a language in this list will be translated. If this list is empty, all documents which are not in the Target Language will be translated.

Detect Language Type: Boolean, Default: True

Enables or disables automated language detection. If set to true, the language of each document will be automatically detected. If set to false, the language code currently assigned to the document will assumed correct.

Output
Disposition Type: TranslateDisposition, Default: Replace

Specifies what will be done with the output document. Can be one of the following values:

  • Replace - Replace the original document with the translation.
  • AddChild - Save the translation as a new child document.

Content Type: ContentLayout, Default: TranslationOnly

Specifies what content should be included in the output document. Can be one of the following values:

  • TranslationOnly - The output document will only contain the translation.
  • TranslationPlusOriginal - The output document will contain all translated pages, followed by all original pages.
  • OriginalPlusTranslation - The output document will contain all original pages, followed by all translated pages.

Page Layout Type: PDF Page Generator, Default: Arial 10pt

Defines page layout settings for the translated output document.

Processing Options
Error Disposition Type: IssueDisposition, Default: Flag, Log

Determines what happens when an error occurs processing an activity.

Maximum Consecutive Errors Type: Int32, Default: 0

The maximum number of consecutive errors, after which a critical stop will be raised. A critical stop will cause services to stop running.

Concurrency Mode Type: ConcurrencyMode, Default: Multiple

Specifies the parallel processing mode for this activity. Can be one of the following values:

  • Multiple - Multiple instances can run concurrently.
  • PerMachine - Only a single instance can run per machine.
  • Single - Only a single instance can run per Grooper repository.
This value determines the type of Thread Pool on which the activity can be executed.

See Also

Culture Data, PDF Page Generator

Used By

Batch Folder - Apply Activity, Batch Process Step