注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Webhook を設定する
前提条件
- はじめにのチュートリアルを完了して、基本的なアクションの設定方法を学びます。
- Webhook を設定して、外部システムへの接続を作成します。Webhook を作成する前に、ソースシステムへの接続権限を持つシステム管理者と連携する必要がある場合があります。
手順
以下の例では、priority という文字列値を受け取り、外部システムに送信する Modify ticket priority という Webhook があるとします。
アクションに移動し、ロジックタブを選択して、新しいルールを追加、Webhook の順に選択します。
デフォルトでは、新しく追加した Webhook は副次的効果として設定されます。この設定では、Foundry でオブジェクトが編集された後に Webhook が実行されます。代わりに書き戻しを選択すると、オブジェクトの編集前に Webhook が実行されます。
以下のメニューで、実行する Webhook を選択します。この例では、Modify ticket priority Webhook を選択します。必要に応じて、Webhook の別のバージョンを選択できます。
次に、アクションパラメーターに基づいて Webhook の入力パラメーターを設定します。デフォルトでは、Webhook の入力ごとに新しいアクションパラメーターが生成されます。ただし、同じ名前のアクションパラメーターがすでに存在する場合は、その既存のパラメーターが自動的に設定されます。この例では、priority という Webhook の入力を、Ticket Priority という既存のアクションパラメーターにマッピングします。
Webhook を追加を選択して、アクションへの Webhook ルールの追加を完了します。Webhook が追加されると、ルールセクションに、オブジェクトが変更される前にライトバックが行われることが表示されます。
Webhook を追加したときに自動生成されたパラメーターのうち、現在使用されていないものは削除してもかまいません。
右上の保存を選択して、アクションへの変更を保存します。これで、アクションが適用されると、Foundry のオブジェクトに変更が適用される前に、外部システムへのリクエストが行われます。
次のステップ
このチュートリアルでは、アクションに Webhook を追加する方法を紹介しました。詳細については、次のリソースを参照してください。
- Webhook セクションを参照して、アクションの Webhook で利用可能なすべてのオプションについて学びます。
- 関数を使用して Webhook の入力パラメーターを設定する方法を学びます。
- Data Connection の Webhook の概念について詳しくはこちら。