Reguły e-mail: Wyodrębnianie danych: Różnice pomiędzy wersjami

Z Planfix
Skocz do: nawigacja, szukaj
(Utworzono nową stronę "{{#seo: |title=Email rules: Extracting data |titlemode=append |keywords=planfix, rules, email, tasks, extracting data from emails |description=email rules: extracting data }} '''Ekstrakcja danych''' to drugi blok w rules for processing emails, który należy wypełnić podczas creating a rule. Możesz wydobywać dane z różnych części wiadomości e-mail: *Temat+Treść e-maila *Temat e-m…")
 
Nie podano opisu zmian
 
Linia 1: Linia 1:
{{#seo:
{{#seo:
|title=Email rules: Extracting data
|title=Zasady e‑mail: Wyodrębnianie danych
|titlemode=append
|titlemode=append
|keywords=planfix, rules, email, tasks, extracting data from emails
|keywords=planfix, rules, email, tasks, extracting data from emails
|description=email rules: extracting data
|description=email rules: extracting data
}}
}}
'''Ekstrakcja danych''' to drugi blok w [[Zasady tworzenia zadań przez e-mail|rules for processing emails]], który należy wypełnić podczas [[Tworzenie i edytowanie reguł|creating a rule]].
'''Wyodrębnianie danych''' jest drugim blokiem w [[Zasady tworzenia zadań przez e-mail|zasadach przetwarzania e‑maili]], który musisz wypełnić podczas [[Tworzenie i edytowanie reguł|tworzenia reguły]].


Możesz wydobywać dane z różnych części wiadomości e-mail:
Możesz wyodrębniać dane z różnych części e‑maila:
*Temat+Treść e-maila
*Temat+treść e‑maila
*Temat e-maila
*Temat e‑maila
*Treść e-maila
*Treść
*Treść (oryginalna wiadomość) - Używaj tej opcji tylko wtedy, gdy kontrolujesz proces wysyłki e-maili, masz oryginalny tekst przed wysłaniem i testujesz wyrażenia regularne lub inne metody ekstrakcji danych.
*Treść (oryginalny e‑mail) - używaj tej opcji tylko jeśli kontrolujesz proces wysyłania wiadomości, masz oryginalny tekst przed wysłaniem i testujesz wyrażenia regularne lub inne metody wydobywania danych.


Dane są wyodrębniane do '''infoblocków''' (bloków informacyjnych). Te infoblocki mają intuicyjne nazwy, co ułatwia późniejszą pracę z nimi przy wypełnianiu pól zadań, kontaktów lub znaczników danych. Oprócz nazwy każdy infoblock zawiera instrukcję, jak wydobyć fragment wiadomości e-mail, który ma do niego trafić:
Dane wyodrębniane są do '''infoblocków'''. Te infoblocki mają intuicyjne nazwy, co ułatwia późniejszą pracę z nimi przy wypełnianiu pól zadania, kontaktu lub znacznika danych. Oprócz nazwy każdy infoblock zawiera instrukcję dotyczącą wyodrębnianej części e‑maila:


https://s.pfx.so/pf/mV/pW1s08.jpg
https://s.pfx.so/pf/mV/pW1s08.jpg
==Formaty ekstrakcji danych==
==Formaty wyodrębniania danych==
Podczas ekstrakcji danych Planfix może analizować wiadomość na dwa sposoby:
Przy wyodrębnianiu danych Planfix może analizować e‑mail na dwa sposoby:
   
   
https://s.pfx.so/pf/dt/QFUoX8.jpg
https://s.pfx.so/pf/dt/QFUoX8.jpg


*'''Text''' — odpowiada zwykle temu, co widzisz w przeglądarce, czytając e-mail. To najpopularniejsza opcja.
*'''Tekst''' — zazwyczaj odpowiada temu, co widzisz w przeglądarce, czytając e‑mail. To najpopularniejsza opcja.
*'''HTML''' — analizowane będą wszystkie treści e-maila, łącznie z markupem. Ta opcja pozwala używać fragmentów zawierających tagi HTML, by dokładniej uchwycić pożądane treści.
*'''HTML''' — analizowane wszystkie elementy wiadomości, łącznie z markupem. Ta opcja pozwala użyć fragmentów zawierających tagi HTML, aby precyzyjniej uchwycić żądane treści.
*'''HTML-Table''' — używane do [[Wyodrębnianie danych z tabel w wiadomościach e-mail|extracting data from tables]] w e-mailach.
*'''HTML-Table''' — używane do [[Wyodrębnianie danych z tabel w wiadomościach e-mail|wyodrębniania danych z tabel]] w e‑mailach.
*'''JSON''' — używane do parsowania, jeśli tekst wiadomości jest w formacie JSON. Więcej o tym w naszej sekcji pomocy [[JSONPath]].
*'''JSON''' — używane, gdy tekst wiadomości jest w formacie JSON. Więcej na ten temat w naszym artykule pomocy [[JSONPath]].
*'''XML''' — używane do przechowywania i przesyłania danych, często stosowane przy wymianie danych przez [[API|Planfix API]].
*'''XML''' — używane do przechowywania i przesyłania danych, często stosowane przy wymianie danych przez [[API|Planfix API]].


==Metody ekstrakcji danych==
==Metody wyodrębniania danych==
Możesz użyć jednej z dostępnych opcji:
Możesz użyć jednej z dostępnych opcji:


https://s.pfx.so/pf/2I/CQyWGR.jpg
https://s.pfx.so/pf/2I/CQyWGR.jpg


*'''From label to end of line''' - infoblock będzie zawierał fragment e-maila zaczynający się bezpośrednio po podanej etykiecie i kończący się znakiem nowej linii lub końcem wiadomości. Wiodące spacje (jeśli występują) i znak nowej linii nie zostaną uwzględnione w infoblocku.
*'''Od etykiety do końca linii''' - infoblock będzie zawierać fragment e‑maila zaczynający się zaraz po podanej przez Ciebie etykiecie i kończący się znakiem nowej linii lub końcem wiadomości. Nie będą wliczane wiodące spacje (jeśli występują) ani znak nowej linii.
*'''From label to label''' - infoblock będzie zawierał fragment wiadomości zaczynający się bezpośrednio po podanej etykiecie początkowej i kończący się znakiem tuż przed etykietą końcową. Wiodące i końcowe spacje zostaną zignorowane.
*'''Od etykiety do etykiety''' - infoblock będzie zawierać fragment e‑maila zaczynający się zaraz po podanej etykiecie początkowej i kończący się znakiem tuż przed etykietą końcową. Wiodące i końcowe spacje zostaną zignorowane.
*'''From label to end of line''' - infoblock zawiera fragment wiadomości, który zaczyna się na nowej linii po podanej etykiecie. Wiodące i końcowe spacje zostaną zignorowane.
*'''Od etykiety do końca wiersza''' - infoblock zawiera fragment e‑maila, który zaczyna się w nowym wierszu po podanej etykiecie. Wiodące i końcowe spacje zostaną zignorowane.
*'''Regular expression''' - infoblock będzie zawierał fragment wiadomości zgodnie z wprowadzonym [[regular expression]].
*'''Wyrażenie regularne''' - infoblock będzie zawierać fragment e‑maila zgodny z wprowadzonym przez Ciebie [[regular expression]].
*'''All contents''' - infoblock będzie zawierał całą treść wiadomości e-mail.
*'''Cała zawartość''' - infoblock będzie zawierać całą zawartość e‑maila.


==Przykłady==
==Przykłady==
Załóżmy, że e-mail wysłany do Planfix ma następującą treść:
Załóżmy, że e‑mail wysłany do Planfix ma następującą treść:


https://s.pfx.so/pf/BK/V6V153.jpg
https://s.pfx.so/pf/BK/V6V153.jpg


Konfiguracja infoblocku do wyciągnięcia numeru telefonu klienta z tego e-maila będzie wyglądać następująco:
Konfiguracja infoblocka do wyodrębnienia numeru telefonu klienta z tego e‑maila wyglądałaby następująco:
   
   
https://s.pfx.so/pf/sV/U1dqar.jpg
https://s.pfx.so/pf/sV/U1dqar.jpg
Linia 49: Linia 49:
Po przetworzeniu zostanie utworzony infoblock o nazwie Phone, zawierający +16888933044.
Po przetworzeniu zostanie utworzony infoblock o nazwie Phone, zawierający +16888933044.


Aby wyodrębnić wiele pozycji z zamówienia wymienionych w e-mailu, użyj następującego ustawienia:
Aby wyodrębnić wiele wierszy z zamówienia wymienionych w e‑mailu, użyj następującej konfiguracji:


https://s.pfx.so/pf/4u/wXosec.jpg
https://s.pfx.so/pf/4u/wXosec.jpg


Po przetworzeniu utworzone zostaną trzy infoblocki o następującej zawartości:
Po przetworzeniu powstaną trzy infoblocki o następującej zawartości:
*'''Product name:''' Toyo r888
*'''Product name:''' Toyo r888
*'''Product price:''' 500
*'''Product price:''' 500
Linia 59: Linia 59:


==Ważne==
==Ważne==
*Później w regule parsowania maili operacja [[Reguły e-mail: Główna operacja| main]] i operacje [[Reguły e-mail: dodatkowe operacje| additional]] będą używać tych infoblocków do wybierania zadań, kontaktów i znaczników danych oraz wypełniania ich pól danymi. (Przykłady znajdują się w odpowiednich artykułach pomocy.)
*Później w regule przetwarzania poczty, [[Reguły e-mail: Główna operacja|główna]] operacja i [[Reguły e-mail: dodatkowe operacje|dodatkowe]] operacje będą używać tych infoblocków do wyboru zadań, kontaktów i znaczników danych oraz do wypełniania ich pól danymi. (Przykłady znajdziesz w odpowiednich artykułach pomocy.)
*Dane z przychodzących e-maili w Planfix mogą być dalej [[Oblicz blok informacyjny|processed]] przed użyciem.
*Dane z przychodzących e‑maili w Planfix można dalej [[Oblicz blok informacyjny|przetwarzać]] przed użyciem.


== Przejdź do ==
==Przejdź do==
*[[Tworzenie i edytowanie reguł]]
*[[Tworzenie i edytowanie reguł]]
*[[Zasady tworzenia zadań przez e-mail]]
*[[Zasady tworzenia zadań przez e-mail]]
*[[Opis funkcji]]
*[[Opis funkcji]]

Aktualna wersja na dzień 13:52, 6 gru 2025

Wyodrębnianie danych jest drugim blokiem w zasadach przetwarzania e‑maili, który musisz wypełnić podczas tworzenia reguły.

Możesz wyodrębniać dane z różnych części e‑maila:

  • Temat+treść e‑maila
  • Temat e‑maila
  • Treść
  • Treść (oryginalny e‑mail) - używaj tej opcji tylko jeśli kontrolujesz proces wysyłania wiadomości, masz oryginalny tekst przed wysłaniem i testujesz wyrażenia regularne lub inne metody wydobywania danych.

Dane wyodrębniane są do infoblocków. Te infoblocki mają intuicyjne nazwy, co ułatwia późniejszą pracę z nimi przy wypełnianiu pól zadania, kontaktu lub znacznika danych. Oprócz nazwy każdy infoblock zawiera instrukcję dotyczącą wyodrębnianej części e‑maila:

pW1s08.jpg

Formaty wyodrębniania danych

Przy wyodrębnianiu danych Planfix może analizować e‑mail na dwa sposoby:

QFUoX8.jpg

  • Tekst — zazwyczaj odpowiada temu, co widzisz w przeglądarce, czytając e‑mail. To najpopularniejsza opcja.
  • HTML — analizowane są wszystkie elementy wiadomości, łącznie z markupem. Ta opcja pozwala użyć fragmentów zawierających tagi HTML, aby precyzyjniej uchwycić żądane treści.
  • HTML-Table — używane do wyodrębniania danych z tabel w e‑mailach.
  • JSON — używane, gdy tekst wiadomości jest w formacie JSON. Więcej na ten temat w naszym artykule pomocy JSONPath.
  • XML — używane do przechowywania i przesyłania danych, często stosowane przy wymianie danych przez Planfix API.

Metody wyodrębniania danych

Możesz użyć jednej z dostępnych opcji:

CQyWGR.jpg

  • Od etykiety do końca linii - infoblock będzie zawierać fragment e‑maila zaczynający się zaraz po podanej przez Ciebie etykiecie i kończący się znakiem nowej linii lub końcem wiadomości. Nie będą wliczane wiodące spacje (jeśli występują) ani znak nowej linii.
  • Od etykiety do etykiety - infoblock będzie zawierać fragment e‑maila zaczynający się zaraz po podanej etykiecie początkowej i kończący się znakiem tuż przed etykietą końcową. Wiodące i końcowe spacje zostaną zignorowane.
  • Od etykiety do końca wiersza - infoblock zawiera fragment e‑maila, który zaczyna się w nowym wierszu po podanej etykiecie. Wiodące i końcowe spacje zostaną zignorowane.
  • Wyrażenie regularne - infoblock będzie zawierać fragment e‑maila zgodny z wprowadzonym przez Ciebie regular expression.
  • Cała zawartość - infoblock będzie zawierać całą zawartość e‑maila.

Przykłady

Załóżmy, że e‑mail wysłany do Planfix ma następującą treść:

V6V153.jpg

Konfiguracja infoblocka do wyodrębnienia numeru telefonu klienta z tego e‑maila wyglądałaby następująco:

U1dqar.jpg

Po przetworzeniu zostanie utworzony infoblock o nazwie Phone, zawierający +16888933044.

Aby wyodrębnić wiele wierszy z zamówienia wymienionych w e‑mailu, użyj następującej konfiguracji:

wXosec.jpg

Po przetworzeniu powstaną trzy infoblocki o następującej zawartości:

  • Product name: Toyo r888
  • Product price: 500
  • Amount: 2

Ważne

  • Później w regule przetwarzania poczty, główna operacja i dodatkowe operacje będą używać tych infoblocków do wyboru zadań, kontaktów i znaczników danych oraz do wypełniania ich pól danymi. (Przykłady znajdziesz w odpowiednich artykułach pomocy.)
  • Dane z przychodzących e‑maili w Planfix można dalej przetwarzać przed użyciem.

Przejdź do