Data Markings and Classification Plugin UserGuide
Data Markings and Classification Plugin UserGuide
https://www.youtube.com/watch?v=OBvX40zgbqc&t=1s
To learn how to install and use Data Markings and Classification Plugin, see:
User Guide
Welcome! This user guide will walk you through the basics of using the Data Markings and Classification
Plugin.
Use the search box to find a specific topic or select one from the list below:
Getting started
Prerequisites
To work with the Data Markings and Classification Plugin, the following software should be installed (see
page 5):
1 https://docs.nomagic.com/display/IL2024xR1/Installation%2C+licensing%2C+and+system+requirements
Sample
You can also review a project sample provided with the installation, found at:
Library
You can use ready-made DoD Data Marking Categories via the DoD data markings model library. The
library is automatically loaded, along with the Data Markings Profile and the Variability Profile, once
you use the DoD Data Marking Categories (see page 12). The library is located at:
Profiles
In order to create and use Data Markings, the Data Markings Profile and the Variability Profile must be
used. They are imported automatically once you create a new Data Marking Category (see page 11) or use
DoD Data Marking Categories (see page 12). You can also import the profile files manually, which can be
found at:
• <tool_installation_directory>\profiles\Variability Profile.mdzip
API
Data Marking features can also be accessed using our standard API.
Related pages:
Main properties
The table below outlines the main properties of the Data Markings and Classification Plugin, which are
implemented in the Data Markings Profile (see page 5).
priority Defines the priority of the Data Marking Right-click a Data Marking Category
Categories, where the lowest number element > Specification > Priority.
indicates the highest priority. Data Learn more >> (see page 18)
Markings from these categories will be
displayed in the Diagram Banner in order
based on their priority.
rankings Specifies whether the markings inside the Right-click a Data Marking Category
category are ranked by the order displayed element > Specification > Rankings.
in compartments. If the ranking is set to Learn more >> (see page 21)
true, only the highest Data Marking will be
displayed.
color Specifies the representation color of Data Right-click a Data Marking Category
Markings that will be displayed as portion element > Specification > select Data
markings. Markings property group > slot cell >
color. Learn more >> (see page 32)
portionMarking An abbreviation of the full Data Marking Right-click a Data Marking Category
text that will be displayed after the Data element > Specification > select Data
Marking is applied to the element. Markings property group > slot cell >
portionMarking . Learn more >> (see
page 38)
bannerMarking Data Marking representation text for the Right-click a Data Marking Category
Diagram Banner marking. element > Specification > select Data
Markings property group > slot cell >
bannerMarking. Learn more >> (see
page 29)
incompatible Specify which Data Markings are Right-click a Data Marking Category
incompatible and cannot be applied to the element > Specification > select Data
same element. Markings property group > slot cell >
incompatible. Learn more >> (see page
35)
data markings A list of the Data Markings inside the Right-click a Data Marking Category
category. element > Specification > select Data
Marking property / Data Markings
property group. Learn more >> (see
page 24)
representing constraint A link to a constraint that will be applied as Right-click a Data Marking element >
a result of data marking. Specification > Representing
Constraint.
specifics Displays the representation attributes of Right-click a Data Marking element >
the Data Marking. Specification > Specifics. Learn more
>> (see page 28)
Project options
The table below outlines the Data Markings and Classification Plugin project options, which are
available via the Main menu > Options > Project > General > Data Markings.
Ignored Data Marking - multi- Specify the Data Marking Categories whose usage you
Categories selection want to be disabled in the model. Learn more >> (see page
41)
Sensitive Element Classifier multi- Select the element types you want to add Data Markings
Types selection to. You can use validation to check whether the selected
Package element types have Data Markings. Learn more >> (see page
43)
Element Types with Classifier multi- Select the element types to be displayed with
Containment Markings selection Containment Markings that indicate the Data Markings of
Package owned elements. Learn more >> (see page 45)
Process
In order to work with Data Markings, we suggest the following workflow:
1. Install (see page 5) the Data Markings and Classification, and the Variability Core plugins in the
modeling tool.
2. Specify the Data Marking Categories and their Data Markings:
• Option 1. Use the DoD Data Markings library.
The library provides you with a ready-to-use package comprised of DoD Data Marking
Categories and their Data Markings that are already specified. You can use it directly in the
project where you want to add or view the Data Markings.
• Option 2. Create your own custom Data Marking Categories with Data Markings and/or
Diagram Banner configurations.
i. Create a new project where the custom Data Marking Categories with their Data
Markings and/or Diagram Banner configurations will be created and specified. This
project will serve as a dedicated Data Marking Categories and Data Markings (and/
or Diagram Banner configurations) project that both you and your colleagues can
share and use. This is necessary in order to use the same custom Data Marking
Categories, add, and view the same Data Markings (and/or custom Diagram
Banners) in your modelling projects.
The Specifying Data Marking Categories and Data Markings (see page
10) section and its subsections provide all necessary information for
specifying custom Data Marking Categories and Data Markings in a
dedicated project.
The Specifying Diagram Banners (see page 46) section and its subsection
provides all necessary information for specifying custom Diagram Banners
in the dedicated project.
ii. Share the newly created Data Marking Categories, Data Markings and/or Diagram
Banner configurations project with your colleagues via TWC or any other internal
tool your company may use.
iii. Use the newly created project with the Data Marking Categories, their Data
Markings and/or Diagram Banner configurations in the project where you want to
add or view the Data Markings and/or custom Diagram Banners.
2 https://docs.nomagic.com/display/MD2024xR1/Sharing+project+data
3 https://docs.nomagic.com/display/MD2024xR1/Using+other+projects+in+a+project
4 https://docs.nomagic.com/display/MD2024xR1/Start+using+a+project+in+your+project
5 https://docs.nomagic.com/display/MD2024xR1/Importing+models
We recommend that you create custom Data Marking Categories and their Data Markings in
a separate project. That project would then be used in projects where the Data Markings would
be added and viewed. To learn more about the recommended project structure and work
process, see the Process (see page 8) page.
To learn more about the main Data Markings and Classification properties, see the Main
properties (see page 6) page.
This section contains all necessary information for creating and managing Data Marking Categories and
Data Markings:
Related pages
You can either create your own custom Data Marking Categories, use DoD Data Marking Categories
(DoD Data Markings library), or combine both options based on your needs via the Data Markings &
Classification shortcut menu. Choosing either one of the two options automatically invokes the usage of
the Data Markings Profile, and the Variability Profile (if they are not used already) needed to create and
use Data Markings and their Categories. To learn more about DoD Data Marking Categories, see the
DoD Data Marking Categories and Data Markings (see page 12) page.
We recommend that you create custom Data Marking Categories and their Data Markings in
a separate project. This project would then be used in projects where the Data Markings would
be added and viewed. To learn more about the recommended project structure and work
process, see the Process (see page 8) page.
Once the Data Marking Category is created, a new package called Data Markings/
Classification, containing the Data Marking Category element, is created in the
Containment tree.
3. Specify the Name for the new Data Marking Category in the Name field.
4. Specify the priority (see page 18)for the new category.
5. Specify the rankings (see page 21)for the new category.
6. Specify the Data Markings (see page 24) for the new category.
7. Specify the representation attributes (see page 28) for the new Data Markings.
Rather than permanently deleting a category from the project, you can add it to an Ignored
Data Marking Categories (see page 41) list.
• Right-click the Data Marking Category element in the Containment tree. In the shortcut menu,
click Delete.
• Right-click the Data Markings/Classification package in the Containment tree. In the shortcut
menu, click Delete.
In addition to or instead of creating custom Data Marking Categories and Data Markings, you can also
use the DoD Data Markings library in your projects. The DoD Data Markings library provides ready-to-use
Data Marking Categories and Data Markings based on the information security classification specified
in the DoD (Department of Defense) Manual 5200.01 Volume 2. If you prefer to work with these Data
Marking Categories, you can use them in your project.
1. Open the project where you want to use DoD Data Markings.
2. Right-click the root package in the Containment tree > in the shortcut menu, select Data
Markings & Classification > under Specification, click Use DoD Data Markings.
Once the DoD Data Markings are used, a new package DoD Data Markings containing
the DoD Data Marking Categories and Data Markings is created in the Containment tree.
If you cannot see the package, make sure the Show Auxiliary Resources6option is
enabled.
6 https://docs.nomagic.com/display/MD2024xR1/Marking+elements+as+auxiliary
You can hide individual DoD categories from the project by adding them to an Ignored Data
Marking Categories (see page 41) list.
• Right-click the DoD Data Markings package in the Containment tree > in the shortcut menu,
click Project Usages > Remove.
Security 1 true Top Secret TS TOP SECRET #FF7 For Official Use
Classificatio B33 Only
n
Disseminati 100 false For Official Use FOUO FOR OFFICIAL USE defau Authorized For
on Control Only ONLY lt Release To
(black CNWDI
) Confidential
Controlled
Unclassified
Information
Display Only
Formerly
Restricted Data
Originator
Controlled
Restricted
Restricted Data
Secret
SIGMA #
Top Secret
The Data Marking Category Priority is an integer Tagged Value, which defines the priority of the Data
Marking Categories, where the lowest number indicates the highest priority. The banner markings (see
page 29) in the Diagram Banner, the portion markings (see page 38) on the element symbols, and the Data
Marking Categories via the Add/Remove action in the Data Markings & Classification shortcut menu are
displayed in the order defined by the specified priority for each category.
You do not need to specify the priority if there is only one Data Marking Category.
Important
If you make changes to the Data Marking Category priority, ensure that you:
1. Right-click the Data Marking Category element and open its Specification window.
2. In the Priority field, write the number to specify the priority. The lowest number indicates the
highest priority.
If the priority is the same for multiple categories or it is not specified, the banner
markings in the Diagram Banner and the categories via the Add/Remove action in the
Data Markings & Classification shortcut menu are displayed in the categories'
alphabetical order.
If you have multiple Diagram Banners, they are ordered based on the priority specified for the category
set in the Diagram Banner configuration. If there are multiple banners in the same position (Header/
Footer/Both), the Diagram Banners with categories that have the highest priority (the lowest number
indicates the highest priority) are displayed first.
For example, you have two Diagram Banner configurations: one has displayedCategories set to
Security Classification, and another to Dissemination Control. Both have displayIn set to Header. The
diagram will have two banners in the header: the first banner (at the top) will display the banner
markings of the Security Classification category and the second banner will display those of
the Dissemination Control, because the priority of Security Classification is higher (1) than that of
Dissemination Control (100). See the image below.
Data Marking Rankings is a boolean Tagged Value that specifies whether the markings inside a category
are ranked by the order specified in their category. Rankings, in combination with Data Markings' order,
determine the display of portion markings (see page 38) on the elements of the project and the banner
markings (see page 29) on the Diagram Banner. To learn more about Data Markings' ordering, see the
Specifying Data Markings (see page 26) page.
Important
If you make changes to the Data Marking Category ranking, ensure that you:
• Refresh the project (click F5 on the keyboard or click View > Refresh in the tool) to see
the changes on the element symbol portion markings.
• Update the Diagram Banner (see page 67) to see the changes in the Diagram Banner
markings.
1. Right-click the Data Marking Category element and open its Specification window.
2. In the Rankings field, do one of the following:
a. To enable rankings, select the false check box to set Rankings to true.
• Only one Data Marking from the same category can be added to an element. If multiple Data
Markings are added, only the higher Data Marking's (Top Secret) portion marking (TS) is
displayed on the element symbol, i.e., based on the Data Markings' order in this category, Top
Secret is higher than Restricted; thus, Top Secret is ranked higher than Restricted. An
Inconsistent Data Markings (Rankings) (see page 81) validation error occurs, prompting you to
remove one of the added Data Markings.
• Only the highest Data Marking from the same category that is added to the element symbols of
the diagram is displayed on the Diagram Banner. If there are multiple element symbols on the
diagram with different Data Markings from the same category, only the highest added Data
Marking is displayed on the Diagram Banner.
• Both portion markings (TS) and (R) of the two Data Markings (Top Secret and Restricted) are
displayed on the element symbol.
• All Data Markings from the same category that are added to the element symbols of the
diagram are displayed on the Diagram Banner.
Once you have a new Data Marking Category created, you need to specify the Data Markings denoting
the classification that you want to have for it.
Important
If you create, reorder, or delete Data Markings, ensure that you:
1. Right-click the Data Marking Category element and do one of the following:
a. In the shortcut menu, click Create Element > Data Marking. Specify the name for the
newly created Data Marking in the Containment tree.
2. Specify the Data Marking representation attributes (see page 28) for the new Data Marking.
3. Repeat steps 1-2 to create additional Data Markings for the category.
4. Click Close.
1. Right-click the Data Marking Category element and open its Specification window.
2. Select the Data Markings property group.
3. Select the Data Marking and click the Up or Down button to move the Data Marking.
4. Click Close. The Data Markings are displayed in the Data Markings & Classification shortcut menu
based on the specified order.
• the Data Marking Category's Specification window > Data Markings property group
> Slots column.
• the Data Marking element's Specification window > Specifics property.
• the Data Marking element's Specification window > Slots property group.
7 https://docs.nomagic.com/display/MD2024xR1/Slot
The bannerMarking representation attribute is a Data Marking representation text for the Diagram
Banner marking.
Important
If you make changes to the bannerMarking representation attribute, make sure to update the
Diagram Banner (see page 67) to see the changes in the Diagram Banner markings.
The color representation attribute specifies the representative color of Data Markings that are
displayed as portion markings on the elements of the project.
Important
If you make changes to the color representation attribute, make sure to refresh the project
(click F5 on the keyboard or click View > Refresh in the tool) in order to see the changes on the
element portion markings.
3. Select the color you want the Data Marking's portion marking to be displayed in. Click OK.
4. Select color and click the Create Value button. The Color dialog opens.
5. Select the color you want the Data Marking's portion marking to be displayed in. Click OK.
6. Click Close.
The incompatible representation attribute is used to specify which Data Markings are incompatible and
cannot be added to the same element. As a result, if incompatible Data Markings are added to the
same element, the Inconsistent Data Markings (Incompatible Tag) (see page 79) validation error occurs.
Important
If you make changes to the incompatible representation attribute, make sure to refresh the
project (click F5 on the keyboard or click View > Refresh in the tool) in order to see the changes
on the element portion markings.
3. Select the Data Marking(s) that you want the current Data Marking to be incompatible with. Click
OK.
You can use the Multiple Selection option to select multiple Data Markings at once.
4. (Optional) Click the button to add another Data Marking that you want the current Data
Marking to be incompatible with.
5. Select the Data Marking(s) that you want the current Data Marking to be incompatible with.
Click OK.
6. (Optional) Click button to add another Data Marking that you want the current Data Marking
to be incompatible with.
7. Click Close.
The portionMarking representation attribute is an abbreviation of the full Data Marking text, and is
displayed on an element as a prefix once the Data Marking is added to an element. The same portion
marking is used for displaying a Containment Marking (see page 58) as a postfix next to the element
name.
Important
If you make changes to the portionMarking representation attribute, make sure to refresh the
project (click F5 on the keyboard or click View > Refresh in the tool) to see the changes on the
element portion markings.
4. Click Close. The portion marking is displayed on the element once the Data Marking is added to
it.
5. Type the abbreviation you want for the Data Marking. This abbreviation will be displayed on the
elements.
6. Click Close.
You can choose to have certain Data Marking Categories ignored in the model. This means that
the Data Marking Category:
The Data Markings of an ignored category that were added to the elements prior to the
category being added to the Ignored list will be displayed again once the category is removed
from the Ignored list.
Important
If you add/remove Data Marking Categories to/from the Ignored list, ensure that you:
• Refresh the project (click F5 on the keyboard or click View > Refresh in the tool) to see
the changes on the element symbol portion markings.
• Update the Diagram Banner (see page 67) to see the changes in the Diagram Banner
markings.
1. In the main menu, select Options > Project. The Project Options dialog opens.
2. In the General group, select Data Markings.
4. In the Select Data Marking Category dialog, select the categories you want to be ignored and
click the Add button. Click OK.
5. Click OK.
1. In the main menu, select Options > Project. The Project Options dialog opens.
To remove all categories from the Ignored list, click the Reset to Defaults button.
4. On the right side of the dialog, select the categories that you want to remove from the Ignored
list.
5. Click the Remove button. Click OK.
6. Click OK.
You can use validation to check whether all elements of the specified element type have Data
Markings added. If there are any elements without Data Markings, the Missing Data
Marking (see page 88) validation rule is prompted.
1. In the main menu, select Options > Project. The Project Options dialog opens.
2. In the General group, select Data Markings.
4. In the Select Element Type dialog, select the element types you want to make sure always have
Data Markings added. Click OK.
5. Click OK.
If you make changes to the Element Types with Containment Markings option, make sure to
update the Containment Markings (see page 59) of the project to see the changes.
1. In the main menu, select Options > Project. The Project Options dialog opens.
2. In the General group, select Data Markings.
3. Click the three dots button next to the Element Types with Containment Markings option.
4. In the Select Element Type dialog, select the element types that should have Containment
Markings displayed. Click OK.
The Diagram Banners display the Data Markings added to the element symbols of the diagram. The
Data Markings displayed on the Diagram Banners are specified via the bannerMarking representation
attribute (see page 29). You can either use the default display of the Diagram Banners, or you can specify
your own custom configurations.
We recommend that you create the configuration for the Diagram Banners in a separate
project, e.g., the same project where the custom Data Marking Categories are specified if you
are using custom categories or a new separate project if you are using DoD Data Marking
Categories. To learn more about the recommended project structure and work process, see
the Process (see page 8) page.
To learn how to specify Diagram Banner configurations, see the Specifying Diagram Banner
configurations (see page 48) page.
Related pages
You can specify your own custom Diagram Banners by creating Diagram Banner configurations; thus,
you can specify the display position (Header/Footer/Both) for specific markings based on their categories
and/or have them displayed on separate banners. To create Diagram Banner configurations, ensure
the working project already has Data Marking Categories (see page 11) created in it.
You can use the Multiple Selection option to select multiple Data Marking Categories if
you want several Data Marking Categories to have the same display position.
8. Under «bannerConfiguration» select displayIn and click the Create Value button.
9. In the Value box, select the display position for the specified categories from the drop-down
menu.
10. Click Close.
1. Right-click the Diagram Banner configuration Class element and open its Specification window.
2. In the Specification window, select the Tags property group.
3. Under «bannerConfiguration» select displayedCategories and on the right side of the window,
click the button. The Select Data Marking Category dialog opens.
4. Select the Data Marking Category you want to add. Click OK.
5. Click Close.
1. Right-click the Diagram Banner configuration Class element and open its Specification window.
2. In the Specification window, select the Tags property group.
3. Under «bannerConfiguration» select displayedCategories.
4. On the right side of the window, select the Data Marking Category value you want to remove and
click the button.
5. Click Close.
Labels
Elements and relationships whose names and/or types are displayed in labels have Data
Markings added as prefixes in the labels. You can choose to show or hide the labels via
Symbol Properties. Hiding the label hides the added Data Marking, too; however, it does
not remove the Data Markings from the element/relationship.
• double slashes ("//") if the Data Markings are from different categories (category scope).
• a single slash ("/") if the Data Markings are from the same category (Data Markings scope).
Data Markings are ordered based on:
The Data Marking that is higher depends on the order of the Data Markings as specified within
their category. To learn more about Data Markings' ordering, see the Specifying Data
Markings (see page 26) page.
Related pages
You can add selected Data Markings to your project elements, as well as remove individual or all Data
Markings added to an element via the Data Markings & Classification shortcut menu. The Data
Markings in the shortcut menu are displayed as their portion markings (see page 38).
To add Data Markings, make sure to specify the Sensitive Element Types (see page 43) project
option with the element types that you want to be able to add Data Markings to.
• Right-click an element or its symbol > select Data Markings & Classification in the shortcut
menu > in the Data Markings section, click Add/Remove > in the Data Markings menu, select
the Data Marking(s) you want to add. Click OK.
To see how to add selected Data Markings to multiple project elements via the parent element
(recursively), see the Adding Data Markings Recursively (see page 55) page.
1. Hold the Ctrl key and select the elements or their symbols you want to add a Data Marking to.
2. Right-click one of the selected elements/symbols, and in the shortcut menu, select Data
Markings & Classification.
3. In the Data Markings section, click Add/Remove, and in the Data Markings menu, select the
Data Marking(s) you want to add. Click OK.
1. Hold the Ctrl key and select the elements or their symbols you want to remove a Data Marking
from.
2. Right-click one of the selected elements/symbols, and in the shortcut menu, select Data
Markings & Classification.
3. In the Data Markings section, click Add/Remove, and in the Data Markings menu, clear the
selection for the Data Marking(s) you want to remove. Click OK.
4. Click the Insert Hyperlink button. The Edit Hyperlink dialog opens.
5. For the Text to display option, select Representation Text.
6. In the Select element/symbol or paste element URL field, click the three dots button.
7. Select the element/symbol in the Select Model Element/Symbol dialog. Click OK.
8. Click Close.
Important
• The Add Recursively action adds the selected Data Markings to the element on which
the action is executed and the elements owned by it if their type is specified in the
1. Specify the element types via the Sensitive Element Types (see page 43) project option (i.e., Package
and Block).
2. Right-click an element or its symbol, and in the shortcut menu, select Data Markings &
Classification.
3. In the Data Markings section, click Add/Remove and select Add Recursively. The Data
Markings menu opens.
The Data Markings are added to the selected element and the elements owned by it if their
element type is specified in the Sensitive Element Types (see page 43) project option (in this case,
To display Containment Markings, you need to specify what element types can have
Containment Markings displayed via the Element Types with Containment Markings (see page 45)
project option.
• double slashes ("//") if the owned elements' Data Markings are from different categories
(category scope).
• a single slash ("/") if the owned elements' Data Markings are from the same category (Data
Markings scope).
Data Markings represented in the Containment Markings are ordered based on:
The Data Marking that is higher depends on the order of the Data Markings as specified within
their category. To learn more about Data Markings' ordering, see the Specifying Data
Markings (see page 26) page.
Related pages
• Updating Containment Markings on multiple elements recursively via the highest parent element
of the project (recommended) (see page 60)
• Updating Containment Markings on a single element (see page 60)
• Updating Containment Markings on multiple elements (see page 61)
• Updating Containment Markings recursively via the parent element (see page 62)
• Updating Containment Markings on multiple elements recursively via the parent element (see page
62)
Containment Markings can be displayed on various element types via the Update action in the Data
Markings & Classification shortcut menu. You can update Containment Markings of individual elements
or multiple ones at the same time by selecting multiple elements or recursively via the parent element.
1. Right-click the highest parent element of the project. In the shortcut menu, select Data Markings
& Classification.
2. In the Containment Markings section, select Update Recursively.
The Containment Markings of the element on which the action is executed and the elements
owned by it (if their type is specified in the Element Types with Containment Markings (see page 45)
project option) are updated.
1. Hold the Ctrl key and select the elements or their symbols whose Containment Markings you
want to update.
2. Right-click one of the selected elements/symbols. In the shortcut menu, select Data Markings &
Classification.
3. In the Containment Markings section, select Update.
The elements' up-to-date Containment Markings are displayed next to the element names.
1. Right-click an element or its symbol. In the shortcut menu, select Data Markings &
Classification.
2. In the Containment Markings section, select Update Recursively.
The Containment Markings of the element on which the action is executed and the elements
owned by it (if their type is specified in the Element Types with Containment Markings (see page 45)
project option) are updated.
1. Hold the Ctrl key and select the elements or their symbols whose Containment Markings you
want to update.
2. Right-click one of the selected elements/symbols. In the shortcut menu, select Data Markings &
Classification.
3. In the Containment Markings section, select Update Recursively.
The Containment Markings of the elements on which the action is executed and the elements
owned by them (if their type is specified in the Element Types with Containment Markings (see
• double slashes ("//") if the Data Markings are from different categories (category scope).
• a single slash ("/") if the Data Markings are from the same category (Data Markings scope).
The Data Marking that is higher depends on the order of the Data Markings as specified within
their category. To learn more about Data Markings' ordering, see the Specifying Data
Markings (see page 26) page.
Multiple custom Diagram Banners (specified via Diagram Banner configurations (see page 46)) are
ordered based on:
Diagram Banners display the banner markings (see page 29) of the Data Markings added to the elements
of the specific diagram. You can display the Diagram Banner on a diagram, specify its position, update
it, or hide it.
• Right-click the diagram. Select Data Markings & Classification in the shortcut menu > in the
Diagram Banner section, click Create. The Diagram Banner is created in the header of the
diagram.
If the Diagram Banner is displayed, but the diagram does not contain any symbols with
added Data Markings, the Diagram Banner is displayed as empty.
If you are using custom Diagram Banner configurations (see page 46), display position changes on
individual diagrams revert to the position specified in the configuration once the Diagram
Banner is updated.
• Of a single diagram: Right-click the diagram > select Data Markings & Classification in the
shortcut menu > under the Diagram Banner section, click Update.
• Of multiple diagrams:
1. In the Containment tree, select the diagrams whose Diagram Banners you want to update.
2. Right-click the diagrams > select Data Markings & Classification from the shortcut menu >
under the Diagram Banner section, click Update. The Diagram Banners of all selected diagrams
are updated.
If you also select a diagram that does not have a Diagram Banner, a Diagram Banner is
created for the diagram upon the Update action.
If a diagram contains elements with added Data Markings, but the Diagram Banner is not
created, an Invalid Diagram Banner (see page 85) validation error occurs.
• Previewing the model prior to performing Sensitive Element Redaction (see page 71)
• Performing a Sensitive Element Redaction (see page 72)
• Sensitive Element Redaction transformation details (see page 74)
Sensitive Element Redaction allows you to narrow down the full model by removing elements with the
selected Data Markings. Additionally, you can choose to remove all Data Markings from the model and
save it as a separate project. You can also use the preview function prior to performing the Sensitive
Element Redaction.
https://www.youtube.com/watch?v=CT7bQ700dMM&ab_channel=3DSCATIAMBSE
The model is transformed based on the selected Data Marking and its position within the
order (see page 26) of its category. Selecting a Data Marking that is lower within the order of its
category means that the elements with higher Data Markings will also be removed from the
model. See the example above.
1. In the Main menu, select Tools > Model Transformations. The Model Transformation Wizard
opens.
2. In the first step of the wizard, select Sensitive Element Redaction. Click Next.
3. Select the elements on which the transformation should be performed and click the Add
button. Click Next.
5. Select the Data Markings you want to remove from the model. Click OK.
• To view the list of Data Markings, select the List tab in the Select Enumeration
Literal dialog.
• Use the Multiple Selection button to select multiple Data Markings.
After performing a Sensitive Element Redaction, make sure to update the Diagram
Banners (see page 65) and the Containment Markings (see page 59) of the project.
Clear Data Markings false true/false If set to true, all Data Markings, in addition to the elements
Data with the specified Data Markings, are removed from the
realized model variant. If set to false, only the elements
with the specified Data Markings are removed.
Forcibly Transform false true/false If set to true, the normally non-editable project elements
Read-Only Elements will be modified or removed during the transformation
without trying to lock them.
You can create a project disclaimer configuration to display custom disclaimers upon project opening.
The disclaimers can contain any information you want project users to be aware of before opening the
project. The project can only be opened after all specified disclaimers have been read.
7. In the Value box, type the message you want to display in the disclaimer.
1. Right-click the project disclaimer configuration Class element and open its Specification window.
2. In the Specification window, select the Tags property group.
3. Under «disclaimerConfiguration» select text.
4. On the right side of the window select the text value you want to remove, and click the
button.
5. Click Close.
1. Right-click the project disclaimer configuration Class element and open its Specification window.
2. In the Specification window, select the Tags property group.
3. Under «disclaimerConfiguration» select text.
4. On the right side of the window select the text value you want to edit, and click the button.
5. Click Close.
1. Right-click the project disclaimer configuration Class element and open its Specification window.
2. In the Specification window, select the Tags property group.
3. Under «disclaimerConfiguration» select text.
4. On the right side of the window select the text value you want to move, and do one of the
following:
a. Click the button to move the text value up.
b. Click the button to move the text value down.
5. Click Close.
• Save as Image8
• Print as PDF9 / Print Preview10
• The images are also represented in the reports generated via the Report Wizard11
Validation
Validation checks the accuracy and compatibility of the added Data Markings, displays errors in the
model, and suggests solutions. The validation suites are part of the Data Markings Profile (see page 5). In
order for the validation rules to work in your project, the Data Markings Profile must be part of your
project.
The Data Markings and Classification Plugin provides two Data Markings validation suites to validate
the Data Markings used in the model:
• Data Markings
Passive validation suite. You can view the validation rules in this suite on the Data Markings
validation rules (see page 83) page.
• Data Markings (Auto)
Active validation suite. You can view the validation rules in this suite on the Data Markings active
validation rules (see page 79) page.
IDB
8 https://docs.nomagic.com/display/MD2024xR1/Saving+as+image
9 https://docs.nomagic.com/display/MD2024xR1/Printing
10 https://docs.nomagic.com/display/MD2024xR1/Printing
11 https://docs.nomagic.com/display/MD2024xR1/Generating+reports+from+the+Containment+tree
12 https://docs.nomagic.com/display/MD2024xR1/Sync+with+Excel+or+CSV+files
The validation rule checks if the added Data Markings are specified as incompatible with any of the
other added Data Markings via their "incompatible" tags.
Severity
warning
Constrained Element
Element
Solvers
• Remove <Data Marking> from Element - once selected, you can choose which one of
the added Data Markings to remove from the element.
<Data Marking> - represents the full Data Marking name and portion marking in
parentheses, e.g. "Remove Top Secret (TS) from Element".
Example
IDM[2]
Description
The validation rule checks if the added Data Markings belong to the same ranked Data Marking
Category.
Severity
warning
Constrained Element
Element
Solvers
• Remove <Data Marking> from Element - once selected, you can choose which one of
the added Data Markings to remove from the element.
Example
The element has both Secret (S) and Top Secret (TS) Data Markings added, both
of which belong to the same ranked Data Marking Category Security
Classification.
The error is resolved by removing the Secret (S) Data Marking from the element
via Remove from Element solver.
IDM [3]
Description
Severity
warning
Constrained Element
Diagram
Solvers
• Show Name - once selected, the element name is displayed along with the added Data
Markings.
For some symbols you can also resolve the error by displaying the element type
via Symbol Properties.
Example
A diagram with a single port (on the left) and multiple ports (on the right) are
displayed without the added Data Markings.
The error is resolved by displaying the name label with the added Data Markings
via the Show Name solver.
IDM [4]
Description
When a property is typed by a sensitive element, the validation rule checks whether the property has a
matching Data Marking or if the sensitivity level of the added Data Marking is not lower than the
sensitivity level of the Data Marking added to the type.
Severity
warning
Constrained Element
Property
Solvers
• Comply with the Property Type's Data Marking(s) - adds the same Data Markings to the
property as the ones added to its type. If any of the added Data Markings are higher than its
type's Data Marking, they remain.
Example
ICM
Description
The validation rule checks if the Containment Markings match the Data Markings of owned elements.
Severity
warning
Constrained Element
Element
Solvers
The Data Marking of the Part Property clutter was changed from (C) to (S), but
the Containment Marking of the Block Radar is outdated.
The error is resolved via the Update Containment Markings solver.
Description
• The Diagram Banner displays up-to-date Data Markings that correspond with those added to the
element symbols of the diagram.
• The diagram contains element symbols with added Data Markings, but the Diagram Banner is
not created.
The validation error is not triggered if the Diagram Banner's display position is set to
None. The error is only triggered if the diagram's «banner» stereotype has a text tag with
no set value, i.e., the banner is removed (see page 69) or not created (see page 65).
Severity
warning
Constrained Element
Diagram
Solvers
IDM [4]
Description
Elements (e.g. ports) and relationships whose names and/or types are displayed in labels have
Data Markings added as prefixes in the labels. You can choose to either show or hide the labels
via Symbol Properties. Hiding the label hides the added Data Marking, too, however, it does not
remove the Data Markings from the element/relationship. A hidden label hides the added Data
Markings and prompts the validation error.
Severity
warning
Constrained Element
Diagram
Solvers
• Show Name - once selected, the element name is displayed along with the added Data
Markings.
Example
A diagram with a single port (on the left) and multiple ports (on the right) are
displayed without the added Data Markings.
The error is resolved by displaying the name label with the added Data Markings
via the Show Name solver.
MDM
Description
The validation rule checks if there are elements that are specified to have Data Markings in the
Sensitive Element Types (see page 43) project option but do not have any Data Markings added.
Severity
warning
Constrained Element
Element
Solvers
To fix this, make sure the element has an added Data Marking.
The Sensitive Element Types project option is set to a Block; thus, the Block
element must have an added Data Marking.
The error is resolved when the Block Aircraft is added a Data Marking.
D I
Install-dds-plugin 5
Dds-real-time-communication-plugin 5
Installing-dds-plugin 5