記録履歴ウィジェットの使用タイミングや、ニーズに合わせて設定する方法について学びましょう。
この機能を利用できるユーザー
「Regulated」プランをご利用のユーザー。
記録履歴ウィジェット(RHW)は、特定のテーブルレコードに関連する記録データを表示します。これには以下が含まれます:
- テーブルレコードへの変更
- 完了レコードからのデータ
- 電子署名(そのレコードが署名済みデータとして含まれている場合)

TulipにおけるGxPデータ収集について理解し、レコード履歴ウィジェットをいつ使用すべきかを把握することが重要です。
このウィジェットは、次のような、特定の製造品の履歴を記録したいユースケースで使用できます。
- ログブック
- コンプライアンスおよびトレーサビリティ
- デジタル履歴記録
レコード履歴ウィジェットはどのように機能するのでしょうか?
記録履歴ウィジェットは、以下の情報源からデータを収集・表示することで、特定のレコード ID に関する可視性を提供します。
- アプリ
- テーブルAPI
- Table UI(管理画面)
- Automation

上の図は、さまざまなソースごとの更新例を示しています。
レコード履歴ウィジェットには、1つのレコードIDに関連する以下のデータが表示されます。
- アプリ、テーブルUI、テーブルAPI、オートメーションを通じて、そのレコードのフィールドに加えられた変更
- アプリの完了時にレコードプレースホルダーで指定されていた完了データ
- 署名データとしてそのレコードを含むすべての署名
このウィジェットは、レコードの履歴を時系列順にスクロール可能なビューで表示し、更新(ステップの変更など)があると更新されます。このビューにより、ユーザーは、そのレコードが作成されてから現在に至るまでの変更内容や関連情報を確認できます。
たとえば、アプリ、オートメーション、またはテーブル UI を通じてレコードが更新された場合、その変更はウィジェットによって時系列順に記録されます。

上記のワークフロー図は、レコード履歴ウィジェットがさまざまなソースからのレコード情報をどのように取得するかを示しています。各ステップで、元の変数の新しい反復が保存されます。レコード履歴ウィジェットは、アプリの稼働期間中に実行された各更新の詳細を表示します。
レコード履歴ウィジェットではデータはどのように表示されますか?
セクション
各ソースから収集されたデータは、セクションとエントリを使用して可視化されます。すべてのデータは時系列順に表示され、セクションは同じセッションに属するデータをグループ化します。セッションは、データソースに応じて異なる要素によって定義されます:
- アプリ:ユーザー + アプリ(バージョン) + ステーション
- API:API(トークン)
- Table UI:ユーザー + 管理インターフェース
- オートメーション:オートメーション名
前のエントリと同じセッションからエントリが作成されなかった場合、新しいセクションが表示されます。例:
- アプリを実行しているユーザーが変更された
- レコードがまずアプリから更新され、その後管理インターフェースから更新された

エントリ
各セクション内には、1つまたは複数のエントリが含まれます。エントリには、レコードの変更、署名、または完了記録に関する情報が含まれる場合があります。すべてのエントリにはタイムスタンプが付与されます。
レコードの変更に関連するエントリ
レコードの変更に関連するエントリには、修正を含めたレコードの完全な履歴が表示されます。これには以下が含まれます:
- レコードの作成
- レコードの更新
- レコードの削除
- すべてのレコードの削除
- ステップ/アプリの変更(このステップでデータが収集された場合にこれらのエントリが発生します)

上記の例は、ユーザー(John Smith)+アプリ(Assemble History Tester)+ステーション(未命名)のセクション見出しと、2つのエントリを示しています。1つ目はアプリのステップを示し、2つ目は更新されたレコードの旧値と新値を表示しています。
オプションとして、キャンセルされたアプリ完了や自動ログアウトされたアプリ完了は、通常の完了と区別するために「キャンセル」バッジが付いたグレー表示で表示される場合があります。このUI動作を有効にするには、CSMまたはTulip管理者にお問い合わせください。

さまざまな種類のデータを収集する
完了レコード
完了レコードは、変数の値、読み込まれたレコードのプレースホルダー、ユーザーやステーションなどのメタデータなど、アプリのプロセスデータを記録します。アプリが完了、キャンセルされた場合、または「すべてのアプリデータを保存」トリガーアクションが実行された場合、そのアプリに対して新しい完了レコードが作成されます。収集されたデータは、レコード履歴ウィジェット内で「記録されたプロセスデータ」として表示されます。

レコード履歴ウィジェットに完了データを表示するための要件:
- 完了レコードが作成された際、そのレコードが任意の「テーブルレコードプレースホルダー」に読み込まれていること
- テーブルレコードプレースホルダーが「分析用に保存」に設定されていること
レコード履歴に表示されるデータ:
- 変数の値:「分析用に保存」に設定されたすべての変数が含まれます。
- レコードID:「分析用に保存」に設定されたレコードプレースホルダーに読み込まれたレコードのID。ただし、レコード履歴が表示されているレコード自体は除外されます。
テーブルレコードデータの変更
テーブルレコードデータの変更は、以下の3つの方法で行うことができます:
- アプリ内でのレコードプレースホルダー経由(ステーションYからアプリXを実行)
- テーブル UI(管理インターフェース)
- テーブルAPI
- オートメーション
レコード履歴ウィジェットには、テーブルレコードへの変更に関する次のような情報が表示されます:
- どのような変更が行われたか?
- 誰が更新したか?
- どのチャネルから更新が行われたか?(アプリ、テーブル UI、テーブル API)
- どのインターフェースで更新されたか?
- 変更はいつ行われたか?
レコードプレースホルダーによるレコードへの変更
「John SmithはStation YでApp Xを実行しました」ウィジェット内の個々のレコード表示に加えられたすべての変更は、テーブルレコードの変更前後のスナップショットが掲載されたセクションに表示されます。これらの変更は、どのアプリを使用しているかに関係なく表示されます。
例
テーブル UI(管理インターフェース)によるレコードの変更
「管理インターフェースを通じてレコードを更新しました」テーブルの管理インターフェースを通じて行われた変更は、新しいセクションに表示されます。以下の内容を含め、すべての変更が個別のエントリとして表示されます:
- ログインユーザー
- 変更の種類
- 変更前の値と変更後の値
- タイムスタンプ
例

Table API によるレコードの変更
*「API によるレコードの更新」*指定されたテーブルのレコードを変更する API リクエストは、新しいセクションに表示されます。これには以下が含まれます:
- APIトークン
- 変更の種類
- 旧値と新値
- タイムスタンプ
例

オートメーションによるレコードの変更
*「オートメーション X がレコードを更新しました」*テーブルのレコードへの変更は、オートメーションを使用して行うことができます。これらは新しいセクションに表示され、以下が含まれます:
- オートメーション名
- 変更の種類
- 旧値と新値
- タイムスタンプ
例

設定
アプリステップにレコード履歴ウィジェットを追加する
- アプリエディタで、ツールバーの [埋め込み] をクリックします。
- 「レコード履歴」を選択します。

設定オプション
コンテキストペインでレコード履歴ウィジェットを設定します。

リンクされたプレースホルダー
レコードおよびレコード履歴を読み込むレコードプレースホルダーを選択します。
印刷を有効にする
Tulip Player からレコード履歴を印刷するためのオプションです。有効にすると、ウィジェットのヘッダーに印刷ボタンが表示されます。
デフォルトの並べ替え
ウィジェット内のデータを以下のいずれかの順序で並べ替えるように選択します:
- 新しい順から古い順
- 古い順から新しい順
フィルタ
レコード履歴は、動的に(変数、テーブルレコード、またはアプリ情報を通じて)フィルタリングすることも、フィルタの種類によって決定される静的な値を通じてフィルタリングすることもできます。利用可能なフィルタの種類は以下の通りです:
- 日時
- アプリ名
- ステップ名
- テーブルのフィールド名(レコードプレースホルダーがリンクされたテーブル内のフィールド)
- ユーザー(アプリを利用しているユーザー)
Tulipでは、データをユーザーにとってより理解しやすい形式で切り分けられるため、少なくとも以下のフィルターを使用することを推奨しています:
- 日時
- アプリ名
- ステップ名
レコード更新時の「古い」値を非表示にする
この機能を有効にすると、ユーザーにはレコードの更新内容と「新しい」値のみが表示されます。
プロセスデータを非表示にする
有効にすると、アプリから保存された変数データがウィジェット上で非表示になります。ウィジェットには、テーブルの更新内容、署名データ、アプリ名、ステップ名、およびタイムスタンプが表示されます。これは、純粋なレビューアプリなど、(プロセスデータを含まない)概要を把握するのに役立ちます。
署名済み完了件のみ
有効にすると、ユーザーには電子署名付きのレコードのみが表示されます。
よくある質問
ログタイプの詳細なデータが表示されないようにするにはどうすればよいですか?
テーブルレコードが入力フィールドに読み込まれ、ユーザーが入力フィールドにログを記録すると、同じエントリ内で非常に詳細なログタイプのデータが生成されます。これにより、レコード履歴内に多数の「エントリ」が生成され、レビュープロセスが困難になる可能性があります。**入力フィールドのデータソースとしてテーブルレコードを使用することは、特にGxPのお客様にとってはベストプラクティスとは言えません。**代わりに、入力フィールドを変数にリンクし、その変数を「すべてのアプリデータを保存」ステップによって完了レコードに保存するようにすることができます。
静的値を使用する際、「テーブルフィールド名フィルター」に注意を払うことがなぜ重要なのでしょうか?
レコード履歴ウィジェットは、データのフィルタリングにフィールドの現在の名前を使用します。ユーザーがテーブルのフィールド名を変更したにもかかわらず、フィルタが依然として古いフィールド名を使用している場合、データレビューに不整合が生じる可能性があります。あるいは、テーブルレコード自体をフィルタとして使用することも可能です。
「ステップ X での完了データが欠落しています」という問題を解決するには?
これは、ユーザーがテーブルレコードに対して操作を行うたびにアプリを完了させていない場合、つまり、ユーザーが1回の完了処理で複数のレコードを処理している場合、またはテーブルレコードのプレースホルダーで「分析用に保存しない」がチェックされている場合に発生する可能性があります。


