Skip to main content
All CollectionsHow-tos
How to map from the ServiceNow CSDM to Ardoq Solutions
How to map from the ServiceNow CSDM to Ardoq Solutions

Learn how to map between Ardoq Solution component types and CSDM elements for easier data integration.

James Tomkins avatar
Written by James Tomkins
Updated over a week ago

The Common Service Data Model (CSDM) is the ServiceNow-developed framework recommended for implementing products and applications on the Now Platform.

Fig. 1 - ServiceNow Common Service Data Model (CSDM) 4.0

The ServiceNow Common Service Data Model (CSDM) 4.0

The CSDM has evolved through multiple iterations as ServiceNow expanded beyond the IT Service Management (ITSM) use case. CSDM 4.0 incorporates multiple domains capturing elements involved in the design, build, support, delivery, and management of Technical and Business Services.

Ardoq provides a number of pre-configured, expert-guided approaches to solving key business problems, known as Solutions. These Solutions are supported by an underlying metamodel in the form of assets, workspaces, component types, and reference types that manage the data for the Solutions. Data used within the Solutions may be sourced from, or shared with, ServiceNow, and Ardoq supports an out-of-the-box (OOTB) 2-way integration with ServiceNow enabling simple data movement between the platforms.

However, the Ardoq Solutions metamodel and the CSDM are not identical, and the mapping between them may not be obvious depending on how you have chosen to configure and/or customize your ServiceNow or Ardoq Solution implementations.

This article describes Ardoq’s recommended approach to mapping between Ardoq Solution component types and CSDM elements.

Mapping between ServiceNow CSDM and Ardoq Solutions

Problem Statement

The Ardoq Solutions metamodel and the CSDM have been developed for significantly different purposes. ServiceNow, and therefore the CSDM, is primarily focused on the Operations domain and the management of operational IT services. Ardoq is primarily focused on the Architecture domain and the achievement of strategic business outcomes. There is a level of commonality between these two domains but a mapping between them is required to support data exchange.

Ardoq and ServiceNow commonality

A key area of differentiation between the two models is the relationship between the Application and Server component types. ServiceNow represents separately the Business Application and each deployed runtime component of the application in each deployment environment. Ardoq Solutions, by default, abstract away the individual runtime components in each deployment environment as they are often less relevant in the Architecture domain. Owing to the way this data is structured within ServiceNow this additional set of relationships can present a challenge when importing and exporting data.

The Ardoq Solutions can be grouped according to their dependence on the relationship between the Application and Server component types. The first group of Ardoq Solutions does not have a dependency on this relationship and can be mapped without further amendment. The second group of Ardoq Solutions has a direct dependency on this relationship and additional steps are required.

Group 1 - No dependency on Application to Server relationship

The Ardoq Solutions that fall within this group are:

AIM

Application Integration Management

ALM

Application Lifecycle Management

ARM

Application Risk Management

BCM

Business Capability Modelling

BCR

Business Capability Realization

CM

Cloud Migration

DL

Data Lineage

ITLM

IT Lifecycle Management

OM

Organizational Modeling

S2E

Strategy to Execution

TCM

Technical Capability Modelling and Realization

These Solutions contain a number of component types, not all of which map to the CSDM. The recommended mapping for component types within these Solutions is shown below:

Mapping between CSDM elements and Ardoq component types for Solutions without a dependency on the Application to Server relationship

* These parents can be derived from fields on the CSDM elements if desired

NB. Not all Ardoq reference types are shown above for reasons of clarity.

Group 2 - Dependency on Application to Server relationship

The Ardoq Solutions that fall within this group are:

AH

Application Hosting

AR

Application Rationalization

ITCM

IT Cost Management

TPM

Technology Portfolio Management

These Solutions contain a number of component types, not all of which map to the CSDM. The recommended mapping for component types within these Solutions is shown below:

Mapping between CSDM elements and Ardoq component types for Solutions with a dependency on the Application to Server relationship

NB. Not all Ardoq reference types are shown above for reasons of clarity.

Application Instance Component Types

To successfully map the technology stack within CSDM, we recommend introducing an additional component type, Application Instance, when using data from ServiceNow.

Application Instance - It is necessary to create an additional component type to mirror the Application Service construct within ServiceNow. This component type provides the bridge between the Business Application and the collection of technology resources (CSDM Configuration Items) that make up a particular instance of that application (usually defined by location or environment). We chose to recommend naming this component type 'Application Instance' rather than 'Application Service' because many architects already associate this term with the concept in Archimate notation.

For more information about Application Services within CSDM please see: ServiceNow: Application Services

We do not provide the Application Instance component type by default in Ardoq Solution bundles nor as part of the Application Workspace definitions. Therefore, to use this component to simplify integration between Ardoq and ServiceNow, you will need to create an additional workspace in which to create the component type.

For more information on creating this component type please see Appendix A.

Solution Impacts

The addition of the Application Instance component type will allow the relationship between Application and Server to be established successfully within Ardoq. A description of the additional impacts on affected Ardoq Solutions is provided below.

Application Hosting (AH)

You will need to amend the following Reports if you want to use them within the Solution:

AH - Servers and Services Missing Deployment Environment

Amendment: Adding the Application Instances Workspace to the report

AH DQ - Servers not Realizing any Application

Amendment: Adding the Application Instances Workspace to the report

AH DQ - Servers missing infrastructure references

Amendment: Adding the Application Instances Workspace to the report

AH DQ - Application missing infrastructure references

Amendment: Adding the Application Instances Workspace to the report will identify Applications with Instances but does not guarantee they have associated infrastructure.

All other Solution functionality will perform as expected.

Application Hosting Revised Metamodel

Application Hosting metamodel incorporating the Application Instance component type

Application Rationalization (AR)

No identified impacts.

All Solution functionality should perform as expected.

IT Cost Management (ITCM)

If you are using the IT Cost Management Solution you will need to add the relevant cost management fields to the Application Instance component type and associated ‘Is Supported By’ reference type. This will allow the relevant OpEx and CapEx numbers to be attributed and totalled correctly. For more information see Appendix A.

NB. Do not edit any of the field values for cost directly against Application Instance components. They are present to allow infrastructure costs to be attributed to Applications correctly.

Once configured, all Solution functionality should perform as expected.

IT Cost Management Revised Metamodel

IT Cost Management (ITCM) metamodel incorporating the Application Instance component type

Technology Portfolio Management (TPM)

You will need to amend the following Reports if you want to use them within the Solution:

ITM - Servers not supporting any applications

Amendment: Adding the Application Instances Workspace to the report

All other Solution functionality should perform as expected.

Technology Portfolio Management Revised Metamodel

Technology Portfolio Management (TPM) metamodel incorporating the Application Instance component type

Integration Considerations

The full list of mapped components and ServiceNow table information is provided below:

Ardoq Component Type

CSDM Element

ServiceNow Table

Business Capability

Business Capability

cmdb_ci_business_capability

Application

Business Application

cmdb_ci_business_app

Data Entity

Information Object

cmdb_ci_information_object

Application Instance

Application Service

cmdb_ci_service_auto

Server

Server

cmdb_ci_server

References

cmdb_rel_ci

Identification

To assist with identifying components and making integrations more straightforward it is advised to always bring across the Sys_ID and Class fields from ServiceNow when importing data.

ServiceNow Mastered Data

When importing data that is mastered in ServiceNow into Ardoq component types (Application Instance, Server) it is recommended to make these Managed Workspaces to ensure that data stays synchronized. For more information please see:

Import Configuration - Pre-Filtering Relationships

The ServiceNow cmdb_rel_ci table can be very large as it contains relationships between all of the configuration items within ServiceNow. It is beneficial to undertake pre-filtering to identify only those relationships you wish to import. For example, to limit the relationships to only those between Business Applications and Application Services you can use the pre-filter condition:

parent.sys_class_name=cmdb_ci_business_app^child.sys_class_name=cmdb_ci_service_discovered^ORchild.sys_class_name=cmdb_ci_service_auto

Mapping additional Configuration Items

The guidance above helps to clarify the preferred mechanism for mapping from Applications to Servers when using ServiceNow in accordance with CSDM.

We currently do not provide a recommended approach for mapping additional Configuration Items (CIs) as the use of these within ServiceNow is less consistent. However, from a model expansion perspective there are two basic approaches - to reuse component types, or create custom component types.

You could choose to reuse an existing component type like the Technology Service for items such as the Application CI. Or, you could choose to create custom component types to hold these CIs such as an instance of a Data Store to hold Database Instance CIs.

The reuse of existing Ardoq Solution component types or the introduction of new component types may have unknown impacts on the operation of existing or future Ardoq Solutions. If unsure, it is recommended you consult with Ardoq Professional Services or an Ardoq Partner on how best to do this.

Alternative approaches to mapping additional CSDM Configuration Items

Mapping additional Component Types

This guidance focuses on the clearest and most common mappings between Ardoq component types and CSDM elements. There are other component types that may be mappable to the CSDM but these are not included here for one of the reasons below:

  1. They are data types that are unlikely to be mastered in Ardoq or ServiceNow and are more likely to be sourced from elsewhere, for example, Person (Ardoq) and User (CSDM).

  2. They are not equivalent concepts but may share a degree of similarity or overlap, for example, Technical Capability (Ardoq) and Technical Service (CSDM).

Whilst it is possible to create custom mappings between other Ardoq component types and CSDM elements these mappings are not made explicit here because of the high degree of variability in customer usage. If unsure it is recommended you consult with Ardoq Professional Services or an Ardoq Partner on how best to do this.

Appendix A - Application Instance component type

Workspace

Name: Application Instances

Location: Application Portfolio Folder

Component Type

Name: Application Instance

Location: Application Instances Workspace

Fields:

Field

Type

Comment

Class

Text

ServiceNow Sys Class

Sys ID

Text

Custom ID field to hold ServiceNow unique identifier

If using the IT Cost Management (ITCM) Solution then add the following existing fields to the Application Instance component type:

Field

Type

Comment

CAPEX

Number

As per ITCM

OPEX

Number

As per ITCM

Total Direct Cost

Calculated Number

As per ITCM

Total Attributed Cost

Calculated Number

As per ITCM

Total Cost

Calculated Number

As per ITCM

Total Attribution Percentage

Calculated Text

As per ITCM

Cost Attribution Percent Data Quality

Calculated Checkbox

As per ITCM

Reference Type

Name: Is Supported By

If using Application Hosting (AH) or Technology Portfolio Management (TPM) then add the following existing field to the 'Is Supported By' reference type:

Field

Type

Comment

Deployment Environment

List

As per AH

If using IT Cost Management (ITCM) then add the following existing fields to the 'Is Supported By' reference type:

Field

Type

Comment

Cost Attribution Percentage

Number

As per ITCM

Cost Type Attribution

Select multiple list

As per ITCM

Metamodel

Metamodel for the incorporation of the Application Instance component type

Did this answer your question?