プロバイダー向け サービスエクスチェンジ でのリモートタスク定義の作成

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

    • プロバイダーは、リモートタスクの割り当てをトリガーするリモートタスク定義 (RTD) を作成します。

    始める前に

    必要なロール：admin

    このタスクについて

    リモートタスクを作成する前に、まず RTD を作成する必要があります。リモートタスクは、定義した RTD に基づいて生成されます。RTD とリモートタスクのしくみの詳細については、「 リモートタスク」を参照してください。

    手順

    1. 移動先 すべて > サービスエクスチェンジ プロバイダー > アドミニストレーション > リモートタスク定義.
    2. [New (新規)] を選択します。
    3. フォームで、フィールドに入力します。
      表 : 1. リモートタスク定義フォーム
      フィールド 説明
      名前 リモートタスク定義レコードの名前。
      アプリケーション これは読み取り専用フィールドで、アプリケーションスコープに基づいてデフォルトで設定されています。
      状況 リモートタスク定義のステータスを表示します。リモートタスク定義を作成すると、このフィールドは [ドラフト] ステータスに設定されます。
      注:
      このフィールドは、リモートタスク定義を公開、アーカイブ、または廃止すると自動的に更新されます。
      プロバイダーテーブル リストから選択した任意のタスクテーブル。たとえば、ケーステーブルまたはインシデントテーブルを選択できます。
      コンシューマーテーブル リストから選択した任意のタスクテーブル。たとえば、ケーステーブルまたはインシデントテーブルを選択できます。
      互換性 このフィールドはデフォルトで入力されています。プロバイダーによって使用されている サービスエクスチェンジ バージョンが表示されます。コンシューマーが互換性のある サービスエクスチェンジ バージョンを使用している場合は、プロバイダーインスタンスとコンシューマーインスタンス間でデータを同期できます。ただし、コンシューマーが互換性のあるバージョンを使用していない場合、対応する サービスエクスチェンジ バージョンがアップグレードされるまで、新しいリモートタスク定義をアクティブ化することはできません。
      添付ファイルを送信 このチェックボックスをオンにすると、添付ファイルが親レコードに追加されると、リモートタスクに送信されます。
      注:
      添付ファイルやタスクなどのデータが サービスエクスチェンジを介して別のインスタンスと共有されると、そのインスタンスのデータの一部になります。 サービスエクスチェンジ リモートインスタンスのデータは削除されません。必要に応じて、受信インスタンスが削除を処理する必要があります。
      簡単な説明 このリモートタスク定義に関する簡単な情報。
      説明 このリモートタスク定義に関する詳細情報。
    4. [Submit (送信)] を選択します。
    5. この新しいリモートタスク定義レコードを開きます。
    6. [ 受信フィールド] 関連タブで、[ 新規] を選択します。
      バージョン 2.2.x 以降 サービスエクスチェンジ 、ソースフィールドとターゲットフィールドがコメントとして設定された受信フィールドレコードが作成されます。このレコードにより、RTD のコメント間のマッピングが可能になります。
    7. フォームで、フィールドに入力します。
      受信フィールドを使用すると、リモートタスクが作成または更新されたときにコンシューマーのインスタンスからデータを受信できます。
      注:
      受信フィールドの値が更新されると、更新された情報が親レコードの作業メモに表示されます。
      表 : 2. 受信フィールドフォーム
      フィールド 説明
      フィールドラベル リモートタスクフォームに表示されるフィールドラベル。
      フィールド名 リモートタスクフローおよびスクリプトで使用されるフィールド名。
      最大長 ソースフィールド名の最大長。
      同期タイミング リモートタスクの親レコードのターゲットフィールドをいつ直接更新するかを指定できます。次を選択できます。
      • 挿入: リモートタスクが最初に挿入された場合にのみ、リモートタスクの親レコードのターゲットフィールドを更新します。
      • 挿入または更新:リモートタスクが更新されるたびに、リモートタスクの親レコードのターゲットフィールドを更新します。
      • なし:受信フィールドは、リモートタスクの親レコードのターゲットフィールドを直接更新しません。たとえば、このフィールドを、ターゲットフィールドを更新する前にフローを使用して受信値を変換するステータスマッピングに使用できます。
      注:
      ここで選択したオプションに関係なく、受信フィールドが更新されるたびに、変更は親レコードの作業メモに反映されます。
      [ソースマッピング] タブ [ 仮想 ] チェックボックスをオンにして仮想フィールドマッピングを定義した場合、このタブは表示されません。
      ソーステーブル (読み取り専用) リモートタスク定義の作成時に選択したコンシューマーテーブル。
      ソースフィールド 別の ServiceNow インスタンスに送信されるソーステーブルのフィールド。

      ソースフィールドでは、 関連テーブルのデータへのドット連結が可能で、 ServiceNow インスタンス間で参照データが使用できない場合に便利です。たとえば、変更インシデント (CI) の複数の受信マッピングを作成して、名前、クラス、IP アドレス、資産タグを含めることができます。
      [ターゲットマッピング] タブ 次の条件でのみ表示されます。
      • 同期するタイミング: [挿入] または [挿入または更新] を選択します。
      • 仮想:このチェックボックスをオンにすると、仮想フィールドマッピングが有効になります。
      ターゲットテーブル (読み取り専用) リモートタスク定義の作成時に選択したプロバイダーテーブル。
      ターゲットフィールド 別の ServiceNow インスタンスに送信されるターゲットテーブルのフィールド。
      注:
      仮想フィールドマッピングを定義する場合、ターゲットテーブルで選択したフィールドはソーステーブルに存在しません。
      アクティブ このフィールドはデフォルトで有効になっています。
      仮想

      仮想受信フィールドマッピングを有効にするには、このチェックボックスをオンにします。仮想フィールドは、ターゲットテーブルには存在するが、ソーステーブルには存在しないフィールドです。

      ターゲットテーブルに存在するフィールドがソーステーブルに含まれていない場合、そのフィールドは仮想フィールドとして構成されます。仮想フィールドに指定された値は、ソースインスタンスからターゲットインスタンスに渡されます。コンシューマーは、リモートタスクを作成してデータを同期し、関連するターゲットタスクレコードの仮想フィールドの値を更新できます。

      ターゲットフィールドは、 サービスエクスチェンジでの変換の作成 で説明されている仮想受信オプションを使用するか、 updateVirtualField API を使用して更新できます。
    8. [Submit (送信)] を選択します。
    9. [ 送信フィールド] 関連タブで、[ 新規] をクリックします。
      サービスエクスチェンジ バージョン 2.2.x 以降、ソースフィールドとターゲットフィールドをコメントとして設定した送信フィールドレコードが作成されます。このレコードにより、RTD のコメント間のマッピングが可能になります。
    10. フォームで、フィールドに入力します。
      送信フィールドを使用すると、リモートタスクが作成または更新されたときに、コンシューマーのインスタンスにデータを送信できます。
      表 : 3. 送信フィールドフォーム
      フィールド 説明
      フィールドラベル リモートタスクフォームに表示されるフィールドラベルの名前。
      フィールド名 リモートタスクフローおよびスクリプトで使用されるフィールド名。
      最大長 フィールド名の最大長。
      同期タイミングの提案 リモートタスクの親レコードのターゲットフィールドを直接更新する必要があるタイミングをプロバイダーがコンシューマーに提案できるようにします。コンシューマーは、定義をアクティブ化する前にこの設定を変更できます
      • 挿入: リモートタスクが最初に挿入された場合にのみ、リモートタスクの親レコードのターゲットフィールドを更新します。
      • 挿入または更新:リモートタスクが更新されるたびに、リモートタスクの親レコードのターゲットフィールドを更新します。
      • なし:受信フィールドは、リモートタスクの親レコードのターゲットフィールドを直接更新しません。たとえば、このフィールドを、ターゲットフィールドを更新する前にフローを使用して受信値を変換するステータスマッピングに使用できます。
      既存のエントリを同期 接続が確立されたときに、既存のすべてのコメントをターゲットタスクに同期できるようにするオプション。有効にすると、リモートタスクの作成時に、接続前に作成されたコメントが同期プロセスに含まれます。
      注:
      この機能は サービスエクスチェンジ バージョン 2.2.x から利用可能です。
      [ソースマッピング] タブ [ 仮想 ] チェックボックスをオンにして仮想フィールドマッピングを定義した場合、このタブは表示されません。
      ソーステーブル (読み取り専用) リモートタスク定義の作成時に選択したプロバイダーテーブル。
      ソースフィールド 別の ServiceNow インスタンスに送信されるソーステーブルのフィールド。

      ソースフィールドでは、 関連テーブルのデータへのドット連結が可能で、 ServiceNow インスタンス間で参照データが使用できない場合に便利です。たとえば、変更インシデント (CI) の複数の受信マッピングを作成して、名前、クラス、IP アドレス、資産タグを含めることができます。

      注:
      サービスエクスチェンジバージョン 2.2.x から、
      [ターゲットマッピング] タブ 次の条件でのみ表示されます。
      • 同期するタイミング: [挿入] または [挿入または更新] を選択します。
      • 仮想:このチェックボックスをオンにすると、仮想フィールドマッピングが有効になります。
      ターゲットテーブル (読み取り専用) リモートタスク定義の作成時に選択したコンシューマーテーブル。
      ターゲットフィールド 別の ServiceNow インスタンスに送信されるターゲットテーブルのフィールド。
      注:
      仮想フィールドマッピングを定義する場合、ターゲットテーブルで選択したフィールドはソーステーブルに存在しません。
      アクティブ このフィールドはデフォルトで有効になっています。
      仮想

      仮想受信フィールドマッピングを有効にするには、このチェックボックスをオンにします。仮想フィールドは、ターゲットテーブルには存在するが、ソーステーブルには存在しないフィールドです。

      ターゲットテーブルに存在するフィールドがソーステーブルに含まれていない場合、そのフィールドは仮想フィールドとして構成されます。仮想フィールドに指定された値は、ソースインスタンスからターゲットインスタンスに渡されます。

      ターゲットフィールドは、 サービスエクスチェンジでの変換の作成 で説明されている仮想送信オプションを使用するか、 updateVirtualField API を使用して更新できます。
    11. [Submit (送信)] を選択します。
    12. [ コンシューマー基準] 関連タブで、[ 新規] をクリックします。
    13. フォームで、フィールドに入力します。
      コンシューマー基準を使用すると、これらのリモートタスク定義を使用できるコンシューマーを管理できます。
      表 : 4. [コンシューマー基準] フォーム
      フィールド 説明
      コンシューマー条件 このリモートタスク定義に資格を付与する顧客の会社またはアカウント。
      リモートタスク定義 このリモートタスク定義レコードの名前。この名前は自動入力されます。

      コンシューマー基準の詳細については、「 プロバイダーの サービスエクスチェンジ でのエンタイトルメントの作成」を参照してください。

    14. [公開] をクリックします。

      リモートタスク定義を公開すると、リモートタスク変数が自動的に作成されます。これらの変数は、表示される受信フィールドのデータ変数であり、リモートタスクでアクセスできます。

    タスクの結果

    リモートタスク定義レコードがインスタンスに作成されます。このレコードは顧客のインスタンスとも同期されており、現在、コンシューマーのインスタンスでアクティブ化処理待ちになっています。[ リモートタスク定義の自動アクティブ化 (Auto activate remote task definition )] フィールドがコンシューマーによって有効になっている場合、リモートタスク定義はコンシューマーのインスタンスで自動的にアクティブ化されます。

    次のタスク

    この公開されたリモートタスク定義の複数の構成リビジョンを作成できます。構成リビジョンの作成方法の詳細については、「 構成リビジョンを作成」を参照してください。次の操作も実行できます。