• 2025

    27.0
    Version 27.0 - November 27, 2024

What's New in Oxygen SDK 28.0

November 26, 2025

Oxygen XML SDK version 28.0 adds some new API methods.

API Additions

Find in Files

The new ProjectController.findInFiles API allows you to find precise matched content in the entire scope of your project using the full power of the Find/Replace in Files functionality. For example, it enables the use of regular expressions, case sensitivity, XPath filters, and more.

Refactor XML Documents

The new XMLRefactorUtilAccess API allows you to run predefined XML refactoring operations on multiple XML documents and then to obtain the modified content. It also allows you to run an XSLT stylesheet as a refactoring operation over multiple XML documents.

Customize Labels in Diff/Merge Tool

New constants have been added to the ro.sync.diff.merge.api.MergeFilesOptionsConstants interface. These constants can be used as keys in the DiffAndMergeTools#openMergeApplication(java.io.File, java.io.File, java.io.File, java.util.Map) "mergeOptions" map parameter. This allows you to customize various labels in the merge application's dialog box, such as:
  • The labels describing the merge states for the compared resources shown in the "description" column.
  • The descriptive labels for the left and right difference panels.
  • The labels used in the operation summary.

Customize Labels in Diff/Merge Tool's Preview Dialog Box

The ro.sync.exml.workspace.api.standalone.DiffAndMergeTools.openPreviewDialog(String, String, String, String, String, LinkedHashMap<URL, URL>) API method has been updated to include three additional parameters. These new parameters allow you to customize various labels in the diff tool. For example, you can now change the label for the action that opens the preview dialog, as well as the labels for the left and right sides of the comparison panes.

Get Associated Transformation Scenario URL

The new XMLUtilAccess.getAssociatedTransformationScenarioInputURL(URL) API method can be used to obtain the input URL of the transformation scenario associated to an XSLT or XQuery document.

Get Associated Validation Scenario URL

The new XMLUtilAccess.getAssociatedValidationScenarioInputURL(URL) API method helps you find the input URL linked to a specific schema in a validation scenario. When you provide a URL that points to a schema file (such as XSD, RNG, DTD, or Schematron), this method searches the validation scenario to identify the associated XML or JSON source file. It returns the first matching input URL it finds in the scenario.

Indent Specific Section in a Document

The new TextDocumentController.indentSection(int, int) API method can be used to indent a specified section in a document.

Allow Deletion of URL Resources

The new ro.sync.net.protocol.RemovableURLConnection API interface can be implemented by a CMS that uses the Oxygen SDK. This allows the deletion of URL resources through the ro.sync.exml.workspace.api.Workspace.delete(URL) API.

Scripting

HTML Comparison Reports Show How Comparison Was Done

The comparison report that is generated by the Generate HTML report for directory comparison tool, now includes a collapsible section with meta information about how the comparison was performed. This helps you review the options used in the process and makes it easier to understand the results.

Include Folders Filter Added in Compare Directories Script

The Include Folders filter has been added in the Compare Directories script to limit comparisons to only the folders that match your specified patterns. This gives you more control over which folders are included when comparing directory structures.