トリガー

Prev Next

コードを記述せずに、トリガーを使用してアプリ内のロジックを構築する方法をご覧ください。

This topic is featured in the Basic App Design and Logic course in Tulip University.


この記事では、以下の内容について解説します:

  • トリガーコマンド、ロジック、および実行動作
  • トリガーの構築と整理に関するベストプラクティス
  • 一般的なユースケース

トリガーを使用すると、アプリにロジックを追加できます。トリガーを使えば、デバイスとの連携、アラートの送信、データの書き込み、バックエンドシステムとの通信など、あらゆる操作を、コードを1行も書かずに実行できます。

トリガーの一般的なユースケースには、次のようなものがあります:

  • **アプリ内の移動:**トランジションを使用して別のステップに移動する。
  • **アプリの完了:**アプリのメタデータを記録します。
  • **コネクタ関数を実行してバックエンドシステムにアクセスする:**コネクタを使用して、Tulipがサードパーティシステムと連携できるようにし、トリガーを介してコネクタ関数を実行します。
  • **アラートの送信:**アプリから管理者へメールやSMSによるアラートを送信します。これらのメッセージには、画像、プロセスのステータス情報、その他の関連情報を含めることができます。
  • **データの保存:**アプリからの入力データを変数やテーブルに保存します。
  • **デバイスの使用:**プロセス中に両手を使うオペレーターの場合は、フットペダルなどのデバイスイベントに対するトリガーを追加して、次のステップに進めるようにします。

トリガーはどのように機能するのですか?

ロジック

トリガーは、「when、if、then、else」という論理構造を使用します:

  • when「Tulipでイベントが登録された」
  • then「アクションを実行」または「遷移を行う」。

トリガーには条件分岐ロジックを含めることもできます:

  • when「Tulipにイベントが登録された」
  • if「条件が満たされた場合」
  • その場合「アクションを実行する」
  • そうでない場合は「別のアクションを実行する」

条件付きトリガーロジックの詳細については、こちらをご覧ください。

トリガーは Trigger Event によってグループ化され、アクションと条件式で構成されます。

トリガーは、以下の例のように単純なものもあります:

ex simple trigger

ボタンが押されたら、次のステップに進みます*。*

あるいは、バーコードをスキャンしてバックエンドのデータベースにクエリを実行し、注文情報を変数として返すといった、より複雑なトリガーもあります。

現在のステーションでバーコードスキャナーが出力を行うと、API Call(コネクタ関数を通じて実行)が外部データベースから注文詳細を取得し*、*その値を変数に格納します。その後 *、*トリガーは次のステップへ遷移します。

コマンドの種類

トリガーでは、2種類のコマンドを使用できます:

  1. **アクション:**ステップの変更とは関係のない、アプリ内の変更(例:エラーメッセージの表示、メールの送信、アプリのスクリーンショットの取得)
  2. **遷移:**アプリ自体におけるナビゲーションイベント(例:次のステップへ進む、アプリを完了する、アプリをキャンセルする)。遷移により、他のトリガーを発動(開始)させることができます。例えば、アプリが完了するたびに発動するアプリレベルのトリガーを作成できます。

トリガーキュー

Trigger Event(例:ボタンのクリック)は、Tulip Player内で実行されるよう、順次処理されるシングルスレッドのTrigger Queueにトリガーを追加します。

Trigger queue and events graphpic.png

Trigger Queueが影響する対象:1.関数: * 関数はトリガーキューに含まれます2.カスタムウィジェット: * カスタムウィジェット内のロジックの実行は、トリガーキューに影響を与える可能性があります

Automations

Automations run in the background, not in an app (even if the Automation is initiated by an action performed in the app), and therefore are not added to the trigger queue.

実行順序

トリガーは、Trigger Event (例:ボタンのクリック、タイマー、テーブル行の選択)に基づいて、一連の順序で実行されます。

トリガーは順次実行されるため、一連のトリガーのうち最初のトリガーが完了してからでないと、2番目のトリガーの実行は開始されません。このトリガー実行の順序は、「トリガーキュー」と呼ばれます。

トリガキューは、変数とのやり取り(テキスト入力、チェックボックスなど)、カスタムウィジェット、カスタムウィジェットのJavaScriptなど、アプリ内の他のタスクとは別個に処理されます。

トリガーでは入力値はどのように使用されますか?

入力値(つまり変数)は、参照によってトリガーに渡されます。

トリガーは、トリガー実行時点での変数の入力値を参照します。トリガーが実行される前に入力値が変更された場合、トリガーは最新の値を参照します。

変数はアプリ全体でグローバルに共有されるため、アプリ内の他のロジックによって変更される可能性があります。

:

トリガーはどのような場合にキャンセルされますか?

以下の場合、トリガキュー内のトリガーはキャンセルされ、実行されません:

  1. 遷移後にトリガーがキューに入れられた場合遷移(「次へ」、「アプリを完了」、「ステップ名で移動」など)が実行されると、キューに残っているトリガーはすべてキャンセルされます。
  2. **Tulip Playerの強制終了:**オペレーターがPlayerを強制終了した場合(例:アプリが応答しなくなった場合)、実行中のトリガーに残っているアクションおよびキュー内の残りのすべてのトリガーがキャンセルされます。

エラー処理

以下のシナリオでは、トリガーのエラーおよびそれに伴うキャンセルが発生します:

  1. トリガーアクションのエラー
  2. トリガーのタイムアウト

トリガーアクションのエラー

NOTE

The Show Error action (show a message to the operator with a red background) does not count as a trigger error.show error trigger (1).png

トリガー内のアクションでエラーが発生した場合、そのトリガー内の残りのアクションはスキップまたはキャンセルされます:

エラー発生後、デフォルトでは、キュー内およびトリガーイベント内の残りのトリガーは、以下のアプリおよびステップレベルのトリガーについては実行されません:* アプリの開始* アプリの完了* アプリのキャンセル* ステップ進入時* ステップ退出時

Trigger error handling ex.gif

その他のすべての種類のトリガー(例:ボタンが押されたとき)については、「エラー時に残りのトリガーを停止する」トグルはデフォルトで無効になっています。

トリガーのタイムアウト

トリガーがタイムアウトした場合(「トリガーのタイムアウト」を参照)、キュー内の残りのトリガーはすべてキャンセルされます。

技術的な動作

トリガーの実行時間

  • トリガーは、単一のトリガー実行時間内で順次実行されます。トリガー実行時間とは、Tulip 内でトリガーがアクティブに実行されている期間のことです。
  • トリガーが並行して実行されたり、他のトリガーのバックグラウンドで実行されたりすることは決してありません。現在実行中のトリガーが終了するまで、新しいトリガーの実行は開始されません。
  • トリガーの実行中も、オペレーターはアプリを操作(ボタンのクリックやテーブルの操作など)することができます。これらのボタンクリックやその他のトリガーイベントにより、新しいトリガーがトリガーキューに追加されます。

トリガーのタイムアウト - LTS15 / r332 時点で更新

トリガーのデフォルトのタイムアウト期間は10分です。この時間が経過すると、トリガーおよび残りのアクションはキャンセルされ、キュー内の他のすべてのトリガーもキャンセルされます。

この10分間のタイムアウト期間は、Trigger Eventに適用されます。たとえば、ボタンのクリックによって5つのトリガーが起動された場合、トリガーキュー内の5つのトリガーすべてと、それに対応するアクションは、10分以内に実行されなければなりません。

トリガーの実行時間が30秒経過すると、アプリはオペレーターに次のメッセージを表示します:r331 trigger wait1.png

トリガーの実行時間が100秒経過すると、アプリはオペレーターに次のメッセージを表示します:r331 Trigger wait2.png

10分経過後、トリガーはキャンセルされ、アプリには次のエラーメッセージが表示されます:r331 trigger cancel2.png

オプションのタイムアウト設定

以下の方法を使用して、インスタンスのタイムアウト設定を編集します:

  1. Tulipでは、最初の100秒経過後にオペレーターが長時間実行中のトリガーを手動でキャンセルできるようにする設定を有効または無効にできます。この機能を有効にするには、Tulipサポートにお問い合わせください。

  2. Tulipサポートでは、タイムアウト期間を短縮または延長することができます。なお**、ロジックが確実に完了する可能性を高めるため、Tulipでは10分間のタイムアウト期間を初期設定として推奨しています。**トリガーの実行に常に数分以上かかる場合は、以下の点を検討してください:

    • トリガーロジックを簡素化し、オペレーターの操作性を向上させるとともに、トリガー失敗の可能性を低減する。
    • 可能であれば、ロジックの実行をオフロードし、オペレーターの継続的な作業が妨げられるのを軽減するために、バックグラウンドでオートメーションを起動する。
    • トリガーロジック内のサードパーティシステムへの依存関係(例:処理が遅いコネクタ関数、最適でないAPIの使用など)を見直し、最適化してください。

テーブルレコードの操作

Record history widget

Inconsistent sequencing of Trigger Actions will result in inconsistent user experience when reviewing audit trails in the Record History Widget.

テーブルレコードの作成

新しいテーブルレコードを作成する場合、ベストプラクティスとしては、「テーブルレコード/レコードの作成」アクションの直後に、対応するデータ操作アクションを実行して、新しく作成されたテーブルレコードの他の列にデータを入力することです。

「テーブルレコード/レコード作成」アクションと、他の列にデータを設定するアクションの間に他のアクションがある場合、そのテーブルレコードの生成は、レコード履歴ウィジェットに個別のイベントとして表示されます。

テーブルレコードの作成 – LTS15 / r332 以降

LTS15 以降、「**テーブルレコード/レコード作成」**と「データ操作/保存」の連続したテーブル操作は、同じレコードに対して束ねられます。つまり、トリガー内の「作成」アクションと「データ操作」アクションは、1 つのトランザクション内で実行されます。

「レコードの作成」と「データ操作/保存」の間に他のアクション(変数や他のテーブルレコードに対するデータ操作、コネクタ関数など)が存在する場合、これらのアクションは1つのトランザクションにまとめられません。

以下の例のトリガーでは、「レコードの作成」アクションと「データ操作/保存」アクションがバンドルされ、すべて成功するか、すべて失敗します。アクションがすべて失敗した場合、回復力のある再試行により、これらはまとめて再試行されます。

例 1: 同じテーブルレコードに対する連続したレコード作成とデータ操作これらはLTS15 ではすべて成功するか、すべて失敗しますが、LTS12 以前ではそうではありません。table record create lts15 ex1.png

例 2: 同じテーブルレコードに対する連続した作成およびデータ操作の後にコネクタ関数アクションが続く場合テーブルレコードの作成およびデータ操作アクション自体は、LTS15 ではバンドルされます。コネクタ関数アクションは、テーブルアクションが成功したかどうかに関係なく失敗する可能性があります。table record create lts15 ex2.png

以下のトリガーでは、2つの異なるテーブルレコードに対して「データ操作/保存」アクションが行われているため、これらのアクションは単一のトランザクションにまとめられません。

例 3: 別のデータ操作アクションを挟んで、同じテーブルレコードに対する「テーブルレコード/作成」と「データ操作/保存」が行われる場合。これらのアクションは単一のトランザクションにまとめられません。table record create lts15 ex4.png

以下のトリガーでは、前のアクションで作成されたテーブルレコードのメタデータが「データ操作/保存」アクションのデータ入力として使用されているため、「テーブルレコード」アクションと「データ操作/保存」アクションは1つのトランザクションにまとめられません。

例 4: 自身から読み取ったデータを使用した作成および更新。これらのアクションは、単一のトランザクションにバンドルされません。table record create lts15 ex5.png

バンドルされたテーブル更新アクションで集計を使用する場合、集計値は更新が行われる前に取得されます。集計値には、バンドルされたテーブルレコードの更新は反映されません。

例 5:集計を使用した作成および更新 これらのアクションはバンドルされ、集計値は作成アクションが行われる前に取得されます。create records bundle with aggregations ex1.png

テーブルレコードの更新

同じテーブルレコードに対する連続したデータ操作アクションは、1つのネットワークリクエストで実行されるようにバンドルされるため、すべて同時に実行されます

テーブルレコードに関連するトリガーアクションは、アクションの種類と順序に基づいてグループ化されます。保存先が同じストアアクションは、1つのネットワークリクエストにまとめられます。一方、「レコードの読み込み」や「レコードの作成」などのアクションは、個別のトランザクションとして扱われます。

最高のパフォーマンスを得るためには、同じレコードに対する更新をまとめて実行することをお勧めします。つまり、同じレコードへの更新を、他のテーブルやデータ操作と混在させないようにしてください。

例 1: 同一レコードへの連続した更新 これらのアクションは 1 つのトランザクションにまとめられます:table record update ex1.png

例 2: 他の操作で区切られた同一レコードへの更新同じテーブルのレコードが連続していないため、これらの操作は1つのトランザクションにまとめられません:table record update ex2.png

以下のトリガーでは、2つの異なるテーブルレコードに対してデータ操作/保存アクションが行われているため、これらのアクションは単一のトランザクションにまとめられません。

例 3: 2 つの異なるレコードに対する更新 これらのアクションは、単一のトランザクションにまとめられません。table record create lts15 ex3.png

バンドルされたテーブル更新アクションで集計を使用する場合、集計値は更新が行われる前に算出されます。集計値には、バンドルされたテーブルレコードの更新は反映されません。

例 4: 集計を含む更新 これらの操作はバンドルされます。つまり、集計値は更新が行われる前に計算されます。update records bundle with aggregations ex1.png

トリガー(テーブルアクション)の再試行 — LTS15 / r332 からの新機能

トリガーが再試行するのは、テーブルアクション(例:テーブルデータへの書き込み、テーブルデータの更新、テーブルとのやり取りなど)のみです。

トリガーの実行時間である10分以内に、1つのテーブルアクションが失敗した場合、最大2分間再試行されます。2分経過してもアクションの実行に失敗した場合、トリガーキュー内の残りのアクションおよびトリガーはすべてキャンセルされます。

ネットワーク耐性のあるトリガーを実現するには、トリガーのアクションにテーブル操作とデータ更新のみを含めるようにしてください。耐性のあるテーブルアクションに関するガイダンスについては、「テーブルレコードアクション」を参照してください。

Connector function calls, send emails, and machine monitoring would not be network resilient in LTS15.

トリガーアクションの再試行では、アクションが誤って2回実行された場合でも、結果が重複することはありません。これにより、テーブルアクションによって同じデータが複数回書き込まれることが防止されます。

制限とタイムアウト

制限
トリガーイベントのタイムアウト- この制限時間に達すると、そのイベントに関連付けられたすべてのトリガーはエラーとなり、トリガーキューから削除されます。 - LTS15/r332:Trigger Eventのタイムアウトは10分です。 **- (LTS15/r332以前):**トリガーイベントのタイムアウトは100秒です。
Trigger Queue- この制限に達すると、新しいトリガーイベントはキャンセルされ、実行されなくなります。 トリガキューは、デフォルトで最大100個のトリガーイベントを保持できます。
遷移によって引き起こされる連続したトリガーの数— 例:ボタントリガーによるステップ1への遷移 → 「ステップオープン」で2つのトリガーが実行 → ステップ2への遷移 → 「ステップクローズ」で3つのトリガーが実行 → 「ステップオープン」で1つのトリガーが実行、など。 トリガキューは、遷移によって引き起こされる連続したトリガーを最大100個まで実行します。 この制限に達すると、新しい遷移トリガーはキャンセルされます。
遷移トリガーのタイムアウト(遷移イベントトリガーのタイムアウト) - 「ステップへ移動」、「ステップ進入時」、「ステップ退出時」などの遷移トリガーが完了するまでのタイムアウト **- LTS15/r332:**25 秒(設定可能)

トリガーの種類

トリガーには3つの種類があります:

アプリレベルのトリガー

アプリレベルのトリガーは、以下のイベントに適用できます:

  • アプリの起動
  • アプリの完了
  • アプリのキャンセル

アプリレベルのトリガーには、「アプリ」タブからアクセスできます。App tab triggers

アプリレベルのトリガーの詳細については、こちらをご覧ください。

ステップレベルのトリガー

ステップレベルのトリガーは、以下のイベントに適用できます:

  • 一定の間隔で(「時間指定トリガー」)
  • 機械やデバイスからの入力があったとき(「機械とデバイス」)
  • ステップが開かれたとき
  • ステップが閉じられたとき

ステップレベルのトリガーには、「ステップ」タブからアクセスできます。Step tab triggers

利用可能なステップレベルのトリガーの詳細はこちら

ウィジェットトリガー

ウィジェットトリガーは、ボタンが押されたときに作動します。1つのステップに複数のボタントリガーを設定でき、Tulip Player上でオペレーターがそれぞれのボタンを押すと、それらがトリガーされます。

目的のウィジェットを選択し、「ウィジェット」タブからウィジェットトリガーにアクセスします。

Widget tab triggers

ウィジェットトリガーの詳細については、こちらをご覧ください。

トリガーの作成

  1. の「トリガー」セクションにある**「+」**をクリックします。トリガーエディタが開きます。
  2. アプリ内での役割がわかるように、トリガーに名前を付けます。詳細については、説明文を追加することもできます。

ベストプラクティス

  • エラーに対応できるようトリガーを設定する:トリガーは、エラーが発生した場合に処理を続行するか停止するように設定する必要があります。トリガーは、無効な入力、実行エラー、コネクタ関数の失敗、またはテーブルへの書き込み失敗によってエラーが発生する可能性があります。
  • トリガーが「処理を続行」するように設定されている場合、エラーが発生したトリガーは停止しますが、次のトリガーは処理を続行します
  • トリガーが「停止」するように設定されている場合、そのトリガーイベント内の他のトリガーはすべてキャンセルされます。

Trigger error handling ex

  • 対話型ウィジェットを含むステップでは、実行に時間がかかるトリガーを配置しないようにしてください。ウィジェットは、操作が行われると即座に視覚的に状態が変化します。オペレーターはウィジェット上で操作が即座に行われるのを確認できますが、ネットワークの速度が遅い場合やコネクタの実行に時間がかかる場合、ロジックの実行にわずかな遅延が生じる可能性があります。
  • オペレーターに対し、遷移(例:[次のステップ])をクリックした後は待機するよう指導してください。ステップ上では、遷移の後にキューに入れられたトリガーは実行されません。 オペレーターが遷移を持つウィジェットを操作した場合、その遷移が実行されるまでそのステップに留まります。例えば、オペレーターが「次のステップ」をクリックした後、待機中に別のトリガーを操作した場合、遷移後の残りのトリガーは実行されません。
  • 長時間実行されるコネクタとデータ更新は別々のステップで実行する機密データへの操作は、長時間実行されるコネクタロジックと同じステップで行わないでください。オペレーターが長時間実行されるトリガーや遷移をクリックした後にそのステップを操作した場合、重要なデータが保存されないリスクがあります。
  • 各ステップで変数の入力を1つに限定するレースコンディションを回避するため、変数は競合する入力ロジック(例:アプリ内の複数のボタンが同じ変数を更新する場合)と共有しないでください。例えば、トリガーが変数の現在の値をキャプチャする場合、トリガーが値をキャプチャする前に変数の値が変更されると、データが不正確になります。

関連情報