Working with the dictionary

Access rights for the complete dictionary and dictionary categories are set by your workspace administrator. The actions available to you depend on your access rights.

In the dictionary, you can search, view, create, edit, delete, and publish dictionary entries.

  • To open the dictionary, click the Dictionary folder in the navigation tree on the left side of the explorer. The dictionary opens in a new browser tab.

  • To view a dictionary entry, select it. Its full description, a list of attached documents, and a list of diagrams referencing that entry is displayed.

You can navigate the dictionary by using the dictionary categories.

  1. Click the category that you want to display (for example, 'Roles').
  2. Use the alphabet links at the top to navigate to the entry you are looking for faster.

Show where a dictionary entry is used

  • To find out where a specific dictionary entry is referenced in your process landscape, select the entry and click Show usages.

A dialog displays the type and name of the referencing elements, as well as the names of the referencing diagrams.

With Load next, you can view links to the referencing elements to analyze the whole chain of references.

Switch the language

If there are multiple languages activated for your workspace, you can switch between them by clicking the language symbol .

Dictionary entries that have not been translated into the currently selected language are displayed in their default language and marked with a country flag.

Full-text search

You can find specific entries with the full-text search.

Follow these steps:

  1. Enter your search terms in the search field.
  2. Press Enter. The search results are listed. The order indicates the entries' relevance regarding the search. For example, an entry with your search terms in the title ranks higher than one with the terms only in the description.

The activity feed

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

You can expand or collapse the revision feed once you select a dictionary entry. When selecting a revision in the feed, you can trigger the following activities:

  • Restore

    Restores your entry to a previous version. This does not delete revisions, but lets you to switch between them.

  • Publishing

    Makes this revision available in SAP Signavio Process Collaboration Hub. By default, the newest revision is automatically published upon creation.

  • Unpublishing

    Revokes the revision's publication in SAP Signavio Process Collaboration Hub.

    The buttons to publish and unpublish revisions are only active in categories for which Publishing Mode has been set to Manual . See Add custom categories for dictionary entries for details.

Manage dictionary entries

Create new dictionary entries

To create a new dictionary entry, follow these steps:

  1. Click New in the top toolbar. The New Entry dialog opens.
  2. In the New Entry dialog box, add the following information:
Parameter Description
Category A number of attributes can be defined for a dictionary entry. Start with selecting a category for the entry, as the category can affect the custom attributes available for the entry. Read more about the configuration of dictionary categories in section Add custom categories for dictionary entries.

Select a language in the drop-down menu. Attribute values of dictionary entries can be defined in multiple languages. Make sure that the title of the entry is defined in at least one language.

You can link dictionary entries by their name by typing the title of the entry 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 applicationand risk manager as further entries. Users who view the diagram in SAP Signavio Process Collaboration Hub users can navigate to these entries via the established references.

Title(mandatory) Enter the name of the dictionary entry.
Description Enter a short description. You can format this description.
Relevant documents

You can attach documents or link to files.

Documents attached to dictionary items are not updated when the source document is updated. The dictionary item contains the revision that was initially attached.

Class name

This name is not available by default. An administrator must enable it.

The class name is relevant when exporting a DMN diagram to Drools files. When modeling, the standard name of the dictionary entry is always used. Read more in section Add export names to data input objects.

Technical name

This name is not available by default. An administrator must enable it.

The technical name is relevant when exporting a DMN diagram to XML or Drools files. When modeling, the standard name of the dictionary entry is always used. Read more in section Export a DMN diagram as XML and Exporting DMN diagrams as drools rules.

  1. Click Create to save the dictionary entry.

Edit 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 opens.
  2. Edit the dictionary entry.
  3. Click Save.

    If the category of the dictionary term you are trying to edit is set to automatically update when making changes, the diagram elements that refer to this entry are updated automatically. This creates new versions of the diagram. If there are a lot of diagrams affected, it can take up to 30 seconds to save your changes.

Delete dictionary entries

To delete an existing dictionary entry, follow these steps:

  1. Select the dictionary entry you want to delete.
  2. Click the Delete button in the top toolbar. A confirmation dialog lists the affected diagrams.
  3. Click Yes to confirm deletion.

Reference documents

You can reference external documents for a dictionary.

  1. Select a dictionary entry and then click Edit. The Edit entry dialog box opens.
  2. In the attribute Relevant documents, select Add a new document. The dialog Link files/pictures opens.
  3. Select a file from your SAP Signavio Process Manager directories. Alternatively, you can upload a new file or picture from your local file storage or add a link.
  4. Click Add. The selected file is added to the dictionary entry.

    More about external data sources is described in section Creating external data sources.

Publish dictionary entries

The following section applies to dictionary entries that are set to manual publishing mode. By default, dictionary entries are automatically published together with the diagram.

If a dictionary entry was edited without being republished, a warning is displayed when this dictionary entry is used in the editor.

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

To publish a dictionary entry manually, follow these steps:

  1. Select the entry you want to publish.
  2. Open the activity feed at the bottom by clicking Expand.
  3. Click the revision you want to publish in the activity feed.
  4. In the dialog, click Publish. The dictionary entry is published in SAP Signavio Process Collaboration Hub.