データ変更アクションで入力値を動的に設定する

データ変更アクションは、データ値を変更する論理演算です。必要な新しい値は式によって定義されます。多くの場合、その値は定数であるか（たとえば、Approve Order アクションで Order のステータスを「Approved」に設定します）、または明確に定義された式を持っています（たとえば、Estimate Delivery Date アクションで Order の配送予定日をこれに含まれる注文のうち最も遅い配送日に設定します）。ただし、アプリのダイアログでユーザーによって、または別の呼び出し元アクションによって入力値を動的に設定することが必要となる場合もあります。

次のように、データ変更アクションで入力値を動的に設定します。

• アクションがアプリで使用されるときに、指定された入力の値を記入するようアプリユーザーに求めるダイアログを表示します。ユーザーにダイアログを表示して行内の列の入力値を動的に設定するをご覧ください。
• アクションが自動化で使用される場合、アプリ作成者はステップの構成時にカスタム入力値を設定します。自動化で一連の行に対してアクションを実行するときに入力値を動的に設定するをご覧ください。
• アクションを Referenced Action から呼び出す場合は（実行中のアプリで呼び出すか自動化で呼び出すかは問わない）、Referenced Action で入力値を使用してバインディング式を指定できます。一連の行に対してアクションを実行するときに入力値を動的に設定する（参照先アクション）をご覧ください。

アクションでは、[_INPUT].[入力の名前] という式を使用して入力値にアクセスします。

アクションの構成時に入力値を追加する方法については、Inputs をご覧ください。

入力値（[_INPUT].[入力の名前]）と INPUT() 関数は、同じアクションまたはタスクでは使用できません。同じ自動化またはアプリでは使用できます。

ユーザーにダイアログを表示して行内の列の入力値を動的に設定する

アクションがアプリで使用されるときに、指定された入力の値を記入するようアプリユーザーに求めるダイアログを表示できます。

たとえば、Orders と Customers を含むアプリを考えてみましょう。Order に対する Change Status というアクションがあり、このアクションでステータスを「Shipped」に変更してコメントも記録するとします。これは、AppSheet では、式によって設定される次の 2 つの列を持つ [Data: set the values of some columns in this row] アクションとして実装されます。

• Status: 「Shipped」
• Details: 「なんらかのメモ」（デフォルトでは「n/a」）

アプリユーザーにとって、このアクションはアプリの [Change Status] ボタンとして表示されます。

アプリユーザーに対し、[Details] 列に保存されるメモを入力するように求めるとします。これを行うには、[Change Status] アクションの [Advanced] セクションを開いて入力値（「Notes」など）を追加し、初期値を「n/a」に設定します。例を次に示します。



その後、式 [_INPUT].[Notes] を使用して、この入力値を [Details] 列の値として設定できます。



アプリユーザーが [Change Status] ボタンをクリックすると、詳細の入力を求めるダイアログが表示されます。

ネストした式（例: [Amount]+[_INPUT].[Amount]）は使用しないでください。ネストした式を指定すると、ユーザー プロンプトが表示されなくなります。

アクションの構成時に入力値を追加する方法については、Inputs をご覧ください。

自動化で一連の行に対してアクションを実行するときに入力値を動的に設定する

自動化で一連の行に対してアクションを実行するときに入力値を動的に設定するには、[Run a data action] ステップを追加して [Set row values] を選択します。アクションが自動化で使用される場合、アプリ作成者はステップの構成時にカスタム入力値を設定できます。

たとえば、次の [Run a data action] ステップは、Change Status アクション（前のセクションで定義）を実行します。アクションを実行するステップごとに、入力値 Notes を設定することでカスタムの詳細を追加できます。

参照先アクションを使用して一連の行に対してアクションを実行するときに入力値を動的に設定する

アクションを Referenced Action から呼び出す場合は（実行中のアプリで呼び出すか自動化で呼び出すかは問わない）、Referenced Action で入力値を使用してバインディング式を指定できます。

時折顧客のアカウントをキャンセルすることが必要になると仮定しましょう。この場合、Customer レコードに対する Cancel Account という 1 つのアクションで、その顧客のすべての注文にアクセスしてステータスを「Complete」に設定し、「Account Cancelled」というメモを付ける必要があります。これを行うには、[Data: execute an action on a set of rows] アクションを追加して、Customer に対して定義できる Referenced Action（参照先アクション）を使用します。このアクションでは、操作の対象となる一連の Orders（この顧客のために作成された注文）と、それらの注文に対して呼び出すアクション（Change Status）を指定できます。そして、Notes 列に必要な値（「Account Cancelled」）を Change Status アクションに渡すために、Notes 値を [Referenced Action] フィールドの式に設定します（この場合は不変のテキスト「Account Cancelled」ですが、一般に、この値は Customer の状況に合った任意の表現にすることができます）。

次に例を示します。