Objects and Associations

Objects and associations are the building blocks of your architectural model. Objects represent assets such as applications, servers, APIs, capabilities, and data entities. Associations define directional relationships between them, building the dependency graph that powers impact analysis and visualisation.

Creating an Object

1. Navigate to the Registry and select the Objects tab.
2. Click Create New Object.
3. Fill in the core fields:
   • Name (required): A descriptive name for the asset
   • Type: The specific type (e.g., Web Application, Database, API)
   • Category: Business, Application, Technology, or Governance
4. Add optional metadata:
   • Description, Business Owner, Technology Owner
   • Lifecycle Status, Criticality, Version
   • Tags, Interface Type
5. Save the object.

Editing an Object

Click any object in the Registry to open its detail pane. From here you can update metadata, view associated relationships, and manage attached source files.

Bulk Import

For loading many objects at once — for example, when seeding a new workspace from a spreadsheet — use the bulk import workflow:

1. From the Registry, click Import.
2. Select a CSV or structured file containing your objects. The expected columns match the core object fields (Name, Type, Category, Description, Lifecycle Status, etc.). See Definitions for the full list of fields and allowed values.
3. Review the import preview, which highlights duplicates and validation errors.
4. Confirm to commit the import. Created objects appear immediately in the Registry with their source set to Import.

Associations can also be imported in bulk by including the source and target object identifiers along with an association label in the import file.

Object Sources

Objects track how they were created:

• Manual: Created directly in the Registry
• Import: Loaded from a bulk import file (CSV or structured upload)
• Document: Extracted from an uploaded file via automation
• URL: Extracted from a web page via automation
• Automation: Generated by an AI-driven job
• Integration: Synced from an external system (e.g., GitHub)

Global Objects

Mark an object as Global to make it visible across all workspaces in your account. This is useful for shared infrastructure or organisation-wide capabilities.

Creating Associations

Associations define directional relationships between two objects. Examples include “Sends Data To”, “Hosted On”, “Depends On”, and “Supports”.

1. Open an object’s detail pane and navigate to the Associations tab.
2. Click Add Relationship.
3. Select the target object and define the Label.

Associations also support interaction type (e.g., REST API, Event-Driven, Shared Database) and description fields, which are typically populated by automations and integrations.

Associations are also visible in the Association Registry, where you can search, filter, and manage all relationships in the workspace.

Deleting Objects

Deleting an object will remove all associations linked to it. This action cannot be undone.

You can delete individual objects from the detail pane, or use bulk selection in the Registry to delete multiple objects at once.