|
<< Click pentru afișare cuprins >> Navigare: SmartCash Everywhere REST Server > Instructiuni generale de utilizare ale metodelor de tip Get > Format JSON utilizat |
Serverul SmartCash Everywhere permite returnarea rezultatelor de tip set de inregistrari (tabela de inregistrari) intr-o sintaxa JSON sub forma de array de perechi de valori, de tipul Camp – Valoare, cu eticheta generala DATASET, similar cu fomatul XML clasic de nominalizare al campurilor. Pentru anumite tipuri de operatii, pe langa nodul cu eticheta general DATASET, poate fi furnizat un nod suplimentar cu eticheta generica METRICS. In acest nod pot fi returnate sume totale de control specifice tipului respectiv de document (de ex numarul total de bonuri emise in cazul metodei GetNextRetailSale, etc).
ATENTIE! Pentru identificarea campurilor se va folosi intotdeauna denumirea acestora si nu ordinea in care sunt livrate in momentul primirii raspunsului deoarece aceasta nu este intotdeauna identica (poate fi diferita in urma unui upgrade al aplicatiilor)!
Iata un exemplu de formatare folosind aceasta sintaxa pentru un rezultat ce contine doar nodul DATASET:
{"result":
{"DATASET":
[
{"REC":1,"CAMP1_STRING":"Valoare Camp", "CAMP2_INT":1,"CAMP3_FLOAT":5.369, …},
{"REC":2,"CAMP1_STRING":"Valoare Camp", "CAMP2_INT":1,"CAMP3_FLOAT":5.369, …}
…
]
}
}
Iata un exemplu de formatare folosind aceasta sintaxa pentru un rezultat ce contine nodul DATASET si nodul METRICS:
{"result":
{"DATASET":
[
{"REC":1,"CAMP1_STRING":"Valoare Camp", "CAMP2_INT":1,"CAMP3_FLOAT":5.369, …},
{"REC":2,"CAMP1_STRING":"Valoare Camp", "CAMP2_INT":1,"CAMP3_FLOAT":5.369, …}
…
]
, "METRICS":{"INVOICE_RECEIPTS_COUNT":1,"RECEIPTS_COUNT":1, …}
}
}
Pentru fiecare inregistrare din nodul DATASET este furnizat automat campul REC care are valoarea egala cu numarul liniei de inregistrare din dataset. Citirea ultimului array permite astfel aflarea rapida a numarului de inregistrari dintr-un dataset.
Nodul METRICS este optional, fiind disponibil doar pentru metodele pentru care este indicat in prezenta documentatie.