---
sourceDocument: オーストラリア ServiceNow AI Platform の機能
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/servicenow-platform

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア ServiceNow AI Platform の機能

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# タグベースのマッピングを自動化

# 内でのタグベースの関係マッピングの作成の自動化 API インサイト {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

API タグに基づいて、API とアプリケーションサービスまたはビジネスアプリケーション間の CMDB 関係の作成を構成および自動化できます。

タグベースの関係マッピングを使用すると、 CMDB アドミニストレーターとエンタープライズアーキテクトは、API タグに基づいて API とアプリケーションサービスまたはビジネスアプリケーション間の CMDB 関係を自動的に作成するルールを定義できます。各ルールは、ソース CI のタグとターゲット CI のフィールドの照合方法、および作成する関係のタイプと方向を指定します。ルールはタグベースの関係マッピング \[sn_api_insights_ws_tag_relationship_mapping\] テーブルに格納され、複数の API をアプリケーションサービスまたはビジネスコンテキストに自動的にマッピングできます。

タグベースの関係マッピングは、次の目的で使用できます。

* タグ (サービス名など) を使用して API をアプリケーションサービスに関連付けます。
* タグを外部 ID フィールドと照合して、API またはコンポーネントをビジネスアプリケーションにリンクします。
* さまざまな環境間での関係の作成を標準化します。

API タグに基づいて API とアプリケーションサービスまたはビジネスアプリケーションの間に CMDB 関係を作成するには、次の手順を実行します。

1. [タグベースのマッピングルールの定義](https://servicenow-prod.fluidtopics.net/sdEarA2QmgkfSbQsNMQMjA#api-insights-defn-tag-reln "API インサイト アプリケーション内で使用可能な API のタグベースのマッピングルールを定義して、API とアプリケーションサービス間の関係を確立します。")。
2. [タグベースのマッピングルールをスケジュールします](https://servicenow-prod.fluidtopics.net/sdEarA2QmgkfSbQsNMQMjA#api-insights-sch-job-tag-reln "スケジュール済みジョブを使用すると、API タグに基づいて API とアプリケーションサービスまたはビジネスアプリケーション間の CMDB 関係を自動的に作成できます。")。
{#api-insights-tag-reln__ol_edh_xkr_jhc}

## タグベースのマッピングルールの定義 {#ariaid-title2}

API インサイト アプリケーション内で使用可能な API のタグベースのマッピングルールを定義して、API とアプリケーションサービス間の関係を確立します。

### 始める前に

必要なロール:sn_cmdb_admin または sn_api_insights_ws.api_mgmt_architect

### このタスクについて

タグベースのマッピングルールを使用すると、タグに基づいて API とアプリケーションサービスまたはビジネスアプリケーション間の関係を自動的に作成できます。タグベースのマッピングルールを定義するには、ソースとターゲットの CI クラス、および関係の詳細を指定するタグ関係マッピングレコードを作成する必要があります。

### 手順

1. アプリケーションナビゲーターのナビゲーションフィルターで、「 <kbd class="ph userinput">sn_api_insights_ws_tag_relationship_mapping.list</kbd> 」と入力し、Enter キーを押します。
2. \[タグ関係マッピング\] ページで、\[ 新規\] を選択します。
3. フォームで、フィールドに入力します。  
   {#api-insights-defn-tag-reln__table_gjd_4tq_jhc__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | 関係の名前。 |
   | ソースクラス | 関係のソースとしてタグが含まれている API、API コンポーネント、API フロントエンド、API バックエンド、またはマネージド API を含む CI クラス。 |
   | ターゲットクラス | ソース CI が関係のターゲットとして関連付けられている アプリケーションサービス または ビジネスアプリケーション を含む CI クラス。 |
   | 関係性タイプ | ソース CI とターゲット CI の間に確立された関係のタイプ。 |
   | タグキー | ターゲット CI フィールドに対応するキー値 \[cmdb_key_value\] テーブルのキー。 |
   | ターゲット照合フィールド | タグ値に一致するターゲット CI のフィールド。 |
   | 親クラスのロール | 関係内で親として機能する CI (ソースまたはターゲット)。 |
   | アクティブ | 関係を有効にするオプション。 |
   [表 : 1. タグベースの関係マッピングの新規レコードフォーム]

   {#api-insights-defn-tag-reln__table_gjd_4tq_jhc}
4. \[送信\] を選択します。

## タグベースのマッピングルールのスケジュール設定 {#ariaid-title3}

スケジュール済みジョブを使用すると、API タグに基づいて API とアプリケーションサービスまたはビジネスアプリケーション間の CMDB 関係を自動的に作成できます。

スケジュール済みジョブは、特定の時間または繰り返しスケジュールで実行されるタスクを自動化します。スケジュール済みジョブを構成して実行するには、admin ロールが必要です。スケジュール済みジョブの構成の詳細については、「[Scheduled jobs](https://www.servicenow.com/docs/access?context=c_ScheduledJobs&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。

Tag based relationship mappingスケジュール済みジョブは、API とアプリケーションサービスまたはビジネスアプリケーション間でタグベースのマッピングルールを適用するスケジュールを設定するために使用できます。デフォルトでは、このジョブは非アクティブです。admin ロールを持つユーザーは、定期的に実行するように構成してアクティブ化できます。

アクティブなタグベースの関係性ルールそれぞれについて、 Tag based relationship mapping スケジュール済みジョブは次のワークフローでアクティブなルールを処理します。

* 指定されたタグキーを使用して、関連するソース CI タグを取得します。
* ターゲット CI の一致フィールドがタグ値と一致するターゲット CI を識別します。
* `parent_class_role`設定で示される方向でソース CI とターゲット CI 間に指定された関係タイプを作成します。
* 既存の関係の重複を回避します。

Tag-based relationship mappingスケジュール済みジョブでは、タグに基づいて関係を作成するプロセスを自動化することで、API と関連するアプリケーションサービスまたはビジネスアプリケーションとの間の最新かつ正確なマッピングを維持できます。

