Skip to content

JSONPath

Pentru a depana expresiile JSONPath, utilizați serviciul online Jayway JsonPath Evaluator, în fila Jayway. Planfix folosește aceeași implementare JSONPath, așadar expresiile se comportă la fel acolo și în Planfix.

E-mailurile primite, webhook-urile sau răspunsurile la Solicitări HTTP POST prin scripturi pot fi analizate în Planfix folosind JSON. JavaScript Object Notation este un format pentru stocarea și schimbul de informații într-o formă ușor de citit de oameni. Un obiect JSON are două elemente principale: chei și valori.

Exemplu:

{"city":"New York", "country":"United States"}
  • chei — city și country;
  • valori — New York și United States.

Planfix poate analiza e-mailurile în acest format și poate adăuga datele necesare în infoblocuri. Acest lucru se face folosind biblioteca Java Jayway JsonPath. JSONPath nu are o singură implementare, iar sintaxa pentru filtre și funcții diferă de la o bibliotecă la alta. Prin urmare, o expresie care funcționează într-un alt serviciu (de exemplu, jsonpath.com) poate returna un rezultat diferit în Planfix. Consultați documentația Jayway JsonPath pentru funcțiile și operatorii disponibili.

Rețineți că, dacă utilizați o funcție la analizare, trebuie să includeți parantezele la final; în caz contrar, funcția nu va funcționa:

H5gE8u.jpg

Exemplul nr. 1

Trimiterea către Planfix a unui e-mail în format JSON

  • Pentru acest exemplu, vom folosi următorul JSON:
{
  "firstName": "Denis",
  "lastName": "Evans",
  "address": {
    "streetAddress": "1109 SW 12th St",
    "city": "Newport",
    "postalCode": 97365
  },
  "phoneNumbers": [
    "1-211-906-4147",
    "1-916-123-4567"
  ]
}
  • De exemplu, avem nevoie de următoarele date din JSON:
{
 "firstName": "Denis",
 "lastName": "Evans",
 "address": {
   "streetAddress": "1109 SW 12th St",
   "city": "Newport",
   "postalCode": 97365
 },
 "phoneNumbers": [
   "1-211-906-4147",
   "1-916-123-4567"
 ]
}
  • Vom configura următoarea regulă pentru procesarea e-mailurilor:

BGQzWr.jpg

  • Apoi, creăm un client nou folosind șablonul, indicăm din ce câmpuri trebuie setate infoblocurile și adăugăm contactul la sarcina creată din e-mail:

dL1P6b.jpg

  • Astfel, datele necesare din e-mailul în format JSON au fost transferate în Planfix:

NtRliu.jpg

Exemplul nr. 2

Adăugarea parametrilor JSON la etichetele de date din Planfix

  • Pentru acest exemplu, vom folosi JSON pentru o comandă de produs dintr-un magazin online. Datele necesare pentru adăugarea etichetelor de date sunt evidențiate cu roșu:

{

"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, 29 pcs",
"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

}
]

}

  • Configurați o regulă separată pentru sarcinile create din e-mailuri și analizați JSON-ul:

4bwSgN.jpg

  • Creați o sarcină nouă și notificați Angajatul care trebuie informat că aceasta a fost creată:

KxwRR2.jpg

  • Adăugați etichete de date la sarcina creată. Rețineți că este important să specificați parametrul Adăugați atâtea rânduri câte valori există în infobloc, astfel încât toate valorile să fie adăugate la etichetele de date:

k56IP5.jpg

  • Astfel, sarcina afișează notificarea și etichetele de date:

ptZGmD.jpg

LKfSAe.jpg

Mergeți la