JSONPath
Planfix-та келіп түсетін электрондық хаттарды немесе вебхуктарды JSON арқылы парсинг жасауға болады. Planfix-ке жіберілген электрондық хаттар JSON арқылы парсингтелуі мүмкін. JavaScript Object Notation — бұл адамға оқуға ыңғайлы мәтін ретінде қолжетімді ақпаратты сақтауға және алмастыруға арналған формат. JSON объектісінің екі негізгі элементі бар: кілт (key) және мән (value).
Мысал:
{"city":"New York", "country":"United States"}
- кілттер — city және country;
- мәндер — New York және United States
Planfix электрондық хаттарды осы форматта парсингтеп, қажетті мәліметтерді инфоблоктарға JsonPath кітапханасын пайдалана отырып қоса алады: JsonPath. Ескерту: Парсинг кезінде функция қолдансаңыз, оның соңында жақшаларды (parenthesis) қою керек, әйтпесе функция жұмыс істемейді.
Мысал №1
JSON форматындағы электрондық хатты Planfix-ке жіберу
- Мысал ретінде келесі JSON-ды қолданамыз:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- JSON-нан келесі мәліметтер қажет делік:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Электрондық хаттарды өңдеу үшін келесі ереже (rule) конфигурациялаймыз:
- Келесіде шаблоннан (template) жаңа тапсырыс берушіні құрып, қай өрістерден қандай инфоблоктарды толтыру керектігін көрсетіп, электрондық хаттан құрылған тапсырмаға контакт қосамыз:
- Нәтижесінде электрондық хаттағы JSON форматындағы қажетті мәліметтер Planfix-ке өтіп кетті:
Мысал №2
JSON параметрлерін Planfix деректер тегтеріне қосу
Осы мысал үшін онлайн дүкендегі өнім тапсырысының JSON-ын пайдаланамыз. Аналитикаға қосу үшін қажетті деректер қызылмен белгіленген:
{
"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
}
]
}
- Электрондық хат тапсырмалары үшін бөлек ереже орнату. JSON парсинг:
- Жаңа тапсырма құрып, оның жасалғаны туралы қажетті қызметкерге хабарлау:
- Құрылып болған тапсырмаға деректер тегтерін қосу. Ескерту: барлық мәндер деректер тегі ретінде қосылуын қамтамасыз ету үшін параметрде Add as many lines as there are values in the infoblock көрсету маңызды.
- Нәтижесінде тапсырмада хабарландыру және деректер тегтері көрсетіледі: