Go to main content
1/18
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documentation
Conventions
1
Building a Ticketing Connector
1.1
Introduction to Ticketing Connectors
1.2
How a Ticketing Connector Functions
1.2.1
Configuring the Connector
1.2.2
Creating a Ticket
1.2.3
Updating a Ticket
1.2.4
Clearing a Ticket
1.2.5
Synchronizing Ticket Status (Optional)
1.3
Prerequisites
1.4
Extracting Schema Files
1.5
Building a Ticketing Connector
1.5.1
Determining Connector Functionality
1.5.2
Developing Required Template Files
1.5.2.1
getTicket Request Template
1.5.2.2
getTicket Response Template
1.5.2.3
Default Template(s)
1.5.2.4
createTicket Response Template
1.5.2.5
publishTicket Request Template
1.5.3
Defining the Connector Descriptor File
1.5.3.1
Connector Deploy Field Information
1.5.3.2
Connector Information Section
1.5.3.3
Sample Connector Information Section
1.5.3.4
Authentication Section
1.5.3.5
Sample Authentication Section
1.5.3.6
Connectivity Test Variable Section
1.5.3.7
Sample Connectivity Test Variable Section
1.5.3.8
External URL Section
1.5.3.9
Sample External URL Section
1.5.3.10
Service Section
1.5.3.11
Sample Service Section
1.5.3.12
Template Registration Section
1.5.3.13
Sample Template Registration Section
1.5.3.14
Complete Ticketing Connector Deployment File
1.6
Packaging and Deploying the Ticketing Connector
2
Building an Event Connector
2.1
Introduction to the Event Connector
2.2
How an Event Connector Functions
2.3
Prerequisites
2.4
Extracting Schema Files
2.5
Building an Event Connector
2.5.1
Determining Connector Functionality
2.5.2
Developing Required Template Files
2.5.2.1
setup/initialize/uninitialize/cleanup Request Template
2.5.2.2
setup/initialize/uninitialize Response Template
2.5.2.3
createEvent/updateEvent Request Template
2.5.2.4
createEvent/updateEvent Response Template
2.5.3
Defining the Connector Descriptor File
2.5.3.1
Connector Deploy Field Information
2.5.3.2
Connector Information Section
2.5.3.3
Sample Connector Information Section
2.5.3.4
Authentication Section
2.5.3.5
Sample Authentication Section
2.5.3.6
Service Section
2.5.3.7
Sample Service Section
2.5.3.8
Template Registration Section
2.5.3.9
Sample Template Registration Section
2.5.3.10
Complete Event Connector Deployment File
2.6
Packaging and Deploying the Event Connector
3
Building a Data Exchange Connector
3.1
Introduction to the Data Exchange Connector
3.1.1
Enterprise Manager and External Management System
3.1.2
Data Forwarding Frequency Options and Modes
3.2
Data Exchange Concepts
3.2.1
Data Exchange Hub
3.2.2
Inbound Data Exchange Session
3.2.3
Outbound Data Exchange Session
3.2.3.1
Normalized Message Format
3.2.3.2
Denormalized Message Format
3.2.4
Message Schemas
3.2.5
Data Source
3.2.6
Average Data
3.3
Setting up a Data Exchange Connector
3.3.1
Creating a Data Exchange Hub
3.3.2
Using a Third-Party JMS Server as a Data Exchange Hub
3.3.3
Creating an Outbound Data Exchange Session
3.3.4
Outbound JMS Destinations
3.3.5
Outbound Message Schema
3.3.5.1
Normalized Message Format
3.3.5.2
Denormalized Message Format
3.3.6
Tuning Outbound Session Message Parameters
3.3.7
Creating an Inbound Data Exchange Session
3.3.8
Inbound JMS Destinations
3.3.9
Inbound Message Schemas
3.3.9.1
Inbound Indicators Schema
3.3.9.2
Message Semantics
3.3.9.3
Inbound Alert Schema
3.4
Integrating Enterprise Manager with Oracle BAM
3.4.1
Supported Versions
3.4.2
Setting up the Data Flow from Enterprise Manager to Oracle BAM
3.4.2.1
Importing Oracle BAM Artifacts for an Outbound Session
3.4.2.2
Updating JNDI (for Oracle BAM 10g and 11g only)
3.4.2.3
Updating the EMS Definitions in Oracle BAM 12c
3.4.3
Setting up the Data Flow from Oracle BAM to Enterprise Manager
3.4.4
End-to-End Flow
3.5
Using an OC4J as a Data Exchange Hub
3.6
Tips and Troubleshooting Information
3.6.1
Data Exchange Hub Connection Errors
3.6.2
Notification Methods and Rules
3.6.2.1
Notification Method
3.6.2.2
Notification Rules
3.6.3
Data Flow Tips
3.6.4
Log Files
3.6.5
End-to-End Flow Sample Demonstrations
3.7
Suggested Reading
4
Reference Tables
4.1
Request Attributes
4.2
Response File Properties for the Windows Platform
4.2.1
sl_OHPartitionsAndSpace_valueFromDlg Property
4.2.2
ret_PrivIntrList Property
4.3
Queryable Properties
4.4
Complex Response Properties
4.5
Status Codes
A
Ticketing Connector Samples
B
Error Messages and Debugging
B.1
Error Messages
B.2
Debugging
B.2.1
Specifying the Debug Option
B.2.2
Viewing Debug Messages
C
Event Connector Samples
D
Default Template Example
D.1
Create Mappings
D.2
Update Mappings
D.3
Completed Templates
D.3.1
Completed First Template Example
D.3.2
Completed Second Template Example
E
Create Event Template Example
E.1
Study Data in External Application
E.2
Study Data in Enterprise Manager
E.3
Determine the Mapping for the Template
E.4
Create the Template
E.5
Create Mappings
E.5.1
Mapping the Summary Field
E.5.2
Mapping the Description Field
E.5.3
Mapping the Severity Field
E.5.4
Mapping the Priority Field
E.6
Completed Template Examples
F
Sample Incident Data
F.1
Sample Create Transaction
F.2
Sample Update Transaction
F.3
Sample Close Transaction
G
Sample Event Data
G.1
Sample Create Transaction
G.2
Sample Update Transaction
G.3
Sample Close Transaction
Scripting on this page enhances content navigation, but does not change the content in any way.