Редактирование свойств макроса

Каждый макрос обладает следующими редактируемыми свойствами:

  • Имя макроса

  • Аргументы макроса

  • Расширение макроса

  • Описание

Имя макроса - уникальный идентификатор в сравнении с другими макросами. В одном списке не может быть двух макросов с одним и тем же именем, но такие макросы могут существовать в разных списках (в этом случае см. абзац о приоритетах макросов при оценке). Более того, имена макросов обычно состоят только из алфавитных и цифровых символов верхнего и нижнего регистра, как например MY_FIRST_MACRO_1 или MyFavoriteMacro, чтобы избежать синтаксических ошибок при вводе макроса в выражение.

В именах макросов запрещается использовать дефисы (тире, символы "-").

Аргументы макроса - специально именованные аргументы и значения, которые можно вставить в выражение макроса.

Расширение макроса также известно как правило макроса, или выражение, или иногда называется собственно макросом. Когда вы используете имя макроса в своем PDL/SRL-выражении, макрос будет переименован и заменен текстом вашего выражения макроса (или расширения). Поскольку имена макросов обычно короткие, а выражения макросов обычно длинные, нужно помнить об этом свойстве, поскольку оно "расширяет" макрос. В зависимости от того, создаете ли вы выражение PDL или SRL, написание макроса происходит также как и редактирование поискового запроса или запроса таксономии, в которых используется PDL, или использование узла Производные колонки или Фильтрация строк, в которых используется SRL. Синтаксис одинаковый. Преимущество макроса состоит в том, что если вы используете одно и то же выражение в нескольких проектах или узлах, вы можете сохранить это выражение, дать ему имя и ссылаться на это выражение, используя его имя в последующей настройки в целях экономии времени (и, возможно, во избежание ошибок).

Описание макроса - редактируемое текстовое поле, которое можно заполнить любым текстом по вашему усмотрению. Поле описания можно использовать для нескольких целей.

Например, оно используется для описания вашей работы. Когда вы создаете макрос, подумайте о том, что его придется прочитать и вашему коллеге, и создайте такое описание, которое поможет вашему коллеге правильно понять принцип вашей работы.

Поле описания также можно использовать в качестве электронного блокнота и копировать и вставлять туда текст.

Например, сохраните прежние версии макроса в поле описания на тот случай, если вам нужно отменить некоторые изменения.

Поле описания также можно использовать в качестве списка задач, в котором можно написать, как именно вы будете улучшать свои макросы в каждом узле. Каждый макрос имеет свое описание, которое, в отличие от выражения, не влияет на логику макроса. Описание макросов не влияет на масштабируемость узлов.