Governance Best Practice in Ardoq

Learn how you can use Ardoq to enable effective IT processes that promote your organizations's strategies.

Kristine Marhilevica avatar
Written by Kristine Marhilevica
Updated over a week ago

Having governance as part of your architecture process is critical to ensuring data integrity and continuity. As more data is created and stored within Ardoq, it is critical to maintain the quality of that data. Having accurate and current data ensures the credibility of your insights with stakeholders.

One challenge to overcome this is through the crowdsourcing of data. As contribution opens up to people potentially outside of the core architecture teams this can lead to undesired changes to data within the organization. To help mitigate this issue and maintain data quality and integrity, Ardoq has established some best practices to ensure the right people are keeping the right data up to date.

In addition to what we outline below, having regular meetings with the Admins and super users of Ardoq is crucial to make sure everyone is aligned and knowledgeable about deliverables and responsibilities.

Dynamic and Static Workspaces

The first thing that we need to define is the terminology we use in this best practice document.

Ardoq segments your data for performance and organizational reasons into what we call workspaces. Workspaces can be categorized into two different types:

1. Static Workspace

A static workspace is a workspace that goes relatively unchanged over time. Some examples of this could be:

These are considered static because after the information is created and stored in Ardoq the workspaces are quite stable over time.

2. Dynamic Workspace

A dynamic workspace is a workspace that is constantly changing. These changes could be driven through integration, crowdsourcing, or the core team itself. Some examples of a dynamic workspace:

  • Applications

  • Infrastructure

  • Business Processes

  • Data Catalog

  • People

  • etc.


As you implement Ardoq in your organization, it is important to decide the access and rights different people in your organization should have to your data. Below, you can see some of the common roles that we see interact with Ardoq.

Ardoq roles

As you can see, there are core Ardoq users, contributors, and consumers. Each one of these roles will use and consume Ardoq differently. A CIO might never log into Ardoq core but may instead consume the data through Ardoq Discover viewpoints, dashboards, or a dynamic presentation. An application owner might only update their application information through aSurvey in Ardoq Discover and check on the applications they own through a viewpoint or report. The architecture team may manage the relationship between the application, capability, and process. Once the roles are defined, this will help you determine how people will interact with Ardoq through a number of permissions.

Governance Before Implementation

It is critical to establish how you will handle the governance of Ardoq before it is implemented. Things like a governance process, the meta-model, roles, and responsibilities should all be defined before onboarding takes place so that the onboarding process can cover governance.

Governance Through Process

Now that you have established roles, it is important to define access and ownership. You wouldn’t want a procurement person defining the capabilities of an application both of which they might not know anything about. We can do this by segmenting the roles we have previously defined.

Segmentation of Roles

Any contributors that aren’t part of the core team should not have access to the full workspace, they should only have access to the data that they are responsible for (ex. An application owner should only have access to change and update their applications, this can be handled through the survey module). Core team members should have access to the workspace with edit privileges but only to workspaces that are dynamic.

It is recommended that with static workspaces that only selected users should have edit access to these workspaces and that other core team members should only have read access. A change process should be established for static workspaces that handle the addition, removal, and changes to components and references as well as updates to the meta-model. Identify and assign reviewers that handle requests to changes to static workspaces (business capabilities, location, business structure, etc) and limit write access to those reviewers. This will help control the data and ensure quality.

Governance Through Functionality

  • Privileges: Decide who can utilize certain features in your organization to keep better control of who can access Ardoq Discover, create scenarios, surveys, dashboards, viewpoints, workspaces, and Gremlin queries.

  • Permissions: Governance can be established through Ardoq permissions. Access and modification can be defined at the asset level (e.g. workspace). Users can have read access to a capability workspace but have write access to an application workspace. This allows for more granular access controls without reducing the visibility of content.

  • Fields: Another way to apply governance is by leveraging component metadata. Create a list field called 'Approved' with 'Yes/No' values to flag newly created components that have been or have yet to be approved. You can then use Perspectives to filter out components with 'No' as a value from views, reports or dashboards. Alternatively, review components based on the last time they were updated. Create a 'Review Date' date field and set the date in which the component was updated. Next, create a report or dashboard using the 'Review Date' field and review the components that were last updated since a particular date.

    It is important to note that while the default field “Last updated” might seem relevant, it won’t help as much as data may still be incomplete even though an update has been made. Adding a validation date field ('Approved' or 'Reviewed Date') ensures that the data is 100% accurate at that date.

  • Surveys: Another way to provide governance over your Enterprise Architecture is through the Surveys functionality. Surveys allow you to define the specific components to include, and can limit and restrict responses and changes to predefined components and references. This is good when you need to get information from employees without having to grant them access to the tool itself. You can also set up an Approval Workflow using Broadcasts that will help you route for review each new application submitted via a survey to a domain expert who either approves it to be added to the repository or sends it back to the submitter with comments.

  • Meta Model generator: You can keep an eye on your main workspaces components, fields, and references and how they connect across using this function. It also shows you how complete the field values are across your dataset.

  • Dashboards: Use reports and surveys to build governance dashboards according to your needs. Examples to look for are the use of implicit references, Applications not connected to Capabilities (if that is what you are working on in Ardoq), any component not updated in the last X amount of days.

  • Scenarios: With Scenarios, users can select any part of their architecture and make a copy of it. Scenarios creates a safe space to make changes and design potential futures without affecting the mainline data. Thus, contributing to strong corporate governance.

  • Audit log: Quickly track all changes in your workspaces with Ardoq's Audit log, offering a central view of modifications to components, references, and more. Enjoy clear insights into the "who" and "when" of changes, assess their impact, and revert any action in a single click for optimal data management and control.

  • My Tasks in Ardoq Discover: You can use the My Task functionality when configuring a targeted broadcast to streamline the knowledge-sharing experience for contributors.

  • [Coming Soon!] Survey Response Approvals: Isolate changes made by contributors via surveys until you review them and decide whether to approve or reject them.

Tips On How to Maintain Data Quality in Ardoq

  1. Maintain a minimum data mindset: Only collect and maintain data that is needed to solve specific and defined business objectives.

  2. Ensure data validation with surveys: Use surveys to ensure that data is entered correctly by the broader organisations. Surveys ensure modeling principles are followed.

  3. Monitor data quality regularly: Monitor data quality regularly to identify any errors or inconsistencies and take corrective action. Use Meta Model Generator.

  4. Establish data quality metrics: Establish data quality metrics to measure the accuracy and completeness of data. We have out-of-the-box data quality metrics in all use case guides.

Please reach out to us if you need help with anything or want to discuss different solutions to this.

Did this answer your question?