1 Introduction to the Connector

The Oracle Management Connector for CA Service Desk (CASD) integrates CA Service Desk 11, 12, 14, or 17 with Enterprise Manager through either an HTTP or HTTPS connection. Using this connector, you can create, update, close, or reopen a ticket for any incident in Enterprise Manager. Note that the term ticket refers to a CA Service Desk incident.

The ticket generated by the connector contains the relevant information about the Enterprise Manager incident, including a link to the Enterprise Manager console to enable helpdesk analysts leverage Enterprise Manager's diagnostic and resolution features to resolve the incident. In Enterprise Manger, the ticket ID, ticket status, and link to the CASD console is the shown in the context of the incident. This provides Enterprise Manager administrators with ticket status information and an easy way to quickly access the ticket.

Note:

the CASD Connector attempts to populate a custom field when you create a ticket, and cannot function without the customizations to CASD. You should only use the CASD Connector if you intend to make the necessary customizations.

The following sections explain various CA Service Desk Connector concepts that you must understand before you start using the CA Service Desk Connector.

1.1 Auto Ticketing

Auto ticketing refers to creating or updating tickets automatically for any matching rule(s) in Enterprise Manager. You can define a set of event or incident rules for which tickets must be opened/updated for changes in underlying event or incident attributes. For example, changing event severity from Warning to Critical can update the associated ticket.

See Also:

"Incident Management" chapter in the Oracle Enterprise Manager Administrator's Guide.

After the ticket is opened, any subsequent update of the incident attributes or underlying event attributes, such as a change in underlying events severity, updates the ticket. After the incident is cleared in Enterprise Manager, the ticket is updated and you can optionally go to CA Service Desk to close the ticket.

1.2 Manual Ticketing

From the Enterprise Manager console, you can manually open a CASD ticket based on an open incident in Enterprise Manager. The CASD Connector populates the ticket with details based on the incident and the ticket template selected.

1.3 Ticket Templates

Ticket templates are XML transformation style sheets that transform Enterprise Manager incidents to a ticket format before the requests are sent to CASD. A ticket template specifies how an Enterprise Manager incident and its associated event attributes can be mapped to the ticket attributes of CASSD.

In Auto Ticketing, while setting up a rule, you select a configured connector and select the ticket template from the template list. The selected ticket template is used when a ticketing request is sent to CASD. For manual ticketing, you have to select a connector instance and ticket template before submitting a request for ticket creation.

The CASD Connector includes some out-of-box default ticket templates. You can customize default templates according to your functional needs. Oracle recommends that you back up these factory-built templates before customizing them.

1.4 Grace Period

The grace period enables you to prevent creating a large number of tickets for frequently created incidents due to reoccurrence of the same event

For example, an event is raised and causes an incident to be created in Enterprise Manager. The rule defined to create the ticket enforces the ticket to be created on the CASD system. If the grace period is one hour and the event is cleared at 10:00 a.m., this clears the incident and ticket. If the same event reoccurs before 11:00 a.m. and enforces creation of another incident, the grace period functionality stops creation of a new ticket for this, and reopens the same ticket instead.

Note:

In CASD, after a ticket is set to a Closed status, it cannot be reopened. Consequently, an incident that re-triggers within the grace period cannot reopen the ticket but only annotate it.

If you want to reopen a ticket for incident occurrences that fall within the grace period, set the ticket status to Resolved instead of Closed when the incident clears. This enables the CASD Connector to reopen the ticket if the same incident reoccurs within the grace period.

1.5 Retry

The “Retry" section, available on the connector configuration page, enables you to specify whether a failed ticketing request needs to be retried within a configurable expiration time.

Enabling the Retry option gives you the option of specifying whether you want to resend a ticketing request if the request fails the first time, and specifying the time period after which you want to abandon the retry. Enterprise Manager retries every 2 minutes until the request is successful or the retry interval expires.

1.6 Versions Supported

The base Enterprise Manager version number for the CA Service Desk Connector Release 12.1.0.2.0 is Enterprise Manager 12c Release 1.

CA Service Desk Connector Release 12.1.0.3.0 supports version 11, 12, 14, and 17 of the CA Service Desk application.