2024.1

A new milestone,
new possibilities!

Discover the technical updates to the Author and Manager modules for 2024.

Part 3 – ADAM Manager

In 2024, the Author and Manager platforms introduce significant technical updates aimed at enhancing productivity, flexibility, and the user experience for documentation management and development teams. In this article, we explore the main innovations brought by these new versions in Release 2024.1.

New Features in Manager

New Features in the Analysis Module

Reminder: the analysis module is an option for ADAM Manager.

One of the major advancements in Manager is the improvement of the documentation analysis module, which enables more complex and flexible queries.

Queries on All Document Types

The PM and IMF document types are now included in the search scope, providing broader documentation coverage.

Independent Searches from DM/PM

Users can extract business information by targeting specific sections of documents without being tied to traditional document types.

Typed Parameters and Result Sorting

Queries can be configured with typed parameters to ensure validity, and the interface allows users to adjust the display order and column sorting.

Managing Long Queries and Save Options

The module now offers the ability to handle long queries, with redesigned result displays, and allows saving conducted searches for future access.

Open API

To facilitate integration with third-party systems, the analysis module is now accessible in integrator mode.

Please note that integration and API access are subject to specific commercial terms.

New Features of the Logistics Module

Reminder: the ADAM Logistics module is an option of the ADAM Suite

The ADAM Logistics module of the ADAM Suite now includes advanced features to optimise workflow management and document imports according to the S1000D standard.

Managing Critical States: Approval, Rejected, ReadyForRelease

Validation states such as Approval (approved), Rejected (rejected), and ReadyForRelease (ready for publication) are strictly controlled.

Automation of Transitions: From Authoring to Released

The new version of the module allows automatic management of state transitions. For example, when a document’s status changes to Released, a new version (new issue) is automatically created.

Import Error Management

In the event of an import failure due to unauthorised statuses, ADAM Logistics provides clear and visual notifications, enabling users to quickly resolve approval and validation issues.

Comparison of Document Revisions

A new feature allows users to view the differences between two revisions of the same document or between two similar-type Document Managers (DM). This facilitates version management and quickly identifies changes.

Graphic Enhancements,
and IMF File Management

The management of graphic conversions has been optimised:

CGM to SVG Conversion

The configuration of CGM to SVG converters is prioritised, with a focus on Larson to ensure high-quality conversions.

Larson

Management of ICN Metadata Files (IMF)

Enhanced functionalities for IMF files have been introduced, including support for hotspots and RFUs, enabling more refined metadata management.

 

Improvements in Applicability Management

The applicability module benefits from several improvements aimed at simplifying the editing and control of applicability criteria.

Import of Applicability Templates

Users can now import templates from XML files (ACT, PCT, CCT).

Applicability Assertion Counter

The system now displays the total number of available assertions directly at the selection button level, thereby simplifying the management of complex applicability rules.

Alerts on Applicability Modifications

When changes are made to applicability assertions, an alert message now highlights the modifications made to the display text (displayText), thereby improving transparency and traceability of the changes.

Project and Workflow Management

The project and workflow management process has also been revised, providing greater flexibility to meet user needs.

Target Project Filtering

Projects can now be filtered based on access keys rather than user roles, offering better access personalisation.

UTF-8 Encoding Management

By default, encodings are now supported to facilitate content standardisation.

Business Behaviours

Import in the “Released” State:
Direct import into the “Released” state is now possible, particularly for the reintegration of subcontracted or legacy documents.

Eligibility Criteria:
Only documents with an issueNumber greater than 000 and inWork equal to 00 can be imported under this workflow. CIR and ICN are excluded.

1. Document Import

Configurable ICN Strategy: The tool allows configuring ICN strategies based on two approaches:

  • Standard: 3 digits for issueNumber and 2 digits for securityClassification.
  • Legacy: 2 digits for issueNumber and 1 digit for securityClassification.

New “issue”: When creating a new “issue,” it is possible to choose between retaining the source ICN strategy or adopting a new strategy.

2. Media Management

Workflows are now separated for each document type:

  • DM: default-dm (previously generic-du).
  • PM: default-pm.
  • Media: default-icn (previously generic-du).

The available states remain unchanged.

Note: The final status for media will be Released.

3. Document-Type-Specific Workflows

When the workflow is initiated, the following actions will be performed on the documents:

  1. Increment inWork.
  2. Change the issue type to “changed”.
  3. Set qualityAssurance to Unverified.
  4. Clear the reasonForUpdate and changeMark fields.
  5. Delete items marked as deleted.

4. Improvement of DMs/PMs Cleanup During Revision

When the workflow is initiated, the following actions will be performed on the documents:

  1. Set the issueNumber to 000 and inWork to 01.
  2. Set the issueDate to the current date.
  3. Change the issueType to “new”.
  4. Set qualityAssurance to Unverified.
  5. Add the DM source identifier (sourceDmIdent).
  6. Clear revision markers (changeMark, changeType, RFU).

5. Duplication of DMs/PMS During Revision

6. Granularity of ACT/BREX References

Ability to enrich information such as IdentExtension and Language from the DM state editing interface.

Metadata Enhancements and Other General Features

SNS Facilitator for DU Searches

The tool allows automatic input of SNS search criteria (SC, SSC, SSSC, AC) based on a source DM.

Other enhancements

Find Our Previous Post

Part 1 - Technical Core

Find Our Previous Post

Part 2 - ADAM Author

We wish you a pleasant discovery of this 2024.1 Release and hope it enhances your experience when using our ADAM Suite.

Kind regards,
The ADAM Team