Accéder au contenu principal

Properties macro

The Properties macro of the ADOIT Enterprise Architect for Confluence enables you to display ADOIT object and model attributes and relations as tables.

With the Properties macro you can:

  • Display notebook-like details about your object or model in Confluence
  • Configure which attributes and relations should be displayed for each macro separately
  • Access a model or object in ADOIT from your Properties macro in Confluence
  • Build comprehensive documentation by combining the Model Viewer Macro and the Properties macro to form custom dashboards

How to use the Properties macro

Add a macro to a Confluence page

While editing a Confluence page, type /adoit and select the ADOIT Properties macro.

Select macro

A configuration dialogue opens. Here you can search for a specific object or model name, or select an object or model in the explorer view on the left of the configuration dialogue.

After selecting an object or model, you can select the attributes and relations that shall be added to the visualization of this Properties macro.

To define default attributes and releations, please refer to the configuration section at the end of this document.

To display a different content language of the model, available languages can be selected. If no model language is selected, the default language of your Confluence instance is used.

When you are done configuring your Properties, click Insert. In case you want to change the visualization later, the Properties configuration can be adjusted at any time while editing your Confluence page.

Model Viewer configuration dialogue

View options

The Properties macro is displayed as an interactive table with attributes and relations of ADOIT objects and models. By clicking on a green relation, a dialog is opened:

  • Open in ADOIT: Leads directly to the notebook of this object or model in ADOIT

  • Open in Confluence: If the selected object or model is also embedded in other Confluence pages, you can directly navigate to these other Confluence pages

Open in Confluence

Remarque

To make all ADOIT macros visible for the Open in Confluence feature, please consider this migration script.

To open the notebook of the object or model that has been selected for this Properties macro directly in ADOIT, click the Open in ADOIT button.

The refresh button on the top right corner renews the displayed contents of the Properties macro, for example if the language has been changed.

View macro

Of course, the Properties and the Model Viewer Macro can be combined to create powerful dashboards with all necessary information at a glance.

Properties and model viewer

How to configure the Properties macro

Default attributes and relations

There are two ways to define the default attributes and relations that are visualized in the properties macro:

  1. Global configuration: Apps -> Manage apps -> ADOIT Enterprise Architect -> Configure

  2. Space-specific configuration: Space Seetings -> ADOIT Enterprise Architect - Space Settings

In both configuration windows, you can add attributes and relations from the tree view to the selected object.

Please note that you can switch between Model and Object in the artefact type selection.

config