Hands-On Tutorial

To try out DMX you have 2 possibilities: one is easy and immediate, the other is easy:

  • Visit the DMX Demo Installation and play with it. You can explore and search. To edit or create anything you need to login. See the information there.
  • Install and run DMX on your computer. See Installation.

Create a topic

Right-click somewhere into the Topicmap. A dialog appears that lets you search all your content. This is the Search/Create Dialog.


DMX makes sure that you do not create anything that already exists. That’s why you enter whatever you want to create into the search field. Let’s assume you want to enter all persons and organizations involved in a project. Enter a person’s first name. DMX will answer “No match”. Select “Person” in the “Create” section on the right from the Topic Type menu and click “Create”.


You will see a rectangle appear on the Topicmap. It represents a person with the name you just entered and it states that this is the person’s first name.


If you enter a person’s given name and surname into the Search/Create Dialog, DMX interprets both as first name: The result would look like this:


To correct it long-press the rectangle and select “edit” from the context menu. On the right-hand side the detail panel shows up.


While you edit, the detail panel shows all fields you might need to describe a person. Correct the first name and click the “Save” button at the very bottom.

Add a second topic: Right-click on the empty background, enter e.g. “Notes for the interview” into the dialog, select the topic type “Note” and click “Create”.


Add another topic, e.g. “Organization No. 1”. Select “Organization” from the list of topic types and press “Create”.


This is just a short walkthrough to help you create your first topics in DMX. Content Authoring is described in-depth in the DMX User Guide. The next section is about the relations between the topics.

Create an association

To create an association between two topics you grab the little dot at the upper border of one of the two topics. If the dot is not visible, hover over the topic with your mouse. In this example the note shall be related to the person “Cathy Jones”.


Drag it onto the other topic until the topic is highlighted by a blue border.


Then drop the association on the “Notes for the interview” item and release your mouse button.

The association will be created and a rectangle appears. These are the in-map details of the newly created association. They tell you that this is association is of type “Association” which is the most generic form of association in DMX. Click somewhere onto the Topicmap to close the in-map details of the association.

The toolbar

Always visible at the Webclient’s top is the toolbar:

Tool bar with workspace and topicmap selection
  • In the upper right corner there is a “Login” button. Log in with the user name “admin” and no password.
  • In the upper left corner there is the Workspace selector. You can use this to switch between Workspaces. By default the “DMX” Workspace is selected.
  • Next to it there is another drop-down menu. This is the Topicmap selector. By default it shows a Topicmap called “untitled”.

Both drop-down menus have a context information button “i” next to them. Click it to reveal detail about the selected Topicmap or Workspace.

For more information visit our detailed guide to the user interface.

A glimpse into information management

DMX comes with some predefined topic types that you saw in the topic type menu of the Search/Create dialog:

  • Person
  • Organization
  • Note
  • Event
  • Bookmark

There are also some predefined association types. One of those association types is called “Organizational Involvement” and it describes the role a person can have in an organization.

To specify the person’s role in the organization, create an association from “Cathy Jones” to the “Organization No. 1”. The in-map details show up again. DMX automatically created an association of type “Organizational Involvement”.


Right-click onto the association to open the context menu and select “Edit”.


The detail panel opens again and displays a form. You can now select an “Organizational Role” from a predefined set of possible values, e.g. “Member”.


For your changes to take effect click “Save”.


Now this is a meaningful association. If you right-click and select “Related” on “Organization No. 1” you see how the role can be useful when navigating in DMX. If you have entered more than one person, you can scroll down in the detail panel to see all persons and their respective roles in the organization.


In this short tutorial, we showed how to create topics and how to work with associations. In DMX you are free to define your own topic types and association types. Find out more about it in the section about Modeling.