Правило для пошти: Видобування даних: відмінності між версіями
Матеріал з Planfix
(Створена сторінка: {{#seo: |title=Правило для пошти: витягування даних |titlemode=append |keywords=планфікс, правила, email, пошта, завдання, витягування даних з листа |description=Правило для пошти: витягування даних }} '''Витягування даних''' — другий блок Правила створення завдань по e-mail| правила...) |
Немає опису редагування |
||
| Рядок 1: | Рядок 1: | ||
{{#seo: | {{#seo: | ||
|title=Правило для пошти: | |title=Правило для пошти: вилучення даних | ||
|titlemode=append | |titlemode=append | ||
|keywords= | |keywords=планфикс, правила, email, пошта, завдання, вилучення даних з листа | ||
|description=Правило для пошти: | |description=Правило для пошти: вилучення даних | ||
}} | }} | ||
''' | '''Вилучення даних''' — другий блок [[Правила створення завдань по e-mail| правила обробки пошти]], який необхідно заповнити при [[Створення та редагування правил| його створенні]]. | ||
Дані | Вилучати дані можна з різних частин листа: | ||
*Теми листа + Вмісту | |||
*Теми листа | |||
*Вмісту | |||
*Вмісту (оригінального листа) — використовуйте цей варіант тільки якщо ви контролюєте відправлення листа, у вас є його оригінальний текст до відправлення, і ви перевіряєте регулярні вирази або інші способи вилучення даних на ньому. | |||
Дані вилучаються в інфоблоки, яким присвоюються зрозумілі назви, щоб надалі ними було зручно оперувати при заповненні полів завдання, контакту або аналітики. Окрім назви, кожен інфоблок містить інструкцію щодо вилучення частини листа, яка має бути в нього поміщена: | |||
https://p.pfx.so/pf/cJ/AVrumL.png | https://p.pfx.so/pf/cJ/AVrumL.png | ||
== Формати вилучення даних == | |||
При вилученні даних Planfix може розглядати лист в одному з наступних варіантів: | |||
https://p.pfx.so/pf/wq/z60Z1h.png | |||
https://p.pfx.so/pf/ | |||
*'''Текст''' — зазвичай відповідає тому, що бачить | *'''Текст''' — зазвичай відповідає тому, що бачить у листі людина. Це найпоширеніший варіант. | ||
*'''HTML''' — буде аналізуватися | *'''HTML''' — буде аналізуватися весь вміст листа, включаючи розмітку. Такий варіант дозволяє використовувати для більш точного виділення потрібного вмісту фрагменти, що містять HTML-теги. | ||
*'''HTML- | *'''HTML-таблиця''' — використовується для [[Видобуток даних з таблиць в листах|розбору даних із таблиць]], що надходять у листах. | ||
*'''JSON''' — використовується для розбору, якщо текст листа в форматі JSON. Детальніше про це читайте в довідці про [[JSONPath| JSONPath]]. | *'''JSON''' — використовується для розбору, якщо текст листа в форматі JSON. Детальніше про це читайте в довідці про [[JSONPath| JSONPath]]. | ||
*'''XML''' — використовується для | *'''XML''' — використовується для збереження і передачі даних, часто застосовується для передачі даних по [https://planfix.com/help/API API]. | ||
== Способи виділення даних == | == Способи виділення даних == | ||
Ви можете використовувати один | Ви можете використовувати один із доступних варіантів: | ||
https://p.pfx.so/pf/Dh/CQEume.jpg | https://p.pfx.so/pf/Dh/CQEume.jpg | ||
*'''Від мітки до кінця рядка''' — в інфоблок потрапить фрагмент листа, що починається | *'''Від мітки до кінця рядка''' — в інфоблок потрапить фрагмент листа, що починається одразу за вказаною вами міткою початку і закінчується символом переносу рядка або завершенням листа. При цьому початкові пробіли (якщо вони є) і символ переносу рядка з виділеного таким чином текстового фрагмента в інфоблок не потрапляють. | ||
*'''Від мітки до мітки''' — в інфоблок потрапить фрагмент листа, що починається | *'''Від мітки до мітки''' — в інфоблок потрапить фрагмент листа, що починається одразу за вказаною вами міткою початку і закінчується останнім символом перед початком мітки кінця. Початкові і кінцеві пробіли отриманого текстового фрагмента також ігноруються. | ||
*'''Наступний рядок від мітки''' — в інфоблок потрапить фрагмент листа, що починається з нового рядка відносно вказаної вами мітки. Початкові і кінцеві пробіли цього рядка ігноруються. | *'''Наступний рядок від мітки''' — в інфоблок потрапить фрагмент листа, що починається з нового рядка відносно вказаної вами мітки. Початкові і кінцеві пробіли цього рядка ігноруються. | ||
*'''Регулярним виразом''' — в інфоблок потрапить фрагмент листа, виділений за допомогою введеного вами [[Регулярні вирази| регулярного виразу]]. | *'''Регулярним виразом''' — в інфоблок потрапить фрагмент листа, виділений за допомогою введеного вами [[Регулярні вирази| регулярного виразу]]. | ||
*''' | *'''Весь вміст''' — в інфоблок потрапляє весь вміст листа. | ||
== Приклади налаштування == | == Приклади налаштування == | ||
Уявімо, що в Planfix потрапляє лист | Уявімо, що в Planfix потрапляє лист такого змісту: | ||
https://p.pfx.so/pf/TR/bZ4Lce.png | https://p.pfx.so/pf/TR/bZ4Lce.png | ||
Налаштування інфоблока для | Налаштування інфоблока для вилучення номера телефону замовника з цього листа: | ||
https://p.pfx.so/pf/Df/MNjxFn.png | https://p.pfx.so/pf/Df/MNjxFn.png | ||
В результаті | В результаті відпрацювання цієї конструкції на наведеному вище прикладі формується інфоблок '''Телефон''' з вмістом '''+75847842159'''. | ||
Для вилучення довільної кількості рядків замовлення, перерахованих у листі, застосовується наступна конструкція: | |||
Для | |||
https://p.pfx.so/pf/5z/oDQdiP.png | https://p.pfx.so/pf/5z/oDQdiP.png | ||
В результаті | В результаті відпрацювання цієї конструкції на наведеному вище прикладі формуються 3 інфоблоки з таким вмістом: | ||
*'''Назва товару''': Зажим КС6, | *'''Назва товару''': Зажим КС6, Фіксатор U-системи, Перехідник N-P | ||
*'''Ціна товару''': 5400, 150, 390 | *'''Ціна товару''': 5400, 150, 390 | ||
*'''Кількість товару''': 1, 5, 3 | *'''Кількість товару''': 1, 5, 3 | ||
== Важливо == | == Важливо == | ||
* | *Надалі ці інфоблоки будуть використані для вибору і заповнення даними завдань, контактів і аналітик в [[Правило для пошти: Основна операція| основних]] і [[Правило для пошти: Додаткові операції| додаткових]] операціях правила розбору пошти (див. приклади в відповідних статтях довідки). | ||
*Дані, що надходять | *Дані, що надходять до Planfix з пошти, перед подальшим використанням можна додатково [[Обчислити інфоблок|опрацювати]]. | ||
== Перейти == | == Перейти == | ||
*[[Створення та редагування правил]] | *[[Створення та редагування правил]] | ||
*[[Правила створення завдань по e-mail]] | *[[Правила створення завдань по e-mail]] | ||
Поточна версія на 11:40, 23 листопада 2025
Вилучення даних — другий блок правила обробки пошти, який необхідно заповнити при його створенні.
Вилучати дані можна з різних частин листа:
- Теми листа + Вмісту
- Теми листа
- Вмісту
- Вмісту (оригінального листа) — використовуйте цей варіант тільки якщо ви контролюєте відправлення листа, у вас є його оригінальний текст до відправлення, і ви перевіряєте регулярні вирази або інші способи вилучення даних на ньому.
Дані вилучаються в інфоблоки, яким присвоюються зрозумілі назви, щоб надалі ними було зручно оперувати при заповненні полів завдання, контакту або аналітики. Окрім назви, кожен інфоблок містить інструкцію щодо вилучення частини листа, яка має бути в нього поміщена:
Формати вилучення даних
При вилученні даних Planfix може розглядати лист в одному з наступних варіантів:
- Текст — зазвичай відповідає тому, що бачить у листі людина. Це найпоширеніший варіант.
- HTML — буде аналізуватися весь вміст листа, включаючи розмітку. Такий варіант дозволяє використовувати для більш точного виділення потрібного вмісту фрагменти, що містять HTML-теги.
- HTML-таблиця — використовується для розбору даних із таблиць, що надходять у листах.
- JSON — використовується для розбору, якщо текст листа в форматі JSON. Детальніше про це читайте в довідці про JSONPath.
- XML — використовується для збереження і передачі даних, часто застосовується для передачі даних по API.
Способи виділення даних
Ви можете використовувати один із доступних варіантів:
- Від мітки до кінця рядка — в інфоблок потрапить фрагмент листа, що починається одразу за вказаною вами міткою початку і закінчується символом переносу рядка або завершенням листа. При цьому початкові пробіли (якщо вони є) і символ переносу рядка з виділеного таким чином текстового фрагмента в інфоблок не потрапляють.
- Від мітки до мітки — в інфоблок потрапить фрагмент листа, що починається одразу за вказаною вами міткою початку і закінчується останнім символом перед початком мітки кінця. Початкові і кінцеві пробіли отриманого текстового фрагмента також ігноруються.
- Наступний рядок від мітки — в інфоблок потрапить фрагмент листа, що починається з нового рядка відносно вказаної вами мітки. Початкові і кінцеві пробіли цього рядка ігноруються.
- Регулярним виразом — в інфоблок потрапить фрагмент листа, виділений за допомогою введеного вами регулярного виразу.
- Весь вміст — в інфоблок потрапляє весь вміст листа.
Приклади налаштування
Уявімо, що в Planfix потрапляє лист такого змісту:
Налаштування інфоблока для вилучення номера телефону замовника з цього листа:
В результаті відпрацювання цієї конструкції на наведеному вище прикладі формується інфоблок Телефон з вмістом +75847842159.
Для вилучення довільної кількості рядків замовлення, перерахованих у листі, застосовується наступна конструкція:
В результаті відпрацювання цієї конструкції на наведеному вище прикладі формуються 3 інфоблоки з таким вмістом:
- Назва товару: Зажим КС6, Фіксатор U-системи, Перехідник N-P
- Ціна товару: 5400, 150, 390
- Кількість товару: 1, 5, 3
Важливо
- Надалі ці інфоблоки будуть використані для вибору і заповнення даними завдань, контактів і аналітик в основних і додаткових операціях правила розбору пошти (див. приклади в відповідних статтях довідки).
- Дані, що надходять до Planfix з пошти, перед подальшим використанням можна додатково опрацювати.