Using the Saved Schema API

Working with the API allows you to access the complete array of settings and options that Dromo provides.

The API

Dromo provides a standard REST API for working with schemas. The API provides standard CRUD operations for saved schemas. You can view the full Saved Schema API reference here.

Saved Schema Structure

Schemas have the following fields:

string

Schemas are automatically assigned a UUID when they are created.

name

string

required

Schemas must have a unique name within your organization.Schema names are displayed in the Dromo dashboard.

settings

Settings

required

Saved schemas accept the same settings that can be provided to the browser SDK.See Settings for more details.

fields

Field[]

required

Schemas have an array of fields which also accept the same full set of options as the browser SDK.See Field Object Reference for more details.

hooks

object

You can define any or all of the hooks that Dromo provides using the Saved Schema API.The hook function JavaScript source is passed as a string, which must evaluate to a valid JavaScript function. See the defining hooks section for examples.All hooks are optional.

Show Hook Properties

rowHooks

string[]

An array of strings defining valid JavaScript standard row hooks.

bulkRowHooks

string[]

An array of strings defining valid JavaScript bulk row hooks.

rowDeleteHooks

string[]

An array of strings defining valid JavaScript row delete hooks.

columnHooks

object[]

An array of objects defining column hooks.Each column hook has a fieldName specifying which column the hook will run on, and a callback defining a valid JavaScript column hook function.

Show Column Hook Object

fieldName

string

required

The field name this hook applies to.

callback

string

required

Valid JavaScript column hook function.

stepHooks

object[]

An array of objects defining step hooks.Each step hook has a type (one of "UPLOAD_STEP", "REVIEW_STEP", or "REVIEW_STEP_POST_HOOKS") and a callback defining a valid JavaScript column hook function.

Show Step Hook Object

type

string

required

One of: "UPLOAD_STEP", "REVIEW_STEP", or "REVIEW_STEP_POST_HOOKS"

callback

string

required

Valid JavaScript step hook function.

beforeFinishCallback

string

A string defining a valid JavaScript before finish callback.

Defining hooks

Hook functions are defined using strings containing JavaScript source code. The code is evaluated in the end user’s browser for standard imports, and using Node.js 18 for headless imports. All types of function declarations are accepted:

Anonymous function expression: function(a, b) { return a + b; }
Named function expression: function sum(a, b) { return a + b; }
Arrow function: (a, b) => { return a + b; }

Row hook example

To define a row hook, you could pass the following to the API’s hooks parameter:

{
  "rowHooks": [
    "(record, mode) => { record.row.zipCode.value = record.row.zipCode.value.padStart(5, '0'); return record; }"
  ]
}

Step hook example

To define a step hook, you could pass the following to the API’s hooks parameter:

{
  "stepHooks": [
    {
      "type": "REVIEW_STEP",
      "callback": "(instance) => instance.addField({ label: 'Full Name', key: 'fullName' })"
    }
  ]
}

Using saved schemas

Saved schemas can be used in the browser or using the Headless API. You can also use the Saved Schema API to programmatically create and manage schemas.

Getting Started

Guides

Reference

FAQ & Changelog

Using the Saved Schema API

The API

Saved Schema Structure

Defining hooks

Using saved schemas

Getting Started

Guides

Reference

FAQ & Changelog

​The API

​Saved Schema Structure

​Defining hooks

​Using saved schemas

The API

Saved Schema Structure

Defining hooks

Using saved schemas