Skip to main content
Skip table of contents

DITA Merge 4.0.0 - API Updates

Background

DITA Merge was first in released in April 2014 and originally only supported Concurrent Merge, with a few features. Since then, the product has evolved quite a bit. In the past few years, we have introduced features such as Table Processing, Sequential Merge, Rule Processed outputs, and more.

In the DITA Merge 4.0.0 release we have improved CALS and Simple table processing, and also added a few more configuration settings to control table processing. These table processing changes are breaking API changes.

API Changes

As we are releasing a major upgrade, we have decided to use this opportunity to update the DITA Merge API to improve consistency, and also make the API easier to understand and use. We have created a new package, com.deltaxml.mergecommon.config, which will include all the enums and configuration classes. This also allows us to use configuration classes in other products such as DITA Merge for similar features and at the same time maintain code easily. The following table summarises all the API changes in 4.0.0:

Original API Settings

New API Settings

Respective table processing settings for classes :

com.deltaxml.ditamerge.ConcurrentMerge, com.deltaxml.ditamerge.ThreeWayMerge, com.deltaxml.ditamerge.SequentialMerge

  • setCalsTableProcessing

  • setInvalidCalsTableBehaviour

  • setWarningReportMode

  • setCalsValidationLevel

  • setHtmlTableProcessing

com.deltaxml.mergecommon.config.CalsTableConfiguration

com.deltaxml.mergecommon.config.HtmlTableConfiguration

com.deltaxml.ditamerge.RuleConfiguration

com.deltaxml.mergecommon.config.RuleConfiguration

com.deltaxml.ditamerge.DoctypePreservationMode

com.deltaxml.mergecommon.config.DoctypePreservationMode

com.deltaxml.ditamerge.EntityReferencePreservationMode

com.deltaxml.mergecommon.config.EntityReferencePreservationMode

com.deltaxml.mergecommon.FormattingOutputType

com.deltaxml.mergecommon.config.FormattingOutputType

State

com.deltaxml.ditamerge.ConcurrentMerge.State

com.deltaxml.mergecommon.config.ConcurrentMergeState

com.deltaxml.ditamerge.ThreeWayMerge.State

com.deltaxml.ditamerge.SequentialMerge.State

com.deltaxml.mergecommon.config.SequentialMergeState

Result Type

com.deltaxml.ditamerge.ConcurrentMerge.MergeResultType

com.deltaxml.mergecommon.config.ConcurrentMergeResultType

com.deltaxml.ditamerge.ThreeWayMerge.ThreeWayMergeResultType

com.deltaxml.mergecommon.config.ThreeWayMergeResultType

com.deltaxml.ditamerge.SequentialMerge.MergeResultType

com.deltaxml.mergecommon.config.SequentialMergeResultType

Three Way Merge Specific

com.deltaxml.ditamerge.ThreeWayMerge.ThreeWayResultPreset

com.deltaxml.mergecommon.config.ThreeToTwoResultPreset

com.deltaxml.ditamerge.ThreeWayMerge.TrackChangesAttributeMode

com.deltaxml.mergecommon.config.TrackChangesAttributeMode

com.deltaxml.ditamerge.ThreeWayMerge.ExistingOxygenTCsProcessingMode

com.deltaxml.mergecommon.config.ExistingOxygenTCsProcessingMode


JavaScript errors detected

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

If this problem persists, please contact our support.