Правило для почты: Извлечение данных
Извлечение данных — второй блок правила обработки почты, который необходимо заполнить при его создании.
Извлекать данные можно из разных частей письма:
- Тема письма + Содержимого
- Темы письма
- Содержимого
- Содержимого (исходного письма) — используйте этот вариант только если вы контролируете отправку письма, у вас есть его исходный текст до отправки, и вы проверяете регулярные выражения или другие способы извлечения данных на нём.
Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена:
Форматы извлечения данных
При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов:
- Текст — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант.
- HTML — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги.
- HTML-Таблица — используется для разбора данных из таблиц, приходящих в письмах.
- JSON — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про JSONPath.
- XML — используется для хранения и передачи данных, часто используется для передачи данных по API.
Способы выделения данных
Вы можете использовать один из доступных вариантов:
- От метки до конца строки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают.
- От метки до метки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются.
- Следующая строка от метки — в инфоблок попадет фрагмент письма, начинающийся с новой строки относительно указанной вами метки. Начальные и конечные пробелы этой строки игнорируются.
- Регулярным выражением — в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами регулярного выражения.
- Все содержимое — в инфоблок попадает все содержимое письма.
Примеры настройки
Представим, что в ПланФикс попадает письмо следующего содержания:
Настройка инфоблока для извлечения номера телефона заказчика из этого письма:
В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок Телефон с содержимым +75847842159.
Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция:
В результате отработки этой конструкции на приведенном выше примере, формируется 3 инфоблока со следующим содержимым:
- Наименование товара: Зажим КС6, Фиксатор U-системы, Переходник N-P
- Цена товара: 5400, 150, 390
- Количество товара: 1, 5, 3
Важно
- В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в основной и дополнительных операциях правила разбора почты (см. примеры в соответствующих статьях справки).
- Поступающие в ПланФикс данные из почты перед дальнейшим использованием можно дополнительно обработать.