- はじめに
- スタート アップ ガイド
- 任意のキャンバスで構築する
- 大文字と小文字で構築
- フローを利用した構築
- BPMN で構築する
- オペレーティング
- 監視
- 最適化中
- 参考情報
トリガー
ワークフローを開始するトリガー ノード、各トリガーがその入力をどのように所有するか、および複数のトリガーを含むワークフローがどのように動作するか。
トリガーは、ワークフローの開始方法を定義します。すべてのワークフローに少なくとも 1 つのトリガーが必要であり、新しいワークフローには既定で手動トリガーが含まれます。トリガー ノードのないワークフローはデバッグできません。 デバッグ は利用できないままで、ワークフローにトリガー ノードが少なくとも 1 つ必要であることを示すエラーが表示されます。
トリガーの種類
新しいワークフローは手動トリガーで始まり、 ワークフローのテストなどを目的としてオンデマンドで実行を開始します。別の方法で開始するには、[ トリガーを変更] リストから [手動トリガー] を置き換えます。
- フォーム トリガー (プレビュー): 人間がフォームを送信したときにワークフローを開始します。
- スケジュールされたトリガー: スケジュールに従ってワークフローを開始します。
- コネクタ トリガー: 接続されたアプリでイベントが発生したときにワークフローを開始します。
- HTTP Webhook: 呼び出しが Web アドレスに到着したときにワークフローを開始します。
- 着信通話 (プレビュー): 電話が着信されたらワークフローを開始します。
- 会話トリガー: ユーザーがチャットを開始したときにワークフローを開始します。
- キュー トリガー: 作業アイテムがキューに追加されるとワークフローを開始します。
トリガーの配置
下部のツールバーにある [+ ] ボタンをクリックすると、[ ノードを追加 ] パネルが開きます。
トリガーが追加されると、キャンバスに円形のノードとして表示されます。その出力ハンドルはワークフローの最初のノードに接続され、このノードがエントリ ポイント (実行を開始する場所) を完了します。
すべてのトリガーは、その後に少なくとも 1 つのノードに接続する必要があります。トリガーに出力コネクションがない場合、キャンバスに警告が表示されます。
トリガーの入力
入力変数は、ワークフローではなくトリガーによって所有されます。各トリガーは独自の入力セットを定義し、それらの入力は、その特定のトリガーが起動したときにのみ入力されます。
トリガーの後のノードは、トリガーの入力を以下の構文で参照します。
$vars.<triggerName>.output.<inputName>
$vars.<triggerName>.output.<inputName>
たとえば、manualTrigger1 という名前の手動トリガーで という入力が定義されている場合userId
$vars.manualTrigger1.output.userId
$vars.manualTrigger1.output.userId
トリガーの入力は、入力引数と呼ばれます。これらはトリガーの [プロパティ] パネルの [ パラメーター ] タブで設定します。ここで [入力引数を追加] をクリックすると、名前と型 (例: string) を持つ引数が追加されます。[変数] パネルでトリガーの横にある [+] をクリックすると [入力変数を追加] ダイアログが開き、名前、データ型、説明、既定値の入力を求められます。引数を定義すると、その引数は [変数] パネル内のそのトリガーの下に表示され、トリガーの後に $vars.<triggerName>.output.<inputName>としてアクセスできるようになります。
変数とデータ フローは 、式と、ノード間でデータがどのように移動するかを記述します。
複数のトリガー
ワークフローに複数のトリガーを含めることができます。各トリガーは個別のエントリ ポイントとして機能します。いずれかのトリガーが発生すると、ワークフローの独立した実行が開始されます。
その後、異なるイベントに応答して同じロジックを実行できます。たとえば、ワークフローに、夜間のバッチ実行用のスケジュール設定されたトリガーと、日中に受信要求に反応するコネクタベースのトリガーの両方を含めることができます。
各トリガーは独自の入力を所有します。トリガーの後のノードは、現在の実行を開始した特定のトリガーを参照します。ワークフローに manualTrigger1 という名前の手動トリガーと scheduledTrigger1という名前のスケジュール設定されたトリガーがある場合、それぞれに独自の $vars.<triggerName>.output 値グループがあります。
トリガーの右クリック メニューに [既定のエントリ ポイントとして設定] アクティビティが含まれており、このトリガーをワークフローの既定のエントリ ポイントとして設定します。
次のステップ
- ノード参照: [ ノードを追加] パネルのすべてのカテゴリです。
- 変数とデータ フロー: 式、ノード出力、トリガーの入力参照。
- フロー キャンバス: [ノードを追加] パネル、[プロパティ] パネル、下部のツールバー。
- エラー処理: トリガー後にノードで発生するエラーの処理です。