Veraltung
VeraltungDeprecation von Feldern

Deprecation von Feldern

Included in the “Power Extensions” bundle

Wenn wir unsere GraphQL-Schemas aktualisieren, werden manche Felder möglicherweise nicht mehr benötigt und durch eine bessere Implementierung ersetzt. Wir können dann die veralteten Felder deprecaten und einen Deprecation-Grund angeben, der unsere Nutzer informiert und dazu bewegt, in ihren Clients auf das neue Feld umzusteigen.

Diese Erweiterung stellt eine Benutzeroberfläche bereit, um Felder zu deprecaten.

Beschreibung

Ein neuer Custom Post Type „Field Deprecation List" wird der Website hinzugefügt. Du kannst die Einträge auf der Seite „Field Deprecation Lists" im Menü einsehen und auf „Add New Field Deprecation List" klicken, um einen neuen Eintrag im Editor hinzuzufügen.

Field Deprecation Lists
Field Deprecation Lists

Field Deprecation List-Editor

Jede Field Deprecation List enthält einen oder mehrere Einträge, jeder mit folgenden Elementen:

  • Die zu deprecatenden Felder
  • Der Deprecation-Grund (wird in der GraphQL-Antwort angezeigt, wenn das veraltete Feld abgefragt wird)

Field Deprecation-Eintrag

Nachdem du die Field Deprecation List erstellt hast, kannst du den Custom Endpoint und die Persisted Query dazu bringen, sie zu verwenden, indem du die entsprechende Schema Configuration bearbeitest und das Element aus der Liste unter dem Block „Field Deprecation Lists" auswählst.

Auswahl einer Field Deprecation List in der Schema Configuration