Create a Roadmap

This tutorial will introduce how to create a roadmap.

In the Workplace Task Board ( /workplace/home), you can find a task list for this tutorial, that supports you in every step you take.

Roadmap Example

This visualization below shows an example of a roadmap (the internal name of this template is Roadmap).

Example of the Dragon1 Roadmap.

A roadmap like this helps you to create and communicate your architecture data with stakeholders more effective and efficient. And also to measure and improve your architecture data and their relationships.

Common Entity classes to use on a Roadmap are:

  • Stakeholders and Actors
  • Goals or Objectives
  • Standards
  • Business Components like Processes and Services
  • Application Components like Applications and Interfaces
  • IT Infrastructure Components like Servers and Clouds
  • Start Date and End Date Events

Steps in the Tutorial, Part I

To create a populated roadmap, you will take the following steps:

  • Create an Atlas and an Atlas page
  • Create a Visualization using the Roadmap template
  • Link the atlas page to the visualization
  • Create a model
  • Enter data such as processes and applications and interfaces
  • Create relationships between the data, building up the model
  • Publish the atlas and visualization to the Viewer to have it commented by stakeholders

In the steps we will use the Collaboration application of Dragon1.

Step 1. - Create an Atlas and atlas page

First we are going to create an atlas.

To create an atlas:

  • Go to the Collaboration application
  • Click the entityclass Atlas
  • Click the Add button to add an Atlas
  • Enter a name in the name field
  • Click the Save button

Step 2. - Create an atlas page

Now we are going to create an atlas page.

To create an atlas page:

  • Go to the Collaboration application
  • Click the entityclass Atlas Page
  • Click the Add button to add an Atlas Page
  • Enter a name in the name field
  • Select a visualization in the Image field
  • Select an Atlas to link this Atlas Page to
  • Set the publication status to published public (so everyone that is logged into the account sees it).
  • Provide a weight to specify the rank in the order of atlas pages
  • If there is already a visualization created, select that visualization here.
  • If you want this atlas page to be shown as folder icon in the atlas, enter Folder in the type field
  • Click the Save button

Step 3. - Create a Visualization

Next we are going to a visualization.

To create a visualization:

  • Go to the Collaboration application
  • Click the entityclass Visualization
  • Click the Add button to add an Visualization
  • Enter a name in the name field
  • Enter a the name in a different language in the title field
  • Select a template: Roadmap
  • Select a Page Size. f.i. A3
  • If you set the visualization as published public it will be shown as a separate visualization next to atlases in the Viewers overview.
  • Add showLanguageButton(Translate) in the Action Script field.
  • Click the Save button

Step 4. - Watch the Visualization in the Viewer

Now we are going to watch the visualization in the viewer.

To watch the visualization in the viewer:

  • Go to the Viewer application
  • Click on the Atlas image
  • Click on the Atlas page in the treeview of the atlas
  • Click on the translate button to toggle between the diagram titles

Step 5. - Create a Model

To create a model:

  • Go to the Collaboration application
  • Click on the entity class Model
  • Add a name for the model
  • Click on Save
  • Go to the Collaboration application
  • Click on the entity class Visualization
  • Select the added model for the visualization (this will cause all the data that is part of the model to be shown on the canvas.
  • Click on Save

Step 6. - Add Applications, Servers and Standards

To create add a process:

  • Go to the Collaboration application
  • Click on the entity class Applications
  • Add a name for the application
  • Click on Save

Repeat this for other data you want to enter

Step 7. - Add Relationships

To create add a relationship:

  • Go to the Collaboration application
  • Click on the entity class Application
  • Select an application
  • Click on Add Relationship
  • Select the added model
  • Select an entity class and an entity instance
  • Click on Save

Repeat this for other data you want to create relationships for.

Step 8. - Watch the End Result

Go to the Viewer application again and watch the end result.

Screenshot of a task board to create and populate a Roadmap.