Keywords for type messages
- Last UpdatedSep 04, 2025
- 2 minute read
The following table shows keywords that can be used to create a type message.
|
Keyword |
Type |
Required |
Supported by PI Web API |
Details |
|---|---|---|---|---|
|
ID |
String |
Required |
Yes |
Becomes the element template name. After the Type ID is defined, it can be referred to case insensitively. For example, when creating a new instance of the Type. Note: When deleting a Type, it is not necessary to provide full entity definitions. ID is the only required keyword. The system ignores any additional information provided in the DELETE message. For complete details about the simplified handling of Delete messages, see Simplified Delete Option. |
|
classification |
String |
Required |
Partially |
Stored as an extended property on the element template. |
|
type |
String |
Required |
Partially |
Inherited from JSON schema. Must be set to object. |
|
properties |
Object |
Required |
Partially |
Stored as attribute templates on the element template. For complete details about this keyword, see Example properties keyword for type messages. |
|
name |
String |
Optional |
Yes |
Stored in the description of the element template in the format of NAME\VERSION\DESCRIPTION. |
|
description |
String |
Optional |
Yes |
Stored in the description of the element template in the format of NAME\VERSION\DESCRIPTION. The description property is exempt from reserved characters; any character can be used. |
|
version |
String |
Optional |
Yes |
Stored in the description of the element template in the format of NAME\VERSION\DESCRIPTION. Version of the type. If omitted version 1.0.0.0 is assumed. |
|
tags |
Array |
Optional |
Yes |
Stored as categories on the template. If a tag specified in a type message does not exist in PI AF as a category, it will be created and then added to the element template. |
|
metadata |
Object |
Optional |
Yes |
Stored as an extended property on the element template. Note: To use PI quality definition, set the metadata property "DataQualitySchema" to PI. |
|
enum |
Array |
Optional |
Yes |
Cannot be used in conjunction with:
|
|
extrapolation |
String |
Optional |
Yes |
Stored as an extended property on the element template. Supported values are:
|