Blueprint Developer Manual / 5.6.2.4.6 AutoMergeTranslationAction

Advanced Search

Blueprint Developer Manual / Version 2010

Table Of Contents

5.6.2.4.6 AutoMergeTranslationAction

This action automatically updates properties of derived contents after changes in their master content since its last translation. See also the API documentation in AutoMergeTranslationAction and Content Type Model - Interaction of Attributes in Content Server Manual for the behavior of the automerge feature.

`performerVariable`
Required	yes
Description	The name of the variable that contains the user in whose name this action performed. Typically, the user has been retrieved previously by the action described in Section 5.6.2.4.5, “ExtractPerformerAction”.
`derivedContentsVariable`
Required	yes
Description	The name of the variable that contains all translated documents.
`masterContentObjectsVariable`
Required	yes
Description	The name of the variable that contains all master content objects.
`resultVariable`
Required	yes
Description	The name of the result variable to store derived contents in, whose properties could not be updated automatically.
`autoMergePredicateFactoryName`
Required	no
Description	The name of a custom Spring bean that implements interface AutoMergePredicateFactory and that is used to decide which content properties are updated automatically. If this attribute is not specified, properties are updated automatically if they are declared in the content type definition as follows: Properties declared with attribute `extensions:automerge="true"` are updated automatically. Properties without attribute `extensions:translatable="true"` are also updated automatically as long as they do not have the attribute `extensions:automerge="false"`.
`autoMergeStructListMapKeyFactoryName`
Required	no
Description	The name of a custom Spring bean that implements the interface AutoMergeStructListMapKeyFactory and that is used to select the merge algorithm for nested struct list properties. For some struct lists, like the placements of a page grid, a better merge algorithm can be used, which enables automatic updates of a derived content for more types of changes. To this end, the merge algorithm can use a selected property of the struct values to find corresponding values in master and derived contents. The default implementation DefaultAutoMergeStructListMapKeyFactory is configured in the Blueprint Spring application context for some standard properties like the page grid placements. If this attribute is not specified, the default implementation `DefaultAutoMergeStructListMapKeyFactory` is used, which can be configured in the Spring application context.

Table 5.36. Attributes of AutoMergeTranslationAction

<AggregationVariable name="derivedContents" type="Resource"/>
<AggregationVariable name="masterContentObjects" type="Resource"/>
<AggregationVariable name="autoMergeConflicts" type="Resource"/>
<Variable name="performer" type="User"/>

...

<UserTask name="Translate" successor="FollowUpAction">
  ...
  <EntryAction class="com.coremedia.translate.workflow.AutoMergeTranslationAction"
               derivedContentsVariable="derivedContents"
               masterContentObjectsVariable="masterContentObjects"
               resultVariable="autoMergeConflicts"
               performerVariable="performer"/>
  ...
</UserTask>

Example 5.45. Usage of AutoMergeTranslationAction

Search Results

Table Of Contents