Правило для почты: Извлечение данных
Извлечение данных — второй блок в правилах обработки электронной почты, который необходимо заполнить при создании правила.
Данные можно извлекать из разных частей письма:
- Тема и текст письма
- Тема письма
- Текст письма
- Текст письма (исходное письмо) — используйте этот вариант, только если вы контролируете процесс отправки писем, располагаете исходным текстом до отправки и тестируете регулярные выражения или другие способы извлечения данных.
Данные извлекаются в инфоблоки. Инфоблоки имеют понятные названия, поэтому с ними удобно работать на следующих этапах: например, при заполнении полей задач, контактов или аналитик. Помимо названия, каждый инфоблок содержит инструкции по извлечению фрагмента письма, который в него попадёт:
Форматы извлечения данных
При извлечении данных Planfix может анализировать письмо двумя способами:
- Текст — обычно соответствует тому, что вы видите в браузере при чтении письма. Это самый популярный вариант.
- HTML — анализируется всё содержимое письма, включая разметку. Этот вариант позволяет использовать фрагменты с HTML-тегами, чтобы точнее выделить нужное содержимое.
- HTML-таблица — используется для извлечения данных из таблиц в письмах.
- JSON — используется для разбора сообщений, текст которых представлен в формате JSON. Подробнее читайте в соответствующем разделе справки JSONPath.
- XML — используется для хранения и передачи данных. Часто применяется при обмене данными через API Planfix.
Способы извлечения данных
Можно выбрать один из доступных способов:
- От метки до конца строки — инфоблок будет содержать фрагмент письма, который начинается сразу после указанной метки и заканчивается символом новой строки или концом письма. Начальные пробелы (если есть) и символ новой строки в инфоблок не попадут.
- От метки до метки — инфоблок будет содержать фрагмент письма, который начинается сразу после указанной начальной метки и заканчивается символом перед конечной меткой. Начальные и конечные пробелы будут удалены.
- Со следующей строки после метки — инфоблок будет содержать фрагмент письма, который начинается с новой строки после указанной метки. Начальные и конечные пробелы будут удалены.
- Регулярное выражение — инфоблок будет содержать фрагмент письма, найденный с помощью регулярного выражения, которое вы укажете.
- Всё содержимое — инфоблок будет содержать всё содержимое письма.
Примеры
Предположим, в Planfix отправлено письмо со следующим текстом:
Настройки инфоблока для извлечения номера телефона клиента из этого письма будут выглядеть так:
После обработки будет создан инфоблок «Телефон» со значением +16888933044.
Чтобы извлечь из письма несколько строк заказа, используйте следующие настройки:
После обработки будут созданы три инфоблока со следующими значениями:
- Название товара: Toyo r888
- Цена товара: 500
- Количество: 2
Важно
- На следующих этапах правила обработки почты основное и дополнительные действия будут использовать эти инфоблоки для выбора задач, контактов и аналитик, а также для заполнения их полей данными. Примеры приведены в соответствующих статьях справки.
- Данные из входящих писем в Planfix можно дополнительно обработать перед использованием.