特定の列と行から値を取得する式を書く
列値の式は、行内の特定の列の値を返します。行そのものを指定する必要はなく、通常は式の文脈で暗黙的に指定されます。
| 式 |
説明 |
[Column] |
現在のテーブルの列の値。
例:
|
Table[Column] |
テーブルの特定の 1 列内のすべての値。
例: IN("Complete", Order[Status])
|
[RefColumn].[Column]
|
RefColumn で参照されている行に含まれる列 Column の値。RefColumn は Ref 型である必要があります。式の逆参照を参照してください。
例: [Order ID].[Status] = "Complete"
|
[ListRef][Column] |
ListRef で参照されている行に含まれる列 Column 内のすべての値。ListRef は List 型で、かつサブタイプが Ref である必要があります。
例: [Related Orders][Status]
|
[_THIS] |
現在の行の現在の列の値。主に列制約で使用されます（Editable if、Required if、Show if、Valid if など）。
例:
AND((LEN([_THIS]) > 3), CONTAINS([_THIS], "@")) は、現在の列の値（Valid if などで取得）が 3 文字以上で、その値に 1 個以上の @ 記号が含まれている場合に TRUE を返します。
|
[_THISROW].[Column] |
式の中でコンテキストが別のテーブルに設定されている場合、現在のテーブル内の列の値。[_THISROW] を単独で指定し、[Column] を省略した場合、key 列の値が返されます。
例:
FILTER("注文", ([顧客] = [_THISROW].[顧客])) は、注文データセットに含まれる行のうち、顧客列の値が現在のフォームの顧客列の値と等しい（つまり、この顧客の注文）行のキーを返します。
SELECT(Orders[注文 ID], ([顧客] = [_THISROW].[顧客])) は、注文データセットの行のうち、顧客列の値が現在のフォームの顧客列の値に等しい行の注文 ID 列の値（行キー）を返します。
|
[_THISROW-n].[Column] |
親レコードまたは祖父母レコードに含まれる列の値。
以下でのみ使用できます。
|
[_THISROW_AFTER].[COLUMN] |
データ変更のコンテキストで、列が更新された直後の値。
注: [_THIS].[COLUMN] と同様です。変更後の値を使用したい場合は _THISROW_AFTER を使用します。ただし、これは bot の実行中に加えられた変更が反映される前の状態の値となります。
After 値には、シートやデータベース レコードから取得されたすべてのフィールド値が含まれており、これは適用後の状態を示します。また、これには以下が含まれます。
- すべての仮想列の値。仮想列の値は、After の値が取得されるときに再計算されます。これによって、仮想列の値に最新のフィールドの値を確実に反映できます。
- Google スプレッドシート、Microsoft Excel、SmartSheet のワークシートの数式によって計算されたフィールド値。これにより、これらのワークシートの数式によって計算されたフィールドの値を表示または参照できます。
詳しくは、更新前後の列の値にアクセスするを参照してください。
たとえば、テンプレートの Priority 列について After の値を表示すると次のようになります。
The new value of Priority is <<[_THISROW_AFTER].[Priority]>>
|
[_THISROW_BEFORE].[COLUMN] |
データ変更のコンテキストで、列が更新される直前の値。
Before 値には、シートやデータベース レコードから取得されたすべてのフィールド値が含まれており、これは適用前の状態を示します。また、これにはすべての仮想列の値が含まれます。仮想列の値は、Before の値が取得されるときに再計算されます。これによって、仮想列の値に最新のフィールドの値を確実に反映できます。
詳しくは、更新前後の列の値にアクセスするを参照してください。
たとえば、テンプレートの Priority 列について Before の値を表示すると次のようになります。
The old value of the Priority columns was <<[_THISROW_BEFORE].[Priority]>>
|