テンプレートで変数を使用する

テンプレートで次のタイプの変数を使用できます。

HTML ブロック内で変数を使用する場合、変数は HTML エンコードする必要があります。たとえば、< 文字は &lt; に、> 文字は &gt; に HTML エンコードします。たとえば、<<[Order Number]>> は以下のように指定しなければなりません。
<html>
&lt;&lt;[Order Number]&gt;&gt;
</html>

列名変数

列名変数を使用すると、1 つのデータ列の値を表示または取得できます。列名はテーブルの列名と完全に一致し、角括弧で囲む必要があります。列名変数はその列の値で置き換えられます。

たとえば、メールのテンプレートで Order Number 列の値を表示するには、次のようにします。

注文番号は <<[Order Number]>> です

: データ列値が HTML ドキュメントに表示される場合、その値は常に HTML エンコードされます。HTML エンコードを使用したクロスサイト スクリプティング攻撃の防止を参照してください。

列値を更新の前と後の両方で表示させることもできます。

式変数

式変数を使用すると、値を計算できます。式変数では任意のを使用できます。式変数は式の評価結果で置き換えられます。

たとえば、以下のように Amt 列値に Qty 列値を掛けた結果を表示できます。

<<[Amt] * [Qty]>>

逆参照式の変数

参照されるレコードの列値を表示するには、以下の形式を使用する逆参照式を使用します。

[参照を含む列].[参照されるテーブルの列]

たとえば、次の式は Products テーブルから製品の価格を取得します。

<<[Product].[Price]>>

ここで ProductProducts テーブルを参照する Order Details テーブルの Ref 型の列名です。Price は製品の価格を含む Products テーブルの列名です。

値を計算するときに逆参照の式を使用できます。例:

合計金額: <<[Product].[Price] * [Quantity]>>

組み込み変数

組み込み変数を使用すると、AppSheet が提供する一連の値にアクセスできます。組み込み変数名は常にアンダースコア(_)で始まります。

組み込み変数は、テンプレート内かつメールSMS メッセージ本文などの特定の自動化プロパティを構成する場合にのみ使用できます。式では使用できません。

AppSheet には、以下の組み込み変数があります。

組み込み変数

説明

<<_APPID>>

アプリを一意に識別するアプリケーション GUID(グローバルに一意の識別子)。

:
8c26466f-1db0-4032-9c0f-40c2a588cf50

<<_APPNAME>>

アプリの名前。

例:
MyApp-10301

<<_APPOWNER>>

アプリのオーナー ID。

例:
10301

<<_ATTACHMENTFILENAME>>

アーカイブの添付ファイル名。アーカイブの添付ファイル名の構成をご覧ください。

:
MyAttachmentName20190207_133355_804.pdf

<<_ATTACHMENTFILE_URL>>

アーカイブの添付ファイル URL。

<<_ATTACHMENTFILE_WEB_LINK>>

アーカイブの添付ファイルへのリンク。添付ファイル名がハイパーリンク テキストとして使用されます。

 

: この変数は本文または添付ファイル テンプレートで使用できます。[Body] プロパティでは使用できません。

<<_ATTACHMENTNAME>>

メールの添付ファイル名。

<<_ROWKEY>>

追加、削除、更新されたレコードのキー値。

<<_ROW_WEB_LINK>>

アプリ内の追加または更新されたレコードへのリンク。例えば、この URL をメールに含めることで、メールの受信者が追加または更新されたレコードを簡単に開くことができます。

 

: この変数は本文または添付ファイル テンプレートで使用できます。[Body] プロパティでは使用できません。

<<_ROW_WEB_URL>>

アプリ内の追加または更新されたレコードを参照する URL。例えば、この URL をメールに含めることで、メールの受信者が追加または更新されたレコードを簡単に開くことができます。完全な URL が表示されます。

<<_RULENAME>>

自動化コンポーネントの名前(タスクなど)。

:
Send an email

<<_TABLENAME>>

テーブルの名前。

:
Orders

<<_UPDATEMODE>>

自動化ルールをトリガーしたオペレーションの名前。

:
AddDelete、またはUpdate

HTML エンコードを使用したクロスサイト スクリプティング攻撃の防止

AppSheet は、フィールド値が HTML ドキュメントに表示されるとき、常に HTML エンコードします。HTML エンコードは、フィールド値がブラウザによって単純なテキストとして表示されるようにし、ブラウザがフィールド値を HTML として解釈しないようにします。これは、ユーザーが以下のようなフィールドに JavaScript を入力するときに、クロスサイト スクリプティング(XSS)攻撃を防ぐために不可欠です。

<script type="text/javascript">
    function doSomethingEvil() { /* ... */ }
</script>

この情報は役に立ちましたか?

改善できる点がありましたらお聞かせください。
検索
検索をクリア
検索を終了
Google アプリ
メインメニュー
4098436267506430250
true
ヘルプセンターを検索
true
true
true
false
false
false
false