---
sourceDocument: Australia ServiceNow AI Platform Capabilities
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/servicenow-platform

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Automate tag-based mapping

# Automating creating tag-based relationship mapping within API Insights {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

You can configure and automate creating CMDB relationships between APIs and application services or business applications based on API tags.

Tag-based relationship mapping enables CMDB administrators and enterprise architects to define rules that automatically create CMDB relationships between APIs and application services or business applications based on API tags. Each rule specifies how a tag on a source CI is matched to a field on a target CI, and which
relationship type and direction to create. Rules are stored in the Tag Based Relationship Mapping \[sn_api_insights_ws_tag_relationship_mapping\] table, enabling automatic mapping of multiple APIs to application services or business
contexts.

You can use tag-based relationship mapping for:

* Relating APIs to application services using a tag, such as a service name.
* Linking APIs or components to business applications by matching a tag to an external ID field.
* Standardizing relationship creation across different environments.

To create CMDB relationships between APIs and application services or business applications based on API tags, follow these steps:

1. [Define tag-based mapping rules](https://servicenow-prod.fluidtopics.net/gO4h3L5tYsPlkxW8HS5ikQ#api-insights-defn-tag-reln "Establish relationships between APIs and application services by defining tag-based mapping rules for APIs available within the API Insights application.").
2. [Schedule the tag-based mapping rule](https://servicenow-prod.fluidtopics.net/gO4h3L5tYsPlkxW8HS5ikQ#api-insights-sch-job-tag-reln "You can use a scheduled job to automatically create CMDB relationships between APIs and application services or business applications based on API tags.").
{#api-insights-tag-reln__ol_edh_xkr_jhc}

## Define tag-based mapping rules {#ariaid-title2}

Establish relationships between APIs and application services by defining tag-based mapping rules for APIs available within the API Insights application.

### Vorbereitungen

Role required: sn_cmdb_admin or sn_api_insights_ws.api_mgmt_architect

### Warum und wann dieser Vorgang ausgeführt wird

Tag-based mapping rules enable you to automatically create relationships between APIs and application services or business applications based on tags. To define a tag-based mapping rule, you need to create a tag relationship
mapping record that specifies the source and target CI classes and the relationship details.

### Prozedur

1. In the navigation filter of the application navigator, enter <kbd class="ph userinput">sn_api_insights_ws_tag_relationship_mapping.list</kbd> and press the Enter key.
2. On the Tag Relationship Mappings page, select New.
3. On the form, fill in the fields.  
   {#api-insights-defn-tag-reln__table_gjd_4tq_jhc__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name for the relationship. |
   | Source Class | CI class including API, API Component, API Frontend, API Backend, or Managed API that contains the tag as the source of the relationship. |
   | Target Class | CI class including Application Service or Business Application that the source CI is related to as the target of the relationship. |
   | Relationship Type | Type of relationship established between the source CI and the target CI. |
   | Tag Key | Key from the Key Value \[cmdb_key_value\] table that corresponds to the target CI field. |
   | Target Match Field | Field on the target CI that matches the tag value. |
   | Parent Class Role | CI that acts as the parent in the relationship, either source or target. |
   | Active | Option to enable the relationship. |
   [Tabelle : 1. New record form for the tag-based relationship mapping]

   {#api-insights-defn-tag-reln__table_gjd_4tq_jhc}
4. Select Submit.

## Scheduling the tag-based mapping rules {#ariaid-title3}

You can use a scheduled job to automatically create CMDB relationships between APIs and application services or business applications based on API tags.

Scheduled jobs automate tasks that run at a specific time or on a recurring schedule. You need the admin role to configure and run a scheduled job. For more information on configuring a scheduled job, see [Scheduled jobs](https://www.servicenow.com/docs/access?context=c_ScheduledJobs&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

The Tag based relationship mapping scheduled job is available to schedule applying tag-based mapping rules between APIs and application services or business applications. By default, this job is inactive. As a user
with the admin role, you can configure and activate it to run at regular intervals.

For each active tag-based relationship rule, the Tag based relationship mapping scheduled job processes active rules with the following workflow:

* Uses the specified tag key to retrieve relevant source CI tags.
* Identifies target CIs where the target CI's matching field matches the tag value.
* Creates the specified relationship type between the source and target CIs in the direction indicated by the `parent_class_role` setting.
* Avoids duplicating existing relationships.

By automating the process of creating relationships based on tags, the Tag-based relationship mapping scheduled job enables maintaining up-to-date and accurate mappings between APIs and related application services
or business applications.