Configuring the mapping file for generated endpoints

A mapping file contains a mappers section that lists one or more API resources. For each resource, the following attributes are specified:

• The schemaDefinition that defines the structure of the resource
  • This references a schema declared in a schema.json file.
• The data model entity that serves as the root for mapping information for this resource.
• A list of properties
  • Each property includes a path attribute. This is a Gosu expression that is used to populate the value of the property. Typically, this expression returns a value from the entity defined in the root attribute.
  • Depending on the nature of the property, there may be additional attributes.

For example, the following is a portion of the mapper for the base configuration Activity resource:

"Activity": {
  "schemaDefinition": "Activity",
  "root": "entity.Activity",
  "properties": {
    "closeDate": {
      "path": "Activity.CloseDate"
    },
    "description": {
      "path": "Activity.Description"
    },
    "mandatory": {
      "path": "Activity.Mandatory"
    },
    ...

Note the following:

• This resource is defined in the schema who name is Activity (This schema is defined in some other schema.json file.)
• The root for the resource mapping is entity.Activity.
• For each instance of the resource:
  • The closeDate property is set to the Activity entity's CloseDate field.
  • The description property is set to the Activity entity's Description field.
  • The mandatory property is set to the Activity entity's Mandatory field.

The base configuration includes a set of API-specific extension mapping files. The purpose of these files is to define mapper information for custom resources for a given API. These files are named using the pattern <API>_ext-1.0.mapping.json, where <API> is the internal name of the API. For example, the common_ext-1.0.mapping.json file is used to define mapper information for custom resources in the Common API. You can access extension mapping files in Studio through the integration -> mappers -> ext -> <API>.v1 node.

(There is an exception to the previous statement. When you add endpoints to the Job API, mapper modifications are not made to a job_ext-1.0.mapping.json file, but rather to the policyperiod_ext-1.0.mapping.json file.)

    "<resourceName>": {
      "schemaDefinition": "<schemaNameForResource>",
      "root": "entity.<customEntity>",
      "properties": {
          ...
        }
      }
    }

      "properties": {
        // TODO RestEndpointGenerator : Add mapper properties here
        "activeCount": {
          "path": "CustomEntity_Ext.ActiveCount"
        },
        "activeDate": {
          "path": "CustomEntity_Ext.ActiveDate"
        },
        "description": {
          "path": "CustomEntity_Ext.Description"
        },
        "id": {
          "path": "CustomEntity_Ext.RestId"
        },
        "isActive": {
          "path": "CustomEntity_Ext.IsActive"
        }
        ...
      }
    }