close

Filter

loading table of contents...

Studio Developer Manual / Version 2406.1

Table Of Contents

9.26.9 Translation Workflow Specifics

This section covers translation-specific workflow customizations for both the server and the client side.

Studio server

The Studio server customizations are mainly related to workflow issue computation.

Calculation of Dependent Content

Dependent content are content items not explicitly chosen for translation, but which are required to keep in-site links consistent. This is the minimal set of dependent content to be added, but an extended set may be desirable.

The easiest example are two new contents A and B where A links to B. If A is transferred to a derived site via translation, a translation of B is required as well, to mirror the relationship from master to derived.

Extension of this set may be desirable for out of date content: Content A is created and links to existing and previously translated content B. As B already exists, it is not necessarily required to be added as dependent content. But the translation of B is out-of-date. Thus, it may be desirable, adding content B nevertheless.

The behavior can be controlled by choosing a strategy for dependent content calculation. This strategy can be chosen via a checkbox that is displayed over the dependent content section.

As the calculation of dependent content may take a considerable amount of time, limits can be configured within Spring application context as well as via settings within content. For details, take a look at Section “Workflow Validation Settings”.

If a limit will be reached, the nagbar will display a warning, which states that not all dependent content has been calculated. Per default the limit does not exist.

Note

Compatibility prior to 2007.1

Prior to 2007.1 the dependent content calculation was different. It also contained the content items, which are required to keep in-site links consistent, but it did not include outdated dependent contents. Instead, it included existing contents, which were added as new links to some contents to translate. These additional dependent contents were meant to provide some context to the translators.

If this behavior meets your requirements, you can still switch back to this behavior. To do so, simply adapt your DefaultStartTranslationWorkflowForm with hideDependentContentsStrategyChooser set to true.

Localization Issues

The Translation Workflow displays its issues in two possible categories. These are localization and content. You can create issues with these categories in order to let your issue show up either as translation or content specific. If you write a custom translation workflow validator, you may extend the class LocalizationWorkflowValidator which automatically creates issues with the category localization. Furthermore, all predefined workflow validators for translation, except the ContentStateValidator, produce only issues for the category localization.

Workflow Validation Settings

Validation of localization workflows (where localization is a superset of translation and synchronization) may be configured within Spring configuration properties. Corresponding properties are denoted in Section 3.4, “Studio Properties” in Deployment Manual.

Some of these settings may be overwritten via a settings document at /Settings/Options/Settings/WorkflowValidation as described in Section “Workflow Validation Settings”. For localization workflows such as translation and synchronization the following properties are supported:

  • localization.maxDepthToCompleteChangeSet (Integer)

    related Spring configuration: studio.translation.max-dependent-content-iterations

  • localization.limitForDependentContentItems (Integer)

    related Spring configuration: studio.translation.max-dependent-contents

If set to a non-empty value, these settings will override the corresponding Spring configuration properties. For details on these properties consult the corresponding description in Section 3.4, “Studio Properties” in Deployment Manual.

Studio client

The TranslationWorkflowPlugin has some additional configuration options compared to the WorkflowPlugin:

isSync

Whether the translation workflow is a synchronization workflow (defaults to false).

downloadXLIFFButtonVisible

Whether the default button to download the XLIFF document should be visible (defaults to false).

createWorkflowPerTargetSite

Whether a separate translation workflow should be created per target site on workflow start or whether one workflow for all target sites shall be created (defaults to false).

hideDependentContentsStrategyChooser

Whether the dependent content strategy chooser should be visible for the start workflow form (defaults to true).

allowSelfAssignedPullTranslation

Whether pull translation leads to automatic self-assignment of the first workflow task (defaults to true).

Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.