Declare ステートメントは、項目定義を作成するために使用されます。このステートメントでは、項目や関数間の関係も定義できます。一連の項目の定義は、取得項目の自動生成に使用できます。取得項目は、軸として使用することもできます。例えば、カレンダー定義を作成して、日付項目から年、月、週、日などの関連する軸を生成するために使用できます。
Declare は、新しい項目定義の設定にも、既存の定義に基づく項目定義の作成にも使用できます。
新しい項目定義の設定
構文:
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
引数：
| 引数 | 説明 |
|---|---|
| definition_name |
項目定義の名前 (末尾にコロン)。 警告メモ項目定義の名前としてautoCalendarは使用しないでください。この名前は、自動生成されるカレンダー テンプレートとして予約済みです。
Calendar: |
| tag_list |
項目定義をもとに作成された項目に適用するタグのコンマで区切りのリスト。タグの適用はオプションですが、$date、$numeric、$text などのソート順を指定するのに使用するタグを適用しない場合、生成される項目はデフォルトのロード順序でソートされます。
'$date'Thank you for bringing this to our attention, and apologies for the inconvenience. |
| parameter_list |
コンマ区切りのパラメータ リスト。パラメータは name=value 形式で定義され、初期値が割り当てられます。初期値は、項目定義が再利用時に、上書きできます。オプション。
first_month_of_year = 1 |
| field_list |
項目定義が使用される際に生成される項目のカンマ区切りのリスト。項目は <expression> As field_name tagged tag の形式で定義されます。自動取得項目の生成元のデータ項目を参照するには $1 を使用します。
Year($1) As Year tagged ('$numeric') |
カレンダーが定義され、ロードされたデータ項目にカレンダーを適用できるようになりました。この場合、Derive 節を使用して OrderDate と ShippingDate にカレンダーを適用できます。
自動取得項目 (詳細な例)
既存の項目定義の再使用
構文:
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
引数：
| 引数 | 説明 |
|---|---|
| definition_name |
項目定義の名前 (末尾にコロン)。
MyCalendar: |
| existing_definition |
新しい項目定義の作成時に再利用する項目定義。作成した新しい項目定義は、項目式で使用されている値を変更するために parameter_assignment を使用する場合を除いて、元になった定義と同様に機能します。
Using Calendar |
| parameter_assignment |
コンマ区切りのパラメータ割り当てリスト。パラメータの割り当ては name=value の形式で定義され、元になる項目定義に設定されているパラメータ値を上書きします。オプション。
first_month_of_year = 4 |
この例では、上の例で作成したカレンダー定義を再利用します。4 月から始まる会計年度を使用します。first_month_of_year パラメータに 4 を割り当てます。このパラメータは、定義されている DayNumberOfYear 項目に影響を与えます。
この例は、上の例のサンプル データと項目定義の使用を前提としています。
このデータ スクリプトをリロードすると、生成された項目を OrderDate.MyCalendar.* と ShippingDate.MyCalendar.* という名前でシート エディタで利用できるようになります。