Правило для почты: Извлечение данных: различия между версиями
DM (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
(не показано 17 промежуточных версий этого же участника) | |||
Строка 5: | Строка 5: | ||
|description=Правило для почты: извлечение данных | |description=Правило для почты: извлечение данных | ||
}} | }} | ||
'''Извлечение данных''' — второй блок [[Правила создания задач по e-mail | правила обработки почты]], который необходимо заполнить при [[Создание и редактирование правил | его создании]]. | |||
Извлекать данные можно из разных частей письма: | |||
*Тема письма + Содержимого | |||
*Темы письма | |||
*Содержимого | |||
*Содержимого (исходного письма) — используйте этот вариант только если вы контролируете отправку письма, у вас есть его исходный текст до отправки, и вы проверяете регулярные выражения или другие способы извлечения данных на нём. | |||
Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена: | Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена: | ||
https://p.pfx.so/pf/cJ/AVrumL.png | https://p.pfx.so/pf/cJ/AVrumL.png | ||
== Форматы извлечения данных == | == Форматы извлечения данных == | ||
При извлечении данных ПланФикс может рассматривать письмо в одном из | При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов: | ||
https://p.pfx.so/pf/ | https://p.pfx.so/pf/wq/z60Z1h.png | ||
*'''Текст''' | *'''Текст''' — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант. | ||
*'''HTML''' | *'''HTML''' — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги. | ||
*'''HTML-Таблица''' — используется для [[Извлечение данных из таблиц в письмах |разбора данных из таблиц]], приходящих в письмах. | |||
*'''JSON''' — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про [[JSONPath | JSONPath]]. | |||
*'''XML''' — используется для хранения и передачи данных, часто используется для передачи данных по [[API ПланФикса |API]]. | |||
== Способы выделения данных == | == Способы выделения данных == | ||
Вы можете использовать один из | Вы можете использовать один из доступных вариантов: | ||
https://p.pfx.so/pf/Dh/CQEume.jpg | https://p.pfx.so/pf/Dh/CQEume.jpg | ||
*'''От метки до конца строки''' | *'''От метки до конца строки''' — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают. | ||
*'''От метки до метки''' | *'''От метки до метки''' — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются. | ||
*'''Регулярным выражением''' | *'''Следующая строка от метки''' — в инфоблок попадет фрагмент письма, начинающийся с новой строки относительно указанной вами метки. Начальные и конечные пробелы этой строки игнорируются. | ||
*'''Регулярным выражением''' — в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами [[Регулярные выражения | регулярного выражения]]. | |||
*'''Все содержимое''' — в инфоблок попадает все содержимое письма. | |||
== Примеры настройки == | == Примеры настройки == | ||
Строка 46: | Строка 53: | ||
В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок '''Телефон''' с содержимым '''+75847842159'''. | В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок '''Телефон''' с содержимым '''+75847842159'''. | ||
Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция: | Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция: | ||
Строка 57: | Строка 63: | ||
*'''Количество товара''': 1, 5, 3 | *'''Количество товара''': 1, 5, 3 | ||
== Важно == | |||
В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в [[Правило для почты: Основная операция | основной]] и [[Правило для почты: Дополнительные операции | дополнительных]] операциях правила разбора почты (см. примеры в соответствующих статьях справки). | *В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в [[Правило для почты: Основная операция | основной]] и [[Правило для почты: Дополнительные операции | дополнительных]] операциях правила разбора почты (см. примеры в соответствующих статьях справки). | ||
*Поступающие в ПланФикс данные из почты перед дальнейшим использованием можно дополнительно [[Вычислить инфоблок |обработать]]. | |||
== Перейти == | == Перейти == | ||
*[[Создание и редактирование правил]] | *[[Создание и редактирование правил]] | ||
*[[Правила создания задач по e-mail]] | *[[Правила создания задач по e-mail]] |
Текущая версия от 10:42, 20 ноября 2023
Извлечение данных — второй блок правила обработки почты, который необходимо заполнить при его создании.
Извлекать данные можно из разных частей письма:
- Тема письма + Содержимого
- Темы письма
- Содержимого
- Содержимого (исходного письма) — используйте этот вариант только если вы контролируете отправку письма, у вас есть его исходный текст до отправки, и вы проверяете регулярные выражения или другие способы извлечения данных на нём.
Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена:
Форматы извлечения данных
При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов:
- Текст — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант.
- HTML — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги.
- HTML-Таблица — используется для разбора данных из таблиц, приходящих в письмах.
- JSON — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про JSONPath.
- XML — используется для хранения и передачи данных, часто используется для передачи данных по API.
Способы выделения данных
Вы можете использовать один из доступных вариантов:
- От метки до конца строки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают.
- От метки до метки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются.
- Следующая строка от метки — в инфоблок попадет фрагмент письма, начинающийся с новой строки относительно указанной вами метки. Начальные и конечные пробелы этой строки игнорируются.
- Регулярным выражением — в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами регулярного выражения.
- Все содержимое — в инфоблок попадает все содержимое письма.
Примеры настройки
Представим, что в ПланФикс попадает письмо следующего содержания:
Настройка инфоблока для извлечения номера телефона заказчика из этого письма:
В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок Телефон с содержимым +75847842159.
Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция:
В результате отработки этой конструкции на приведенном выше примере, формируется 3 инфоблока со следующим содержимым:
- Наименование товара: Зажим КС6, Фиксатор U-системы, Переходник N-P
- Цена товара: 5400, 150, 390
- Количество товара: 1, 5, 3
Важно
- В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в основной и дополнительных операциях правила разбора почты (см. примеры в соответствующих статьях справки).
- Поступающие в ПланФикс данные из почты перед дальнейшим использованием можно дополнительно обработать.