Definer vannmerke for trinnvis datauthenting
Et vannmerke må bygge på en dokumentert endringsregel og først flyttes når hele leveransen er kontrollert.
Trinnvis uthenting henter endringer siden forrige kjøring. Det reduserer datamengden, men krever en presis regel for hvilke endringer som regnes med. Et vannmerke er den sist godkjente grensen, ikke klokkeslettet da en jobb tilfeldigvis startet.
Syntetisk tidslinje med like tidsstempler
En lokal test bruker endringstid og postnøkkel som sammensatt grense. Feltnavnene er beskrivelser av testmodellen, ikke lovede API-parametre.
| Post | Endringstid | Hva kjøringen må gjøre |
|---|---|---|
| A | 10.00.00 | Motta og kontrollere |
| B | 10.00.00 | Motta selv om tiden er lik A |
| C | 10.00.01 | Motta før vannmerket flyttes |
Et filter som bare bruker «senere enn 10.00.00» etter A, kan miste B. Har API-et bare tidsfilter, kan et overlappende vindu være nødvendig. Da må mottakeren kunne gjenkjenne allerede behandlede versjoner uten å gjøre dem til nye bilag.
Finn hva endring betyr
Undersøk om tidsfeltet oppdateres ved endring av betalingsstatus, dokumentkobling, prosjekt og sletting. Dokumentdato er normalt ikke en fullstendig beskrivelse av når innholdet endret seg. En faktura fra mars kan få ny status i oktober.
Skil mellom en hendelsesstrøm og en liste over objektenes nåværende tilstand. Den første kan vise flere endringer av samme objekt; den andre kan bare vise siste versjon. De løser ulike kontrollbehov. En fakturastatus alene forklarer heller ikke alltid hvilke betalinger som førte til statusen.
Beskriv tidssone, presisjon og inkludering av grenseverdien i datakontrakten. Hvis tidsstempelet bare har sekundoppløsning, må testsettet inneholde flere endringer samme sekund.
Flytt grensen etter godkjenning
- Les forrige godkjente vannmerke.
- Hent alle sidene i det avtalte endringsvinduet.
- Behandle normalposter og synliggjør avvik.
- Avstem antall og relevante summer.
- Lagre nytt vannmerke sammen med resultatet.
Hvis tredje steg feiler, skal ikke femte steg kjøres som om jobben var vellykket. Bevar det gamle vannmerket eller en dokumentert delgrense slik at resten kan hentes igjen.
Et overlappende vindu må ha en kontrollert lengde og en begrunnelse. Bevar hvilke tidligere poster som kom tilbake i overlappen, og hvilke som faktisk hadde ny versjon. Ellers kan overlappen maskere at kildefilteret ikke fanger viktige endringer.
Velg trinnvis uthenting når kildegrensesnittet dokumenterer endringssemantikken. Velg periodisk full sammenligning når slettinger eller gamle endringer ikke blir fanget. En blanding kan være nødvendig: hyppige små uttrekk og sjeldnere full kontroll. Det finnes ingen universell vannmerkeregel i HTTP; OpenAPI-spesifikasjonen gir et format for å beskrive API-kontrakten, mens leverandøren må forklare feltbetydningen.