Правило для почты: Извлечение данных: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 11 промежуточных версий этого же участника)
Строка 5: Строка 5:
|description=Правило для почты: извлечение данных
|description=Правило для почты: извлечение данных
}}
}}
'''Извлечение данных''' — второй блок [[Правила создания задач по e-mail | правила обработки почты]], который необходимо заполнить при [[Создание и редактирование правил | его создании]].


'''Извлечение данных''' - второй блок [[Правила создания задач по e-mail | правила обработки почты]], который необходимо заполнить при [[Создание и редактирование правил | его создании]].  
Извлекать данные можно из разных частей письма:
*Тема письма + Содержимого
*Темы письма
*Содержимого
*Содержимого (исходного письма) — используйте этот вариант только если вы контролируете отправку письма, у вас есть его исходный текст до отправки, и вы проверяете регулярные выражения или другие способы извлечения данных на нём.


Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена:
Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена:


https://p.pfx.so/pf/cJ/AVrumL.png
https://p.pfx.so/pf/cJ/AVrumL.png




Строка 17: Строка 21:
При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов:
При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов:


https://p.pfx.so/pf/1S/xBvlVg.jpg
https://p.pfx.so/pf/wq/z60Z1h.png




*'''Текст''' — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант.
*'''Текст''' — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант.
*'''HTML''' — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги.
*'''HTML''' — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги.
*'''HTML-Таблица''' — используется для разбора данных из таблиц, приходящих в письмах.
*'''HTML-Таблица''' — используется для [[Извлечение данных из таблиц в письмах |разбора данных из таблиц]], приходящих в письмах.
*'''JSON''' — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про [[JSONPath | JSONPath]].
*'''JSON''' — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про [[JSONPath | JSONPath]].
 
*'''XML''' — используется для хранения и передачи данных, часто используется для передачи данных по [[API ПланФикса |API]].


== Способы выделения данных ==
== Способы выделения данных ==
Вы можете использовать один из трех доступных вариантов:
Вы можете использовать один из доступных вариантов:


https://p.pfx.so/pf/Dh/CQEume.jpg
https://p.pfx.so/pf/Dh/CQEume.jpg




*'''От метки до конца строки''' - в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают.
*'''От метки до конца строки''' в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают.
*'''От метки до метки''' - в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются.
*'''От метки до метки''' в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются.
*'''Регулярным выражением''' - в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами [[Регулярные выражения | регулярного выражения]].   
*'''Следующая строка от метки''' — в инфоблок попадет фрагмент письма, начинающийся с новой строки относительно указанной вами метки. Начальные и конечные пробелы этой строки игнорируются.
 
*'''Регулярным выражением''' в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами [[Регулярные выражения | регулярного выражения]].   
*'''Все содержимое''' — в инфоблок попадает все содержимое письма.


== Примеры настройки ==
== Примеры настройки ==
Строка 48: Строка 53:


В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок '''Телефон''' с содержимым '''+75847842159'''.
В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок '''Телефон''' с содержимым '''+75847842159'''.


Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция:
Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция:
Строка 59: Строка 63:
*'''Количество товара''': 1, 5, 3
*'''Количество товара''': 1, 5, 3


 
== Важно ==
В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в [[Правило для почты: Основная операция | основной]] и [[Правило для почты: Дополнительные операции | дополнительных]] операциях правила разбора почты (см. примеры в соответствующих статьях справки).
*В дальнейшем эти инфоблоки будут использованы для выбора и заполнения данными задач, контактов и аналитик в [[Правило для почты: Основная операция | основной]] и [[Правило для почты: Дополнительные операции | дополнительных]] операциях правила разбора почты (см. примеры в соответствующих статьях справки).
 
*Поступающие в ПланФикс данные из почты перед дальнейшим использованием можно дополнительно [[Вычислить инфоблок |обработать]].


== Перейти ==
== Перейти ==
*[[Создание и редактирование правил]]
*[[Создание и редактирование правил]]
*[[Правила создания задач по e-mail]]
*[[Правила создания задач по e-mail]]

Текущая версия от 10:42, 20 ноября 2023

Извлечение данных — второй блок правила обработки почты, который необходимо заполнить при его создании.

Извлекать данные можно из разных частей письма:

  • Тема письма + Содержимого
  • Темы письма
  • Содержимого
  • Содержимого (исходного письма) — используйте этот вариант только если вы контролируете отправку письма, у вас есть его исходный текст до отправки, и вы проверяете регулярные выражения или другие способы извлечения данных на нём.

Данные извлекаются в инфоблоки, которым присваиваются понятные названия, чтобы в дальнейшем ими было удобно оперировать при заполнении полей задачи, контакта или аналитики. Помимо названия, каждый инфоблок содержит инструкцию по извлечению части письма, которая должна быть в него помещена:

AVrumL.png


Форматы извлечения данных

При извлечении данных ПланФикс может рассматривать письмо в одном из следующих вариантов:

z60Z1h.png


  • Текст — обычно соответствует тому, что видит в письме человек. Это наиболее распространенный вариант.
  • HTML — будет анализироваться все содержимое письма, включая разметку. Такой вариант позволяет использовать для более точного выделения нужного содержимого фрагменты, содержащие HTML-теги.
  • HTML-Таблица — используется для разбора данных из таблиц, приходящих в письмах.
  • JSON — используется для разбора, если текст письма в формате JSON. Подробнее об этом читайте в справке про JSONPath.
  • XML — используется для хранения и передачи данных, часто используется для передачи данных по API.

Способы выделения данных

Вы можете использовать один из доступных вариантов:

CQEume.jpg


  • От метки до конца строки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся символом перевода строки или окончанием письма. При этом начальные пробелы (если они есть) и символ перевода строки из выделенного таким образом текстового фрагмента в инфоблок не попадают.
  • От метки до метки — в инфоблок попадет фрагмент письма, начинающийся сразу за указанной вами меткой начала и закачивающийся последним символом перед началом метки конца. Начальные и конечные пробелы получившегося текстового фрагмента также игнорируются.
  • Следующая строка от метки — в инфоблок попадет фрагмент письма, начинающийся с новой строки относительно указанной вами метки. Начальные и конечные пробелы этой строки игнорируются.
  • Регулярным выражением — в инфоблок попадет фрагмент письма, выделенный при помощи введенного вами регулярного выражения.
  • Все содержимое — в инфоблок попадает все содержимое письма.

Примеры настройки

Представим, что в ПланФикс попадает письмо следующего содержания:

bZ4Lce.png


Настройка инфоблока для извлечения номера телефона заказчика из этого письма:

MNjxFn.png

В результате отработки этой конструкции на приведенном выше примере, формируется инфоблок Телефон с содержимым +75847842159.

Для извлечение произвольного количества строк заказа, перечисленных в письме, применяется следующая конструкция:

oDQdiP.png

В результате отработки этой конструкции на приведенном выше примере, формируется 3 инфоблока со следующим содержимым:

  • Наименование товара: Зажим КС6, Фиксатор U-системы, Переходник N-P
  • Цена товара: 5400, 150, 390
  • Количество товара: 1, 5, 3

Важно

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

Перейти