Dragon1 Charts and Maps (JSON API)

Dragon1 Charts and Maps (with Javascript and JSON) is a new feature on Dragon1. You can create or generate a .dragon1 file and upload it to the new viewer. This is a quick and easy way for Enterprise Architecture and Data Visualization.

How does it Work?

Go to a Charts & Maps demo page at www.dragon1.com/demo.
Next download a .dragon1 file (it has a JSON internal structure).
Next open Notepad and the .dragon1 file, or you generate a JSON file from a software system in your company and rename it to .dragon1.

Now use the blue button to upload your .dragon1 file on the demo page, and see directly the result. Or you upload the file in the new viewer

This new Dragon1 technology supports you in having to focus only on the quality data and have more time to spend with stakeholders exploring and collecting data (entities and their attributes).

Minimum .dragon1 File

The following JSON placed in a .dragon1 file and uploaded in the viewer on Dragon1, will generate a visualization.

[{ "class": "Visualization",
"id": "100",
"name": "Dragon1 Charts & Maps Demo",
"title": "Digital Transformation with Smart and Fast Decisions",
"subtitle": "Dragon1 Charts & Maps Demo",
"team": "The Archi Team",
"logo": "https://www.dragon1.com/images/dragon1-logo-example.png",
"template": "Front_Page",
"keyword":"INNOVATION",
"date":"14 November 2019",
"backgroundimage":
"https://www.dragon1.com/images/renewable-energy.jpg",
"backgroundcolor": "darkgreen",
"backgroundopacity": "0.7",
"animatedlink": {"linkname":"Process Application Landscape",
"linkurl":"https://www.dragon1.com/demo/process-application-landscape"},
"layout": "NONE",
"relationships":"hidden",
"pageformat":"A0"
}]


Optionally you can specify one or more modelids or viewids in the visualization:

...
"models": [{"modelid":"1"},{"modelid":"2"},... ],
"views": [{"viewid":"1"},{"viewid":"2"},... ],
...


Download an example frontpage.dragon1 file.

Templates and Layouts

With Dragon1 Charts & Maps you can focus on getting the correct data and then choose a template and layoutto get your data generated. Below you see how you specify them:

...
"template": "Process_Application_Landscape_Map",
"layout": "L3_C4_C2_C3",
...

The templates have many configuration option to tailer them to your likeness. At the bottom of this page is a list of available Templates and Layouts.

Showing Entities on the Dragon1 Architecture Canvas

[{ "class": "Visualization",
"id": "108",
"name": "Process Application Landscape",
"title": "Process Application Landscape",
"team": "The Archi Team",
"logo": "https://www.dragon1.com/images/dragon1-logo-example.png",
"icons": "Dragon1",
"template": "Process_Application_Landscape_Map",
"layout": "C5_L01_L03_L02_L04_L01",
"blocks": { "label1": "Architecture Concepts", "label2": "Business Processes", "label3": "Applications" }
},
{ "class": "Application",
"type": "Business",
"name": "MyCRM (Sales)",
"id": "02",
"domain": "02",
"vendor": "Microsoft",
"platform": "Win32",
"criticality": "Mission Critical",
"startdate": "01 mar 2010",
"enddate": "01 jun 2018",
"contractenddate": "01 11 2019",
"annualcost": "40.000 USD",
"link": "https://www.dragon1.com/images/customer-journey-map-1.png"
}]

Download an example entity-on-canvas.dragon1 file.

Note: if no View and Model are specified in the file, all data in the file will be used for the visualization. If an entity has no model specified or no group, the entity will not be visible in a visualization.


An Atlas with Folders and Pages

It is optional to work with a folder structure. A folder can hold pages. a page is a link to a visualization, meta model, model, view or entity.

You can add folders and pagelinks:


...
{ "class": "Atlas", "id":"0", "name": "EA Design Book" },
{ "class": "Folder", "id":"0", "name": "Strategy" },
{ "class": "Folder", "id":"1", "name": "Architecture"},
{ "class": "Folder", "id": "2", "name": "Transformation" },
{ "class": "Page", "id": "0", "name": "Stakeholders", "folderid": "0", "visualizationid":"1" },
{ "class": "Page", "id":"1", "name": "Business Model", "folderid":"0", "visualizationid":"2"},
{ "class": "Page", "id":"2", "name": "Application Landscape",
"folderid":"1", "visualizationid":"3"} { "class": "Page", "id":"3", "name": "Enterprise Model",
"folderid":"1", "modelid":"1"} { "class": "Page", "id":"4", "name": "Enterprise Architecture Meta Model",
"folderid":"1", "metamodelid":"1"} { "class": "Page", "id":"5", "name": "Financial View",
"folderid":"1", "viewid":"1"} { "class": "Page", "id":"6", "name": "Stakeholder 1",
"folderid":"1", "entityclass":"stakeholder", "entityid":"1"}
...


Specifying Models

You can specify models:


...
{ "class": "Model",
"id": "01",
"name": "Enterprise Model",
"owner": "Mrs. Vanderbilt"
},
...

If you want to visualize a model directly, you could specify a layout and template to override the default layout and template.

Specifying Views

You can specify views:


...
{ "class": "View",
"id": "01",
"name": "Financial View",
"owner": "Mrs. Vanderbilt",
"modelid": "1",
},
...

If you want to visualize a model directly, you could specify a layout and template to override the default layout and template.

Specifying Relationships

You can specify relationships:

...
{ "class": "Relationship",
"id": "00",
"modelid": "01",
"sourceclass": "Stakeholder",
"sourceid": "04",
"targetclass": "Process",
"targetid": "03",
"type": "Association",
"text": "is owner of",
"attribute": "owner"
},
...

About Layouts

In any visualization you can specify a layout, like this:

"layout": "C5_L01_L03_L02_L04_L01",
...

This layout specification would generate 5 columns from left to right where column 1 has 1 layer, column2 has 3 layers, column 3 has 2 layers, column 4 has 4 layers and column 5 has 1 layer.

The example screenshot of a Business Capability Heat Map below has specified the following layout: "layout": "L04_C01_C04_C03_C01"

Download the example file:business-capability-heat-map.dragon1 here.

If you start the layout string with L, Dragon1 will generate a layered layout. If you start with C, Dragon1 will generate a column based layout. You can specify up to 12 layers and/or 12 columns.

You can also specify a border for the layout:
"layoutborder":"LTRB". This will generate left, top right and bottom an extra bar.

You can specify a name for every generated group of the layout like this: "group1":"finance", "group2":"IT". Or you can use your data like this: "groups":"function.name". If you have a list of functions, the names of these functions are use for the group names.

List of Templates

  • HTML_CSS
  • Front_Page
  • Basic_Page
  • Application_Landscape
  • Architecture_Framework
  • Process_Application_Landscape
  • Strategy_Map
  • Stakeholder_Onion_Diagram
  • Enterprise_Blueprint
  • Business_Blueprint
  • Technology_Roadmap
  • Principles_Diagram
  • Customer_Journey_Map
  • Capability_Map
  • Functions_Capability_Map
  • Use_Case_Diagram

List of Entity Classes

You can use one of the following entity classes.

  1. Stakeholder
  2. Person
  3. Actor
  4. Goal
  5. Objective
  6. Outcome
  7. Target
  8. Requirement
  9. Constraint
  10. Meaning
  1. Framework
  2. Architecture
  3. Concept
  4. Element
  5. Component
  6. Principle
  7. Pattern
  8. Plateau
  9. Gap
  10. Project
  11. Deliverable
  12. System
  13. Unknown
  1. Service
  2. Process
  3. Value
  4. Event
  5. Trigger
  6. Resource
  7. Value
  8. Stream
  9. Path
  10. Plan
  11. Interaction
  12. Collaboration
  13. Function
  14. Activity
  15. Capability
  16. Enterprise
  17. Business
  18. Application
  1. Platform
  2. Database
  3. Protocol
  4. Network
  5. Software
  6. Device
  7. Node
  8. Server
  9. Interface
  10. Connection
  11. Zone
  12. Environment
  13. Network
  1. Client
  2. Domain
  3. Standard
  4. Scenario
  5. Driver
  6. Mission
  7. Vision
  8. Strategy
  9. Assessment
  10. Change
  11. Motivation
  12. Issue
  1. Artifact
  2. Decision
  3. Data
  4. Contract
  5. Organization
  6. Case
  7. Object
  8. Information
  9. Document
  10. Reference
  11. Group
  12. Location
  1. Visualization
  2. View
  3. Model
  4. Metamodel
  5. Relationship
  6. Cabinet
  7. Dossier
  8. Folder
  9. Page

List of Attributes

Every entity class can have its own user defined attributes. The mandatory attributes (per entity class) are:

  • id
  • name
  • class
  • type

Optional attributes are:

  • image
  • name
  • owner
  • startdate
  • enddate

Contact Us with your Feedback

Do you have feedback, questions or suggestions? Please email specs@dragon1.com. Emails normally are be answered within 1 business working day.

SaaS platform for Enterprise Architecture. The best option a CIO has for Technology Innovation and Digital Transformation.

© 2019 Dragon1