CDROnDemand Getting Started

The CDROnDemand service is included in the installation of Cisco Unified Communications Manager (Cisco Unified CM) software. The minimum requirements for using and testing CDROnDemand service are:

  1. A Cisco Unified CM infrastructure or the Dedicated Lab in the Cisco Sandbox
  2. A registered phone (optional)
  3. A CTI application (optional)

CDROnDemand Service Activation

CDROnDemand Service Activation is handled in Cisco Unified Communications Manager (Cisco Unified CM) Serviceability.

Before making a CDROnDemand request, ensure the Cisco SOAP - CDRonDemand Service is running.

Follow these steps to verify the service is running:

  1. From the Cisco Unified CM Administration window, select Cisco Unified Serviceability. Then click Go.
  2. Select Tools > Service Activation
  3. Scroll down to the SOAP Services section to verify Cisco SOAP - CDRonDemand Service is activated.

If needed, other services can be activated or deactivated

To activate and configure the Cisco SOAP - CDRonDemand Service on all the nodes in an environment with a cluster of nodes, review Cluster service activation recommendations.

Application User Configuration

All Serviceability APIs use HTTP 1.0 Basic access authentication which requires username and password credentials. Create an application user in Cisco Unified CM, then use those credentials to authenticate the RisPort requests.

For configuring an application user, refer to Application User Setup.

Application users are assigned to Access Control Groups. An application user can be assigned to:

  • An existing group
  • A newly configured group
Assigning a User to an Existing Group

To assign an application user to an existing group, select the Standard CCM Server Monitoring group. This is the default group.

Roles are assigned to groups, and users in that group are assigned roles belonging to that group. For example, Standard CCM Server Monitoring group has the three roles assigned to it. The preceding image shows the user being associated to the group which contains those roles.

Assigning a User to a New Group

To create a new group, refer to Access Control Group Setup. Verify that the roles for that new group include at least the Standard CCM Admin Users and Standard SERVICEABILITY roles.

Application Preparation

Your application can use the WSDL file to generate the proper SOAP requests. The WSDL files are located on every Cisco Unified CM Publisher and Subscriber node. Download the WSDL for CDROnDemand at the following URL:

https://<server>:8443/realtimeservice2/services/CDRonDemandService?wsdl

With the Cisco SOAP - CDRonDemand Service activated, a user created, and WSDL consumed, you are ready to make the first request. Use SoapUI to test, become familiar with, and gain a better understanding of the APIs.