Smartfacts Platform

Introduction of the Pages Concept

We have added the Pages concept to the Smartfacts platform. This means that you can add rich text pages to the project tree that can be hierarchized. Any page may have child pages. You can manually edit pages or copy and paste content from MS Word or a website. The Pages are a Confluence like feature which is especially designed to document model based content.

Model references in a page: You can drag & drop nodes of a model tree into a page from the project tree. This will create a reference in the page. A user consuming the page can examine the delegated UI of the model node just as you know it from other features like comments, chats, reviews.

You add a page by using the local menu of a folder or a page and selecting the add page command.

Master pages: You can make a page a master page by checking the master page checkbox in the local menu of the page. Master pages automatically get loaded to the left side when a user enters a project. So, a master page could e.g. provide an overview of the project and current focus.

Stereotype Filter for the Model Tree

Every root node of a model can now carry a filter definition of stereotypes. If you want to filter the model tree down to nodes that only carry use case and sequence diagrams of a model, you use the local menu of the model root node and check the diagram types to define the filter. By checking the apply filter checkbox, the filter is activated.

Preset Global Visibility for Newly Published Models

Models that are newly published to Smartfacts are by default only visible to the user who has published the model. This user is the one and only model owner and the only user who can see the model in the Smartfacts model tree. So far, other users had to be provided visibility manually.
In order to simplify this, you can specify user groups in the Model Warehouse Profile in the Smartfacts tab under Global visibility for newly published models.
Simply add group names separated by a comma min order to automatically provide visibility for all these groups to the newly published model.

Indexed Models

In this release, we reorganized the Indexed Models page (formerly known as Link Index). In order to migrate existing Git connections to the recent version, please do the following:

• Ensure that the existing Git servers have been correctly transferred / added to the External Servers section of the Model Warehouse Profile. Use the Text Connection button to ensure that connection and authentication are set up correctly:
  

  

• In the updated Indexed Models page, the branches to be synchronized must be defined from scratch. To add a branch, click the Add Config button, select the Git server(s) and the desired branch. Repeat this for every branch of every Git repository supposed to be synchronized via the index:
  

  

New UI for the Smartfacts Global Configurations

Smartfacts provides its own Global Configuration Management concept which is vendor and platform independent and is based on the OSLC configuration management standard published by OASIS. Therefor, the Smartfacts project tree has a standard folder Global Components. This folder cannot be deleted and has a specific local menu that allows to add global components.

Headless Publishing

New Supported tools:

Headless publishing now supports the following for tools:

CAMEO/MagicDraw, Enterprise Architect, Rhapsody, Innovator

Change Detection for TWC:

For CAMEO models provided on TWC, change detection is supported based on the TWC commit id, so only models which have changed on TWC are updated.

Headless Publishing for CAMEO under Linux environment:

The Publisher now also runs in Linux environment for tool supporting running under Linux (CAMEO)

New Configuration switches:

doDeltaImport: Run headless publisher in delta import mode ( reduces runtime, as only changed diagrams are exported )

doVersionOverride: Amend the latest existing version on smartfacts for the model.

Please ensure, that latest versions of the plugins are used.

Abbreviated Link Format

In this release, we have introduced an abbreviated link format for source code links. It replaces the previous, JSON-based format, which is still readable from the plug-ins. To use the abbreviated link format:

• if you are using the Eclipse plug-in, upgrade it to 2022.11.1 via the Get Plug-Ins functionality. (A corresponding VSCode plug-in will be provided soon)

• Configure the link format in the Source Code Links section of the Model Warehouse Profile.

  • There is a default link format for links to Smartfacts-internal elements, which produces the following links:

    

    where @(' ') represents the language-specific comment pattern, oslc:// the global prefix, Elaborates is an example of the link type, SUV2.6 denotes the unit name, and EL-40dc... is the smartfacts ID of the referenced element.

  • To enable abbreviated link format for a specific codebeamer instance, add the following into the root-level templates array:

Replace genoslc with an arbitrary short identifier and the baseUrl value with the genoslc codebeamer instance you want to work with. It is possible to maintain multiple codebeamer instances in parallel. A link created with this configuration looks like this:

Experimental: Traceability browser version 1

IBM Jazz Integration

Update of picking / switching Jazz global configurations

##To be added by Christoph

PTC Codebeamer

Improved Cameo Systems Modeler Integration

##To be added by Christoph

Felicity integration

##To be added by Christoph

Adding new requirements from withing the plug-ins

##To be added by Christoph

Jama Connect

Improved authentication of the API

Improved Cameo Systems Modeler Integration

##To be added by Christoph

Dassault Systèmes, Cameo Systems Modeler

Cameo diagram navigation inside delegated UIs

##To be added by Christoph