JSONPath: Różnice pomiędzy wersjami
PlanfixBot (dyskusja | edycje) (Utworzono nową stronę "{{#seo: |title=JSONPath |titlemode=append |keywords=planfix, rules, email, extracting data from an email, JSONPath, JSON, json |description=JSONPath }} <div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;">Użyj dedykowanej usługi online do debugowania i naprawy błędów parsowania: [https://jsonpath.com/ JSONPath Online Evaluator]</div> W Planfix możesz parsować przychodzące e-maile lub Prz…") |
PlanfixBot (dyskusja | edycje) Nie podano opisu zmian |
||
| Linia 5: | Linia 5: | ||
|description=JSONPath | |description=JSONPath | ||
}} | }} | ||
<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> | <div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;">Skorzystaj ze specjalnej usługi online do debugowania i naprawy błędów parsowania: [https://jsonpath.com/ JSONPath Online Evaluator]</div> | ||
W Planfix możesz parsować przychodzące [[Reguły e-mail: Wyodrębnianie danych|e-maile]] lub [[Przychodzące webhooki|webhooki]] | W Planfix możesz parsować przychodzące [[Reguły e-mail: Wyodrębnianie danych|e-maile]] lub [[Przychodzące webhooki|webhooki]] przy użyciu JSON. [[Reguły e-mail: Wyodrębnianie danych| E-maile wysyłane do Planfix można parsować]] za pomocą JSON. JavaScript Object Notation to format przechowywania i wymiany informacji dostępny jako tekst czytelny dla człowieka. W obiekcie JSON występują dwa główne elementy: klucz i wartość. | ||
Przykład: | Przykład: | ||
| Linia 15: | Linia 15: | ||
*wartości — New York i United States | *wartości — New York i United States | ||
Planfix może parsować e-maile w tym formacie i dodawać potrzebne dane do | Planfix może parsować e-maile w tym formacie i dodawać potrzebne dane do bloków informacyjnych za pomocą biblioteki [https://github.com/json-path/JsonPath JsonPath]. | ||
Uwaga: Jeśli używasz funkcji podczas parsowania, upewnij się, że | Uwaga: Jeśli używasz funkcji podczas parsowania, upewnij się, że dodajesz nawiasy na końcu, w przeciwnym razie funkcja nie zadziała. | ||
https://s.pfx.so/pf/YE/H5gE8u.jpg | https://s.pfx.so/pf/YE/H5gE8u.jpg | ||
==Przykład №1== | ==Przykład №1== | ||
===Wysyłanie | ===Wysyłanie e‑maila w formacie JSON do Planfix=== | ||
*Jako przykład użyjemy następującego JSON: | *Jako przykład użyjemy następującego JSON: | ||
<div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | <div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | ||
| Linia 42: | Linia 42: | ||
</div> | </div> | ||
* | *Załóżmy, że potrzebujemy następujących danych z JSON: | ||
<div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | <div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | ||
{ | { | ||
| Linia 60: | Linia 60: | ||
<p>}</p> | <p>}</p> | ||
</div> | </div> | ||
* | *Skonfigurowalibyśmy następującą regułę do przetwarzania e‑maili: | ||
https://s.pfx.so/pf/vt/BGQzWr.jpg | https://s.pfx.so/pf/vt/BGQzWr.jpg | ||
*Następnie tworzymy nowego | *Następnie tworzymy nowego kontrahenta przy użyciu szablonu, wskazujemy, które bloki informacyjne ustawić z których pól, i dodajemy kontakt do zadania utworzonego z e‑maila: | ||
https://s.pfx.so/pf/nG/dL1P6b.jpg | https://s.pfx.so/pf/nG/dL1P6b.jpg | ||
*W | *W efekcie niezbędne dane z e‑maila w formacie JSON zostały przekazane do Planfix: | ||
https://s.pfx.so/pf/xN/NtRliu.jpg | https://s.pfx.so/pf/xN/NtRliu.jpg | ||
==Przykład №2== | ==Przykład №2== | ||
===Dodawanie parametrów JSON do znaczników danych | ===Dodawanie parametrów JSON do znaczników danych Planfix=== | ||
Do tego przykładu użyjemy JSON z zamówienia produktu w sklepie internetowym. Dane potrzebne do analityki są wyróżnione na czerwono: | |||
<div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | <div style="background-color:#f9f9f9; border:1px solid #ddd; padding:1em;border-radius:4px;"> | ||
{<br> | {<br> | ||
| Linia 127: | Linia 127: | ||
</div> | </div> | ||
* | *Skonfigurowanie osobnej reguły dla zadań e‑mail. Parsowanie JSON: | ||
https://s.pfx.so/pf/V3/4bwSgN.jpg | https://s.pfx.so/pf/V3/4bwSgN.jpg | ||
*Utwórz nowe zadanie i powiadom | *Utwórz nowe zadanie i powiadom odpowiedniego Pracownika o jego utworzeniu: | ||
https://s.pfx.so/pf/0H/KxwRR2.jpg | https://s.pfx.so/pf/0H/KxwRR2.jpg | ||
*Dodawanie znaczników danych do utworzonego zadania. Uwaga: Ważne jest, aby | *Dodawanie znaczników danych do utworzonego zadania. Uwaga: Ważne jest, aby określić parametr '''Add as many lines as there are values in the infoblock''' (Dodaj tyle wierszy, ile jest wartości w bloku informacyjnym), aby zapewnić dodanie wszystkich wartości do znaczników danych. | ||
https://s.pfx.so/pf/s8/k56IP5.jpg | https://s.pfx.so/pf/s8/k56IP5.jpg | ||
*W | *W efekcie zadanie wyświetla powiadomienie i znaczniki danych: | ||
https://s.pfx.so/pf/th/ptZGmD.jpg | https://s.pfx.so/pf/th/ptZGmD.jpg | ||
Aktualna wersja na dzień 02:12, 3 gru 2025
W Planfix możesz parsować przychodzące e-maile lub webhooki przy użyciu JSON. E-maile wysyłane do Planfix można parsować za pomocą JSON. JavaScript Object Notation to format przechowywania i wymiany informacji dostępny jako tekst czytelny dla człowieka. W obiekcie JSON występują dwa główne elementy: klucz i wartość.
Przykład:
{"city":"New York", "country":"United States"}
- klucze — city i country;
- wartości — New York i United States
Planfix może parsować e-maile w tym formacie i dodawać potrzebne dane do bloków informacyjnych za pomocą biblioteki JsonPath. Uwaga: Jeśli używasz funkcji podczas parsowania, upewnij się, że dodajesz nawiasy na końcu, w przeciwnym razie funkcja nie zadziała.
Przykład №1
Wysyłanie e‑maila w formacie JSON do Planfix
- Jako przykład użyjemy następującego JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- Załóżmy, że potrzebujemy następujących danych z JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Skonfigurowalibyśmy następującą regułę do przetwarzania e‑maili:
- Następnie tworzymy nowego kontrahenta przy użyciu szablonu, wskazujemy, które bloki informacyjne ustawić z których pól, i dodajemy kontakt do zadania utworzonego z e‑maila:
- W efekcie niezbędne dane z e‑maila w formacie JSON zostały przekazane do Planfix:
Przykład №2
Dodawanie parametrów JSON do znaczników danych Planfix
Do tego przykładu użyjemy JSON z zamówienia produktu w sklepie internetowym. Dane potrzebne do analityki są wyróżnione na czerwono:
{
"site": "mysite.shop",
"name": "Denis Evans",
"id": "6598634",
"date": "30.11.2024 09:16:05",
"status": "In progress",
"email": "techT7@gmail.com",
"phone": "+1 211 906-4147",
"address": "1109 SW 12th St1",
"price_total": "466.45",
"item_order": [
{
"sku": "598623",
"name": Cobalt drill bit set 29pc",
"barcode": "596325689126",
"price": "29.99",
"quantity": 5
},
{
"sku": "589624",
"name": "High torque driver",
"barcode": "5963256858963",
"price": "230.00",
"quantity": 1
},
{
"sku": "579824",
"name": "Half inch ratchet 120 tooth",
"barcode": "5963256889634",
"price": "43.25",
"quantity": 2
}
]
}
- Skonfigurowanie osobnej reguły dla zadań e‑mail. Parsowanie JSON:
- Utwórz nowe zadanie i powiadom odpowiedniego Pracownika o jego utworzeniu:
- Dodawanie znaczników danych do utworzonego zadania. Uwaga: Ważne jest, aby określić parametr Add as many lines as there are values in the infoblock (Dodaj tyle wierszy, ile jest wartości w bloku informacyjnym), aby zapewnić dodanie wszystkich wartości do znaczników danych.
- W efekcie zadanie wyświetla powiadomienie i znaczniki danych: