imbahub
Menu +
DA
Tal med os
IMBAHUB / Viden og guider

Test feltændringen mod modtageren, der stadig bruger gammel kontrakt.

Et fungerende nyt API-svar kan ødelægge en ældre kanal. Kontrollér betydning, validering og faktisk præsentation for hver berørt modtager. Brug fiktive eksempler og gemte kontraktversioner i testmiljø.

Tre kontroller af samme ændring
  1. Form

    Typer og påkrævede felter følger kontrakten.

  2. Betydning

    Enhed, sprog og fortolkning er fortsat korrekte.

  3. Modtager

    Gamle og nye modtagere giver aftalte udfald.

Samme datatype kan bære en brydende betydningsændring.

Tallet 60 er gyldigt, men feltet er skiftet fra minutter til timer. Er skemaet nok?

Nej. Betydningsændringen skal håndteres og testes i modtagerne, selv om typen er uændret.

Gem kontrakt og modtagerversion først

Oplist modtagere, der bruger feltet, og deres version. Notér navn, type, påkrævede betingelser og betydning. En ændret CMS-etiket er ikke nødvendigvis et ændret API-felt.

I et tænkt kursuseksempel kan duration være antal minutter som tal. Skift til teksten halvdag ændrer både type og betydning. En numerisk sorterende modtager kræver en plan, selv om teksten ser rigtig ud i en ny visning.

Test form og betydning hver for sig

Vælg tilfælde med uændret værdi, manglende felt, tom tekst, null og ny egenskab. Tilføj forkert type og betydningsændring med samme type. Definér forventningen før modtageren læser testsvarene.

Skema kan støtte typekontrol og påkrævede felter, men kræver rette regler og validatorindstillinger. Det afgør ikke, om et tal betyder minutter eller timer. Undersøg også sprog, referencer og præsentation.

ÆndringRisiko at testeForventning skal angive
Felt fjernetGammel modtager kræver detAfvisning, reserve eller egen version
Null frem for manglendeForskellige kodeveje for tom værdiAftalt betydning og præsentation
Ny valgfri egenskabStreng afvisning af ukendte felterFaktisk støtte i gammel modtager
TypeskiftBeregning eller visning brydesAftalt overgang frem for tavs konvertering
Samme type, ny betydningTeknisk validering bestårBetydning bevares eller kontrakt opdeles

Kør gamle og nye modtagere mod testsvar

Følg skemakontrol med faktisk modtagervej: hentning, læsning og relevant visning eller beregning. Medtag lang tekst, andet sprog og manglende reference, hvor modellen kræver det.

Notér kombinationer af kontrakt og modtager, der fungerer. Bagudkompatibilitet er ikke et løfte til alle fremtidige modtagere. En brydende overgang kræver aftalt skift eller parallel støtte i en defineret periode.

Gør skift og tilbageførsel sporbare

Aftal hvem der opdaterer hver modtager, og hvilket bevis der kræves før ændret levering. Behold tidligere kontrakt, repræsentative fiktive svar og aftalt vej tilbage. Brug ikke private virkelige poster i regressionstests.

Efter skift gentages matricen mod faktisk leveret version. Notér resterende gamle modtagere, udfasningsbeslutning og ansvarlige. Et versionsnummer hindrer ikke alene forkert svar til en gammel kanal.

Kilder og fordybelse

Spørgsmål og svar

Er alle tilføjelser bagudkompatible?

Nej. Det afhænger af modtagernes håndtering af ukendte felter og ændret betydning.

Beviser gyldig JSON, at ændringen fungerer?

Nej. Syntaks, skema og faktisk modtageradfærd er forskellige kontroller.

IMBAHUB

Hvad vil du gøre muligt?

Vælg en feltændring, og test den mod både uændret ældre modtager og ny version.

Tal med os
Produktets brugerflade er indstillet til dansk i et isoleret miljø med fiktivt dansk demoindhold.

Produktets brugerflade er indstillet til dansk i et isoleret miljø med fiktivt dansk demoindhold.