JSONPath
W Planfix możesz parsować przychodzące e-maile lub webhooki w formacie JSON. E-maile wysyłane do Planfix mogą być parsowane przy użyciu JSON. JavaScript Object Notation to format przechowywania i wymiany informacji dostępny jako tekst czytelny dla człowieka. W obiekcie JSON występują dwa podstawowe elementy: klucz oraz 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 infobloków przy użyciu biblioteki JsonPath. Uwaga: Jeśli używasz funkcji podczas parsowania, upewnij się, że dodasz nawiasy na końcu, w przeciwnym razie funkcja nie będzie dział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"
]
}
- Powiedzmy, ż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"
}
- Skonfigurujemy następującą regułę do przetwarzania e-maili:
- Następnie tworzymy nowego klienta używając szablonu, wskazujemy które infobloki ustawić z których pól i dodajemy kontakt do zadania utworzonego z e-maila:
- W rezultacie potrzebne dane z e-maila w formacie JSON zostały przeniesione do Planfix:
Przykład №2
Dodawanie parametrów JSON do znaczników danych w Planfix
W tym przykładzie użyjemy JSON z zamówienia produktu w sklepie internetowym. Dane potrzebne do dodania 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
}
]
}
- Konfiguracja osobnej reguły dla zadań e-mail. Parsowanie JSON:
- Utwórz nowe zadanie i powiadom wybranego pracownika o jego utworzeniu:
- Dodawanie znaczników danych do utworzonego zadania. Uwaga: Ważne jest, aby w parametrze Add as many lines as there are values in the infoblock określić dodanie tylu linii, ile jest wartości w infobloku, aby wszystkie wartości zostały dodane do znaczników danych.
- W rezultacie zadanie wyświetla powiadomienie i znaczniki danych:
