Checklisten-API

Die /checklists/-API wurde erstellt, um Benutzern das Herunterladen und Analysieren von Antworten auf Checklistenfragen in L2L's DISPATCH zu ermöglichen. Jeder von dieser API zurückgegebene Datensatz stellt eine Checkliste dar, die aus einem Versand, dem Bedienerportal oder manuell erstellt wurde.

Checklisten filtern

Die /checklists/-API kann nach allen wichtigen Eigenschaften gefiltert und sortiert werden, wie zum Beispiel: Standort, Dokumentname, Versand, Produkt, Linie, Maschine usw.

Fragen und Antworten

Fragen und Antworten befinden sich jeweils unter den Eigenschaften tasks und answers.  

Die Liste tasks enthält alle Fragen, die sich zum Zeitpunkt der Erstellung der Checkliste in der veröffentlichten Version der Checkliste befanden. Wenn eine neue Version einer Checkliste veröffentlicht wird und ein Benutzer die Checklistenfragen aktualisiert, wird auch die Liste tasks in der API aktualisiert.

Die Liste answers enthält alle in der Checkliste eingegebenen Antworten. Jede Antwort verfügt über eine Eigenschaft task_number, die den Index der Frage in der Liste tasks angibt, auf die sich die Antwort bezieht. Wenn eine Antwort beispielsweise den Wert 3 für task_number hat, ist die zugehörige Frage das dritte Element in der Liste tasks.

Die Answers-API enthält außerdem die Kriterien für Bestanden, Nicht bestanden und Warnung, wenn Sie die Checklistenbewertung verwenden. Die API gibt eine Zahl zurück: 0 = Bestanden, 1 = Warnung, 2 = Nicht bestanden

 

Tabellen

Fragen und Antworten für Checklisten, die sich in Tabellen befinden, sind ebenfalls in der /checklists/-API enthalten. Das Objekt task definiert die Tabelle, einschließlich Spaltenüberschriften, Zeilen- und Spalteninformationen sowie Fragendefinitionen. Antworten sind in der Liste answers enthalten, und die zugehörige Frage kann in der Liste tasks anhand der Eigenschaften task_number, table_row_number und table_column_number gefunden werden.

Überlegungen zur Entwicklung

• Die Eigenschaft task_hash im Task-Objekt und im Antwortobjekt ist aus Gründen der Abwärtskompatibilität vorhanden. Diese Eigenschaft sollte nicht verwendet werden, um Aufgabenfragen und Antworten miteinander zu verknüpfen.
• Die /checklistsanswers/-API wurde entwickelt und veröffentlicht, bevor Antworten in die Payload der /checklists/-API aufgenommen wurden, und wird auch in Zukunft Antworten bereitstellen. Das Antwortobjekt in der Payload der /checklists/-API ist jedoch robuster und wird bevorzugt zum Abrufen von Checklistenantworten verwendet.