Skip to main content
Skip table of contents

Configuration Options

These configuration options and values may be used in the command line, in Java and in REST.  More details are available in Javadoc here and for RESThere.

Examples of using the REST API are available on Postman documentation.

ResultType

The ResultType specifies the type of post-processing applied to the merge result. The types available are:

ResultType Value

Description

Merge Type

concurrent

three-way (concurrent3)

sequential

DELTAV2

the raw result with no post-processing.

ANALYZED_DELTAV2

performs first-line analysis of the result and adds attributes to indicate types of change

RULE_PROCESSED_DELTAV2

applies default rules to auto-resolve the simple change types 'add' and 'delete'.


SIMPLIFIED_DELTAV2

a simplified form of the deltaV2 format

SIMPLIFIED_RULE_PROCESSED_DELTAV2

the simplified format with the simple change types 'add' and 'delete' auto-resolved.


TWO_WAY_RESULT

a three-way merge converted to a two-way result



RULE_PROCESSED_TWO_WAY_RESULT

a three-way merge converted to a two-way result, with rule processing applied



THREE_WAY_OXYGEN_TRACK_CHANGES

standard three-way merge except changes are displayed in Oxygen's track changes format



Specific Javadoc ResultType pages:

ConcurrentMergeResultType

ThreeWayMergeResultType

SequentialMergeResultType

DoctypePreservationMode

Controls how DOCTYPE declarations appear in the result. The available modes are:

REMOVE_ALWAYS

no doctypes appear in the result, irrespective of what's in the inputs.

PRESERVE_WHEN_UNCHANGED

if no changes then preserved, otherwise removed.

ERROR_WHEN_CHANGED

if changes signal error, otherwise preserved in result.

For Javadoc see here.

EntityReferencePreservationMode

Controls how general entity references appear in the result. The available modes are:

USE_REPLACEMENT_TEXT

Entity references are replaced with their 'replacement text' (which may actually include general XML such as text, attributes and elements).

PRESERVE_REFERENCES

Entity references remain in the body of the XML content. Declarations in the internal subset will also be preserved where possible. If multiple declarations with different values are used in the inputs then multiple declarations may appear in the result.

PRESERVE_REFERENCES_ENCODED_FORM

Entity references remain in the body of the XML content in encoded output format. Declarations in the internal subset will also be preserved where possible. If multiple declarations with different values are used in the inputs then multiple declarations may appear in the result.

For Javadoc, see here.

WordByWord

Controls the granularity of text/PCDATA comparison, alignment and change reporting:

true

Text is segmented into words (as described in Unicode Annex 29, Section 4), compared and results are then reported as this granularity.

false

Text is compared and changes reported corresponding to the text/PCDATA structure found in the comparison inputs.

For Javadoc see here for Concurrent and here for Sequential. Three-way merge is here.

ElementSplitting

Sets whether elements containing significantly modified text should be split.

true

Enable element splitting when WordByWord is true and the amount of unchanged text in an element falls below 10%.

false

Disable element splitting.

The Javadoc entry for Concurrent Merge is here and for Sequential Merge is here. Three-way merge is here.

Debug

Controls the generation of intermediate pipeline debug files. This parameter is not available for REST API-based command-line interface.

true

Intermediate pipeline debug files are generated.

false

Intermediate pipeline debug files are not generated.

The Javadoc entry for Concurrent Merge is here and for Sequential Merge is here. Three-way merge is here.

Table Configuration

CALS and HTML (DITA Simple Tables) have their own separate configuration objects, CalsTableConfiguration and HtmlTableConfiguration respectively. These objects share most of the same properties:

ProcessTables

Controls whether to enable processing for that type of tables.

true

Enables the table processing.

false

Disables the table processing.

Javadoc for the CALS parameter and HTML parameter.

InvalidTableBehaviour

This parameter declares what type of processing should be used for invalid tables.

PROPAGATE_UP

Propagate the changes to the  <tgroup>  level of the table.

COMPARE_AS_XML

Compare tables as 'plain' XML.

FAIL

Throw an Exception when invalid CALS tables are encountered.

Javadoc for the CALS parameter and HTML parameter.

ValidationLevel

Controls the validation level to use for table validation.

RELAXED

Performs relaxed validation. Invalidities which are known to have no effect on subsequent processing will not cause that processing to be bypassed.

STRICT

Performs strict validation. All invalidities will cause the appropriate subsequent processing to be bypassed.

Javadoc for the CALS parameter and HTML parameter.

WarningReportMode

Specifies how table invalidity warnings should be reported.

PROCESSING_INSTRUCTIONS

Reports warning using processing instructions with the format  <?dxml_warn warning content ?> .

COMMENTS

Reports warnings using XML comments.

MESSAGE

Reports warnings using <xsl:message/>.

Javadoc for the CALS parameter and HTML parameter.

NormalizeTable

HTML Tables Only

Controls whether to normalize the specification of columns in HTML tables.

true

Enables the table normalization.

false

Disables the table normalization.

Javadoc for the HTML parameter.

Additional Three Way Merge Parameters

ThreeToTwoResultPreset

Presets the corresponding RuleConfiguration and ResultType settings. The types available are:

ALL_CHANGES

shows as many changes as possible.

CONFLICTING_CHANGES

shows conflicts for further resolution. Simple, non-conflicting adds, deletes and modifications are automatically resolved.

THEIR_CHANGES

shows conflicts for further resolution. Additionally changes in the third input are displayed. Simple, non-conflicting changes in the second input are automatically resolved. This is designed for merge scenarios where the third input corresponds to the 'remote' or other users (their) branch.

The Javadoc is here.

TwoWayResultFormat

Specifies the result format when using three-to-two merge. The formats available are:

XML_DELTA

produces a deltaV2 result.

OXYGEN_TRACK_CHANGES

produces a result format which is an XML file with processing instructions used in the accept/reject interface of the oXygen XML editor/author

DITA_MARKUP

produces a DITA document, using rev and status attributes to mark changes

The Javadoc is here.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.