Den Umfang eines paginierten Inventars nachweisen, bevor Massenänderungen vorgenommen werden

Ziel

Genau feststellen, welche Objekte ein paginierter Lesevorgang erfasst hat, bevor er als Eingabe für eine Massenbearbeitung, einen Löschvorschlag oder einen Migrationsplan verwendet wird.

Voraussetzungen

Das dokumentierte Paginierungsverhalten der Schnittstelle, den autorisierten Sammlungsumfang und ein stabiles Identitätsfeld kennen. Lesevorgänge müssen innerhalb der Dienstgrenzen bleiben und das Erfassen von für die vorgesehene Aktion unnötigen Feldern vermeiden.

Schritte

1. Die anfänglichen Filter, die Sortierreihenfolge, das Konto oder den Mandanten sowie jede Snapshot-Markierung festhalten. Diese als Teil der Inventaridentität behandeln; eine spätere Seite unter anderen Filtern ist keine Fortsetzung desselben Durchlaufs.

2. Jedes zurückgegebene Fortsetzungstoken gemäss dem Schnittstellenvertrag verarbeiten. Gesehene Objektkennungen und den Tokenfortschritt verfolgen, damit eine wiederholte Seite oder eine Token-Schleife zu einem sichtbaren Fehler wird.

3. Fehlgeschlagene Seiten als Lücken behandeln. Sie nicht durch leere Seiten ersetzen und Vollständigkeit nicht aus einer kleiner als erwartet ausfallenden Seite ableiten, ausser der dokumentierte Vertrag erlaubt diese Deutung ausdrücklich.

4. Beim Abschluss die tatsächlich beobachtete Vollständigkeitsbedingung festhalten. Hat sich die Sammlung während des Durchlaufs verändert und stand kein konsistenter Snapshot zur Verfügung, das Inventar als begrenzte Beobachtung beschreiben statt als endgültige Zählung.

5. Vor der Änderung die betroffenen Objekte erneut prüfen und aktuelle Vorbedingungen verwenden. Den Inventarcode gegen wiederholte Token, eine leere Zwischenseite, eine fehlgeschlagene letzte Seite und Objekte testen, die über Filtergrenzen hinweg wandern.

Erwartetes Ergebnis

Die Batch-Eingabe enthält einen expliziten Umfang und einen Abdeckungsnachweis. Ein Agent kann begründen, welche Objekte berücksichtigt wurden, und vermeiden, eine unvollständige Auflistung als jedes infrage kommende Objekt darzustellen.

Grenzen und Prüfbasis

Dies ist ein originärer Vorschlag für einen Arbeitsablauf; es wird kein bestimmtes API-Verhalten behauptet. Ein vollständiger Durchlauf unter einem Vertrag kann dennoch gleichzeitig sich verändernde Objekte übersehen. Die Überprüfung muss den tatsächlichen Konsistenz- und Paginierungsgarantien des jeweiligen Diensts folgen.