JSONPath
Sie können eingehende E-Mails oder Webhooks in Planfix mit JSON parsen. An E-Mails, die an Planfix gesendet werden, können geparst werden im JSON-Format. JavaScript Object Notation ist ein Format zum Speichern und Austausch von Informationen, das als menschenlesbarer Text vorliegt. Es gibt zwei Hauptelemente in einem JSON-Objekt: den Schlüssel und den Wert.
Beispiel:
{"city":"New York", "country":"United States"}
- Schlüssel — city und country;
- Werte — New York und United States
Planfix kann E-Mails in diesem Format parsen und die notwendigen Daten mithilfe der JsonPath-Bibliothek in Informationsblöcke eintragen. Hinweis: Wenn Sie beim Parsen eine Funktion verwenden, stellen Sie sicher, dass Sie am Ende Klammern einfügen, andernfalls funktioniert die Funktion nicht.
Beispiel №1
Senden einer E-Mail im JSON-Format an Planfix
- Als Beispiel verwenden wir folgendes JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- Angenommen, wir benötigen die folgenden Daten aus dem JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Wir würden die folgende Regel für die Verarbeitung von E-Mails konfigurieren:
- Anschließend erstellen wir einen neuen Kunden mit der Vorlage, geben an, welche Informationsblöcke aus welchen Feldern gesetzt werden sollen, und fügen den Kontakt zur aus der E-Mail erstellten Aufgabe hinzu:
- Als Ergebnis wurden die notwendigen Daten aus der E-Mail im JSON-Format nach Planfix übertragen:
Beispiel №2
Hinzufügen von JSON-Parametern zu Planfix-Daten-Tags
Für dieses Beispiel verwenden wir JSON aus einer Produktbestellung in einem Onlineshop. Die für Analytics erforderlichen Daten sind rot hervorgehoben:
{
"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
}
]
}
- Einrichten einer separaten Regel für E-Mail-Aufgaben. JSON parsen:
- Erstellen einer neuen Aufgabe und Benachrichtigung der erforderlichen Mitarbeiter/in über deren Erstellung:
- Hinzufügen von Daten-Tags zur erstellten Aufgabe. Hinweis: Es ist wichtig, den Parameter Fügen Sie so viele Zeilen hinzu, wie es Werte im Informationsblock gibt anzugeben, damit alle Werte zu den Daten-Tags hinzugefügt werden.
- Als Ergebnis zeigt die Aufgabe die Benachrichtigung und die Daten-Tags an:
