JSONPath
V Planfixu můžete parsovat příchozí e-maily nebo webhooky pomocí JSONu. E-maily zaslané do Planfixu je možné parsovat pomocí JSONu. JavaScript Object Notation je formát pro ukládání a výměnu informací dostupný jako čitelný text. V JSON objektu jsou dva hlavní prvky: klíč a hodnota.
Příklad:
{"city":"New York", "country":"United States"}
- klíče — city a country;
- hodnoty — New York a United States
Planfix dokáže parsovat e-maily v tomto formátu a přidat potřebná data do informačních bloků pomocí JsonPath knihovny. Poznámka: Pokud při parsování používáte funkci, ujistěte se, že na konci vložíte závorky, jinak funkce nebude fungovat.
Příklad č. 1
Odeslání e-mailu v JSON formátu do Planfixu
- Jako příklad použijeme následující JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- Řekněme, že z JSONu potřebujeme následující data:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Nakonfigurujeme následující pravidlo pro zpracování e-mailů:
- Dále vytvoříme nového zákazníka pomocí šablony, určíme, které informační bloky nastavit z kterých polí, a přidáme kontakt do úkolu vytvořeného z e-mailu:
- Výsledkem je, že potřebná data z e-mailu v JSON formátu byla přenesena do Planfixu:
Příklad č. 2
Přidání JSON parametrů do datových tagů v Planfixu
Pro tento příklad použijeme JSON z objednávky produktu v e‑shopu. Data potřebná pro přidání analytiky jsou zvýrazněna červeně:
{
"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
}
]
}
- Nastavení samostatného pravidla pro e-mailové úkoly. Parsování JSONu:
- Vytvoření nového úkolu a upozornění potřebného zaměstnance o jeho vytvoření:
- Přidání datových tagů do vytvořeného úkolu. Poznámka: Je důležité u parametru Add as many lines as there are values in the infoblock uvést tolik řádků, kolik je hodnot v informačním bloku, aby se všechny hodnoty přidaly do datových tagů.
- Výsledkem je, že úkol zobrazuje upozornění a datové tagy:
