プロバイダー向け サービスブリッジ でのリモートタスク定義の作成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：9分

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

    始める前に

    必要なロール：admin

    手順

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

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

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

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

      ターゲットフィールドは、 での変換の作成 サービスブリッジ で説明されている仮想受信オプションまたは updateVirtualField API を使用して更新できます。
    8. [Submit (送信)] を選択します。
    9. [ 送信フィールド] 関連タブで、[ 新規] をクリックします。
    10. フォームのフィールドに入力します。
      送信フィールドを使用すると、リモートタスクが作成または更新されたときに、コンシューマーのインスタンスにデータを送信できます。
      表 : 3. 送信フィールドフォーム
      フィールド 説明
      フィールドラベル リモートタスクフォームに表示されるフィールドラベルの名前。
      フィールド名 リモートタスクフローとスクリプトで使用されるフィールド名。
      最大長 フィールド名の最大長。
      同期タイミングの提案 ユーザー(プロバイダー)は、リモートタスクの親レコードのターゲットフィールドを直接更新するタイミングをコンシューマーに提案できます。コンシューマーは、定義をアクティブ化する前にこの設定を変更できます
      • 挿入する： リモートタスクが最初に挿入されたときのみ、リモートタスクの親レコードのターゲットフィールドを更新します。
      • 挿入または更新:リモートタスクが更新されるたびに、リモートタスクの親レコードのターゲットフィールドを更新します。
      • なし:受信フィールドは、リモートタスクの親レコードのターゲットフィールドを直接更新しません。たとえば、このフィールドを、ターゲットフィールドを更新する前にフローを使用して受信値を変換するステータスマッピングに使用できます。
      [ソースマッピング] タブ 仮想フィールドマッピングを定義するために [仮想 ] チェックボックスをオンにした場合、このタブは表示されません。
      ソーステーブル (読み取り専用) リモートタスク定義の作成時に選択したプロバイダーテーブル。
      ソースフィールド 別の ServiceNow インスタンスに送信されるソーステーブルのフィールド。

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

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

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

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

      コンシューマー基準の詳細については、「 サービスブリッジ for Providers でのエンタイトルメントの作成」を参照してください。

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

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

    タスクの結果

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

    次のタスク

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