Действие — Создать / изменить ресурс Автопилота

ВАЖНО!

Перед прочтением этой статьи рекомендую ознакомиться с тем,
что такое ресурсы в Автопилоте. Эта статья даст вам
базовое понимание основ. А именно:

• что такое поля ресурса?
• где находится каждое поле и какие функции выполняет?
• в чем разница между полями:
  номер, название, содержимое и примечание ресурса?

В этой статье к разжевыванию данных терминов возвращаться НЕ БУДЕМ!

Для добавления ресурса нужно нажать на кнопку «Действие» и выбрать пункт «Создать / изменить ресурс». Можно начать вводить «ресурс» и сервис мгновенно покажет нужный пункт.

Рассмотрим интерфейс действия подробнее:

Ресурс имеет несколько параметров:

1. Тип изменения ресурса

Доступны значения:

• Изменить или создать — изменяет существующий ресурс, если сервис находит его по параметрам 2, 3 и 4, либо создает новый (с названием, написанным в поле 4)
• Создать новый — создает новый ресурс с названием, написанным в пар. 4 и значением (содержимым / примечанием) прописанным в пар. 7
• Изменить (если найден) ресурс — пытается найти ресурс по параметрам 2, 3 и 4. Если находит, редактирует, если не находит, ничего не делает.

2. По какому полю искать

Доступны значения:

• название — будет искать ресурс с названием написанным в пар. № 4.
• номер — с номером указанным в параметре № 4.
• содержимое — имеющим указанный текст в содержимом.
• примечание — имеющим указанный текст в примечании.

3. Тип поиска

Здесь можно выбрать типы сравнения текста, указанного в параметре № 4 с полем ресурса. Доступны варианты:

• равным — текст должен быть равным полю на 100%;
• содержащим — текст должен содержаться в поле ресурса.
  Например, буквосочетание «рес» содержится в слове «Ресурс»;
• с элементом массива‚ равным. Массив — это список элементов / фраз / значений через запятую. Автопилот ищет первый ресурс, у которого хотя бы один элемент массива совпадает с введенным текстом;
• со строкой‚ равной — аналогично как с массивом. Должна совпадать хотя бы одна строка в поле с указанным текстом.

4. Что искать

• название, номер или содержимое ресурса, по которому его нужно найти.

5. Какое поле менять

Параметр имеет варианты:

• название,
• содержимое,
• примечание.

Ну тут все предельно очевидно, надеюсь :-)
Какое поле указали, то и редактируется. Поле «номер» — системное и редактироваться, конечно не может. Также в случае с изменением названия, просьба не «дописывать ему новые строки» ;-)

Повторюсь, подробнее про эти элементы можно прочесть в этой статье. А как достать эти элементы в других блоках (например написать в сообщении) смотрите в этом разделе инструкции про переменные.

6. Тип операции

Нашли ресурс, выбрали нужное поле, осталось только придумать что с этим полем сделать. Есть много разных операций по изменению ресурса. Новое значение (текст/число) для операции берется из параметра № 7.

Операции представлены в виде меню, которое имеет параметры:

• установить значение — просто меняет значение поля на новое;
• дописать текст — дописывает указанный текст в поле;
• увеличить как число на— приводит выбранное поле к числовому представлению и увеличивает его на указанное (в пар. 7) число;
• уменьшить как число на — приводит выбранное поле к числовому представлению и увеличивает его на указанное (в пар. 7) число;
• добавить элемент массива — воспринимает поле ресурса как массив элементов разделенных запятой. Добавляет новый элемент (то что в пар. 7) в конец массива. Если ввести в пар. 7 несколько элементов через запятую, то Автопилот добавит несколько.
• удалить элемент массива — поле ресурса как массив элементов через запятую. Ищет элементы совпадающие с введенным значением и удаляет их. Важно: удаляет ВСЕ совпадения массива.
• добавить элементы и убрать повторяющиеся — то же самое, что «добавить элемент массива», только с доп операцией: удалением возможных повторов.
• добавить строки — воспринимает поле ресурса как массив строк, разделенных, конечно, переносом строки. Добавляет новые строки (то что в пар. 7) в конец массива. Если ввести в пар. 7 несколько строк, то будет добавлено несколько.
• удалить строки — если находит строку равную указанной, удаляет. Может использоваться, например, для удаления использованного промокода.
• добавить строки и убрать повторяющиеся — то же самое, что «добавить строки», только с доп операцией: удалением возможных повторов строк.

7. Поле для ввода значения.

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

Переменные доступные только после выполнения действия «Создать /изменить ресурс»

• %res_id% — ID измененного / нового ресурса.
• %res_val%— новое значение.

На этом инструкция завершена. Спасибо за внимание! Статью подготовил Андрей Горячих. Пост статьи для поддержки 💙, комментариев и замечаний.