Diagrams

Where can I find diagrams and categories?

Use the menu to navigate to the Diagrams section. In this section you will find all diagrams (possibly sorted in categories) of the current repository.

Here, the "Diagrams" button of the menu is shown.

You can choose between the two views Diagram list and Dashboard. Initially, the diagram list is presented to you. Then the main area of your screen shows the categories and diagrams that have the current repository as their immediate parent category.

The diagrams main area with the tabs "diagrams list" and "dashboard" is shown here.

For each diagram, you will see the name in the current content language and the corresponding diagram type in the UI language below. Clicking on a diagram list entry leads you to the corresponding diagram view, from where you can access alternative views.

In the vertical bar on the left side of the main area, you can find the categories. Click Open categories to open the panel. You can either click on the folder icon or on the complete vertical bar.

The button to open the categories panel is displayed here.

Then all categories that are subordinated to the current repository are listed in an explorer menu. A category can be expanded by clicking on its name. The diagrams in this category will be listed in the main area now.

The screenshot shows the categories panel and contained diagrams in the main area.

Categories can also contain subcategories which is indicated by an arrow next to the category name. A subcategory can be opened analogously by a click on its name or on the arrow next to its name. You can always navigate in the category tree using the breadcrumb navigation in the header bar. If you like to minimize the category explorer, select the Collapse categories button.

The button to close the categories panel is displayed here.

Tip

Toggle the menu bar to enlarge your main area.

You have the opportunity to adjust the size of the category panel. Click with the mouse on the right border of the category panel. Then you can drag the blue upcoming line with the hold mouse to the left (minimize) or the right (enlarge).

The screenshot shows the adjusting function for the categories panel.

On the right side of the screen, the desktop view first shows the options and the filters. Go to the linked question to read more about the filters. Different exports are currently offered as options. These functions generate Excel files for you with the content and additional information on all diagrams in the category. See the Exports chapter for more information.

How can I create a diagram?

You can create a new diagram by clicking on the button at the bottom right corner of the diagram list.

The screenshot shows the button "Create diagram".

After clicking on it, you have two options, the Quick Modeler option, and the AI-generated draft option.

If you select the Quick Modeler option, give your new diagram a name and upload the corresponding BPMN file. You can find the template for it here.

The screenshot shows the dialog window for creating a new diagram, in which you can use the "Quick Modeler".

Note

Please note that only users with the roles Administrator and Editor can import an Excel file. Authors who normally do not have access to the created diagram are excluded from this import function.

If you select the AI-generated draft option, give your new diagram a diagram name.

The screenshot shows the dialog window for creating a new diagram in which you can use the "AI-generated BPMN draft".

Note

Please note that only users with the roles Administrator or Editor can create an AI-generated draft.

Once you have selected your preferred option, click Create to view your new diagram.

Quick Modeler

The Quick Modeler is an Excel file containing a table necessary for quick modeling. Within the Excel file, you’ll find a detailed introduction to the Quick Modeler, along with a template featuring an example.

Download Quick Modeler Template (Excel)

Hint

Currently, this Excel file is necessary to create a new diagram.

Hint

Please be aware that the Excel file is currently available only in English.

Note

Please note that only users with the roles Administrator and Editor can import an Excel file. Authors who normally do not have access to the created diagram are excluded from this import function.

AI-generated diagrams

How can I get a BPMN draft for my process when I create a new diagram?

Using the AI-generated BPMN draft, you can leverage artificial intelligence (AI) to create your diagram. Upon selecting this option, you need to provide a name in the designated input field. Once you’ve entered a name, the Create option becomes active.

After creating the new diagram, a loading spinner will appear, which may take a few minutes. Following this, you will either be redirected to the diagram view to preview your diagram or receive an error message with an error code in case of an issue.

Note

Please note that only users with the Administrator or Editor roles can create an AI-generated draft.

Functions in category explorer

To select a function for a diagram category, you need to be assigned as an Administrator, Editor or Author role and be in Public Workspace. Here you can find how to change the stage.

How can I create diagram categories?

You can create diagram categories in the category explorer. Open the explorer menu and click on the context menu (three dots) next to your repository folder. Select the option New category.

The screenshot shows the option "New category".

Enter the category name and confirm with Create. The diagram category will be shown in the category explorer alphabetically sorted.

The screenshot shows the dialog window for the creation.

Hint

You can also create subcategories for already existing main categories. Therefore you can click on the context menu next to the category name and repeat the process. The created categories will be listed as subcategories for the selected main categories.

How can I rename diagram categories?

If you want to rename a diagram category name, you need to click on the context menu (three dots) and select Rename.

The screenshot shows the option "Rename" for the chosen category.

In the upcoming displayed dialog window, you can enter a new name for the selected category. Type the new name into the input field and select Rename. To discard the renaming, click the Cancel button.

The screenshot shows the dialog window for the renaming.

After the renaming is completed, the updated diagram category name is visible in the category explorer. Concurrent user need to refresh the view to see the made changes.

Note

You need to enter at least one character to complete the renaming.

Note

The renamed diagram category will only be displayed in your content language.

How can I delete diagram categories?

You can delete main and subcategories according to your needs. Click on the context menu (three dots) next to the category name and select Delete.

The screenshot shows the option "Delete" for the chosen category.

Then a dialog window appears. If you do not want to delete the category, you can close the window by clicking on the Cancel button.

The screenshot shows the dialog window for the deletion.

Enter the category name und click on Delete to complete your deletion.

The screenshot shows the confirmation for the deletion.

Hint

If the category contains subordinated diagrams and categories, they will be deleted as well. This cannot be undone.

How can I cut and paste diagrams and diagram categories?

Cut and Paste diagrams

To insert a diagram from one diagram category to another diagram category, you can use the Cut function. Open the diagram category where the desired diagram is located. Click on the context menu (three dots) in the diagram list and select Cut.

The screenshot shows the option "Cut" in the context menu in the diagram list.

Select the diagram category in which you want to insert the diagram. This can be done for both main categories and subcategories. Click on the context menu of the category and select Paste.

The screenshot shows the option "Paste" for the chosen category.

The selected diagram will then be removed from the original category and pasted into the selected category.

Cut and Paste diagram categories

To reorganize a diagram category, click the context menu next to the desired diagram category name and select Cut.

The screenshot shows the option "Cut" in the context menu in the category panel.

This will cut every subcategory (if any are provided) and all containing diagrams in the category as well. To paste the cut-out category, click on the context menu where you want to insert it and select Paste.

The screenshot shows the option "Paste" for the chosen category.

The procedure will be cancelled if you

  • cut out a new diagram,

  • press the ESC key,

  • refresh the page or

  • change the repository.

How can I publish diagram categories?

To publish your diagram category, click on the context menu (three dots) next to name and select Publish.

The screenshot shows the option "Publish" for the chosen category.

In the upcoming dialog window you have to enter the category name and the reason for the publication and click Publish. If you want to discard the publication, select Cancel.

The screenshot shows the dialog window for the publication.

Hint

When you want to publish a diagram category, you are going to publish all subordinated diagrams as well. For each diagram a workflow will be initiated.

Note

You can also publish your repository. Select the context menu next to the repository and follow the same steps.

How can I export diagram categories?

Export in context menu (three dots)

You can export diagram categories by clicking on the context menu and selecting Export.

The screenshot shows the option "Export" for the chosen category in the category panel.

An archive of the diagram category will be created. The notification, which appears at the bottom right side of the screen, informs you about the start of the export.

Export in Options panel

You can also export a diagram category in the Options panel. Click on Reports & Exports and select the Create the report button next to Export Category. The notification at the bottom right side of the screen informs you about the start of the export.

The screenshot shows the option "Export category" in the options panel.

When the export is successfully completed, you will receive another message. This notification contains a link, that enables you to download the export.

The screenshot shows a toast with a link to start the download of an export.

Once the export has been created, you will find a Download the report button in the Reports & Exports section of the Options panel. There, you can download the export.

The screenshot shows the "download the report" button in the options panel next to the option "Export category".

How can I analyze diagram attributes in the dashboard?

If you open the Diagrams section using the menu, you can switch to the Dashboard in the main are of your screen.

The selection of the button "Dashboard" is displayed here.

The dashboard view enables you to analyze the diagram attributes of all diagrams contained in your current repository. A donut chart is displayed for each available diagram attribute type. An attribute type is available as soon as it is set visible in the method and is maintained in at least one diagram. The number in the middle of a chart tells you how many different facets of the attribute are currently present in the repository.

The screenshot shows the dashboard in the main area.

The right sidebar shows the filter. If you select one or more facets there, the charts will be updated to count only the diagrams which satisfy the filter criteria.

The screenshot shows the selection of a chart facet.

Vice versa, you can select one or more facets of a chart in order to filter for a characteristic.

The screenshot presents a dashboard with activated filters.

If you activate one or more facets in the filter and switch to the diagrams list, the filter is still active and only the filtered diagrams are listed there.

Filter and search diagrams

How can I filter the diagrams?

When you are in the diagrams list or the dashboard, you have the possibility to filter your diagrams. On the right-hand side of the list you can see the option filter and all attributes.

The screenshot shows the filter in the right-hand side.

When you click on an attribute, a list with its facets will appear. Here you can choose which facets should be displayed. You have the possibility to choose more than one facet. If you activate one or more facets and switch between the diagrams list and dashboard, the filter is still active and only the filtered diagrams are shown in the respective view.

Filtered diagram list: The filtered diagrams list is displayed here.

Filtered dashboard: The filtered dashboard is displayed here.

If you remove all filters or click on the entry diagram again all diagrams will be displayed in the list resp. dashboard again.

Tip

If you have user rights Reviewer or higher, you can use the additional filter facet diagram views.

How can I search for diagrams?

You have the possibility to search for diagrams by using the search function in the diagram list. The search will look for coincides in the diagram titles as well as the attributes of the diagrams. The search results may also include access-restricted diagrams that you cannot open.

Click on the Search diagram list field in the Filter panel. Enter the search term and confirm by pressing the Enter key or clicking on the magnifier glass.

The screenshot shows the "Search" button in the filter panel.

You will then see all the search results that contain the specific term.

If there are no matching diagrams for your search term, the main area will show a corresponding hint as well as the button Toggle language & search again. You can select this button to set the alternative language as your content language and restart the search in this new content language.

If you want to display your entire diagram list again, click Clear search next to the magnifier glass icon to reset your list.

The screenshot shows the "Clear search" button.

Hint

Here you can find an overview of the different options you have for search terms.

Bulk Edit

If you want to edit the same type of attributes in multiple diagrams as an administrator or editor, you can do so using the Bulk Edit feature. To do this, go to the Options of the diagram view while being in the Public Workspace and select Bulk Edit.

The screenshot shows the "Bulk Edit" option in the diagram view options.

Subsequently, you will enter the Bulk Edit mode for the respective category in which you are currently located. All (filtered) diagrams within the category will be displayed to you in a list view. Select the diagrams you want to edit, and click on Start bulk edit.

The screenshot shows the "Start Bulk Edit" option after diagrams have been selected in bulk edit mode.

This will open a dialog window where you first need to choose the attribute type you want to edit. Once you have selected an attribute type, you can set the action to replace the attribute value. Enter the new attribute value and choose what it should be replaced with.

The screenshot shows the dialog window for bulk editing.

Click on Update to apply the changes, or on Cancel to discard any changes.

Once you click on Update, a confirmation window will appear. Enter the corresponding confirmation term to confirm the bulk edit.

The screenshot shows the confirmation window for updating the bulk edit.

If the corresponding attribute values in the selected diagrams are updated successfully, you will receive a success message. Otherwise, an error message will appear.

Which alternative views on diagrams are available?

When you open a diagram, you first go to the diagram view. Here the diagram name is always displayed in the headline and the diagram version of the current stage is presented.

The screenshot shows a diagram in diagram view and the buttons to switch to the other views.

In addition to the diagram view, you can view the matrix (1) and the process execution (2) here for the diagram types “Collaboration diagram (BPMN)” und “Process (EPC)”. The matrix is also available for the “Process overview (VCD)”. All these alternative diagram views refer to the same diagram version. Depending on the current view of the diagram, you have different options, which you can find in the sidebar on the right.

The different diagram views and their options are explained in more detail in the following chapters.

Diagram view

How do I get to the diagram view?

This view is initially set if you have opened a diagram and presents the diagram version of the selected stage. The graphical representation of the diagram is always svg-based.

If the diagram view is not opened, you can display it by clicking on Diagram view.

Here the "Diagram" button is displayed in the menu bar.

Note

The graphical diagram view offers you an easy handling over the left mouse button, known from Google Maps.

How can I view the properties in the diagram view?

In the diagram view, the hub on the right shows the Properties of the diagram by default. If they are not displayed, open the right sidebar if necessary and switch to the Properties.

The screenshot shows the properties in the diagram view.

When you select a symbol in the diagram, the properties associated with the symbol are displayed. If you deselect a symbol by clicking on an empty space in the diagram, you see the diagram properties again. Optionally, you can right-click on a symbol and select the entry Show attributes of the appearing context menu to display the properties of the currently selected symbol.

The screenshot shows the properties of a symbol in the diagram view.

You can find an explanation of which contents are displayed to you as properties in the corresponding chapter.

Which options do I have in the diagram view?

To display the options of the diagram view, click on Options in the right hub.

Here the options of the diagram view are displayed.

The following options are now available for diagrams or symbols and the corresponding chapters are linked for further explanation:

Once you have opened one of these options, you can use the back arrow in the sidebar to navigate back to the main options menu.

Tip

If a symbol has an attachment, you can also display it by double-clicking on the symbol.

Matrix

How do I get to the matrix?

You only have the option to display the matrix, if you have opened a VCD, EPC or BPMN diagram in the repository. Then click the Matrix view button.

Here, the "Matrix" button appears in the menu bar.

Depending on the process flow (BPMN and EPC), or depending on the location on the diagram (VCD), the matrix displays all the activities of a diagram in rows. All actors, such as roles and responsible applications (e.g. pools), form the columns in alphabetical order. In the matrix cells, the association type between the activity and the resource is displayed (R-Responsible, I-Informed, C-Consulted, A-Accountable). The following columns are about inputs, outputs, applications and risks of the diagram. The objects associated with an activity are then listed alphabetically as chips in the corresponding field. If an attachment exists for an object, the chip contains a paper clip symbol. By clicking on this paper clip, attachments can be accessed directly. See the profile for a more detailed description.

The screenshot shows the RACI matrix.

Note

The matrix is not available in the mobile view.

How can I view the properties in the matrix?

In the matrix, the hub on the right shows the Properties of the diagram by default. If they are not displayed, open the right sidebar if necessary and switch to the properties.

The screenshot shows the properties of the diagram in the matrix view.

By clicking on activities or chips of the matrix, the associated properties are automatically displayed in the options. This selection can be deselected in the desktop version by clicking again, so that you now see the properties of the diagram.

You can find an explanation of which contents are displayed to you as properties in the corresponding chapter.

Which options do I have for the matrix?

To display the options of the matrix, click on Options in the right hub.

The screenshot shows the options of the diagram in the matrix view.

The following options are now available and the corresponding chapters are linked for further explanation:

Once you have opened one of these options, you can use the back arrow to navigate back to the main options menu.

How do I filter the matrix?

Looking at your diagram in the matrix view you can use the filter option. If you click on filter, the column headers of the matrix are shown as filtering options. An eye icon on the left side of a column header displays its visibility. Every column is visible initially.

The screenshot shows a matrix and the columns as filter options.

You can deselect a column of your matrix by clicking on the corresponding header. The column is not visible anymore and the header as well as the now crossed out eye icon are greyed out.

The screenshot shows a filtered matrix that does not contain all columns.

Another click on the column header enables the visibility again. If you navigate back to the main options menu using the back arrow, the filter is reset. All columns are displayed again.

Process execution

How do I get to the process execution?

You only have the option to display the process execution view, if you have opened an EPC or BPMN diagram in the repository. Then click the Process Execution button.

Here the "Process execution" button is displayed in the menu bar.

Based on your modeling in the Diagram view, you can now see the process execution in the middle of your screen. The activities, decisions and related events are listed here.

The activities represent the individual tasks in the process. Below each activity name, the responsible resource is displayed if it has been modeled in the diagram. When you select an activity, you can use the options to display the properties and thus obtain more information about the task.

The process flow means the sequence of activities and is initially determined by the software for the user. The decisions corresponding to the gateways in the diagram are made based on the probability of the process flow. The most probable process flow is automatically displayed. You can maintain the Probability for each activity in its attributes. If no probability has been maintained, the position of the node is decisive instead. Loops are not considered for automatic decisions. Overall, only the sequence flow forms the basis for the path.

The process flow is thus divided by the decisions into segments or sections, in which successive activities are placed. The activities are consecutively numbered starting with 1. The segments displayed depend on the decisions made. Each segment has its own background color for the activity numbers. The respective segment can also be identified by its heading, which includes the name of the gateway and the sequence of the selected path in the process. If a gateway was not named there, only the name of the sequence is displayed. If the sequence also has no name, you will see the name of the subsequent activity at this point. In front of the heading, the route icon belonging to the segment will always be shown. On the right of the headline you will see the Change decision button with which you can decide on your own and thus influence the following tasks. This is how a gateway can be noticed in the process flow, whereby a distinction is made between the following gateways:

  • Exclusive or: By clicking on Change decision, a menu shows you all possible decisions. Here you can only select one alternative, which adjusts the list of subsequent activities. The section of an “Or” decision ends with the last activity before the next gateway or the end of the process. The background color of the numbering does not change within this segment.

The screenshot shows the possible choices of an "or" gateway in process execution.

  • Inclusive or: In this case, one possible path of the process is initially listed. By clicking on Change decision you can select another path or several paths at the same time. A path then corresponds to a subsegment. Within this segment, the numbering of each subsegment has the same background color in different transparency levels.

  • Parallel: In the case of an “And” gateway, all parallel paths of the process are listed one below the other, since all paths are executed. One path corresponds to one subsegment. Within this segment, the numbers of each subsegment have the same background color in different levels of transparency. Nevertheless, a decision can be made here by clicking on Change decision to highlight individual segments.

The screenshot shows the possible choices of an "Parallel" gateway in process execution.

Note

Multiple starting points for the path are also displayed as an exclusive gateway above all activities.

Overall, the numbering is continuous across all segments and subsegments. The end of the process flow is marked by the corresponding event and by a flag instead of a number. If there is no end event but an activity at the end of the process, the end is inserted virtually and named accordingly, as shown below.

This screenshot shows the process end in the process execution.

Further options to work with the process execution are described in the following chapter.

How can I perform process execution tasks?

To obtain an overview of the progress of a running process instance, you can mark the individual activities as completed in the process execution. This is only visible to you.

Navigate to the Process execution of the desired BPMN or EPC diagram. There you can see the activities to be executed and make decisions at gateways. For a detailed description please refer to the associated chapter.

The click on the number of an activity is displayed here.

If you have completed a task, you can mark it by clicking on the number in the corresponding activity. There you will then see a check mark for the status “Done”.

Here the task is displayed with the status "Done".

The tasks can be marked as completed in any order. To reset the status of the tasks, for example, after a complete run of the process, navigate to the Options and choose Reset process flow.

This screenshot shows the context menu with the entry "Reset".

In addition, when a decision is changed in the process, the status of all subsequent and possibly already completed tasks is reset.

Tip

For an optimal work with process execution and extensive functionalities in dealing with process instances we refer to our product BIC Process Execution!

How can I display the properties in the process execution?

In the matrix, the hub on the right shows the Properties of the diagram by default. If they are not displayed, open the right sidebar if necessary and switch to the Properties.

The screenshot shows the properties of the diagram in the process execution view.

When you select a task in the process execution, the properties associated with the task are displayed.

You can find an explanation of which contents are displayed to you as properties in the corresponding chapter.

What options do I have for the process execution?

To display the process execution options, open the right sidebar if necessary and click on the Options button.

The screenshot shows the options of the diagram in the process execution view.

The following options are now available and the corresponding chapters are linked for further explanation:

Once you have opened one of these options, you can use the back arrow to navigate back to the main options menu.

Options in a diagram

When you open a diagram, more Options are displayed by default in the hub on the right. A selected view in this bar remains in the desktop version after reloading. You can also Collapse and again Expand the sidebar. To do this, click on the button having the same name in the desktop version, which is located in the middle of the right edge of the screen. This setting is stored in your account, which means the hub will always remain closed or opened until you change it manually. This applies to any view changes, such as diagram switching or switching to Matrix or Process Execution.

The screenshot shows collapse option of the right sidebar.

In the mobile view, you will instead find the 3-point context menu in the top right corner of the screen to display the options. The options are collapsed here by default. When you display them, they are located at the bottom of the screen, partially covering the main area of the screen and are therefore in focus.

The screenshot shows the options in the mobile Version.

The options depend on the current view of the diagram. To find out which options are available in your open view and where you can see them, navigate to the corresponding chapter for the diagram view, matrix or process execution.

What is displayed in the diagram as attachments?

You have already navigated to the Options of a diagram in the hub on the right. There you can open the Attachments.

The screenshot shows the attachment option.

The attachments are divided into two different sections: Files and links. Both sections can be expanded and collapsed. In addition, the number of attachments listed is shown in the section header on the right.

The screenshot shows attachments of the diagram in the options.

The Files list all files added to the diagram alphabetically, using the diagram or object attribute named Attachment (URL). For each list entry, you will see the title, if this has been assigned, or the name of the file instead. Below the title, the associated object in the diagram or the diagram itself, if the attachment is part of the diagram attributes, is named. For each entry you will also see a chip, which either displays the default file icon or highlights special file types, such as pdf and office files, for easier differentiation. With a click on a list entry you can download the corresponding file directly.

The Links list all URLs added to the diagram alphabetically via the diagram or object attribute named Attachment (URL). For each list entry, the title of the attachment, if this has been assigned, or the URL is displayed here. The URL is also displayed below. With a click on a list entry the URL is opened automatically.

Attachments can also be displayed or accessed via chips in the profile or in the matrix view.

How can I view the occurrences of symbols in checked in diagrams?

If you have opened a checked in diagram and want to display the occurrences of a symbol, proceed as follows.

First select the desired symbol in the main area. Then, in the right side bar, select the entry Occurrences.

The screenshot shows the option "Occurrences" within the right side bar.

A list will be displayed within the right side bar, which contains an entry for every use of the given object.

By clicking on a list entry, you can then navigate to another diagram in which the object is reused, or display the occurrences in the current diagram.

Tip

You can also access occurrences of symbols in checked out diagrams. You can find more information towards this here.

How can I get a full list of occurrences in the diagram options?

Panel for new occurrences

When you open the occurrences view of a diagram, a list of one or more panels appear displaying the connections of the selected entity to other catalog or diagram entities. Each list entry includes numbers representing the count of sub-entries.

Panel for occurrences in catalog items

When the selected entity is assigned to another catalog entry, a sub-entry with the name of the respective catalog entry is displayed as the title. The subtitle contains the name of the associated attribute type, while the icon identifies the entity type.

Panel for occurrences in diagrams

When the selected entity is used in another diagram as a diagram attribute, a subordinate list entry appears with the name of the relevant diagram as the title. The subtitle displays the associated attribute type name, and the icon represents the general diagram icon.

If the selected entity has an association with another entity in this diagram, a subordinate list entry appears with the name of the relevant entity as the title. The subtitle indicates the name of the associated entity type, and the icon displays an abbreviation of the association type.

If the selected entity is used in this diagram but has no association with another entity, a subordinate list entry appears with the entity’s name as the title. The icon displays a generic symbol to indicate that there is no association with another entity.

How can I comment on a diagram?

The Comments of a diagram are available in the Options for every diagram view.

The screenshot shows the option "comments" in the options menu.

By clicking on the Comment entry, the comment bar opens on the right-hand side. In the comment bar you can now see comments on the diagram on top - if already submitted. If comments on objects of the diagram are existing, they are grouped below.

The screenshot shows the input field containing a new comment and also the button "Add comment".

Click on the field Enter comment to diagram to write a new comment. Your comment will appear in the comment bar after you confirmed by clicking the Add comment button. Each comment is displayed with the information about the submission date and the name of the commentator as a chip.

Alternatively, you can also add a comment to the diagram via the context menu. This appears by a right-click in a free space of the diagram.

The screenshot shows the context menu of a diagram opened at free space of the diagram. There is the entry "Add comment" in the context menu.

Choose the entry Add comment to enter and add a comment by a click on the equivalent button.

The dialog window with a new comment and the button "Add" is displayed here.

Some users receive an e-mail notification of the new comment. This is described for each stage in the following:

  • Public Workspace: A notification is sent to the Author and to users involved in the conversation.

  • Preview: A notification is sent to the Examiner and to users involved in the conversation.

  • Publication: A notification is sent to the user or user group mentioned in the attribute Responsible and to users involved in the conversation.

Note

Please note that you do not receive notifications about your own comments.

Note

Comments depend on the area. This is caused by different work states and versions in each area. For example, users in the publication cannot see comments from the public workspace.

You can edit or delete a comment by a click on the desired entry in the context menu of your comment.

The context menu of a comment is displayed here.

Warning

Deleting comments is done immediately when you select the function. You will not be asked for confirmation again.

Note

Administrators and Editors are able to edit or delete all comments. All other user roles can use these features only for their own comments.

How can I comment on an object?

Objects can be commented independently in each version of a diagram. These comments are not diagram overlapping.

Right-click on the object you want to comment on. Select Add comment in the context menu.

The option "Add comment" in the context menu of an object is shown here.

A dialog window opens. Here you can Add a comment in the equivalent field and confirm by a clicking the Add button.

The screenshot the dialog window for an object comment with the button "Add".

If you do not want to submit the comment, cancel the process with a click on the equivalent button or outside the dialog window. Alternatively, you can use the ESC key.

After you confirmed the process, your comment is visible in the comment bar for all users who have access to the stage. You can look at the comment bar by selecting the entry Comments in the options. If a comment has been submitted for an object, the name of the object appears in the bar and you can view it by a click on the name.

The screenshot shows a diagram where the comment bar is opened. In the comment bar, the comment group of an object is opened.

In case an object has already been commented, you can alternatively enter a comment in the corresponding field. Confirm the input by a click on Add comment.

The screenshot shows how to add a comment to an object in the comment bar.

Some users receive an e-mail notification of the new comment. This is described for each stage in the following:

  • Public Workspace: A notification is sent to the Author of the diagram and to users involved in the conversation.

  • Preview: A notification is sent to the Examiner of the diagram and to users involved in the conversation.

  • Publication: A notification is sent to the user or user group mentioned in the attribute Responsible of the diagram and to users involved in the conversation.

Note

Please note that you do not receive notifications about your own comments.

Note

Comments depend on the stage. This is caused by different work states and versions in each stage. For example, users in the publication can not see comments from the public workspace.

Each user can edit and delete his own comments. Furthermore, administrators can also make these changes to all existing comments.

Open the comments via the options. Navigate to the comment you want to edit or delete by clicking on the list entry of the corresponding object.

This screenshot displays a collapsed comment group of an object.

In the context menu you have the option to Edit or Delete the comment.

The screenshot shows an object comment and the related context menu with the options "Edit" and "Delete".

The editing needs to be saved to apply the changes.

Warning

The deletion of comments is executed right after you click this option in the context menu. You will not be asked for further confirmation.

How can I highlight an object with a comment to indicate its position in the diagram?

When you open the comment panel of a diagram, and there is at least one comment for an object, you can view all comments made for that object under its name. In this context, you have the option to highlight the corresponding object with the selected comment directly in the diagram.

The screenshot shows you the "Select in diagram" button to navigate to the corresponding object in the diagram.

The object with the selected comment will then be highlighted in the diagram view.

Note

Please note that the selection of an object with its corresponding comment will be removed once you leave the comment panel, close the comment field of the selected object, choose another comment of an object, or the last comment of an object is deleted.

How can I track the changes in a diagram?

In the diagram view, you can display the changes in the diagram compared to its other versions. In the public workspace, this option gives you an insight on the changes that have been made in the diagram by the other modelers. If you view the changes of a diagram in preview or publication stage, you will notice what has been changed in the latest releases of the diagram.

To view the changes, switch to the Options tab in the right side bar and select the entry Changes. There exists no previous versions of the diagram, if this entry is deactivated.

The selection of the option "changes" is displayed here.

For a detailed insight of changes in a diagram, you can go to the chapter Model comparison.

How can I print the graphic of a diagram?

To print the graphic of a diagram, navigate to the Options and select the option Print.

The screenshot shows the option "print" in the options menu.

You will be shown a print preview with default settings, which can be customized if needed.

The choice of the output format is made through the dropdown menu, where you can set the preferred format for the graphic printing. You have the option to select from the formats PDF, PNG, JPEG, and SVG.

The screenshot shows the various options for print formats.

Furthermore, you can modify additional pre-settings in the print menu and customize the printing as desired:

  • Paper format (A0, A1, A2, A3, A4, A5, B3, B4, B5, LEGAL, LETTER)

  • Orientation (Landscape, Portrait, Automatic)

  • Margins (positive integers)

  • Resolution (only PNG and JPEG)

  • Include header and footer (only PDF)

  • Print in black and white

The screenshot shows the settings options and the "Print" button in the print preview.

After configuring your print settings, click on Print and your graphic will be rendered. You will be notified with a message in the bottom right corner.

Once the rendering process is complete, a download link will be provided for you. Clicking on the link will initiate the download of a file with the diagram’s name in your current content language.

The screenshot shows a notification message that informs the user about the rendering process.

Hint

Please note that texts in the supported languages Arabic, Chinese, Greek, Hindi, Japanese, Korean, Persian, Thai, and Vietnamese may not be displayed correctly in the printed PDF document. For Greek and Vietnamese text, the Roboto font is used, while for all other listed languages the Noto Sans font is displayed. Additionally, please note that Cyrillic text may not be accurately rendered in the fonts Handlee, Inconsolata, and Titillium Web and in such cases, it will be displayed in the Ubuntu font.

How can I make diagrams and their entities available in other languages?

In the diagram view, as an administrator, editor, or assigned author, you have the option to translate diagrams and their entities into other languages that are supported by BIC. To do this, navigate to the Options panel in the public workspace and select the option Translation mode.

The screenshot shows the option "Translation mode".

If the diagram is locked, you will receive a corresponding notification as soon as you hover over the option.

After opening the translation mode, you will have access to a list of all entities used in the diagram. Additionally, you can translate the diagram so that it is displayed in the respective languages in the diagram list.

By clicking on the desired entry, you can translate the name, description, keywords and attachments (URL).

The screenshot shows the list of all diagram attributes that are permissible for translation.

Assuming the DeepL function has been activated for a user, and corresponding credentials have been saved.

When you open the translation mode in a diagram, translation options are available for each localized text attribute and localized HTML attribute in each language. These options include entries for the attributes Name, Description, and Keywords.

Hint

Please note that the localized text attribute/localized HTML attribute of the active content language serves as the source language for the translation and the option Request translation is not available for this attribute.

In translation mode, the option Request translation is automatically deactivated if an input field already contains an input. Conversely, the option is automatically activated if an existing value of a target attribute is removed.

If you want to request a translation for a localized text attribute/localized HTML attribute, select the option Request translation in a target attribute. This will result in a request being sent to the DeepL API, which will automatically generate translation suggestions. Once the request has been sent to the DeepL API, the translation suggestion is displayed in the input field of the target attribute. If the API response is incorrect, an error toast is displayed.

Note

If you see the option Request translation and hover the mouse pointer over it, you will receive corresponding information depending on the activation or deactivation status.

To save the translations, click on Save changes. Otherwise, you can discard the changes.

The screenshots shows the option "Save changes" in the translation mode.

Note

You will be notified of unsaved changes in the respective entry.