リテラルの使用
リテラルについて
式を作成するときに、入力値が必要になる場合があります。 多くの場合、入力値はリテラルです。 リテラルは、式に渡す値です。 リテラルには 2 つの種類があります。
- スタンドアロンリテラル: 式構文のない入力。
- 埋め込みリテラル: 式構文内で使用される入力。
スタンドアロンリテラル
スタンドアロン リテラルとは、式構文を使用せずにプレーン テキストを式エディターに入力する場合です。
たとえば、式エディタに if a>0 then 10 else 20 と入力すると、 サービス マネージャ はこれをスタンドアロンのリテラルと見なします。 $( などの式構文がないため、式として扱われません。 これを式にするには、 $(if a>0 then 10 else 20) と入力します。すると式になり、内部のリテラルは埋め込みリテラルになります。
文字列は区切られて入力する必要があります。 たとえば、 $(if a>0 then 10 else hello) と入力すると、 hello はリテラルではなくフィールド名として扱われます。 実際に helloという単語を意味するようにするには、 $(if a>0 then 10 else "hello")のように、引用符で囲む必要があります。 また、 $(if a>0.01 then 10USD else "hello") と入力することもできます。ここで、10USD は通貨リテラル、0.01 は数値リテラルです。 固定日付ではなくフィールドを使用することをお勧めします。
以下は、 サービス マネージャでサポートされているスタンドアロンリテラルです。
- ブール値のスタンドアロンリテラル: true または falseのいずれか。
- 数値スタンドアロンリテラル: 整数または浮動小数点数のいずれか。 16 進数のスタンドアロンリテラルはありません。
- 整数スタンドアロンリテラル: 数字または 16 進数値のいずれか。
- 通貨スタンドアロンリテラル: 小数点とそれに続く 3 文字の通貨コードで構成されます。
- DateTime スタンドアロンリテラル: ロケールに依存する DateTime フィールド。 たとえば、「 6/4/2014」と入力すると、米国では 2014 年 6 月 4 日を意味しますが、英国では 2014 年 4 月 6 日を意味します。
- テキスト スタンドアロン リテラル: これはテストですと入力するなどのプレーン テキスト。
埋め込みリテラル
埋め込みリテラルについて
埋め込みリテラルは式内のどこにでも配置でき、必ずしも式の先頭に配置する必要はありません。 これらは、リテラルではない他のものとともに、式の一部になることができます。 場合によっては、埋め込まれたリテラルは $(true) のように単独ですが、他の場合には、埋め込まれたリテラルは式の一部分にすぎません。たとえば、$(123456 * 47) は、間に演算子がある 2 つのリテラルです。
日時埋め込みリテラル
DateTime 埋め込みリテラルは存在しません。
ただし、ニュートラル カルチャ (米国英語) でテキスト値を入力し、式が DateTime 値を探している場合、アプリケーションは暗黙的にテキスト値を DateTime 値に変換します。 これを行うには、 $("2/3/15 10:46 PM")などのテキストを入力すると、アプリケーションによってそれが DateTime 値に変換されます。
ヌル埋め込みリテラル
null リテラルを表す場合は $(null) を使用します。null は大文字と小文字を区別せず、$() で囲まれることに注意してください。
Null 値の詳細については、NULL値についてを参照してください。
ブール埋め込みリテラル
ブールリテラルは、true または false の値を表すために使用されます。 これらは、大文字と小文字を区別しないキーワード true と false ($(true) や $(FALSE) など) で表されます。
数値埋め込みリテラル
数値リテラルには、浮動小数点数と整数の 2 種類があります。
数値リテラルでは次の表現が許可されます。
- 標準の式構文 $() で囲まれた数値:
$(123456.78), $(123456)- 整数は$(0として指定できます
- 数字の前に + と - を使用できます。
テキスト埋め込みリテラル
テキストリテラルは、一重引用符または二重引用符で表されます。
$("Humpty Dumpty sat on a wall")
$('Humpty Dumpty had a great fall.')新しいライン
文字列内の新しい行を「\r\n」エスケープシーケンスで指定します。
$("Humpty Dumpty sat on a wall," + "\r\n" + "Humpty Dumpty had a great fall.")新しい行を表示するには、 高さ フィールド (フォームの コントロール プロパティ タブの下) の値が 2 以上であることを確認します。 テキスト値がコントロールの現在のサイズを超えると、垂直スクロールバーが自動的に表示されます。
タブストップ
タブ ストップを指定するには、"\\t" エスケープ シーケンスを使用します。
$("Elvis" + "\t" + "has left the building!")「\\t」エスケープ シーケンスを使用して式を保存すると、エディター (クイック アクション エディターのフィールド エディターなど) ではタブ ストップがスペース文字として表示されますが、メタデータではエスケープ シーケンスが適切に保持され、実行時にそれに応じて評価されます。
引用
一重引用符を二重引用符と一緒に使用できますが、二重引用符内で二重引用符を使用する場合は、バックスラッシュ エスケープ シーケンス "\\" を使用します。
$("The latest operating system is 'Windows 8' from Microsoft.")
$("The latest Office suite is \"Office 2013\" from Microsoft.")ユニコード文字
Unicode 文字を指定するには、Unicode エスケープ シーケンス "\\u<nnnn>" を使用します。ここで、 <nnnn> は Unicode 値の 4 桁の 16 進表現です。
$("The first CJK Unicode character is:" + "\u4E00")Unicode 文字を含む式を保存すると、エディター (クイック アクション エディターのフィールド エディターなど) では Unicode 文字がそのまま表示されます。
キーボードが Unicode 文字をサポートしている場合は、エスケープせずに直接入力できます。 たとえば、Unicode 文字 4E00 はアジアの文字であり、ほとんどのユーザーは既存の文字を使用して入力することはできません。 ただし、アプリケーションで é などの一部の Unicode 文字を入力できる場合は、エスケープせずに直接入力できます。
通貨埋め込みリテラル
通貨リテラルは、10 進数リテラルとそれに続く 3 文字の通貨コードで構成されます。 小数リテラルは、数字と、オプションで小数点、そして 2 つの数字で構成されます。 例としては、5 USD と 7.56 GBP があります。
