Jump to: navigation, search

Extension

ApiRef2.png Purpose: Describes an extension.
  • For Customers
    Available since: 8.0.100.00
  • For services, states, or tasks
    Available since: 8.0.200.00

Description

Each extension fulfills the contract of an Extension Schema that your application created in anterior operations. Your application can create schemas for the following extensions:

Once the extension schema is defined, your application can create and add extension records when dealing with standard profile, services, states, and task operations. For instance, if you start a task, you can specify extension records in your operation body as shown in the example section.

Profile Extension

Profile Extension
Field Type Mandatory Description
customer_id string yes if not nested in a profile The unique ID of the given customer.


Important.png This field is mandatory if the extension is not nested inside a Customer Profile.

name string yes The unique, case-insensitive name of the extension.
  • Starts with a letter to which you can append letters, numbers, or underscores.
  • Restricted to a maximum of 26 characters. (Maximum RDBMS shared limit on index creation.)
<attribute n>
  • string
  • integer
  • long
  • double
  • date
  • datetime
  • currency
  • boolean
yes Individual attributes, defined in the Extension Schema.
<attribute n> corresponds to the attribute name defined in the schema.

Service/State/Task Extension

Service/State/Task Extension
Field Type Mandatory Description
service_id integer yes The unique ID of the service associated with the extension.
state_id integer yes if state extension The unique ID of the state associated with the extension. For task and service extensions, you do not need to specify this id.
task_id integer yes if task extension The unique ID of the task associated with the extension. For state and service extensions, you do not need to specify this id.
name string<ref name="string">Important.png Do not use Unauthorized Strings as attribute values.</ref> yes The unique, case-insensitive name of the extension. The name must start with a letter, and can be followed with letters, numbers, or underscores (_). The name is restricted to a maximum of 26 characters. (Maximum RDBMS shared limit on creation of index).
<attribute n>
  • boolean
  • string<ref name="string" />
  • integer
  • long
  • double
  • date
  • datetime
  • currency
yes Individual attributes, as defined in the extension schema. <attribute n> corresponds to the attribute name defined in the schema. Optional attributes do not need to be specified.

<references />

This page was last edited on July 17, 2020, at 15:47.
Comments or questions about this documentation? Contact us for support!