Oxygen XML Developer Professional V24.1

JSON Schema Design Mode

• Added JSON Schema Design mode drag-and-drop support - You can now design your JSON Schema in the Design mode by using drag-and-drop support. You can move or reorder components just by dragging and dropping into the correct location. Oxygen will display a connector to help you visualize the drop location and will highlight the connector with red when the component is not allowed in that particular location.
• New Palette View makes schema building easy in JSON Schema Design mode - The newly implemented Palette view is designed to offer quick access to JSON Schema components and to improve the usability of the JSON Schema diagram builder. The Palette can be used to easily drag and drop various components into the JSON Schema diagram built in the Design mode.
• New actions to mark properties as required or optional - New contextual menu actions have been added in the JSON schema Design mode to make it easy to mark a property as being either required or optional in the parent object. By default, the defined properties are not required in the JSON schema. However, you can set a list of required properties in the required keyword value.
• Convert between Object schema and Boolean schema - New contextual menu actions are available in the JSON schema Design mode that give you the ability to convert the object schema for a property or definition into a boolean schema with the value of true or false, and vice versa.
• Extract Definition - A new Extract Definition action has been added within the Refactoring sub-menu in the contextual menu of JSON schema Design mode. The action allows you to extract a definition into the global definitions and reference it. It can be used to extract the definition of a property as a global definition, or extract a local definition globally.
• Go to Definition - A new Go to Definition contextual menu action has been added in the JSON schema Design mode that enables you to quickly navigate to the referenced schema component.
• Content completion is now supported for in-place editing - The content completion assistant is now available for in-place editing within the JSON schema Design mode. For example, when editing properties, you can use Ctrl+Space to invoke the content completion window and the proposals are offered based on the defined JSON schema, according to the version used.

JSON Tools

• Mark properties to be required in JSON Schema Generator Tool - When using the JSON Schema Generator tool, the 'Make all properties required' option is now available to specify that all properties be required in the generated schema.
• Control the conversion of empty elements in the XML to JSON Converter - A new option (Covert empty elements to structures of type) has been added in the XML to JSON converter dialog box that allows you to choose the data type that empty elements will be converted to during the conversion. The possible values are object, string, or array.
• Diagrams generated for references schemas in JSON Schema documentation - If you choose to display diagrams in the generated documentation when using the JSON Schema Documentation tool, diagrams are now also shown for components from files that are referenced in the schema document.
• Added Hyperlinks for diagrams in JSON Schema documentation - When using the JSON Schema Documentation tool, you can now choose to include hyperlinks for the diagrams displayed in the generated documentation. Each hyperlink will navigate to the particular component.

OpenAPI

• OpenAPI Tester tool - A new OpenAPI Tester tool is now available to help you to easily inspect OpenAPI request responses and to ensure they work as expected. It can be used for OpenAPI 3.0 in JSON or YAML format. The tool is available in the Tools->JSON Tools menu. It requires an add-on to be installed but you have the option to automatically install it the first time you select the tool.
• OpenAPI Documentation generator - A new OpenAPI Documentation generator tool is now available to help you to easily generate full documentation for OpenAPI components in HTML format, including comprehensive annotations and cross references. The documentation is presented in a visual diagram style with various sections, hyperlinks, and filtering options. The tool is available in the Tools->Generate Documentation menu. It requires an add-on to be installed but you have the option to automatically install it the first time you select the tool.

XSLT/XQuery

• XSLT transformation and debugging - The Saxon built-in XSLT processor used for XSLT transformations and debugging has been updated to version 10.6.
• XQuery transformation and debugging - Updated the Saxon XQuery processor used for XQuery transformations and debugging to version 10.6.
• Added a new option in the Compile XSLT for Saxon Tool - A new option has been added in the Compile XSLT Stylesheet for Saxon dialog box that allows you to set the default namespace for unprefixed element names. It can be used to control the -ns (uri|##any|##html5) Saxon parameter that defines the handling of unprefixed element names that appear as name tests in path expressions and match patterns in the stylesheet.
• Saxon XSLT and XQuery transformer add-on for Saxon version 11.2 - A new Saxon transformer add-on is now available that adds support for the Saxon transformer version 11.2. This allows you to validate and transform XSLT and XQuery documents with the Saxon 11.2 engine.
• Updated Saxon 10 XSLT and XQuery transformer add-on to version 10.7 - The Saxon 10 transformer add-on has been updated to version 10.7. This allows you to validate and transform XSLT and XQuery documents with the Saxon 10.7 engine.

Markdown

• Added support for underlining content - The Markdown editor now supports the ++abc++ syntax that is used for underlining content.

Security

• Removed Apache Log4j dependency - Removed the dependency on Apache Log4j to help prevent security vulnerabilities. The SLF4j API and Logback libraries are now used instead.

Add-ons

• Add-on documentation structure has been improved - All of the add-ons from the official Oxygen repository are now divided into categories in the user guide (Add-ons Chapter) to make it easier to find the types of add-ons that you want to read about.
• Quick Install button has been added - There is a new easier installation method for all of the add-ons. The user guide topics now have a new Install button in a Quick Installation section that can simply be dragged and dropped into the main editor in Oxygen to initiate the installation process.
• Git Client improvements - Various improvements have been made to the Git Client add-on:
  • The History view now includes a new revision graph that helps you to understand how commits connect with one another.
  • The Stash dialog box now has a column that shows the creation time for each stash.
  • A new Checkout action has been added to the contextual menu of the History view. It checks out a branch at a specific commit (either in detached head form or by creating a new branch at that commit).
  • The Git Staging view toolbar has been simplified to only display the most common actions, while all actions are easily accessible in a new ellipsis (three vertical dots) menu. This menu also includes some new actions. For example, you now have the ability to manage remote repositories (add, edit or delete), track a remote branch for the current branch, or to edit the repository's configuration file. Most of the actions are also available in a new Git menu that was added in the main menu bar.
  • Performance has been improved by optimizing the process of checking the status of the repository.
  • Integrated various bug fixes, component updates, and performance enhancements.
• Git Client improvements - Various improvements have been made to the Batch Documents Converter add-on:
  • You can now convert HTML documents exported from Atlassian Confluence into DITA.
  • You can now convert one or multiple DocBook documents into DITA and an option called Create DITA maps from DocBook documents containing multiple sections can be used to convert all sections into individual DITA topics and referenced in a new DITA map.
  • A new preferences page has been added to provide options for configuring the mappings between elements for certain types of conversions. For example, you can use the Microsoft Word styles mapping option to customize the mapping between Word elements and styles to the corresponding HTML elements when converting from Word to XHTML, DITA, or DocBook.
  • Improved handling of tables that contain cell spans when converting Markdown documents to DITA.
  • Various small bug fixes and conversion improvements.
• OpenAPI Tester add-on improvements - The OpenAPI Tester add-on has been updated to version 1.1 and its improvements include:
  • You can now use the testing tool for OpenAPI documents represented in YAML format, as well as in JSON format.
  • Added basic support for the OpenAPI 3.1.0 Specification (except for webhooks).
  • The layout of the view has been improved.
  • Various bug fixes and improvements.
• DITA Prolog Updater add-on improvements - Various improvements were made to the DITA Prolog Updater add-on:
  • A new option has been added for controlling where to store the options from the Add-on preferences page (either in global options or in project-level options).
  • Fixed an issue where the prolog element was inserted in documents that do not allow it.
• The XSpec Helper View add-on has been updated to include XSpec version 2.2.4.

Other

• Added a new setting to control initial view mode for tracked changes in the Author visual editing mode - A new Initial display mode setting has been added in the Preferences->Editor / Edit Modes / Author / Review preferences page to control the initial display mode for tracked changes in the Author visual editing mode.
• Added a new option to return the results of a search as a PDF -  A new Include the contents of these binary files option has been added in the Preferences->Open/Find Resource preferences page and it returns the results of a search in the Open/Find Resource dialog box/view as a PDF, if the PDF contains the searched text.

Component Updates

• Updated the DITA Open Toolkit version that is bundled with Oxygen to version 3.7.0.
• Oxygen has been fully tested on Apple macOS 12 (Monterey) which is now officially supported.
• Some of the installation kits bundle OpenJDK as the Java Runtime Environment and this has been updated to version 17.0.2.
• Updated the third-party Jackson libraries to version 2.12.6 to fix a security vulnerability.
• Updated the Xerces library to version 2.12.2.
• Updated the built-in XSpec framework to version 2.2.4.
• Oxygen has been tested and now officially supports eXist-db version 6.0.1.
• Updated the Calabash engine to version 1.3.2-100. The bundled Calabash XProc engine is now integrated with the Saxon 10 library.
• Updated the Eclipse plugin to support version 4.2.

Scripting

• The all platforms distribution of Oxygen is bundled with a scripts sub-folder that contains scripts for automating and running various utilities from a command line interface. To run any of these scripts, you need to purchase a scripting license.
  • Use custom settings file for batch converter script - When using the Batch Converter script, you can now use a new argument (-cs converterSettingsFile) to specify a file that contains settings for the conversion. It can be an .xpr file that contains project options or an XML file that contains global options.
  • Batch Converter script now has an option for DocBook to DITA conversions - You can now convert HTML documents exported from DocBook into DITA using the Batch Converter script.
  • Batch Converter script now has an option for Confluence to DITA conversions - You can now convert HTML documents exported from Atlassian Confluence into DITA using the Batch Converter script.
  • Batch Converter Script - Other Improvements - Other improvements made to the Batch Converter script include:
    • Improved handling of tables that contain cell spans when converting Markdown documents to DITA.
    • Various small bug fixes and conversion improvements.