Insert an Entity (via the Architecture Repository)

On Dragon1, the user can insert entities into a cabinet. A cabinet is a logical repository that is stored in the Dragon1 database. An entity is a piece of data.

You can use the Architecture Repository to insert an entity. Choose the menu item 'Insert Archifact' or 'Insert Entity' on the menubar, and click the class of entity you need in the dialog. Next, you fill in the entities details in the Add New dialog, click OK and you have your entity inserted.

You can also use the Visual Designer and the Data Dashboard to insert an entity.

What is an entity? - An entity is something that has its own identity. It is identifiable in a context. A person, a process, an application, an architecture, a concept and principle, all are entities.

Entities can only reside in folders. Folders can only resides in Dossiers and Sub Folders. Dossiers can only reside in Cabinets.

What is an archifact? - An archifact is an architectural archifact, a specialized entity in the field of architecture. Principles, Concepts, Plateaus, Views, Viewpoints, etc.. are examples of archifacts.

Archifacts and entities are stored in folders.


Follow the steps below to insert your entity:

The steps for inserting an entity

  1. Startup the Architecture Repository Web Application (fig 1.)
  2. Open a Cabinet or Create a new Cabinet
  3. Select a folder in a dossier
  4. Click insert archifact or insert entity (fig 1.) on the menubar. (Archifacts are specialized architectural entities).
    1. If you click on the top button you first get a dialog box offering you the selection of all available entity classes in the tool.
    2. If you click on a submenu item in the drop-down menu the New Edit Dialog immediately appears (fig 2.)
  5. Enter at least the name of the entity (fig 2.). Later on, you can edit the name of the entity anytime if necessary.
  6. Click OK
  7. Select the add item in the treeview
  8. In the form, you can enter more attributes, like a title, reference, description, bitmap url, etc... (fig 3.)
  9. Click Update
  10. Now you see your entity updated in the tree view within the folder you selected. (fig 4.) (To see all the created information you may need to refresh the screen [F5])

Screenshots to show the steps:

dragon1 insert archifact dropdown menu selected

Figure 1. - Screenshot of the Architecture Repository web application with the 'Insert Archifact'-dropdown menu selected.

dragon1 add new dialog entities

Figure 2. - Screenshot of the Add New Dialog for entities after clicking on the 'Insert Function' submenu item in the 'Insert Archifact' drop-down menu.

dragon1 selected entity form

Figure 3. - Screenshot of a selected Entity Form after filling in a bitmap image url. In this case, the picture was uploaded to the sites folder of the account. But the url can be any internet location.

dragon1 added item looked up in search

Figure 4. - Screenshot of the added item looked up in the Search.

Multiple Insert

You can do multiple inserts of entities and archifacts. If you separate the names with ^ like this: sales^procurement^finance in the Name field of the Add New dialog, Dragon1 will insert three entities at once.

View Images in the Search

When you have entered different items, you can view them all in the search.

dragon1 search added items

Figure 5. - Screenshot of several added items looked up in the image view of the Search.

Of course normally you do not have a goldfish in a fishbowl being part of your enterprise architecture, but this example shows the power of using images with your data.