Documentation Center

New features and enhancements in Contenta S1000D 5.6

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

Support for multiple languages

Contenta S1000D common source databases (CSDBs) now support content in multiple languages, enabling you to store multiple, language-specific versions of S1000D modules. A new object type, LanguageCountry and several new AppData settings have been created to enable this functionality. In new Contenta S1000D databases, these AppData settings support multiple languages by default, which means that, for example, Upload will add language-country codes to names of S1000D modules in the CSDB, and DDN Export will add language-country codes to filenames of exported S1000D modules. This default may be changed if, for example, this database will always be a single-language database and you do not want this default behavior.

S1000D modules in a multi-language CSDB typically will be written in one language, called the source language, and then translated into as many other languages as needed. Contenta S1000D 5.6 supports one source language per CSDB and supports uploading codes (CSV files), defining codes (Define DMRL), and creating from template (via Manage DMRL) in the source language only.

In addition, the following Contenta S1000D tools have been enhanced for multi-language support.
  • Upload
  • Define and Manage tools
  • Contenta drop down tools in Arbortext Editor
  • Check-in
  • LiveContent Preview
  • DDN Export
  • Validate
  • PM Builder
  • Publish

Any CSV file to be uploaded must now contain Language and Country as its last two columns, even if these columns contain no values. For S1000D issues 4.0 and later, the CSV file must contain 20 columns; for pre-4.0 issues, the file must contain 18 columns. The sample files delivered to the Contenta_home/S1000D_samples/data directory have been modified to include the Language and Country columns. In a CSDB that supports multiple languages, if the Language and Country columns are empty, the source language and country codes will be inserted into the S1000D database tables.

In multi-language CSDBs, DM/PM/SCPM hierarchies will contain a new LanguageCountry level for non-source-language modules. Source-language DMs will continue to be located in Subsubsystem folders, but DMs in other languages will be one level lower, in the appropriate LanguageCountry folder, for example, FR-FR or PT-BR. Source-language PMs and SCPMs will continue to be located in PMNumber folders, but PMs/SCPMs in other languages will be one level lower, in the appropriate LanguageCountry folder.

In all CSDBs (whether they support multiple languages or not), the LiveContent Preview user interface now additionally displays the Language-Country Code in the Task metadata if language and country markup is included in the DM's address in the idstatus or identAndStatusSection. A new Language-Country Code line is displayed beneath the Data Module Code line in the LiveContent Preview UI. A sample Language-Country Code value is EN-US.

For further information about this enhancement, see the Contenta S1000D Database Upgrade Changes section later in this topic, and the Contenta S1000D User topics.

S1000D Issue Support

Contenta S1000D now includes schema support for S1000D Issue 4.2.
Support for Issue 4.2 modules is provided throughout the Contenta S1000D tool set, from Upload to Publish, notably the following.
  • Pass-through support for Issue 4.2 modules: Available in Upload, the Define and Manage tools, Arbortext edit (Checkout/Checkin), LiveContent Preview, DDN Export, Validate (References and BREX), PM Builder, and Publish.
  • Additionally, Contenta S1000D tools support the following Issue 4.2 functionality.
    • Tools support uploading, creating from template, editing, and validating all 4.2 DM types, including the new brDoc DM type.
    • PM Builder may be used to create or update Issue 4.2 PMs. PM Builder also preserves optional Issue 4.2 markup in the identAndStatusSection and detects optional Issue 4.2 unsupported markup in the content section.
    • Validate BREX, PM Builder, and DDN Export recognize the Issue 4.2 default BREX DM, DMC-S1000D-F-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.1 to Issue 4.2.
    • Validate References recognizes and skips any references to chapters in the Issue 4.2 specifications—that is, dmRefs to DMs found only in the Issue 4.2 specification (not in customer CSDBs) in the 4.2 sample brDoc DM, DMC-S1000DBIKE-AAA-D00-00-00-00AA-024A-D.
    • Insert Reusable Component recognizes Issue 4.2 information codes for Warning CIR DMs (0A4) and Caution CIR DMs (0A5), and continues to recognize infocode 012 for either Warning or Caution CIRs.

Publish S1000D content to XPP using CSS

By default, Contenta S1000D now publishes content to XPP using Cascading Style Sheets (CSS) instead of XPP proprietary styles to create PDF output. This enhancement allows greater flexibility in the tools you can use to control document formatting and uses technology more familiar to many users than XPP styling functionality. To enable publishing using CSS, modifications have been made to Contenta S1000D publish configuration files, including the addition of a new configuration setting, xppStyleType, which controls whether CSS or XPP proprietary styles are used to format output. An additional sample data set using CSS has been delivered with this release.

If you previously used XPP proprietary styles to publish content from Contenta S1000D to XPP, see Switching to CSS for publishing to XPP for PDF output for information about configuring Contenta S1000D to use CSS.

Publish S1000D content to XPP using Direct-to-PDF to create PDFs

To support publishing very large S1000D publications to XPP, changes have been made to XPP software, S1000D XPP style files (job tickets), the S1000D Publish tool, and S1000D publish configuration files.

  • Prerequisites:
    • XPP 9.2, or XPP 9.1 with the latest patches, is required when publishing from Contenta S1000D 5.6 to XPP.
    • Contenta S1000D customers who publish to XPP need a new license file that includes the XPP Direct-to-PDF feature.
  • The XPP library-level job tickets for S1000D Publish have been modified to increase the Max Number of Pages value. The updated job ticket files are available in the delivered s1000dstyles.zip and s1kdXppCssStyles.zip files and must be copied to the XPP server, into the Ls1000d and Ls1kd_css style libraries respectively.
  • The S1000D Publish tool now uses XPP's divpdf program instead of its psfmtdrv program to create PDFs as efficiently as possible. Therefore, the xppPsfmtdrv1 setting in the delivered publish configuration files has been replaced with a new xppDivpdf1 setting. Upgrading customers who publish to XPP must update their publish configuration files accordingly.

Documentation enhancement

As of this release, Contenta S1000D documentation is available on the SDL Documentation Center at https://docs.sdl.com/SDLCAS510. This enhancement gives you access to the latest, most up-to-date information about installing, upgrading, managing, using, and extending Contenta S1000D. The Documentation Center includes a downloadable .zip file ( Contenta S1000D full documentation download as HTML) containing the full product documentation in HTML format, which you can provide to users without internet access.

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.6. If you are upgrading from a release earlier than 5.2, contact SDL Professional Services at mailto:ProServRequest@sdl.com to discuss upgrade services for your implementation.

  • New language and country columns have been added to S1000D database tables as needed.
  • New object type LanguageCountry has been added with the following properties.
    • Object type name: LanguageCountry
    • Object type template: Document
    • Icon name: Group
    • Can be created by: Subsubsystem, UnitorAssembly, PMNumber, Project, ContentRoutingProject, Dispatch (in BASE_TOOLS, ProjMan, and SysAdmin tool boxes.
    • Can create: DModule, PModule, SCORMContentPackage, PubManager
  • The Contenta S1000D 5.6 database upgrade adds 21 Issue 4.2 templates to the CSDB under S1000D/Templates/4.2, including a template for the brdoc DM type added in S1000D Issue 4.2.
  • New AppData settings have been added.
    • New key brdoc added under {Global} > Document Types. The keys and values that exist under all document types to facilitate Checkout, Checkin, and Edit have been added under this key.
    • New key CaS_Languages added under {Global} > Settings.
    • New name/value pairs under {Global} > Settings > CaS_Languages.
      • supportMultipleLanguages (default value = no in an upgraded Contenta S1000D CSDB, and yes in a new CSDB)
      • sourceLanguageCountry Code (default value = SX-US, where SX is the language code for Simplified Technical English)
      • includeLanguageCountry CodeInSourceObjectNames (default value = no in upgraded Contenta S1000D CSDBs, and yes in new Contenta S1000D CSDBs)
  • The following AppData settings have been modified.
    • Under the key, {Global} > Settings > Display, the Language ISO Code and Country ISO Code properties have been added to listViewPropertyFields.
    • Under the key, {Global} > DB Schema, the ContentaS1000D value has been updated to CaS_5.6.
  • The Issues 3.0, 4.0, and 4.1 template PubManager objects in the Publication Management container in the CSDB have been updated for multi-language support. A new Issue 4.2 template PubManager object has been added, and multi-language templates for EN-US have been added for each issue.
Upgrade customers must first run the Contenta database upgrade program, upgrade_56, and then run the Contenta S1000D database upgrade program, upgrade_S1000D_56.pl, to upgrade their Contenta S1000D databases. New customers must dbimport the appropriate s1000d.dmp file, which is located at one of the following locations.
  • Contenta_home/S1000D_samples/databases/Contenta56_Oracle11g_database
  • Contenta_home/S1000D_samples/databases/Contenta56_Oracle12c_database