アプリからテーブルを操作する

アプリのエディターでテーブルを修正する方法

フロントライン・オペレーション・アプリケーションからテーブルを読み書きする方法を説明します。

このガイドでは、次のことを学びます。

• アプリ内の既存のテーブルレコードを読み込む方法
• アプリ内の既存のテーブルレコードを更新する方法
• アプリで新しいテーブルレコードを作成する方法
• アプリのCompletionsに基づいてテーブルのデータを分析する方法

App Editorでは、個別のテーブルレコードの読み取り、編集、作成が可能です。テーブルはコードを必要としないため、アプリをPlayerで実行し、テーブルがリアルタイムに更新される様子を見ることができます。

このガイドでは、テーブルとアプリを一緒に使用して、より強力なアプリを作成するためのさまざまな方法について説明します。

アプリを構築する際、特定のデータを変数に保存するか、テーブルレコードに保存するかを決定する必要があります。

Variableは、特定のアプリの個々の使用法に関連するデータに適しています。テーブルは、複数のアプリからアクセスされる必要があるデータに適しています。

テーブルは、次のような概念を追跡するために頻繁に使用されます。

• 作業指示
• 個々の製品のSKU
• 部品表(BOM)
• スキルマトリックス
• ...などなど

この記事を読む前に、「テーブルの概要」を読んで、テーブルの機能を完全に理解する必要があります。

テーブルとアプリを一緒に使用した例をご覧になりたい場合は、作業指示テーブルのウォークスルーをご覧ください。

テーブルのレコードを読み込んだり、更新するには、3つのステップがあります。

**1-**レコードプレースホルダーを作成し、アプリ内で特定のテーブルレコードに名前を付けます。

**2-**トリガーアクションでレコードをロード（または作成）します。

**3a-**テーブルレコードの値のロジックを書きたい場合、"If "ステートメントにテーブルレコードを含めます。

**3b-**レコードの個々のフィールドを更新したい場合は、"Then" ステートメントにテーブルレコードを含める。

レコードプレースホルダーの作成

まず、テーブルレコードにアクセスするアプリで、「レコードプレースホルダー」を作成する必要があります。これは、後にTriggerロジックで動的にロードされるレコードのプレースホルダです。

例えば、アプリで「Work Orders」テーブルのレコードを編集したい場合、「Active Work Order」というレコードプレースホルダーを作成します。その後、オペレータの入力に基づいてレコードを動的にロードしますが、それは常に "アクティブな作業指示" として参照されま��。

これらのプレースホルダーを設定するには、ステップリストの横にあるレコードタブをクリックします。

[

次に、"テーブルの追加 "を選択します。次に、"レコードプレースホルダー "の追加をクリックします。トリガーから動的にロードされるレコードに名前を付けることができます（例：「アクティブな作業指示書」）。

{height="" width=""}.

分析用に保存する "という設定があることに注意してください。選択すると、このレコードプレースホルダに読み込まれたテーブルレコードが、アプリの完了レコードに保存されます。補完のデータには、そのレコードへのリンクが表示されます。

レコードプレースホルダーの削除

レコードプレースホルダーを削除するには、画面左側のレコード一覧からプレースホルダーを選択します。下の例では、「Test Record Name」を選択します。

次に、以下のメニューから[削除]を選択します。

これで、Trigger Editorを使ってレコードを動的に選択する準備が整いました。

Trigger Editorでレコードにアクセスする

レコードプレースホルダを作成したら、次はオペレータの入力に基づいてレコードを動的にロードしたり作成したりするロジックを記述します。

これを実現するには、"Table Records" と "Data Manipulation" のトリガーアクションを使用します。以下はその方法です。

次にステートメント

複数の種類のTrigger Actionを使用して、テーブルレコードを読み込んだり、変更したりすることができます。以下、簡単にまとめます。

テーブルレコード／レコードを読み込む特定のIDを持つレコードを読み込む

***テーブルレコード/レコードの作成。***特定のIDを持つ新規レコードを作成

***テーブルレコード/レコードの作成または読み込み。***特定のIDを持つレコードが存在しない場合は、それを作成します。そうでなければ、特定のIDを持つレコードをロードする。

既存のレコードの読み込み

レコードを読み込んだり編集したりするには、まずアプリにレコードをロードしてプレースホルダー名を付ける必要があります。これは、ステップを開いたり、ボタンを押したりすることで頻繁に発生します。

一度に1つのレコードをロードでき、レコードを選択するためにユニークなID（テーブルの最初のフィールド、テキスト値）を使用する必要があります。

これを実現するには、"Table Records" "Load Record" ステートメントを使用します。

{height="" width=""}.
* "レコードの読み込み"
* IDによって： "テキスト" - 0146
* active_wo "プレースホルダーに入れる。

この例では、IDが「0146」のレコードがすでに作業指示テーブルに存在しています。

各テーブルの「ID」フィールドはテキスト・フィールドなので、個々のレコードにアクセスするにはテキストを使用する必要があります。IDを選択するために、すべての典型的なオプションを使用することができます。

• テーブル レコード
• 式
• 静的な値
• アプリ情報
• 変数

変数を使った例。

{height="" width=""}.

• "テーブルレコード" "ロードレコード" by ID: "Variable" "text_wo_id" into:"アクティブワークオーダー"

フォームステップのテキストウィジェットのオペレータ入力に関連する場合など、入力が動的である場合に変数を使用する必要がある可能性が高いです。

新規レコードの作成

テーブルに新しいレコードを作成したい場合、"Create" または "Create or Load" オプションを使用する必要があります。

作成」を使用する場合、テーブルにまだ存在しないIDを持つ新しいレコードを作成する必要があります。そのレコードがすでにテーブルに存在する場合、アプリはエラーをスローします。

Create or Load"を使用すると、特定のIDを持つレコードがすでに存在する場合はロードされ、そのIDがテーブルに存在しない場合は作成されます。

この場合、id "newID "を使って新しいレコードを作成します。

• "テーブルレコード" "レコードの作成"
• by ID: "静的値" "テキスト" "newID"
• を入力します。"active_wo "とします。

通常、オペレーターがアプリを使用するたびに新しい値を作成したいので、このフィールドには変数のような動的な値を使用する必要があります。

トリガーエディタでのレコードの編集

レコードを編集するには、"Data Manipulation" アクションを使用し、次に "Store" を使用してレコード内の値を編集または更新します。

レコードを編集するには、"Table Records" "Load" または "Table Records" "Create" により、すでにレコード・プレースホルダとしてロードしておく必要があります。

以下は、"active_wo "としてロードされたレコードの "status "フィールドを更新する例である。

{height="" width=""}.

{高さ="" 幅=""}です。

• "データ操作"
• "ストア"
• "テキスト""合格"
• "テーブルレコード" "active_wo"
• フィールド"ステータス"

例えば、オペレーターがボタンを押して変更を指示する場合など、一般的にはウィジェット・トリガーを使ってこれを行います。

また、テーブルレコードから値をインクリメントすることもできます。この方法については、インベントリテーブルのガイドを参照してください。

テーブルレコードで条件付きロジックを使用する

特定のレコードのフィールドの値に基づいて、アプリのロジックを変更することもできます。

これを行うには、レコードがすでにロードされていることを確認します。次に、レコードからフィールドを選択し、他の「if」文で使用するのと同じロジックを使用します。

*テーブルのレコード。*ロードされたテーブルレコードのフィールドに特定の値があるかどうかをチェックします。

{height="" width=""}.

• "テーブルレコード" "TestImg" "ID" "Contains" ...
• Table:*指定したIDのレコードがすでにTableに存在するかどうかを確認する。

{height="" width=""} ...

• "テーブル" "ワークオーダー" "IDを持つレコードがある" "静的な値" "テキスト" "001"

以下はその例です。この場合、"status "フィールドに他のテキストが含まれているかどうかをチェックします。

{height="" width=""}.
* "テーブルレコード" "active_wo" "status"
* "含む"
* "静的値" "テキスト" "合格"

また、"If "ステートメントを使って、与えられたIDのレコードがすでに存在するかどうかをチェックし、特定のエラーメッセージを投げるなどの方法もあります。

以下は、オペレータに別の作業指示番号を入力するように促すエラーメッセージを作成する方法です。

{height="" width=""}.

IF

• "テーブル" "ワークオーダー" "IDを持つレコードがある"
• "静的な値" "テキスト" "024dfg45"

THEN

• "Show Error" "Static Value" "text" "This work order already exists, please enter a new one".

ステップにテーブルレコードを表示する

このレコードをステップに追加するには、Widget Menuの「Text」ボタンの下にある「Table Record」オプションを選択します。

[

コンテキストペインのウィジェットタブで、「レコード」横のオプションからレコードプレースホルダーを選択すると、プレーヤーに表示されます。

[

これは、例えば、オペレータに作業指示の詳細を表示するためによく使われます。

また、アプリを構築しているときに、特定のテーブルレコードの値がわからない場合にも役立ちます。

個々のフィールドを表示から並べ替え/削除するには、コンテキスト・ペインでプロパティ上の x またはグリッド・シンボルをクリックします。

列の数を変更するには、コンテキストペインの「列」オプションを使用します。

ラベルや値の表示を変更するには、「コンテキストペイン」で色やフォントサイズを調整します。

このデータがどのようにオペレータに表示されるかを確認するために、プレイヤーでアプリを実行すると、テーブルレコード全体を見ることができます。最初にレコードを読み込むと、値が含まれるようになります。

レコードのプレースホルダをクリアする

レコード プレースホルダをクリアして、そのレコード プレースホルダの下にある特定のレコードがアプリにロードされないようにしたい場合があります。

その方法は次のとおりです。

• "テーブルレコード" "レコードプレースホルダーのクリア"

ユーザーとそのフィールドを表示する

ユーザーとその関連フィールドのレコードプレースホルダーを作成し、埋め込みテーブルで特定のユーザーをロードすることもできます。詳しくは、別冊の「ユーザーフィールド」をご覧ください。

その他の資料

• 最初のテーブルを作成する (チュートリアル)
• テーブルレコードのデータを分析する方法
• アプリでレコードのリストを表示する

お探しのものは見つかりましたか？

また、community.tulip.coに質問を投稿したり、他の人が同じような質問に直面していないか見てみるのもよいでしょう。