/
Universal Event Template Web Services

Universal Event Template Web Services

Mar 26, 2024

Overview

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.

Auditing Universal Events

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.

(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.

Create a Universal Event Template

 

Description

 

Description

URI

http://host_name/uc/resources/universaleventtemplate

HTTP Method

POST

Description

Creates a Universal Event Template.

Example URI

http://localhost:8080/uc/resources/universaleventtemplate

Authentication

HTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example

See Create, Modify, and Read a Universal Event Template: XML and JSON Examples, below.

Universal Event Template Properties

See Universal Event Template Properties.

Example Response

  • Status 200 /OK
    Successfully created the universal event template with id <id>.

  • Status 400 /Bad Request
    Create universal template failed. (message).

Create, Modify, and Read a Universal Event Template: XML and JSON Examples

XML

JSON

XML

JSON

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <eventTemplate retainSysIds="true">     <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>

 

{     "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 }

 

Delete a Universal Event Template

 

Description

 

Description

URI

http://host_name/uc/resources/universaleventtemplate

HTTP Method

DELETE

Description

Deletes a Universal Event Template.

URI Parameters

See Delete a Universal Template URI Parameters, below.

Example URI

Example Response

  • Status 200 /OK
    Universal event template deleted successfully.

  • Status 400 /Bad Request
    Mutual exclusion violation. Cannot specify templatename and templateid at the same time.

  • Status 404 /Not Found
    A universal event template with "<{name/id>" does not exist.

Delete a Universal Event Template - URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

Parameter

Description

Specifications

Required

Mutually Exclusive With

templateid

ID used within the Controller to identify this Universal Event Template.

String; URI parameter.

Y (unless templatename is specified)

templatename

templatename

Name used within the Controller to identify this Universal Event Template.

String; URI parameter.

Y (unless templateid is specified)

templateid

List Universal Event Templates

 

Description

 

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 List Universal Event Templates: XML and JSON Examples, below.

Universal Event Template Properties

See Universal Event Template Properties.

List Universal Event Templates - URI Parameters

Parameter

Description

Specifications

Required

Parameter

Description

Specifications

Required

templatename

Name used within the Controller to identify this Universal Event Template.

Wildcards are supported.

N

List Universal Event Templates: XML and JSON Examples

XML

JSON

XML

JSON

<?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>



[
    {
        "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    },    {        "attributes": [            {                "label": "attribute_label1",                "name": "attribute_name1",                "type": "Integer"            },            {                "label": "attribute_label4",                "name": "attribute_name4",                "type": "Float"            }        ],        "attributesPolicy": "Prohibit Universal Event",        "description": "description.",        "label": "Universal Event - Label2",        "name": "universal_event_template2",        "sysId": "982a434746fc4618aa55d7928ba1f3e4",        "ttl": null    },    {        "attributes": [            {                "label": "attribute_label1",                "name": "attribute_name1",                "type": "Integer"            },            {                "label": "attribute_label4",                "name": "attribute_name4",                "type": "Float"            }        ],        "attributesPolicy": "Prohibit Universal Event",        "description": "description.",        "label": "Universal Event - Label2 - Copy",        "name": "universal_event_template2_copy",        "sysId": "814b1b35ea844407b6cd378f149d61a3",        "ttl": null