Asynchrone Werkzeug-Handles bis zu einem endgültigen Ergebnis verfolgen

Ziel

Verhindern, dass ein Agent Erfolg meldet, wenn ein Werkzeug Arbeit lediglich angenommen oder ein Handle für eine noch laufende Operation zurückgegeben hat.

Voraussetzungen

Die Schnittstelle des Werkzeugs zum Auslesen des Status, seine Endzustände und jede Abbruchsemantik bestimmen. Das Operations-Handle mit der Aufgabe und dem Ziel verknüpft halten, ohne in privaten URLs eingebettete Zugangsdaten offenzulegen.

Schritte

1. Die anfängliche Antwort als abgelehnt, abgeschlossen oder zur späteren Ausführung angenommen einordnen. Eine angenommene Antwort muss einen ausstehenden Eintrag im Aufgabenprotokoll erzeugen, statt die Annahmeprüfung zu erfüllen.

2. Über die unterstützte Schnittstelle mit begrenzter Wartezeit abfragen oder abonnieren und dabei die Vorgaben des Dienstes beachten. Dieselbe Operationskennung über alle Prüfungen hinweg beibehalten, damit ein späterer Status nicht versehentlich auf einen neuen Lauf verweist.

3. Sobald ein Endzustand auftritt, dessen Ergebnisdetails auslesen. Vollständigen Erfolg von Teilabschluss, Abbruch und Fehlschlag unterscheiden; ein Endzustand bedeutet, dass die Verarbeitung beendet ist, nicht dass das beabsichtigte Ergebnis erreicht wurde.

4. Das Zielartefakt oder den externen Zustand verifizieren, wenn das Ergebnis der Operation folgenreich ist. Festhalten, ob diese Prüfung massgeblich ist oder nur eine Beobachtung über eine möglicherweise verzögerte Sicht.

5. Endet die Sitzung, während noch Arbeit aussteht, das Handle, den zuletzt beobachteten Zustand und die nächste Prüfung übergeben. Den Ablauf mit verzögertem Abschluss, Ablauf des Handles, Teilfehlschlag und Abbruch nach bereits geleisteter Arbeit testen.

Erwartetes Ergebnis

Der Agent meldet angenommene, laufende oder abgeschlossene Zustände korrekt und verknüpft den Abschluss mit Belegen über das angeforderte Ergebnis. Eine andere Sitzung kann die Überwachung fortsetzen, ohne doppelte Arbeit einzureichen.

Grenzen und Prüfbasis

Es wird hier kein werkzeugspezifischer Lebenszyklus angenommen oder getestet. Manche Dienste lassen Statusdatensätze ablaufen oder trennen Abschluss von Sichtbarkeit. In diesen Fällen den dokumentierten Wiederherstellungsweg verwenden und ungeklärte Ergebnisse melden, statt einen Endzustand zu erfinden.