Partial schemas

This page gives you an introduction to the concept of partial schemas. Go to schema references to find the API documentation for partial schemas.

Partial schemas are a bit different from the typical schema. A partial schema is a reusable schema that is used across multiple schemas. A typical use case is when you want a specific data structure and type of data across many schemas. The difference between using a partial schema versus referencing another schema is that a referenced schema is stored as a separate view. Using a partial schema with your schema gives the output of a single view when processed.

Partial schemas are typically used when you want a reusable schema for mapping data that is part of the same entity. Eg. metadata (title, description, …) is the same across different entity types but the data lives on the entity itself.

Don’t use partial schemas for mapping data from another entity that’s being referenced, as your views can be outdated if the referenced entity is updated. In this case, you should use reference schemas.

Configure a partial schema

When using a partial schema, you are giving it a data object. This data object is typically the value of a specific part of the data source you are working on. In the below example, we are using a partial schema called seo, and passing it the value of p.seo (a complex JSON object with SEO properties and data)

Examples

Example of a schema that is referencing a partial schema

Schema

/** @type {Enterspeed.FullSchema} */
export default {
  properties: function (sourceEntity, context) {
    return {
      headline: sourceEntity.properties.title,
      seo: context.partial('seo', sourceEntity.properties.seo)
    }
  }
}

Example of the partial schema being used by the schema.

Schema

/** @type {Enterspeed.PartialSchema} */
export default {
  properties: function (input, context) {
    return {
      metaTitle: input.seoTitle,
      metaDescription: input.seoDescription
    }
  }
}

The data source used in this example.

Data source

{
  "sourceId": "gid://Source/bfb8fd65-35d7-48d1-94bc-df0da13469d2",
  "id": "gid://Source/bfb8fd65-35d7-48d1-94bc-df0da13469d2/Entity/1103",
  "type": "product",
  "originId": "1103",
  "originParentId": "1098",
  "url": "http://localhost:57152/products/bowling-ball/",
  "redirects": [],
  "properties": {
    "title": "Bowling Ball",
    "seo": {
      "seoTitle": "Bowling Ball",
      "seoDescription": "A bowling ball is a hard spherical ball used to knock down bowling pins in the sport of bowling. Balls used in ten-pin bowling and American nine-pin bowling traditionally have holes for two fingers and the thumb."
    }
  }
}

More examples can be found here here

Overview

Schema reference

API

Integrations

Tutorials

Best practices

CLI

MCP server

Configure a partial schema

Examples

​Configure a partial schema

​Examples

Configure a partial schema

Examples