Оператор Declare используется для создания определений полей и групп, где можно определить отношения между полями или функциями. Ряд определений полей можно использовать для автоматического создания производных полей, которые можно использовать как измерения. Например можно создать определение календаря и использовать его для создания соответствующих измерений, таких как год, месяц, неделя и день, на основе поля даты.
Можно использовать Declare, чтобы установить новое определение поля или создать определение поля на основе уже существующего определения.
Установка нового определения поля
Syntax:
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
Arguments:
| Аргумент | Описание |
|---|---|
|
|
Имя определения поля с двоеточием в конце. Предупреждение: Не используйте
Example: Calendar: |
|
|
Список тегов, разделенных запятыми, которые будут применяться к полям, извлеченным из определения поля. Применять теги не обязательно, но если не применить теги, которые используются для определения порядка сортировки, такие как Example: '$date' |
|
|
Список параметров, разделенных запятыми. Параметр определяется в виде name=value и назначается в качестве начального значения, которое можно переписать при повторном использовании определения поля. Дополнительно. Example: first_month_of_year = 1 |
|
|
Список полей, разделенных запятыми, которые будут созданы при использовании определения поля. Поле определяется в виде <expression> As field_name tagged tag. Используйте $1 для ссылки на поле данных, из которого должны быть созданы производные поля. Example: Year($1) As Year tagged '$year' |
Example:
Календарь теперь определен. Можно применить его к загруженным полям с датами, в данном случае
Производные поля (полный пример)
Повторное использование существующего определения поля
Syntax:
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
Arguments:
| Аргумент | Описание |
|---|---|
|
|
Имя определения поля с двоеточием в конце. Example: MyCalendar: |
|
|
Определение поля для повторного использования при создании нового определения поля. Новое определение поля будет работать таким же образом, как определение, на котором оно основано, за исключением случая, когда используется Example: Using Calendar |
|
|
Список назначений параметров, разделенных запятыми. Назначение параметра определяется в виде name=value, оно переопределяет значение параметра, заданное в базовом определении поля. Дополнительно. Example: first_month_of_year = 4 |
Example:
В этом примере мы повторно используем определение календаря, созданное в предыдущем примере. В этом случае мы хотим использовать финансовый год, начинающийся в апреле. Это достигается путем назначения значения 4 параметру
В этом примере допускается, что вы используете данные образца и определение поля из предыдущего примера.
После повторной загрузки скрипта данных созданные поля будут доступны в редакторе листа с именами
