Documentation Center

New features and enhancements in Contenta S1000D 5.9

This section lists features and enhancements that were introduced in Contenta S1000D 5.9.

New S1000D XML editor

This release introduces a new S1000D XML editor for all supported S1000D issues leveraging Syncro Soft Oxygen XML Author (version 22.1 or later). A delivered editor extension provides integration between Contenta S1000D and the editor, and the following tools for Oxygen have been added to the Contenta Explorer and Contenta Web user interfaces.
  • Oxygen (round-trip edit)
  • Check Out/Check In
  • Insert Reference
  • Validate
  • Rebuild Table of References
  • Manage Internal References
  • Manage Hotspots
  • Assign Applicability
  • Preview
During installation or upgrade, if Oxygen XML Author is present, the Contenta S1000D styles and schemas for the supported S1000D Issues are delivered to an Oxygen_home directory.
For more information about these enhancements, refer to the following topics in the Contenta S1000D documentation.

CIR support enhancements

This release includes the following enhancements to Contenta S1000D support for CIRs.

Support for additional types of CIRs
The Contenta S1000D Publish tool now resolves references to items in most types of CIRs during publish. (Previously, the tool resolved only applicability, warning, and caution references.)
Enhancements in this release to Publish tool CIR support include the following.
  • Support for implicit CIR references was added. (Only explicit CIR references were supported previously.)
  • A new Resolve CIR References check box in the tool interface enables publishing with or without resolving CIR references.
By default, the S1000D Publish tool resolves each type of CIR reference in a particular context, such as the Preliminary Requirements section of Procedural, Process, Fault, or Checklist DMs.
Enhanced support for CIR warnings and cautions
In this release, Contenta S1000D improves support for reusing warning and caution elements stored in S1000D Issue 4.1 and later CIR DMs. The Insert Reusable Component editor plug-in now allows a user to specify a search string (consisting of plain text or an XSLT 3.x regular expression) by which to filter search results, making it easier to find warnings and cautions in CIR DMs for reuse. A new configuration file allows you to customize search criteria by CIR type. For each CIR type, you can specify the following search criteria.
  • Spec Issue
  • Tag name under which search can be performed
  • Maximum number of hits to be returned
Additional CIR enhancements
The following enhancements to CIR support were also made.
  • Contenta S1000D now uses the Saxon PE parser, enabling use of XSLT 3.x regular expressions in search strings.
  • The Insert Reusable Component user interface has been modified to improve performance and useability.

For more information about these enhancements, refer to Inserting items from a CIR or a CSDB reusable component directory in the Contenta S1000D documentation.

S1000D Upload Content enhancements

The following enhancements were made to the S1000D Upload Content tool.
  • S1000D schema validation

    You can now opt to have the S1000D Upload Content tool parse each XML file specified for upload to validate it against the applicable S1000D schema. You can elect whether content consisting of well-formed XML that fails the schema validation is uploaded.

    By default, the Upload Content tool uses the path set in an XML's noNamespaceSchemaLocation attribute to find the S1000D schemas against which it validates content. If the path in that attribute does not exist or cannot be accessed, you can use the new XYV_SCHEMA_CATALOG registry setting (under the XyEnterprise\Content@\Web\Settings\Upload key) to specify an alternate schema location to be used.

  • Performing multiple uploads

    When an upload completes, the Cancel button in the Upload Content UI is replaced with a New Upload button, allowing you to perform another upload to the same configuration or project without closing and reopening the Upload Content window.

  • Parallel processing of duplicate files

    When multiple files with identical file names but different extensions are uploaded, the Upload Content tool uses parallel processing. The first such file is uploaded and each of the others is skipped while the system displays the following message.

    This object is already being uploaded as a different type

  • User interface improvements
    • Improved filtering of prior upload information

      Clicking Prior Uploads in the Upload Content window now displays information only about prior uploads to the current database by the current user.

    • Improved warning and error messages

      While an upload is in progress, if there are no successful imports and errors are detected, the progress bar displays in red. In addition, if there are errors, the error count is displayed in red.

    • Improved logging

      Duplicate entries are now deleted from Upload Content log files after each upload.

S1000D Upload Codes enhancements

The S1000D Upload Codes tool user interface has been enhanced to improve usability and provide better progress feedback. Unneeded fields and links have been removed, and a new progress bar shows upload progress in terms of the number of codes imported.

For more information about these enhancements, refer to Using the S1000D Upload Codes tool in the Contenta S1000D documentation.

Support for DMRL (XML or SGML) files

The S1000D Upload Codes tool has been enhanced to allow the import of DMC and ICN codes in a DMRL (XML) file. Information from the DMC codes is parsed based on S1000D Issue and stored in Contenta S1000D data tables. The Manage Programs tool now allows the export of codes into a DMRL file. Previously, codes could be imported and exported only in comma-separated-value (CSV) format. When exporting a DMRL file, you can enter or modify information for its identAndStatusSection section (or dmlc/issno/issdate/security/datarest sections in pre-Issue 4.0).

Note the following about Contenta S1000D 5.9 support for DMRLs.
  • Partial and Complete DMRLs are supported; CSDB Status Lists (CSLs) are not.
  • ICN codes are available only in S1000D Issue 4.1 or later DMRL files.
  • For Issues 1.8 and 1.9 only, SGML DMRLs can be used for import/export of codes.
For more information about these enhancements, refer to the following topics in the Contenta S1000D documentation.

Contenta S1000D publish to XPP using XPP RESTful Web Services

The delivered Contenta S1000D-to-XPP publish script now uses XPP RESTful Web Services version 1.0 to publish content from Contenta S1000D to XPP. The RESTful XPP Web Services API uses newer technology than the legacy, SOAP-based XPP Web Services API used by previous versions of Contenta S1000D, and offers benefits including the following.
  • XPP RESTful Web Services is easier to install and does not require that Apache Tomcat and Java be installed on the XPP server.
  • Limitations on transferring large output PDF files from the XPP server to the Contenta Web server have been eliminated.
The following are prerequisites for using XPP RESTful Web Services for Contenta S1000D-to-XPP publish.
  • XPP 9.3 or later
  • XPP RESTful Web Services 1.0 installed on the XPP server
Upgrading customers are encouraged to migrate to XPP RESTful Web Services to take advantage of its benefits. If you have a customized S1000D Publish tool, contact SDL Professional Services for assistance.
To configure your environment to publish using XPP RESTful Web Services:
  • New Contenta S1000D and XPP customers: Refer to the following topic in the Contenta S1000D documentation: Configuring a new SDL XPP installation to publish PDFs
  • Upgrading Contenta S1000D and XPP customers:
    1. Merge the updated Contenta S1000D publish configuration file with your existing publish configuration files, as the xppPort property has changed for XPP RESTful Web Services.
    2. Extract the appropriate s1000dXppXz.zip file as described in the Adding new XPP publish resources from a zip file topic, as the location of the modifytoc.pl file has changed for XPP RESTful Web Services.

Refer to the SDL XPP RESTful Web Services documentation for more information.

S1000D Issue Support

Support for S1000D Issue 5.0 is provided throughout the Contenta S1000D tool set, from Upload to Publish, notably the following.
  • Pass-through support for Issue 5.0 modules: Available in Upload Content, the Define and Manage tools, Import/Export DMRLs, Arbortext and Oxygen edit (Checkout/Checkin), LiveContent Preview, DDN Export, Validate (References and BREX), PM Builder, and Publish.
  • Additionally, Contenta S1000D tools support the following Issue 5.0 functionality.
    • Tools support uploading, creating from template, editing, and validating all 5.0 DM types.
    • PM Builder may be used to create or update Issue 5.0 PMs. PM Builder also preserves optional Issue 5.0 markup in the identAndStatusSection and detects optional Issue 5.0 unsupported markup in the content section.
    • Validate BREX, PM Builder, and DDN Export recognize the Issue 5.0 default BREX DM, DMC-S1000D-G-04-10-0301-00A-022A-D, and reference it when needed.
    • The default DDN version in the DDN Export UI has been changed from Issue 4.2 to Issue 5.0
    • Validate References recognizes and skips any references to chapters in the Issue 5.0 specifications—that is, dmRefs to DMs found only in the Issue 5.0 specification (not in customer CSDBs) in the 5.0 sample brDoc DM, DMC-S1000DBIKE-AAA-D00-00-00-00AA-024A-D.
    • Insert Reusable Component recognizes Issue 5.0 information codes for Warning CIR DMs (0A4) and Caution CIR DMs (0A5), and continues to recognize infocode 012 for either Warning or Caution CIRs.

Contenta S1000D database upgrade changes

This section lists the changes made to your existing Contenta S1000D databases when you upgrade them to Contenta S1000D 5.9. If you are upgrading a database from a release earlier than 5.6, contact SDL Professional Services at mailto:ProServRequest@sdl.com to discuss upgrade services for your implementation. The Contenta Core database upgrade should be performed before upgrading the Contenta S1000D database. For more information about performing the Contenta Core database upgrade, refer to the Contenta 5.9 Release Notes, available at https://docs.sdl.com.
  • Added 21 Issue 5.0 data module templates in the S1000D/Templates/5.0 container.
  • Added the following Issue 5.0 PubManager templates.
    • S1000D/Publication Management/PubMan-SAMPLEBIKE-XYENT-00050-01_002
    • S1000D/Publication Management/PubMan-SAMPLEBIKE-XYENT-00050-01_002_EN-US
  • Added an Information Name Variant property to DModule objects.
  • Added new database tables and modified existing tables in the schema to support importing and exporting DMRLs and new Issue 5.0 functionality.
  • Added Oxygen Editor tools to DModule, PModule, PubManager, and SCORMContentPackage object types, for ProjMan, SysAdmin, and writer roles. These tools include Oxygen (short-term/round-trip edit), Oxygen Check Out, and Oxygen Check In, for both Contenta Web and Contenta Explorer.
  • Added GetDoc/PutDoc adapter mappings for all of the Oxygen Editor tools to all S1000D document types in AppData.

For customers upgrading from Contenta S1000D version 5.6, there is no Contenta core database upgrade program; customers upgrading from previous versions must run the Contenta upgrade_56 database program before running the Contenta S1000D upgrade_S1000D_59.pl database program to upgrade their Contenta S1000D databases. Refer to the Contenta 5.8.1 Release Notes for the latest information about database support.