About OData and references

Die Orchestrator-API-Implementierung basiert auf dem OData-Protokoll. OData (Open Data Protocol) ist ein von ISO/IEC zugelassener OASIS-Standard, der einen Satz bester Praktiken zum Aufbauen und Verbrauchen von RESTful APIs definiert.

Das Open Data Protocol (OData) ermöglicht die Erstellung von REST-basierten Datendiensten, welche mit URLs identifizierten und in einem Datenmodell definierten Ressourcen ermöglichen, mit einfachen HTTP-Meldungen von Webclients veröffentlicht und bearbeitet zu werden. Diese Spezifikation definiert die Kernsemantik und die Verhaltensaspekte des Protokolls.

Das Standardformat für den Orchestrator OData-Metadatenendpunkt ist JSON und die Metadaten-URL ist https://{yourDomain}/odata. Um das Standardformat in XML zu ändern, hängen Sie /?$format=xml an diese URL an.

Weitere Informationen zu Protokollgrundsätzen und Definitionen finden Sie in der entsprechenden offiziellen OData-Dokumentation.

Hinweis: Wir zielen auf die Einhaltung des OData-Standards ab, können dies jedoch nicht garantieren. Während der Standard vorschreibt, dass der Metadatenendpunkt standardmäßig das XML-Format zurückgeben muss, geben wir aus Gründen der historischen Kompatibilität JSON zurück.

Logical resources and metadata

Die Orchestrator-API bietet benutzerdefinierte Methoden für die Statusabfrage zu verschiedenen in Orchestrator registrierten Einheiten. Jede logische Ressource ist eine OData-Einheit. Alle Einheiten (wie Roboter, Prozess, Warteschlange) haben Eigenschaften, Beziehungen und Operationen.

Available operations

CRUD operations

Diese Operationstypen stehen meistens in logischen Ressourcen zur Verfügung. Zu CRUD-Operationen gehören GET-, POST-, PUT- und DELETE-Anfragen, aber beachten Sie bitte, dass aus technischen und geschäftlichen Gründen nicht alle logischen Ressourcen diese Verben verwenden.

Requesting data

Es besteht die Möglichkeit, bestimmte Informationen in Verbindung mit GET-Operationen durch ODaTa-spezifische Parameter von einer bestimmten Ressource anzufordern.

Sie ermöglichen Ihnen, Informationen abzufragen, zu filtern, zu sortieren, auszuwählen und zu erweitern. Ausführliche Informationen finden Sie in der offiziellen OData-Dokumentation.

Custom actions

Die folgenden benutzerdefinierten Aktionen und Aktionen, die nicht an eine logische Ressource gebunden sind, stehen in der Orchestrator-API zur Verfügung:

• Statusmethoden bieten aggregierte Informationen zu verschiedenen Einheiten.
• Kontomethoden bieten Authentifizierungsmethoden für Orchestrator;
• Warteschlangenmethoden werden vom Roboter verwendet, um auf Warteschlangen zuzugreifen, während der QueueDefinitions-Endpunkt anstatt für externe Systeme über API verwendet werden sollte;
• Methoden für die Aufzeichnung der Warteschlangenverarbeitung bieten statistische und aggregrierte Informationen über Warteschlangen;

• Roboterdienst-Ressourcen können von Orchestrator verwendet werden, um mit dem Roboter zu kommunizieren.