Erweitern von Schemadefinitionen

Durch das Erweitern einer Schemadefinition können Sie Eigenschaften zu einer Ressource hinzufügen, die so in der Basisschemadefinition nicht vorhanden sind. Bei diesem Vorgang wird einer Erweiterungsdatei für ein Schema eine Erweiterung der Schemadefinition hinzugefügt.

Erweiterungsdateien für ein Schema

In Studio befinden sich Erweiterungsdateien für Schemata unter Integration > schemas > ext > <API name> in Verzeichnissen mit dem Dateinamensmuster <API name>_ext-<VERSION>.schema.json.

Beispielsweise befindet sich die Erweiterungsdatei für Schemata für die Common API unter Integration > schemas > ext > common.v1 > common_ext-1.0.schema.json. Die Basisdatei hat den folgenden Inhalt:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "x-gw-combine": [
      "gw.content.cc.common.v1.common_content-1.0",
      "ext.framework.v1.framework_ext-1.0"
  ],
  "definitions": {}
}

$schema: Verweist auf die JSON Schema-Namensraumdeklaration
x-gw-combine: Verweist auf das zu erweiternde Array von Schemadateien. Auf diese Dateien wird mittels vollständig qualifizierter Namen Bezug genommen, die relative Pfade innerhalb des Verzeichnisses schemas sind.
definitions: Enthält die Erweiterungen der Schemadefinition. In diesem Fall ist der Wert ein leeres Objekt, da noch keine Erweiterungen erstellt wurden.