Publication for Capella - Releases

• Publication for Capella 2024.3.0
• Publication for Capella 2023.12.0
• Publication for Capella 2023.10.0
• Publication for Capella 2023.8.0
• Publication for Capella 2023.4.0
• Publication for Capella 2023.3.1
• Publication for Capella 2023.3.0

Publication for Capella 2024.3.0 (2024-03-28)

The focus of this version is to manage the versioning of models and model elements published on the server.

Web Client Improvements

• The web client now displays the history of publications and online link modifications. This history is displayed in a dedicated right-hand panel.

   

  

  Figure 1. New History UI

• The quick search no longer reloads the page when a search result is selected.
• The quick search now supports navigating in search results using the keyboard arrows.

Contributor Client Improvements

• The publication wizard now requires the user to enter a message explaining the reason of the publiction. This message is used as a commit message, displayed online in the model history view.
• The credentials to connect to the Publication server will always be requested if they are not properly set in the preferences, without interrupting the requested operation.

Server Changes

• The default labels for the four IBM DOORS Next link types (trace, satisfy, specify, derives) have been fixed. It is recommended to reflect these changes in server environments in the oslc-linking.json file.

Publication for Capella 2023.12.0 (2023-12-31)

The focus of this version is on bringing a first level of Global Configuration Support. This support is not complete but makes it possible to use Publication for Capella with third-party repositories that use Global Configuration.

Web Client Improvements

• Limited Support for Global Configuration Management:
  • A project can now be set-up to use Global Configuration if connected to an IBM Jazz Team Server.
  • Within such a project, all models must be associated to exactly one Global Configuration to support traceability.

   

  

  Figure 1. Activate Global Configuration on a Project

   

  

  Figure 2. Work in a specific Stream in a 'Global Configuration Aware' Project

Contributor Client Improvements

• Limited Support for Global Configuration Management:
  • There is now an initializer to create the OSLC Configuration Management domain. This initializer must be run if the model needs to use a Global Configuration.
  • Whenever a model is configured for a specific Global Configuration, then only artifacts compliant with the Global Configuration can be dragged and dropped from third-party repositories.
• Facilitate the reuse of a Traceability Configuration:
  • It is now possible to export and import a traceability configuration in Capella, making it easier to configure a new Capella project for traceability with third-party repositories.

   

  

  Figure 3. Import Shared Traceability Configuration

• The publication URL of a given Capella model is now stored in the *.traceability file instead of the *.aird file.

Server Changes

• The property perseus.oslc.linking.global has been renamed to perseus.oslc.linking.default. Make sure to change this property’s name in your own application.properties file accordingly.

Publication for Capella 2023.10.0 (2023-10-17)

Contributor Client Improvements

• The traceability initializer now provides an initializer for the JTS domain 'LinkTypes'.

API Improvements

• OSLC queries now support "where *=<perseus_url>".
• OSLC queries now support "in [<perseus_url>]".
• Model object data retrieval via OSLC API has been optimized.

Bug Fixes

• OSLC links created from another tool to an unnamed object in Perseus are now navigable.
• It is now possible to create OSLC links from an unnamed object in Perseus.
• Fix wrongfully encoded characters in OSLC query results.
• Limit access to OSLC Catalogs according to the user’s permissions.
• Contributor Client
  • Fix counting of model elements when publishing.
  • Fix missing links issue in some Capella diagrams.
  • Fix NullPointerException when trying to publish a model with broken representation descriptions.

Publication for Capella 2023.8.0 (2023-08-23)

Server Improvements

• Proxies are now supported in the server. Refer to the installation guide for more details.

Web Client Improvements

• The labels of OSLC Link types are now properly displayed in the OSLC Links panel, taking into account the OSLC Linking Configuration.

Figure 1. Improved OSLC Links Panel

• Web Client - The refresh all artifacts action is now accessible to all the project contributors.
  • Previously, this action was only available to the server administrator. This was wrong because most of the time the server administrator has no account on the registered OSLC Friend servers, especially when P4C is deployed in a cloud environment.

Figure 2. Refresh All Artifact available to Project contributors

• Miscellaneous UI Improvements:
  • A link "back to consumer’s list" has been added to all OSLC Consumer pages.
  • A link "back to project" has been added to the project settings page.
  • It is now possible to rename OSLC Friends.

Contributor Client Improvements

• Proxies are now supported in the Contributor Client. Refer to the installation guide for more details.
• The traceability layer is now automatically activated whenever an artifact is dropped in a diagram.
• Links created from remote consumer servers are now synchronized with Capella, as long as there is a correct configuration making it possible for the Publication server to access this consumer as an OSLC Friend.

API Improvements

• Miscellaneous OSLC API Improvements (Refer to the Perseus - OSLC API.pdf document for more details):
  • The amount of information available in the RDF representation of model elements is now richer. It includes all the properties and references of the model elements.
  • The OSLC Query API now supports more types of queries.

Bug Fixes

• Web Client - Links with no reverse link type can be properly created, which is absolutely necessary for compatibility with DOORS Next.
  • The previous version had a regression that caused such links to be wrongly marked as problematic.
• Using the Capella templatepatterns meta-model is now supported.
  • Previously, trying to publish models that depend on this meta-model was prevented by a Constraint Violation exception.
• The order of viewpoints in Representations per viewpoint in the Web Client is now identical to what it is in Capella, even when additional viewpoints are used.
• Minor differences regarding the labels of Viewpoint Categories in the Web Client model tree have been fixed.
• Web Client - The licensing enforcement mechanism will now properly ignore inactive accounts.
• Contributor Client - Artifacts are now properly displayed in unsynchronized diagrams.
  • Previously, a bug was causing artifacts to be displayed without their type and text in unsynchronized diagrams.
• Web Client - The web client will no longer fail if access to the browser’s local storage is denied.
• Contributor Client - Closing the Perseus preferences dialogs no longer causes an exception to appear in the error log.

Publication for Capella 2023.4.0 (2023-06-06)

The focus of this version is on user experience improvements.

Web Client Improvements

• The search treats % and _ as any other characters, making it possible to search for the exact chain containing one of those.
• OSLC link targets and their OSLC identifier are included in the search scope.
  • Consequently, it’s now possible to locate model elements linked to an artifact ART-ID by simply searching for ART-ID.

Figure 1. Quick Search showing model elements linked to an artifact

• Capella models and model elements are displayed with the same icons as within Capella.
• The labels of the Viewpoints and their ordering is now identical to what they are in Capella.
• Representations are grouped by type in the explorer tree, just like in the Capella explorer.
• The Model Tree nodes are now properly aligned, no matter whether they have children or not.
• Diagrams are scaled to the browser size. More specifically, diagram images are scaled down if they exceed the available width of the available area.
• An action makes it possible to display diagrams in full screen.
  • When in full screen, it is possible to grab the whole diagram with the middle mouse button to move it easily.

Figure 2. Miscellaneous Improvements in the web UI

• Representation Notes in diagrams can now be clicked to navigate to their target diagram.
• Clicking on objects in diagrams that have other representations attached makes it possible to access those representations.
• The jobs page now refreshes automatically.
• OSLC small preview is now supported, which consequently makes it possible to have the OSLC preview being displayed by Polarion for links targeting Capella model elements in Publication for Capella.

Figure 3. Small Preview working in Polarion

Contributor Client Improvements

• At the end of a publication, the jobs page is no longer automatically opened. A pop-up with a hyperlink leading to the jobs page is now displayed instead.
• Updating from the server only considers friends that have been configured as Artifact Repositories within the Traceability model.
• The "Init traceability" action now only displays domains that are not already configured in the model.
• The "Init traceability" action now displays icons for each initializer.
• A new kind of initializer is available to facilitate the creation of Artifact Repositories in the model by retrieving available friends from the Publication server.

Figure 4. Artifact Repositories initialization

Bug Fixes

• A bug prevented very large models from being published (when the amount of bytes to publish exceeded the largest Integer value in Java). This has been resolved, making it possible to publish very large models. However, the RAM and disk space must be sufficient to hold the published data in memory and in the temporary folder used by Java, which is system-dependent.

Publication for Capella 2023.3.1 (2023-03-28)

The version is mainly a bug-fix release, with a few improvements related to the IBM Jazz suite support.

Improvements

• Connectivity from Publication for Capella to Jazz EWM and Jazz Quality Manager is now supported.
  • In previous versions, only DOORS Next could be connected from Publication for Capella.
• Consequently, drag & drop from Jazz EWM is now supported.
  •  Drag & drop from Jazz Quality Manager is still not supported.

Documentation Improvements

• Examples of configurations for Jazz EWM and Jazz Quality Manager have been added, both for the server OSLC Linking configuration and for the Contributor Client configuration.

Contributor Client Bug Fixes

• Diagrams are now properly refreshed when artifacts are dropped, even in Team for Capella.
• The Contributor Client no longer hides meta-model registration errors.
  • There was a bug in previous versions that could hide a meta-model registration error and let the publication proceed, resulting in an error message meta-model with hash xxxx is not registered.
• Models with invalid views can now be published.
  • There was a bug in previous versions that prevented some models from being published. Specifically, the models with views with no viewpoint set could not be published.

Server Bug Fixes

• The regression that caused deleted links to still appear in DOORS Next is now fixed. This regression had been introduced in version 2023.3.0.

Publication for Capella 2023.3.0 (2023-03-03)

The main novelty of this version is the capability to manage traceability links directly within Capella, while keeping these links synchronized with the Publication server and the connected third-party repositories.

Managing Traceability in Capella

This new capability makes it possible for System Engineers to easily create traceability links between their model elements and third-party artifacts such as requirements, tests cases, or change requests.

The System Engineer can create such links simply by dragging and dropping URLs of artifacts from their website into Capella.

The drag and drop can take place in a diagram, or in the model tree. A link gets created between the dropped artifact and the model element on which it was dropped.

It is possible to configure different types of links to be created between different types of model elements and different types of artifacts. If several types of link are configured as being allowed between the dropped artifact and the model element, then the user must chose the one they want to create.

These links are available within the Capella model, but they also get to the Publication server each time the model is published. These links can also be created or deleted on the Publication for Capella website, and System Engineers can synchronize their Capella models to retrieve these link changes in the Capella model.

Please refer to the User Guide for a complete description of this novelty and the related features.

Other Changes

• Models must be saved before publishing.
  • A pop-up will be displayed if the user tries to publish an unsaved model to make it possible to save the model and proceed, or cancel the publish.
• Models are automatically saved after publishing.
  • Publishing a model will modify some technical information in the model. For this reason, the model is saved automatically after publishing, whereas it appeared as dirty in previous releases.

Bug Fixes

• The display of the rich text documentation is now correct.
  • There was a bug in previous versions that caused the rich text to be incorrectly formatted after the 1st link in the documentation.
• The version number displayed in the home page footer is now correct;
  • In version 2022.11.0, the footer was incorrect and stated 2022.9.0.