Tulipアプリのデータを長期保存する方法の一つに、「App Completions」があります。この記事ではその方法について解説します。
この記事では、以下の内容について解説します:* アプリに「完了」ボタンを設けるべき理由* アプリ完了のトリガーにはどのような種類があるか* アプリの完了またはキャンセル時に保存されるデータ* アプリ完了に関するベストプラクティス
Read more about [completions](/r230/docs/<span translate=)">Completions data.
アプリの完了方法
Tulipアプリの情報を保存するには、オペレーターが「アプリを完了」する必要があります。これを可能にするには、アプリに「完了」ボタンを追加する必要があります。
オペレーターが「完了」ボタンを使用するたびに、「完了」タブに新しい行が追加されます。各行には以下の情報が含まれます:
- アプリ完了情報(ステーション名、オペレーターのバッジID、アプリの開始日時および終了日時など)。
- アプリが完了した時点でのすべての変数とその値。
- オプション:完了時にアプリに読み込まれていたテーブルレコードを保存対象に含めるかどうかを選択できます。
アプリで定義されているすべての変数(例:バーコード、ログインしたオペレーター、所要時間、点検結果)が、このビューの列として表示されます。オペレーターが「アプリを完了」すると、リストに新しい行が追加されます。
アプリを完了すると、すべてのフォームステップの値が保存され、クリアされます。
実際、個々のアプリの [完了] タブに移動すると、まさにその内容が表示されます。

オペレーターがアプリを完了させた際、「アプリを完了」させる方法はいくつかあります。
アプリエディタに組み込まれている「完了」ボタンを使用するか、「アプリを完了」という遷移を持つカスタムトリガーを作成することができます。
完了ボタン
ツールバーから[ボタン]を選択し、[完了]を選びます。

「新しい遷移を追加」ボタンを使用して、アプリの完了遷移を手動で追加することもできます:

カスタムトリガーを使用する:
上記の例の場合、「完了」ボタンのロジックはデフォルトで次のように設定されています:
- 「ボタンが押されたとき」
- その際、「アプリ」→「アプリ完了」となります。

ただし、この遷移は、ワークフローの終了に対応する任意のトリガーに追加することができます。例えば:

- 「デバイス」の「GPIO」が「このステーション」で「ピンダウン」イベントを出力したとき
- If、「デバイス出力」「ピン」「=」「静的値」「整数」「2」
- それなら、「アプリ」の「アプリ完了」
この例では、このステップでGPIO I/Oゲートウェイのピン2に「ピンダウン」信号を送信するIoTデバイスがあれば、アプリが完了します。
「アプリを完了」の他に、以下の2つのオプションがあります:
「完了後、次のステップへ」:アプリを完了させた後、別のアプリに切り替えます。
「完了後、ステップへ切り替え」:アプリを完了させた後、同じアプリ内の別のステップ、または別のアプリの特定のステップに切り替えます。
**「完了してスプラッシュ画面へ」:**アプリを完了し、そのアプリのスプラッシュ画面に移動します。オペレーターが「開始」ボタンを押すまで、アプリは起動しません。
「完了後、現在のユーザーをログアウト」:アプリを完了させた後、現在のユーザーをログアウトします。
**「完了後、アプリ名を指定して切り替え」:**アプリを完了した後、変数などにあるアプリからの値で指定できる別のアプリに移動します。
**完了後、指定されたステップへ移動:**アプリを完了させ、変数などを通じてアプリ内の値で指定可能な、同じアプリ内の別のステップに移動します。
注:アプリは、Tulip Playerから実行されている場合にのみ完了できます**。**アプリが完了すると、オペレーターには以下に示すメッセージが表示されます。

アプリをキャンセルする
あるアプリの使用時に、データを保存したくない場合を想定します。この場合、「アプリをキャンセル」し、特定のステップに戻る必要があります。これにより、アプリが最後に開かれてからのすべてのデータが消去されます。
アプリの完了トリガー遷移に直接対応するトリガー遷移は5つあります:

- アプリをキャンセル
- キャンセル後、次のステップへ
- キャンセルしてステップへ移動
- キャンセルしてスプラッシュ画面へ移動
- キャンセルして現在のユーザーをログアウト
アプリの完了に関する技術的詳細
アプリの完了またはキャンセルごとに自動的に保存されるデータ項目は以下の通りです:
- **開始時刻:**オペレーターが最初のステップを開いた日時
- **終了時刻:**オペレーターが「完了」または「キャンセル」ボタンを押した日時
- **所要時間:**開始時刻と終了時刻の間の時間
- **ログインユーザー:**Tulip PlayerにログインしたユーザーのバッジIDに基づく
- ステーション名:「Shop Floor」タブで指定された、アプリが使用されたステーションの名前
- **コメント:**Playerメニューでアプリ全体に対して入力されたコメント
- **バージョン:**アプリが完了した時点でのバージョン
- **キャンセル:**アプリがキャンセルされたかどうか
- **実行ID:**その特定の実行におけるアプリの一意のID
- **最後に表示されたステップ名:**ユーザーがアプリを完了またはキャンセルする前に最後に表示されたステップの名前
ベストプラクティス
Shop Floorの設定では、ステーショングループレベルまたは特定のステーションのいずれかで、アプリの「最新公開バージョン」を割り当てるのが一般的な慣行です。
ステーションが最新公開バージョンの実行を開始するには、以下のいずれかを行う必要があります:
- 「メニュー」→「アプリを再起動」からアプリを再起動する。
- 「アプリ/アプリを完了...」への遷移が行われる。
- 「アプリ/アプリをキャンセル...」遷移が使用される。
このため、Tulipアプリの使用中に、いずれかの時点でこのような遷移が実行されるように設定することがベストプラクティスです。
:::(警告) (ヘッドレスアプリでは「App / Complete App」を使用してください)
「ヘッドレスアプリ」(例:Machines & Devicesトリガーの実行など)を使用している場合は、定期的に「App / Complete App」遷移を実行するタイマートリガーを追加することを検討してください。
Tulip Stationが「Most recentlypublished version 」に割り当てられている場合、これによりアプリが直近のpublished version で確実に実行されるだけでなく、潜在的なメモリリークによって引き起こされる可能性のある問題も軽減されます。
:::
アプリ完了時のデータ削除
製造に関するGxP基準に準拠するため、Tulip内のデータを削除することはできません。
ただし、回避策があります。アプリをコピーして古いものを削除すれば、エントリのない新しいテーブルが作成されます。
Analyticsから完了データを非表示にする
「完了」タブの一部のデータを分析対象から除外したい場合があるでしょう。これを行うには、「完了」タブで除外したいレコードを見つけ、「分析に含める」チェックボックスのチェックを外してください。これにより、そのレコードが分析対象から除外されます。

このレコードを分析対象から除外しても、完了データ自体からは削除されないため、このデータのエクスポートには影響しません。
