Werte mit Kontexten ändern
Ein Szenario entscheidet, was passiert. Ein Kontext entscheidet, wie die Werte aussehen.
Jeder Anbieter bringt einen mit, deshalb antwortet eine Sandbox von Anfang an mit Daten in der Form des Anbieters: ein Statement Descriptor im Format, das Stripe nutzt, Referenzen, die aussehen wie die dieses Anbieters, Währungen, in denen er wirklich abrechnet. Ein eigener Kontext ersetzt davon die Teile, auf die es dir ankommt.
Wann du einen brauchst
Die eingebauten Werte sind realistisch, aber allgemein. Schreib einen Kontext, wenn deine Tests, deine Fixtures oder deine Screenshots eure eigenen Werte brauchen:
- Eure Konto-, Händler- oder Filialkennungen, damit Antworten zu dem passen, was euer Staging-System erwartet.
- Eine Währungsliste, die nur die enthält, in denen ihr wirklich verkauft.
- Referenzformate, die euer Code zum Auslesen oder Abgleichen ohnehin voraussetzt.
Wo sie liegen
Öffne die Sandbox, geh auf Kontexte, wähle einen Anbieter und nutze den Tab Diese Sandbox.
Das Dokument ist eine Zuordnung von Feldnamen zu Werten. Ein Name trifft dieses Feld überall in einer Antwort, in jeder Tiefe, currency deckt also jedes Währungsfeld ab, das der Anbieter zurückgibt. Verschachtele einen Namen unter einem Objekt, um ein häufiges Wort wie name, code oder value auf eine Stelle einzugrenzen.
Ersetzt werden nur die Namen, die du schreibst. Alles andere fällt auf das zurück, was der Anbieter mitbringt, ein Dokument mit drei Zeilen ist also ein völlig brauchbarer Kontext.
Sehen, worauf du aufsetzt
Der Tab Mitgeliefert zeigt den Kontext des Anbieters: die Namen, die sich zu ersetzen lohnen, und die Formate, in denen sie kommen. Lies ihn, bevor du einen Teil davon überschreibst.
Dieses Dokument kopieren holt das Ganze in deinen Tab, das ist der einfache Weg, von etwas Funktionierendem auszugehen.
Geltungsbereich
Ein Kontext gehört zu einem Anbieter-Geltungsbereich: einer Marke, einer ihrer APIs oder einer genauen Version.
Jeder passende Geltungsbereich greift, der engste zuerst. Ein Name auf Versionsebene gewinnt für diesen Namen, und der Kontext der Marke liefert weiterhin jeden Namen, den der der Version auslässt.
Schreib die Werte, die für einen Anbieter allgemein gelten, auf die Marke, und greif zur Version nur dort, wo sich diese Version wirklich unterscheidet.
Was geprüft wird
Beim Speichern wird ein Kontext nicht geprüft. Ein Szenario wird vor dem Speichern gegen das Vokabular des Builds geprüft, ein Kontext nicht, weil er eine freie Zuordnung von Namen zu Werten ist.
Die Sandbox hält ihre Antworten trotzdem an die Spezifikation des Anbieters. Ein Wert, der nicht zum Typ des Feldes passt oder nicht zu den erlaubten Werten gehört, wird nicht genutzt: Die Sandbox erzeugt stattdessen einen passenden. Ein Kontext kann also sauber speichern und trotzdem Werte liefern, die du nicht geschrieben hast.
Ein Name, den der Anbieter nie zurückgibt, ist ebenfalls kein Fehler. Er trifft einfach nie etwas.
Kommt ein Wert nicht so zurück, wie du es erwartest, sind das die üblichen Ursachen: ein Typ oder ein Wert, den das Feld nicht annimmt, ein Name, der in dieser Antwort nicht vorkommt, oder ein Name, der so häufig ist, dass er verschachtelt werden musste.
Live schalten
Speichern legt das Dokument ab. Bereitstellen bringt es auf die laufende Sandbox.
Den Override zu entfernen setzt diesen Anbieter auf die Werte zurück, die er mitbringt.