...
Universal Controller supports the following RESTful-based web services for Global Universal Event Templates, which are listed alphabetically on this page.
...
Formatting specifications for each web service, including details about parameter requirements, are provided.
...
Description
...
URI
...
HTTP Method
...
POST
...
Description
...
Creates a Universal Event Template.
...
Example URI
...
Auditing Universal Events
The Universal Event Web Service Publish Audit lets you specify whether or not an audit record is generated for each Universal Event published through the Universal Event Web Services.
(The Universal Event Extension Publish Audit lets you specify whether or not an audit record is generated for each Universal Event published through an Extension-based Universal Task Instance.)
Note |
---|
|
Enabling these audit properties can generate a large quantity of audit. |
Anchor |
---|
| Create a Universal Event Template |
---|
| Create a Universal Event Template |
---|
|
Create a Universal Event Template Anchor |
---|
| Create, Modify, and Read a Universal Event Template XML and JSON Examples |
---|
| Create, Modify, and Read a Universal Event Template XML and JSON Examples |
---|
|
Create, Modify, and Read a Universal Event Template: XML and JSON Examples
The excludeRelated and retainSysIds properties are specified as attributes in the <universalTemplate> element of XML web services.
XML | JSON |
---|
Expand |
---|
| Code Block |
---|
language | text |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<eventTemplate retainSysIds="true">
<attributes> <label>attribute <label>attribute_label1</ label>
<name>attributelabel>
<name>attribute_name1</ name>
<type>Text</type>name>
<type>Text</type>
</attribute>
<attribute>
<label>attribute <label>attribute_label2</ label>
<name>attributelabel>
<name>attribute_name2</ name>
<type>Integer</type>name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute <label>attribute_label3</ label>
<name>attributelabel>
<name>attribute_name3</ name>
<type>Boolean</type>name>
<type>Boolean</type>
</attribute>
<attribute>
<label>attribute <label>attribute_label4</ label>
<name>attributelabel>
<name>attribute_name4</ name>
<type>Float</type>name>
<type>Float</type>
</attribute>
</ attributes>
<attributesPolicy>Include Attributes</attributesPolicy>
<description>Global universal event template descriptionattributes>
<attributesPolicy>Include Attributes</attributesPolicy>
<description>Global universal event template description.</ description>
<label>Global Universal Event description>
<label>Global Universal Event - Label</ label>
<name>globallabel>
<name>global_universal_event_template</ name>
<sysId>66c6e90f5a334378809884a11cb12ac0</sysId>
<TTL>11</TTL>name>
<sysId>66c6e90f5a334378809884a11cb12ac0</sysId>
<ttl>11</ttl>
</eventTemplate> |
| Expand |
---|
| Code Block |
---|
language | text |
---|
{
"attributes": [
{
"label": "attribute_label1",
"name": "attribute_name1",
"type": "Text"
},
{
"label": "attribute_label2",
"name": "attribute_name2",
"type": "Integer"
},
{
"label": "attribute_label3",
"name": "attribute_name3",
"type": "Boolean"
},
{
"label": "attribute_label4",
"name": "attribute_name4",
"type": "Float"
}
],
"attributesPolicy": "Include Attributes",
"description": "Global universal event template description.",
"label": "Global Universal Event - Label",
"name": "global_universal_event_template",
"retainSysIds": true,
"sysId": "66c6e90f5a334378809884a11cb12ac0",
"ttl": 11
}
|
|
Anchor |
---|
| Delete a Universal Event Template |
---|
| Delete a Universal Event Template |
---|
|
Delete a Universal Event Template
...
| Description |
---|
URI | http://host_name/uc/resources/universaleventtemplate/list |
HTTP Method | GET |
Description | Retrieves information on Universal Event Templates using specific query parameters. Note |
---|
| System event template will not be included in the list response. |
|
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | application/xml, application/json |
Example | See Create, Modify, and Read a List Universal Event TemplateTemplates: XML and JSON Examples, below. |
Universal Event Template Properties | See Universal Event Template Properties. |
...
Anchor |
---|
| List Universal Event Templates XML and JSON Examples |
---|
| List Universal Event Templates XML and JSON Examples |
---|
|
List Universal Event Templates: XML and JSON Examples
XML | JSON |
---|
Expand |
---|
| Code Block |
---|
language | text |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<unversialEventTemplates>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Text</type>
</attribute>
<attribute>
<label>attribute_label2</label>
<name>attribute_name2</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label3</label>
<name>attribute_name3</name>
<type>Boolean</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Include Attributes</attributesPolicy>
<description>Global universal event template description.</description>
<label>Global Universal Event - Label</label>
<name>global_universal_event_template</name>
<sysId>66c6e90f5a334378809884a11cb12ac0</sysId>
<TTL>11</TTL>
</eventTemplate>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Prohibit Universal Event</attributesPolicy>
<description>description.</description>
<label>Universal Event - Label2</label>
<name>universal_event_template2</name>
<sysId>982a434746fc4618aa55d7928ba1f3e4</sysId>
<TTL />
</eventTemplate>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Prohibit Universal Event</attributesPolicy>
<description>description.</description>
<label>Universal Event - Label2 - Copy</label>
<name>universal_event_template2_copy</name>
<sysId>814b1b35ea844407b6cd378f149d61a3</sysId>
<TTL />
</eventTemplate>
</unversialEventTemplates>
| Expand |
---|
| Code Block |
---|
| | [
{
"attributes": [
{
"label": "attribute_label1",
"name": "attribute_name1",
"type": "Text"
},
{
"label": "attribute_label2",
"name": "attribute_name2",
"type": "Integer"
},
{
"label": "attribute_label3",
"name": "attribute_name3",
"type": "Boolean"
},
{
"label": "attribute_label4",
"name": "attribute_name4",
"type": "Float"
}
],
"attributesPolicy": "Include Attributes",
"description": "Global universal event template description.",
"label": "Global Universal Event - Label",
"name":
<unversialEventTemplates>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Text</type>
</attribute>
<attribute>
<label>attribute_label2</label>
<name>attribute_name2</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label3</label>
<name>attribute_name3</name>
<type>Boolean</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Include Attributes</attributesPolicy>
<description>Global universal event template description.</description>
<label>Global Universal Event - Label</label>
<name>global_universal_event_template</name>
<sysId>66c6e90f5a334378809884a11cb12ac0</sysId>
<ttl>11</ttl>
</eventTemplate>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Prohibit Universal Event</attributesPolicy>
<description>description.</description>
<label>Universal Event - Label2</label>
<name>universal_event_template2</name>
<sysId>982a434746fc4618aa55d7928ba1f3e4</sysId>
<ttl />
</eventTemplate>
<eventTemplate>
<attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Integer</type>
</attribute>
<attribute>
<label>attribute_label4</label>
<name>attribute_name4</name>
<type>Float</type>
</attribute>
</attributes>
<attributesPolicy>Prohibit Universal Event</attributesPolicy>
<description>description.</description>
<label>Universal Event - Label2 - Copy</label>
<name>universal_event_template2_copy</name>
<sysId>814b1b35ea844407b6cd378f149d61a3</sysId>
<ttl />
</eventTemplate>
</unversialEventTemplates>
| Expand |
---|
| [
{
"attributes": [
{
"label": "attribute_label1",
"name": "attribute_name1",
"type": "Text"
},
{
"label": "attribute_label2",
"name": "attribute_name2",
"type": "Integer"
},
{
"label": "attribute_label3",
"name": "attribute_name3",
"type": "Boolean"
},
{
"label": "attribute_label4",
"name": "attribute_name4",
"type": "Float"
}
],
"attributesPolicy": "Include Attributes",
"description": "Global universal event template description.",
"label": "Global Universal Event - Label",
"name": "global_universal_event_template",
"sysId": "66c6e90f5a334378809884a11cb12ac0",
"ttl": 11
},
{
11
},
{
"attributes": [
{
[
{
"label": "attribute_label1",
"
"name": "attribute_name1",
"type": "Integer"
},
{
"label":
},
{
"label": "attribute_label4",
"name": "attribute_name4",
"type": "Float"
}
],
"type": "Float"
}
],
"attributesPolicy": "Prohibit Universal Event",
"description":
"description": "description.",
"label": "Universal Event - Label2",
"name": "universal_event_template2",
"sysId": "982a434746fc4618aa55d7928ba1f3e4",
"ttl": null
},
{
null
},
{
"attributes": [
{
[
{
"label": "attribute_label1",
"name":
"name": "attribute_name1",
"type": "Integer"
},
{
"label":
},
{
"label": "attribute_label4",
"name": "attribute_name4",
"type": "Float"
}
],
"type": "Float"
}
],
"attributesPolicy": "Prohibit Universal Event",
"description":
"description": "description.",
"label": "Universal Event - Label2 - Copy",
"name": "universal_event_template2_copy",
"sysId": "814b1b35ea844407b6cd378f149d61a3",
"ttl": null
}
]
|
|
...
Anchor |
---|
| Modify a Universal Event Template |
---|
| Modify a Universal Event Template |
---|
|
Modify a Universal Event Template
...
Property | UI Field Name | Description | Specifications | Required |
---|
Anchor |
---|
| UET - nameattributesPolicy |
---|
| UET - nameattributesPolicy |
---|
| nameattributesPolicy
| Name | Unique event name, adhering to the same naming convention as a Universal Template field name. | Y | Anchor |
---|
UET - label | UET - label | labelLabel | User-friendly display name for the event, to be displayed within the client. | The Label must be unique. | YUnmapped Attributes Policy | Defines how unmapped/unknown attributes that are in the published event are handled. | Valid values: As String = Prohibit Universal Event, As Value = 1 As String = Include Attributes, As Value = 2 As String = Exclude Attributes, As Value = 3
Default is Prohibit Universal Event (1). | N |
Anchor |
---|
| UET - descriptionattributes |
---|
| UET - descriptionattributes |
---|
| descriptionattributes
| Description | Description of the Universal Event. | N | Anchor |
---|
UET - TTL | UET - TTL | TTLTime To Live | Default value for Time to live; how long, in minutes, the Universal Event data is valid. | non-negative Integer | N | Anchor |
---|
UET - attributePolicy | UET - attributePolicy | attributePolicyUnmapped Attributes Policy | Defines how unmapped/unknown attributes that are in the published event are handled. | Valid values: As String = Prohibit Universal Event, As Value = 1 As String = Include Attributes, As Value = 2 As String = Exclude Attributes, As Value = 3
Default is Prohibit Universal Event (1). | N | Anchor |
---|
UET - attributes | UET - attributes | attributesAttributes | Zero or more attributes, specifying their Name, Label, and Type. | Expand |
---|
| Code Block |
---|
| <attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Text</type>
</attribute>
<attribute>
<label>attribute_label2</label>
<name>attribute_name2</name>
<type>Integer</type>
</attribute>
</attributes> |
|
Expand |
---|
|
|
Code Block |
---|
|
"attributes": [
{
"label": "attribute_label1",
"name": "attribute_name1",
"type": "Text"
},
{
"label": "attribute_label2",
"name": "attribute_name2",
"type": "Integer"
}
]Attributes
Zero or more attributes, specifying their Name, Label, and Type. | Expand |
---|
| Code Block |
---|
| <attributes>
<attribute>
<label>attribute_label1</label>
<name>attribute_name1</name>
<type>Text</type>
</attribute>
<attribute>
<label>attribute_label2</label>
<name>attribute_name2</name>
<type>Integer</type>
</attribute>
</attributes> |
|
Expand |
---|
| Code Block |
---|
| "attributes": [
{
"label": "attribute_label1",
"name": "attribute_name1",
"type": "Text"
},
{
"label": "attribute_label2",
"name": "attribute_name2",
"type": "Integer"
}
] |
|
| N | Anchor |
---|
| UET - description |
---|
| UET - description |
---|
| description
| Description | Description of the Universal Event. |
| N |
| Label | User-friendly display name for the event, to be displayed within the client. | The Label must be unique. | Y |
| Name | Unique event name, adhering to the same naming convention as a Universal Template field name. |
| Y |
| Time To Live | Default value for Time to live; how long, in minutes, the Universal Event data is valid. | non-negative Integer | N |
| n/a | sys_id used within the Controller to identify this record. | Persisted only if retainSysIds is set to true. | N |
Anchor |
---|
| Universal Event Template - Attribute Properties |
---|
| Universal Event Template - Attribute Properties |
---|
|
Universal Event Template
- Attribute Properties...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Name
...
Unique attribute name, adhering to the same naming convention as a Universal Template field name.
...
- Attribute Properties
Property | UI Field Name | Description | Specifications | Required |
---|
| Label | User-friendly display name for the attribute, to be displayed within the client. | The Attribute Label must be unique. | Y |
| Name | Unique attribute name, adhering to the same naming convention as a Universal Template field name. |
| Y |
| Type | Attribute type. | Valid values: As String = Text, As Value = 1 As String = Integer, As Value = 2 As String = Boolean, As Value = 3 As String = Float, As Value = 4
| Y |