Map your IT landscape
How the building blocks fit together
On this page
A few rules hold the map together. They decide what you must fill in, in which order you create things, and why a deletion is sometimes refused. Read this page once before you enter your own data.
The objects and their links
Programs, applications, flows, servers, infrastructures and architecture documents, and where processes and capabilities meet them.
The rules behind the diagram:
- An application belongs to exactly one program. The program is required.
- An application runs on one server at most. You can leave it without a server.
- An application can follow one version of one architecture document (DAT).
- A server sits in one infrastructure at most.
- A flow goes from one application to a different one, and has exactly one flow type. Both applications and the flow type are required.
- Names are unique within an organization for programs, applications, servers, flows and DAT references.
Typologies classify and colour
Typologies are the lists of values your organization shares. They classify elements and give them colours:
- editors (software vendors) and advancement statuses, on applications;
- flow types, on flows. Their colour is the colour of the arrows on the map;
- infrastructures, for servers;
- statuses, on DAT versions;
- process domains, on processes;
- organization roles, next to people.
See Typologies: your reference lists.
Processes and capabilities point to the same applications
Your processes and your capabilities link to the applications you register here. A process step uses applications. A capability is supported by applications. Each link has a relation type: Primary, Supporting or Data source.
That is why one application record serves the map, the processes and the coverage matrix. See Describe a step: RACI, applications and time and Business capabilities.
Build in this order
- Typologies: check the values you need, at least one flow type.
- Programs.
- Servers, with their infrastructures.
- Applications, each in a program and, if you know it, on a server.
- Flows between applications.
DAT references and their versions can come at any time. Create them before your applications if you want to link each application to its document when you create it.
Deleting: what blocks what
UrbaHive never deletes an element that another element still uses. The deletion is refused with "Cannot perform this action: related record does not exist or is in use." Remove or change what uses it first.
An arrow from X to Y means: while an X uses this Y, the Y cannot be deleted.
| You delete | Refused while | Do this first |
|---|---|---|
| A program | it still holds applications | Move its applications to another program, or delete them. |
| An application | a flow starts or ends on it | Delete those flows. |
| A server | an application runs on it | Set each application's Server to another one or to None. |
| A DAT reference | one of its versions is linked to an application | Set the application's DAT to None. Deleting a reference deletes all its versions. |
| A typology value | elements use it | Change those elements. The Usage column of Typologies says how many there are. |
For process domains, the delete icon stays disabled while a process uses the domain. Its tooltip says "Used by one or more processes — remove the link first".
Deleting an application removes, by itself, its links to process steps and to capabilities, and its additional contacts.
Note
Only Owners and Editors delete. A deletion cannot be undone.
Every change is recorded
Each creation, update and deletion of an element or a typology value is written to the audit log. You see it in Logs and in the dashboard's Recent activity. Changes to the definitions of custom fields are not recorded. See Follow changes in the audit log.
Related pages
- Your first steps: the path to a first map.
- Register your applications: the central object.
- Work with lists and windows: create, edit and delete.