Extending mappers

By extending a mapper, you can associate the schema definition extension of the target resource with the backing data source, a PolicyCenter entity. This step is necessary in order to expose your resource extensions to PolicyCenter through the API. To extend a mapper, you must configure a mapper extension in a mapper extension file.

Mapper extension files

In Studio, mapper extension files are located in Integration > mappings > ext > <API name> directories, with the file naming pattern of <API name>_ext-<VERSION>.mapping.json .

For example, the mapper extension file for the Common API is located at Integration > mappings > ext > common.v1 > common_ext-1.0.mapping.json . That file has the following content:

{
  "schemaName": "ext.common.v1.common_ext-1.0",`
  "combine": [
      "gw.content.cc.common.v1.common_content-1.0",
      "ext.framework.v1.framework_ext-1.0"

  ],
  "mappers": {}
}
  • schemaName: References the base name of the schema extension file
  • combine: References an array of schema files that are being extended. These files are referenced as fully qualified names that are relative paths within the mappings directory.
  • mappers: Contains the mapper extensions