Working with the Dictionary

The Dictionary allows you to search, view, create, edit, delete, and publish dictionary entries.

To open the Dictionary, click the corresponding folder in the navigation tree on the left side in the Explorer. The Dictionary opens in a new browser tab.

Open the dictionary via the folder tree on the left of the Explorer.

Open the dictionary via the folder tree on the left of the Explorer.

Select a dictionary entry. Its full description, a list of attached documents and a list of diagrams referencing that entry will be displayed.

Display a dictionary entry.

Display a dictionary entry.

Hint

To add, delete or publish a dictionary entry, you need the corresponding access rights. Workspace administrators can grant users publish, write or delete rights for the Dictionary. Please contact an administrator and ask them for the corresponding rights if you cannot access the option you need. As an administrator, you also have to grant yourself publishing rights if necessary because they are not activated by default. You can learn how to grant dictionary access rights in the chapter Managing access rights.

Switching the language

If there are multiple languages activated for your workspace, it is possible to switch between them by clicking on the language symbol.

Switch the language from German to English.

SThe language is switched from English to German.

Dictionary entries that are not available in the language currently set will be displayed in their default language and marked with a country flag.

The activity feed

Similar to the activity feed in the Signavio Explorer, the dictionary feed allows you to manage revisions.

In the dictionary feed, you can manage revisions of dictionary entries.

In the dictionary feed, you can manage revisions of dictionary entries.

The revision feed opens automatically once you select a dictionary entry. When selecting a revision in the feed, you can trigger the following activities:

  • Restore
With this option you restore an old revesion as current revision, which is identical to the selected one. There won’t be any revisions deleted.
  • Publishing
Will make this revision available in the Collaboration Hub. By default, the newest revision is automatically published upon creation.
  • Unpublishing

Will revoke the revision’s publication in Collaboration Hub.

Hint

The buttons to publish and unpublish revisions will only be active in categories, whose Publishing Mode has been set to Manual. Under Defining custom categories for dictionary entries you find more information.

Managing dictionary entries

Creating new dictionary entries

To create a new dictionary entry, proceed as follows:

  1. Click in the menu bar of the Dictionary on New. The dialog box New entry opens.
Create a new dictionary entry.
  1. In the dialog box that allows you to create a new dictionary entry, make the following configuration:
The dialog to create a new dictionary entry.
Parameter Description
Category A number of possible attributes can be defined for a dictionary entry. Start with selecting a category for the entry, as the category may affect the custom attributes that can be defined for the entry. Read more about the configuration of dictionary categories Defining custom categories for dictionary entries.
Language Select the desired language in the dropdown menu. Attribute values of dictionary entries can be defined in multiple languages. Please make sure that the title of the entry is defined in at least one language. You can link dictionary entries by their name by beginning to type the title of the entry that is supposed to be linked and choosing it from the auto-completion drop-down menu. This is useful if a dictionary entry contains other dictionary entries in its title. For example, the dictionary entry Prepare loan application for check by risk manager can reference loan application and risk manager as further entries. Readers - in especially Collaboration Hub users - can now easily navigate to these entries via the established references.
Title Enter the name of the dictionary entry (manadatory).
Description Enter a short description. You can format this description, as you already know it from common writing programs or the Editor.
Relevant documents To attach documents, edit the attribute Attached documents, as described later in this chapter.
  1. Click Create to save the dictionary entry.

Editing dictionary entries

To edit an existing dictionary entry, follow these steps:

  1. Choose the dictionary entry you want to edit and click Edit. The edit-dialog for dictionary entries appears.
Link to edit a dictionary entry.
  1. Now you can edit the dictionary entry. The functionality resembles the functionality of the creating dictionary entries dialogu (see above: Creating new dictionary entries).
Editing an existing dictionary entry.
  1. Click Save to confirm your modifications.

Hint

If for the category to which the dictionary term is associated, the setting On change, linking diagrams are is set on updated automatically, the diagram elements that refer to this entry are updated automatically. This results in new versions of the diagram. Depending on the number of affected diagrams, this process can take up to 30 seconds. For more information see:Creating a new category.

Deleting dictionary entries

To delete an exisitng dictionary entry, proceed as follows:

  1. Select the dictionary entry you want to delete.
  2. Click the Delete button in the top toolbar. A confirmation dialog opens to inform you about the diagrams that will be affected by the deletion.
Delete a dictionary entry.
  1. Click Yes to confirm deletion, if you would like to abort the deletion, click No.
Confirmation dialog box for deletion.

Referencing documents

You can reference external documents for a dictionary entry while creating or editing it.

  1. Select a dictionary entry and then click Edit. The Edit entry dialog box opens.
Link to edit a dictionary entry.
  1. Scroll to the attribute Relevant documents and select Add a new document. The dialog Link files/ pictures opens.
Reference external documents in a dictionary entry.
  1. Select a file from your Signavio team directory. Alternatively, you can upload a new file/picture from your local file storage.
  2. Click Add. The selected file is added to the dictionary entry.

Important

Please take the notes on referencing documents into account.

Publishing dictionary entries

If a dictionary entry is set to manual publishing mode and has been altered without being republished, an appropriate warning notice will appear, when the dictionary entry is used in the Editor.

If changes in a dictionary entry used during modeling are not published, this warning will be displayed.

If this is the case, make sure that the current dictionary entry is also published when publishing the diagram.

To publish a dictionary entry, proceed as follows:

  1. First select the entry you want to publish.
  2. Open the activity feed at the bottom by clicking Expand.
Opening the activity feed.
  1. Click the desired revision of the dictionary entry in the activity feed. An information dialog box opens.
Publishing a dictionary entry via the activity feed..
  1. Click Publish. The dictionary entry is now published in Collaboration Hub.