プロバイダー向けでの Service Bridge リモートタスク定義の作成

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む8読むのに数分

    • プロバイダーは、リモートタスクのアサインをトリガーするリモートタスク定義を作成します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > Service Bridge プロバイダー > 管理 > リモートタスク定義.
    2. [New (新規)] をクリックします。
    3. フォームのフィールドに入力します。
      表 : 1. リモートタスク定義フォーム
      フィールド 説明
      名前 リモートタスク定義レコードの名前。
      プロバイダーテーブル リストから選択したタスクテーブル。たとえば、ケーステーブルまたはインシデントテーブルを選択できます。
      コンシューマーテーブル リストから選択したタスクテーブル。たとえば、ケーステーブルまたはインシデントテーブルを選択できます。
      添付ファイルを送信 これを選択すると、添付ファイルが親レコードに追加されると、リモートタスクに送信されます。
      添付ファイルを親にコピー 添付ファイルがリモートタスクに含まれている場合、コピーは親レコードに送信されます。
      簡単な説明 このリモートタスク定義に関する簡単な情報。
      説明 このリモートタスク定義に関する詳細情報。
    4. [Submit (送信)] をクリックします。
    5. この新しいリモートタスク定義レコードを開きます。
    6. [ 受信フィールド ] 関連タブで、[ 新規] をクリックします。
    7. フォームのフィールドに入力します。
      受信フィールドを使用すると、リモートタスクが作成または更新されたときにコンシューマーのインスタンスからデータを受信できます。
      注:
      受信フィールドの値が更新されると、更新された情報が親レコードの作業メモに表示されます。
      表 : 2. 受信フィールドフォーム
      フィールド 説明
      フィールド ラベル リモートタスクフォームに表示されるフィールドラベル。
      フィールド名 リモートタスクフローとスクリプトで使用されるフィールド名。
      最大長 ソースフィールド名の最大長。
      同期タイミング リモートタスクの親レコードのターゲットフィールドが直接更新されるタイミングを指定できます。次を選択できます。
      • 挿入： リモートタスクが最初に挿入されたときのみ、リモートタスクの親レコードのターゲットフィールドを更新します。
      • 挿入または更新:リモートタスクが更新されるたびに、リモートタスクの親レコードのターゲットフィールドを更新します。
      • 実行しない:受信フィールドがリモートタスクの親レコードのターゲットフィールドを直接更新することはありません。たとえば、ターゲットフィールドを更新する前にフローを使用して受信値を変換するステータスマッピングに、このフィールドを使用できます。
      注:
      ここで選択したオプションに関係なく、受信フィールドが更新されるたびに、親レコードの作業メモに変更が反映されます。
      [ソースマッピング] タブ 仮想フィールドマッピングを定義するために [ 仮想 ] チェックボックスをオンにした場合、このタブは表示されません。
      ソーステーブル (読み取り専用) リモートタスク定義の作成時に選択したコンシューマーテーブル。
      ソースフィールド 別の ServiceNow インスタンスに送信されるソーステーブルのフィールド。

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

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

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

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

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

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

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

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

      コンシューマ基準の詳細については、「」を参照してください プロバイダー向けエン Service Bridge タイトルメントの作成。

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

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

      注:
      • 不要になったリモートタスク定義を非アクティブ化するには、[ 廃止 ] をクリックします。既存のリモートタスクは、廃止されたリモートタスク定義を引き続き使用できますが、リモートタスク定義を使用して新しいリモートタスクを作成することはできません。
      • 不要になったリモートタスク定義を削除するには、[ 削除 ] をクリックします。
      • 公開されたリモートタスク定義を編集するには、[ 編集] をクリックします。必要に応じてリモートタスク定義を変更し、[ 公開] をクリックします。

    タスクの結果

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