API pentru liste de verificare

API-ul /checklists/ a fost creat pentru a permite utilizatorilor să descarce și să analizeze răspunsurile la întrebările din listele de verificare în DISPATCH-ul L2L. Fiecare înregistrare returnată în acest API reprezintă o listă de verificare care a fost creată dintr-o Expediere, din Portalul operatorului sau manual.

Filtrarea listelor de verificare

API-ul /checklists/ poate fi filtrat și sortat după oricare dintre proprietățile principale, cum ar fi: site, numele documentului, expediere, produs, linie, mașină etc.

Întrebări și răspunsuri

Întrebările și răspunsurile se găsesc în proprietățile tasks și, respectiv, answers.  

Lista tasks conține toate întrebările care se aflau în versiunea publicată a listei de verificare la momentul creării acesteia. Dacă este publicată o versiune nouă a unei liste de verificare, iar un utilizator alege să actualizeze întrebările listei de verificare, lista tasks va fi, de asemenea, actualizată în API.

Lista answers conține toate răspunsurile introduse în lista de verificare. Fiecare răspuns are o proprietate task_number, care reprezintă indicele întrebării din lista tasks la care se referă răspunsul. De exemplu, dacă un răspuns are task_number 3, întrebarea asociată este al treilea element din lista tasks.

API-ul pentru răspunsuri conține, de asemenea, criteriile de promovare, eșuare și avertizare, dacă utilizați evaluarea listelor de verificare. API-ul vă va furniza un număr: 0 = Promovat, 1 = Avertizare, 2 = Eșuat

 

Tabele

Întrebările și răspunsurile pentru listele de verificare care se află în tabele sunt, de asemenea, incluse în API-ul /checklists/. Obiectul task definește tabelul, inclusiv anteturile coloanelor, informațiile despre rânduri și coloane și definițiile întrebărilor. Răspunsurile sunt incluse în lista answers, iar întrebarea asociată poate fi găsită în lista tasks folosind proprietățile task_number, table_row_number și table_column_number.

Considerații privind dezvoltarea

• Proprietatea task_hash din obiectul task și obiectul answer există din motive de compatibilitate cu versiunile anterioare. Această proprietate nu trebuie utilizată pentru a asocia întrebările și răspunsurile task-urilor.
• API-ul /checklistsanswers/ a fost dezvoltat și lansat înainte ca răspunsurile să fie incluse în încărcătura API-ului /checklists/ și va continua să furnizeze răspunsuri și în viitor. Cu toate acestea, obiectul answers din încărcătura /checklists/ este mai robust și reprezintă metoda preferată pentru colectarea răspunsurilor din listele de verificare.