JSONPath
In Planfix è possibile analizzare le email in arrivo, i webhook o le risposte a Richieste HTTP usando JSON. JavaScript Object Notation è un formato per memorizzare e scambiare informazioni in forma leggibile. Un oggetto JSON ha due elementi principali: chiavi e valori.
Esempio:
{"city":"New York", "country":"United States"}
- chiavi — city e country;
- valori — New York e United States.
Planfix può analizzare le email in questo formato e aggiungere i dati necessari ai blocchi informativi. Questa operazione viene eseguita usando la libreria Java Jayway JsonPath. JSONPath non ha un’unica implementazione e la sintassi di filtri e funzioni varia da una libreria all’altra. Pertanto, un’espressione che funziona in un altro servizio, ad esempio jsonpath.com, potrebbe restituire un risultato diverso in Planfix. Consulta la documentazione di Jayway JsonPath per conoscere le funzioni e gli operatori disponibili.
Nota: se usi una funzione durante l’analisi, devi inserire le parentesi alla fine; altrimenti, la funzione non funzionerà:
Esempio n. 1
Invio a Planfix di un’email in formato JSON
- Per questo esempio, useremo il seguente JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147",
"1-916-123-4567"
]
}
- Ad esempio, ci servono i seguenti dati dal JSON:
"firstName": "Denis", "lastName": "Evans", "address": { "streetAddress": "1109 SW 12th St", "city": "Newport", "postalCode": 97365 }, "phoneNumbers": [ "1-211-906-4147", "1-916-123-4567" ]}
- Configureremo la seguente regola per elaborare le email:
- Poi, creiamo un nuovo cliente usando il modello, indichiamo da quali campi impostare i blocchi informativi e aggiungiamo il contatto al compito creato dall’email:
- Di conseguenza, i dati necessari dell’email in formato JSON sono stati trasferiti a Planfix:
Esempio n. 2
Aggiunta di parametri JSON ai tag dati di Planfix
- Per questo esempio, useremo un JSON relativo all’ordine di un prodotto in un negozio online. I dati necessari per aggiungere i tag dati sono evidenziati in rosso:
{
"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
}
]
}
- Imposta una regola separata per i compiti creati dalle email e analizza il JSON:
- Crea un nuovo compito e notifica al Dipendente interessato che è stato creato:
- Aggiungi i tag dati al compito creato. Nota che è importante selezionare il parametro Aggiungi tante righe quanti sono i valori nel blocco informativo, affinché tutti i valori vengano aggiunti ai tag dati:
- Di conseguenza, nel compito vengono visualizzati la notifica e i tag dati: