内でのタグベースの関係マッピングの作成の自動化 API インサイト

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：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. タグベースのマッピングルールの定義。
    2. タグベースのマッピングルールをスケジュールします。

    タグベースのマッピングルールの定義

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

    始める前に

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

    このタスクについて

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

    手順

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

    タグベースのマッピングルールのスケジュール設定

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

    スケジュール済みジョブは、特定の時間または繰り返しスケジュールで実行されるタスクを自動化します。スケジュール済みジョブを構成して実行するには、admin ロールが必要です。スケジュール済みジョブの構成の詳細については、「Scheduled jobs」を参照してください。

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

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

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

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