2024.1 – A New Milestone, New Possibilities! (technical post)

2024.1

A new milestone,
new possibilities!

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

Part 1 – Technical Core, ergonomics, and IT

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.

Technical Core Update

The 2024 versions of Author and Manager are built on modernised technological foundations to improve performance, security, and ensure better compatibility with recent systems. Here are the key updates:

  • Upgrade to Java 17.
  • Update to Oxygen 26.
  • Update to JxBrowser.
  • Upgrade to Spring Boot 3.
  • Updates to Postgres 15, Solr 10, and adoption of Angular and Bootstrap 5.
  • BaseX 10.

Information Systems and Support

Faster Document Opening for more convenience.

New “Technical Support” Role: This role, dedicated to technical teams, allows managing Web Services (WS) migrations without accessing business domains via the HMI. It simplifies technical interventions while minimising risks.

Simplified and Trusted Installations

Ansible scripts have been introduced to automate and simplify the installation and updates of the ADAM Suite (Manager and Publisher). This allows technical teams to deploy new versions more quickly and maintain a stable environment.

During the installation of ADAM Author, the default path now offered is fully synchronised with the application version, making the update process smoother.

The installation of ADAM Author is now more secure, with a certificate issued by a Trusted Third Party (Qualified Trust Service Provider - QTSP) accompanying the executable file.

Find the Continuation of Our Post

Part 2 - ADAM Author

Find the Continuation of Our Post

Part 3 - ADAM Manager

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

2024.1 – A New Milestone, New Possibilities! (ADAM Author)

2024.1

A new milestone,
new possibilities!

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

Part 2 – ADAM Author

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 Author

In addition to the technical update, Author introduces new features designed to enhance the user experience and improve efficiency.

New editing features

Insertion at the Point of Use

Users can insert CIR, RAW DATA, DMRef, PMRef, ICN fragments (illustration, symbol, multimedia) at the exact cursor position in the document.

Highlighting Non-Breaking Spaces

Users can select a style sheet to clearly identify non-breaking spaces.

Support for Larson SVG Files

Support for Larson SVG files generated from CGM extraction, ensuring better compatibility with this graphic format.

Publication Filtering by Applicability

Users can now configure the publication of a Data Module (DM) directly within the interface, in the same way as in Manager. This feature includes the ability to filter publications by applicability.

Reduction of Applicability Expression Format

A simplified format for visualising applicability is now available to facilitate reading and management.

Managing Multiple Values for Applicability Conditions

When editing applicability expressions, it is now possible to select multiple conditions of the same type at the second level of the expression.

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 change traceability.

Applicability Assertions Counter

The system now displays the total number of available assertions directly on the selection button, making it easier to manage complex applicability rules.

Performance and Ergonomics Improvements

Display of Workflow Status

An additional column has been added to the DM and PM widgets to show the workflow status of documents. The colour codes used in Manager are now also applied in Author.

Warning About Loss of Undo Capability

When a user switches to XML view, a message is now displayed to alert them of the loss of undo history (UNDO).

Modification of the Button Allowing Project Switching from the Home Page

Image3 - BoutonChangeProj

Find Our Previous Post

Part 1 - Technical Core

Find the Continuation of Our Post

Part 3 - ADAM Manager

We wish you a pleasant discovery of this Release 2024.1 and hope it enhances your experience with the ADAM Suite.

Kind regards,
The ADAM Team

2024.1 – A New Milestone, New Possibilities! (ADAM Manager)

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

Adoption of CalVer Naming and New Schedule

Dear Customers and Partners,

We are thrilled to share with you significant changes in our development process, designed to improve the clarity, predictability, and efficiency of our products. These changes reflect our commitment to meeting the evolving needs of our clients and partners.

 

New Naming Strategy: CalVer

To align the naming of our products, we are adopting the CalVer (Calendar Versioning) strategy.

This approach allows us to name our versions more intuitively and in sync with time. For example, a version labeled “2024.1” might include Manager (6.0), Author (6.0), Publisher (3.0), Viewer (2.0), etc.

Besides simpler correspondence with our contracts and commitments, this will help you, our clients, and partners, to better understand and anticipate updates to our products.

 

Schedule with Fixed Dates

We are introducing a deployment schedule with fixed dates to make our release cycles more predictable. This will allow IT Departments to prepare more effectively for deployments and avoid delays due to last-minute adjustments.

 

Versioning Policy: Major, Minor, Maintenance

  • Major: A major update will be released once a year. This approach aims to minimize the efforts required by IT Departments by limiting infrastructure changes, while ensuring the security and updating of our applications.

  • Minor: Also once a year, these updates will be spaced six months apart from the major versions. They will offer an opportunity for specific client projects, based on a stable version, without incorporating major changes.

  • Maintenance (OCM): We will offer a monthly version during the first three months following a release, then a quarterly version. A 4D CONCEPT committee, combining technical and functional aspects, will determine the eligibility of features and bug fixes for each version.

We also offer our clients the opportunity to test the Release Candidates (RC) before the official launch, thus contributing to the early stabilization of versions.

 

Provisional Schedule

We are confident that these developments mark a turning point in how we develop and deploy our solutions, with an emphasis on transparency, reliability, and your satisfaction.

We look forward to your feedback and are ready to answer any questions you may have.

 

The ADAM Support Team

Optimization of Release Notes in the ADAM Suite: A Functionality-Centered Evolution

Dear users,

 

We are thrilled to announce a major evolution in the way we manage our Release Notes. This transformation is part of our commitment to enhance your experience and effectively meet your documentation needs.

 

1.  Centralization of information for a global view

Say goodbye to multiple Release Notes for each update and bugfixes. From now on, a major version benefits from a single Release Note which is updated with each minor version. Whether you consult version 5.6.0 or 5.6.2, you will be greeted by the same note. This centralization offers you an overview of the new features and the evolution of bug corrections.

 

 

2.  Total transparency on version support

Knowing the lifespan and support of a version is essential for planning your deployments. That’s why we have made this information accessible by displaying the support dates for each version.

 

 

3.  Intuitive navigation with Search and Filtering

Navigating through the Release Notes has never been simpler. Thanks to our advanced search and filtering system, quickly access relevant information, without having to browse through long pages.

 

 

4. Improved readability by distinguishing the Release Note and the Changelog

The distinction between a Release Note and a Changelog is crucial. The Release Note focuses on the new features, improvements, and corrections made to a specific version to inform and guide users. The Changelog, on the other hand, offers a detailed technical history of the changes made to the source code over time.

With this update, we have taken measures to clarify this distinction in the ADAM software suite:

  • Release Note focused on Functionality: We have redesigned our Release Notes to be focused on functional aspects. They highlight the new features, improvements, and bug corrections of each version. Their goal is to provide users with a clear and concise overview of the updates, without overwhelming them with technical details.

 

  • Changelog for Technical Details: The technical information, previously partially integrated into the Release Notes, has been moved to the Changelog. It offers a detailed tracking of technical changes. It is mainly aimed at developers, testers, and anyone wishing to have a deep understanding of technical changes.

 

5. The same approach for the entire ADAM Suite

This evolution of Release Notes management will be deployed across the entire ADAM software suite, ensuring uniformity and clarity in all our documentation.

 

 

In conclusion, this overhaul of the Release Notes reflects our desire to provide you with quality documentation, aligned with the current standards of software development.

You will find:

  • Release Notes:
    • on the support site, under the “documentation” section
  • Changelog:
    • In the deliverables, under the “installation guide” section
    • On the support site, under the “documentation” section

We look forward to receiving your feedback and suggestions.
Your feedback is essential for us, as it helps us to continue innovating and improving our software products.

 

Warm regards,

 

The ADAM team.

The ADAM SUITE is undergoing a technological evolution.

 

 

ADAM SUITE must follow the versions made available on its technical base to respond to security, performance, and obsolescence issues. This evolution of the technical components is expected to occur in the first half of 2024.

Our clients have their limitations and IT strategies, and our teams will work together to tackle them. Hence, our teams will be eager to provide guidance on the optimal deployment alternatives provided by these advancements. You can rely on us.

 

Updated components

 

What are these new features bringing?

Spring Boot will facilitate deployments and expedite the installation of new versions by utilizing these technologies and techniques. We will provide you with the following options:

  • Around Tomcat. We will provide two deployment solutions:
    1. “Standalone” with Spring Boot technology and the Tomcat server embedded in the application.
    2. “Expert” under Tomcat to retain customization possibilities.
  • With ANSIBLE version 2. We recommend implementing this scenario as it offers numerous advantages.
    We will furnish deployment scripts that customers can modify to their environments to enhance automation.

Not only that, but we will also do a webinar about these innovations in the coming months. This communication aims to prepare CIOs who oversee operating applications for these methods.

The ADAM team.

 

About ANSIBLE

Ansible is an open-source automation tool that is used for various IT tasks, including configuration management, application deployment, and task automation.

Here’s a brief summary of Ansible’s key features and capabilities:

  1. Automation: Ansible allows you to automate repetitive and complex tasks, making it easier to manage and configure systems and applications.
  2. Agentless: Unlike some other automation tools, Ansible is agentless, meaning it doesn’t require any software to be installed on the target systems. It communicates with remote systems using SSH, making it lightweight and easy to set up.
  3. Declarative Language: Ansible uses a declarative language to define the desired state of systems. You specify what the end result should be, and Ansible takes care of figuring out how to get there.
  4. Playbooks: Automation tasks in Ansible are defined in YAML files called playbooks. Playbooks describe the tasks to be performed on specific hosts or groups of hosts.
  5. Idempotent: Ansible playbooks are idempotent, meaning they can be run multiple times without causing harm. If a task has already been completed and the system is in the desired state, Ansible won’t make any changes.
  6. Extensible: Ansible can be extended through modules, which are reusable units of code that perform specific tasks. A vast library of Ansible modules is available to support a wide range of operations.
  7. Inventory: Ansible uses an inventory file to keep track of the target hosts it manages. This file can be static or dynamic, allowing for flexible host groupings and organization.
  8. Role-Based: Ansible promotes the use of roles to organize and reuse sets of tasks. Roles can be shared and reused across different playbooks.
  9. Community and Ecosystem: Ansible has a large and active community, contributing to its extensive library of roles and modules. It also integrates well with other tools and systems.
  10. Security: Ansible employs secure communication via SSH, and it doesn’t require a centralized server for operation, making it a secure choice for automation.

Ansible is widely used by DevOps teams and system administrators to streamline and simplify infrastructure management and application deployment processes, making it a valuable tool for modern IT operations.

 

Analysis, control, search, discover the advanced features of ADAM Manager’s Search and Analytics module.

Documentation processing is alive and well! For many, that’ s not a surprise. Once a project is completed, many external parameters and factors can impact the documentation during the product life cycle. A change of parts, a tool, a reference number or a consumable, or a customer request or a new normative or regulatory constraint, are all reasons why documentation has to be modified and/or updated (RFU, reason for update).

The issue is therefore no longer whether or not the publication assets will be impacted over the 20 to 30 years of product use, but to visualize precisely and quickly where this will be the case.

THE IMPACT ANALYSIS

In most cases, modifications are in response to typical cases that have an impact on the publication assets, such as updating a tool, which may, depending on the case, have a knock-on effect on a set of procedures.


At best, a modification can be limited to updating the reference number of a tool. However, as mentioned above, changing a tool, even if it has the same purpose as the previous one, can have an impact on the way certain tasks are carried out.

Impact analysis meets the important need of quickly and easily identifying all the data modules that reference the tool in order to analyze them and, if necessary, assign them in batches to specialists who can update them.

This sort of impact can be extended to any change in support elements required to carry out tasks, be it an item, an ingredient, test equipment, a change of location, a warning message, a hazard, a sign, a name, etc.

In a system where configuration management is an important element, the Search and Analytics module allows you to search for specific configurations and provide a list of document objects corresponding to your configuration criteria.

MASS CHECKS

In the same way, the Search and Analytics module allows for mass checking of your publication assets. In the case of a modification affecting a greater or lesser number of documentary units (DMs), this ensures that all the documentary units that need to be modified have been modified, and that the entire revised content corresponds to the impact analysis.

It is also possible to perform a search to extract Data Modules with their RFUs (reasons for update) to ensure that none have been forgotten. In fact, an exhaustive list of all the RFUs per documentary unit can be obtained.

ADVANCED CONTEXTUAL SEARCHES

Another way to take advantage of this module, besides impact analysis, is to develop and perform contextual searches on the XML structure of the document, such as searching for a word in an ‘Abbreviation’ tag rather than searching for that word independently of its semantics.

The Search and Analytics module, a quiet revolution, increases the publication-asset search and analysis capabilities tenfold. It offers new perspectives to users and managers, who can now easily and quickly anticipate, quantify and check all and any updating work.

HOW DOES IT WORK?

The Search and Analytics module allows the user to perform advanced search queries on the XML structure of the Data Module. The aim here is to have a list of DMs available as a result.

For instance, the queries could be:
– What are the DMs that refer to such and such an identifier or such and such a tool?
– Which DMs contain at least one inline applicability??
– Which DMs specifically contain this text in the RFU?
– Others


These requests based on the XQUERY language can be created by an administrator with sufficient knowledge of that language, and are taken into account in real time as soon as they are made available on the server.

Users can then enter parameters before executing them, define how the results are displayed, and export them in CSV format. The user can access details of a DM with a simple click.

Naturally, a list of queries accompanies the Search and Analytics module by default. They cover a wide range of current topics including:
– Full text search on content bloc.
– Return all RFU element on all domain search.
– Return RFU element with a specific id
– Return Tool element with a specific toolRef
– Return Supply element with a specific text on name (e.g ‘grease’)
– Return DM with an issueType changed
– Search the impacted DM by a revised CIR fragment
– Search Abbreviation on content (ATA2300)
– Search techLabel on content
– Search reference to the document
– Return all inline applic element on all domain search

4D Concept offers services for tailor-made customer solutions and for training users.

ADAM Manager 5 breaks the sound barrier

 

This is an important period for the ADAM suite and especially the Manager module. Graphic redesign, improved performance, enhanced security, 4D Concept has not left anything out of its version 5 offering of the CSDB S1000D, the most powerful on the market.

 

Security

Security is a major issue in the management of sensitive projects. In an increasingly agile and flexible context for employees, who are now more than ever in home-offices with all the problems inherent in remote working, the heart of the matter is system intrusion resistance, which sends a shiver down the spines of managers and CIOs alike.

This is why 4D Concept has made it one of its main areas of focus, now and for the years to come, and particularly since the beginning of 2020 with the implementation of the ISO 27001 certification reference system dedicated to the security of information systems.

ADAM Manager 5 is already benefiting from these developments, with a first major technical upgrade linked to a version upgrade of the technological bricks used and the replacement of those considered outdated, guaranteeing greater stability and much better resistance to intrusion.

ADAM Manager 5 is already ready for these changes, with a first major technical upgrade linked to a version upgrade of the technological bricks used and the replacement of those considered outdated, guaranteeing greater stability and much better resistance to intrusion.

 

Performance

Powerful tools are prerequisites for successful project management. ADAM Manager 5 already outperforms the competition in this respect.

Nevertheless, we have thoroughly tested the solution through a major performance study which makes it possible for us to guarantee optimal response times and import times (-66%), check-ins (-25%), execution of requests known as “usual Admin”, which are very resource intensive (-78%) because they feed

the Dashboards, and PDF publications (-15%).

 

ADAM Manager 5 drives your projects 1.5 times faster than the previous version.

All tests were carried out on an AWS environment.

 

Ergonomics

You won’t recognize Manager!

The development teams have been working hard for a year to keep all the strengths of ADAM Manager while offering a new graphical interface that is simpler, more readable, easier, just better! Manager 4 users will not be lost, and the new users will appreciate a more modern and user-friendly GUI.

Finally, the overall ergonomics have been designed to integrate authoring skills into ADAM Manager in the very near future. Web authoring is coming…

 

ADAM is on track for S1000D 5.0

Since the beginning of the year, ADAM received many improvements, becoming always closer to our customers’ and users’ expectations.

ADAM Manager

ADAM is now in capacity to:

  • Handle S1000D 5.0 to manage, write et publish your content.
  • Manage a JOB queue to optimize long and greedy tasks.
  • Directly connect to JIRA, leader project manager software to steer your documentation and your teams day to day.
  • Export, publish and preview CIR format from the writting and to the publishing.

connecteur JIRA sofware ADAM Viewer

    ADAM Author benefits from:

  • A CSNRs links generation assistant (CSNRefs)
  • A gathering CIR Widget.
  • A multiple preview management (HTML, PDF).
  • An ability to search in previews.
  • A S1000D style sheet improvement.

 

To contact our sales team and find out about all new features of the ADAM suite, click here

 


ADAM Author is a “tagless” XML editor, based on a robust engine, open to API, and rapidly configurable for your particular business, regardless of your editorial structure or your DTD or XSD. Together with ADAM Manager CMS, ADAM Author lets you expand production power, reduce errors and improve overall quality so that you can focus on the fundamentals – the content.

More about ADAM

 

RELEASE NOTE – NEW VERSIONS OF ADAM AUTHOR AND MANAGER

Our team has just gone live with important new features for ADAM Author and Manager.

 

ADAM Author, the technical authoring tool, has been completely redesigned with a brand-new graphical interface. The user experience has been rethought with an innovative ergonomic design that guides authors in the execution of their tasks.

 

ADAM Manager is now equipped with innovative features that have a direct impact on users’ ability to manage their workflow and make the viewing and publishing processes more fluid.

 


“These latest versions of Author and Manager are definitely major improvements to the ADAM Suite, strengthening its authoring and publishing abilities.”

Alexandre NIO – Product Owner – ADAM


 

As these updates facilitate exchanges between Author and Manager, the ADAM suite provides you with many useful improvements:

 

 

  • WORKFLOW: Make it easier to set up one or more workflows on S1000D documentary units.
  • PERFORMANCES: Save time with a thumbnail display of illustrations and their asynchronous loading, optimisation of data module loading time and enhancement of the Author view style sheet.
  • PREVIEW: Read your contents easily in ADAM Author and Manager with an HTML preview.
  • PUBLICATION: Create filtered publications directly from Manager.
  • DEPLOYMENT: Maximize your deployments with external services.
  • REFERENCE: Open references straight from Author

 

 

Contact our sales team and find out about all new features of the ADAM suite.