あるインスタンスから別のインスタンスへのサービス定義の転送

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

    • ソースインスタンスからサービスインスタンスの定義をエクスポートし、これらの定義をターゲットインスタンスにインポートすることで、時間と労力を節約します。このメソッドを使用して、検出されたタイプのサービスインスタンスの定義のみをコピーできます。

    通常、組織内では本番用と開発用の 2 つの ServiceNow インスタンスを管理します。テストに使用する開発インスタンスで、組織内のアプリケーションサービスの初期マッピングを実行します。初期マッピングの結果では、基本的なトラブルシューティングや微調整が必要になる場合が多くあります。ソースインスタンスでのアプリケーションサービスマッピングが完了したら、サービス定義をターゲット (本番) のインスタンスに転送します。

    実際にエクスポートできるのはアプリケーションサービスではなく、サービス定義のみであることに注意してください。マッピングは動的なプロセスであり、マッピング結果に実際のインフラストラクチャとその構成が反映されます。したがって、あるインスタンスからエクスポートして別のインスタンスにインポートしたサービスの表示が異なる場合があります。

    デフォルトでは、次のサービス定義をエクスポートします。
    • サービス名
    • トラフィックベースのディスカバリーの使用
    • エントリポイント
    • ビジネス上の重要度
    • サービスが属するグループ

      このサービスグループがサービスグループ階層の一部である場合、この階層のすべての親サービスグループもエクスポートされます。

    • コメント
    Sys ID [sys_id] 属性を使用してソースおよびターゲットインスタンスのサービスが識別され、次のルールに従ってサービス定義インポートが実装されます。
    • サービスの Sys ID がターゲットインスタンスに存在しない場合、ターゲットインスタンスに新しいサービスが作成されます。
    • サービスの Sys ID と名前が既にターゲットインスタンスに存在する場合、既存のサービス定義がインポートされた定義で上書きされることによって、このサービスが更新されます。
    • サービスの Sys ID がターゲットインスタンスに存在しても、別のサービス名に関連付けられている場合、この Sys ID でサービスが更新されます。サービス名などのサービス定義がシステムによって上書きされます。
    • ソースおよびターゲットインスタンスの異なるサービスに同じ名前が使用されている場合、サービス定義はインポートされません。
    • 手動サービスはエクスポートできません。同様に、手動で追加したエントリーポイントもエクスポートできません。手動エントリーポイントを含むサービスの定義をインポートする場合、エントリーポイントに変更は加えられません。
    図 : 1. サービス定義フローのエクスポート

    サービス定義のエクスポート

    インスタンス間でサービス定義を転送する場合、インポートされたサービスインスタンスとサービスグループはユーザーのドメインに割り当てられます。

    デフォルトでは、インポートした定義を含むアプリケーションサービスにNon-operationalのステータスがアサインされます。

    サービス定義を転送すると、ServiceNow AI Platform で利用可能な標準のインポートセット機能が展開されます。ソースインスタンスでサービス定義をエクスポートすると、エクスポートされたデータを含む JSON ファイルが作成されます。サービス定義をターゲットインスタンスにコピーすると、この JSON ファイルのデータがインポートされてインポートセットになります。

    サービス定義のエクスポート

    サービスの定義を含むインポートセットを作成します。このインポートセットを使用して、サービス定義を別のインスタンスにインポートします。

    始める前に

    • エクスポートするサービス定義を決定します。
      重要:
      この方法を使用して、検出されたタイプのみのアプリケーションサービスの定義をコピーできます。
    • ソースインスタンスとターゲットインスタンスが同じ ServiceNow リリースにあることを確認します。
    • サービス定義をコピーするソースインスタンスを開きます。
    • 必要に応じて、下の関連プロパティを変更して、インポートセットの作成を微調整します サービスマッピング > アドミニストレーション > プロパティ. 詳細については、「サービスマッピング とともにインストールされるコンポーネント」を参照してください。
    必要なロール：service_mapping_admin

    手順

    1. インスタンスがドメインセパレーションを使用し、ユーザーにグローバルドメインへのアクセス権がある場合は、ドメインピッカー (ドメインピッカー) から サービスインスタンス が所属するドメインを選択します。
      選択するドメインは、子ドメインのないドメインである必要があります。
    2. 移動先 サービスマッピング > サービス > アプリケーションサービス.
    3. エクスポートするアプリケーションサービスを選択します。
    4. ページの下部にある [選択した行のアクション] をクリックし、[サービスをエクスポート (Export Services)] を選択します。
      インポートセットが、ダウンロードフォルダーに表示されます。ファイル名は「export_service_<日時>.json」の形式になります。
    5. 必要に応じて、コンピューター上の別の場所にインポートセットをコピーします。

    あるインスタンスから別のインスタンスへのサービス定義のインポート

    アプリケーションサービスの定義をソースインスタンスからインポートします。

    始める前に

    • ソースインスタンスとターゲットインスタンスが同じ ServiceNow リリースにあることを確認します。
    • サービス定義をインポートするターゲットインスタンスを開きます。
    必要なロール：import_admin

    手順

    1. インスタンスがドメインセパレーションを使用し、ユーザーにグローバルドメインへのアクセス権がある場合は、ドメインピッカー (ドメインピッカー) から サービスインスタンス が所属するドメインを選択します。
      選択するドメインは、子ドメインのないドメインである必要があります。
    2. 移動先 サービスマッピング > サービス > サービス定義をインポート.
    3. [サービス定義をインポート] ウィンドウで [ファイルを選択] をクリックし、サービス定義を含む JSON ファイルに移動して、[OK] をクリックします。
    4. オプション: [プレビューを表示] をクリックし、選択した JSON ファイル内の定義を確認します。
    5. [インポート] をクリックします。
    6. [はい] をクリックして、サービス定義をインポートする準備ができていることを確認します。
      重要:
      インポート中に、システムは現在のサービス定義を不可逆的に上書きします。

      [進行状況] ウィンドウに成功メッセージが表示されます。

      サービスマッピング が、インポートされたエントリーポイントを含むサービスのディスカバリーを自動的に開始します。

    7. サービスマッピング によるマッピングプロセスが終了したら、インポートされた、または更新されたサービスをレビューします。
      転送結果が期待通りではなかった場合は、次のテーブルの説明に従って基本的なトラブルシューティングを行ってください。
    症状 原因 ソリューション
    最近サービスインスタンスに加えた変更が消えてしまった。 既存のアプリケーションサービスの定義は、転送時に常に上書きされます。
    1. このサービスインスタンスの定義に対して必要な変更を再度行います。
    2. サービスマップで [ディスカバリーの実行] をクリックして、この サービスインスタンス のトップダウンディスカバリーを実行します。
    インポートされたサービスグループが表示されない。 このグループにアサインされたアプリケーションサービスのインポートに失敗しました。グループが空のように見えるため、グループが作成されませんでした。
    1. このグループに属するサービスインスタンスのインポートの障害になっている問題を解決します。
    2. インポートセットを再度インポートします。
    3. サービスグループが表示されていることを確認します。
    インポートしたサービスグループに誤ったアプリケーションサービスがアサインされている。 これは、インポートしたサービスグループではなく、同じ名前の異なるサービスグループです。ソースインスタンスに同じ名前を持つか、または同じ名前と Sys ID を持つサービスグループが既に存在するため、サービスグループのインポートに失敗しました。
    1. インポートログを確認します。
    2. 「名前の一意性のチェック」ビジネスルールの実行中にレコードの作成に失敗したことを示すエラーが発生した場合は、次のステップを実行します。
      1. ソースインスタンスのサービスグループの名前を変更します。
      2. このグループにアサインされたアプリケーションサービスを再度エクスポートします。
      3. ターゲットインスタンスに最新のインポートセットをインポートします。
    3. Sys ID が既に存在するためにレコードの作成に失敗したことを示すエラーが発生した場合は、次のステップを実行します。
      1. ソースインスタンスでサービスグループを再度作成し、異なるグループ名と Sys ID を指定します。
      2. このグループにアサインされたアプリケーションサービスを再度エクスポートします。
      3. ターゲットインスタンスに最新のインポートセットをインポートします。
    4. サービスグループがソースインスタンスに正しく表示されることを確認します。