Spara kontrakt och konsumentversion före ändringen
Lista vilka mottagare som använder fältet och vilken version de kör. Dokumentera nuvarande namn, typ, obligatoriska villkor och betydelse. En ändrad etikett i CMS är inte nödvändigtvis samma sak som ett ändrat API-fält.
I ett fiktivt kursexempel kan duration vara numeriskt antal minuter. Att byta till texten halvdag ändrar både typ och betydelse. En mottagare som sorterar numeriskt behöver en plan, även om den nya texten ser korrekt ut i en ny vy.
Prova både form och innebörd
Välj fall för oförändrat värde, saknat fält, tom text, null och ny egenskap. Lägg till fel typ och ett meningsmässigt ändrat värde med samma typ. Ange förväntat utfall innan svaren läses av mottagaren.
Schema kan hjälpa med typer och obligatoriska fält men måste ha rätt regler och validatorinställningar. Det avgör inte om ett tal betyder minuter eller timmar. Bedöm också språk, referenser och hur värdet presenteras.
| Ändring | Risk att prova | Förväntan ska ange |
|---|---|---|
| Fält borttaget | Gammal mottagare kräver det | Avslag, reservtext eller separat version |
| Null i stället för saknat | Olika kodvägar för tomt värde | Avtalad betydelse och presentation |
| Ny valfri egenskap | Strikt avvisning av okända fält | Faktiskt stöd hos gammal konsument |
| Typbyte | Beräkning eller rendering bryts | Avtalad övergång, inte tyst omvandling |
| Samma typ, ny betydelse | Teknisk validering passerar | Verksamhetsinnebörden bevaras eller versionsdelas |
Kör gammal och ny mottagare mot provsvaren
En lyckad schemakontroll ska följas av den verkliga konsumentvägen: hämtning, läsning och relevant presentation eller beräkning. Prova lång text, främmande språk och saknad referens där de ingår i modellen.
Dokumentera vilken kombination av kontrakt och konsument som fungerar. Bakåtkompatibilitet är inget allmänt löfte för alla framtida mottagare. Om övergången bryter en befintlig konsument behövs ett beslutat byte eller parallellt stöd under avtalad tid.
Gör byte och återgång möjliga att följa
Bestäm vem som uppdaterar varje mottagare och vilket bevis som krävs före ändrad leverans. Spara tidigare kontrakt, representativa fiktiva svar och en avtalad återgångsväg. Blanda inte privata riktiga data i regressionsproven.
Efter byte provas samma matris igen mot den version som faktiskt levereras. Rapportera kvarvarande äldre konsumenter, utfasningsbeslut och ägare. Ett versionsnummer ensamt förhindrar inte att fel respons skickas till en gammal kanal.