Use Case Description

This package provides a thin wrapper around the Cisco Unified Communications Manager (UCM) AXL API library. The UCM AXL API provides an RPC style API to programatically perform CRUD operations on the UCM administration database.

AxSizzle takes away a bit of the hassle with setting up a SOAP client and importing the WSDL by providing an interface to build the request details dynamically. After you specify the UCM version, API method and request body details, the SOAP headers and XML for any API request will be built for you.

Installation

npm install @sloan58/axsizzle

Configuration and Usage

You'll need to import the package and create an instance, passing in an object that specifies your UCM details. I've included some examples below to get you started.

Usage

Below is an example of importing the package and configuring the client.

// Import the package
const AxSizzle = require('@sloan58/axsizzle')

// Create a Cisco UCM object
// with the required properties
let ucm = {
  ip: '10.1.10.1',
  user: 'Administrator',
  password: 'supersecret',
  version: '12.5'
}

// Create the AXL wrapper client
let client = new AxSizzle(ucm)

Each API request needs an object that specifies two properties:

• method: The AXL API method to call
• body: The API body in JSON format

Get Requests

let message = {
  method: 'getPhone',
  body: {
    name: 'SEP001D452CDDB7'
  }
}

Update Requests

let message = {
  method: 'updatePhone',
  body: {
    name: 'SEP001D452CDDB1',
    description: 'Hey, this is a new description!'
  }
}

List Requests

let message = {
  method: 'listPhone',
  body: {
    searchCriteria: [{ name: '%' }],
    returnedTags: [{ name: '', description: '' }]
  }
}

Remove Requests

let message = {
  method: 'removePhone',
  body: {
    name: 'SEP123123123123'
  }
}

SQL Requests

let message = {
  method: 'executeSQLQuery',
  body: {
    sql: 'SELECT name FROM device'
  }
}

Sending Requests

// Call the API and log the ouput
client
  .callApi(message)
  .then(result => console.log(result))
  .catch(err => console.log(err))

Todo

• Improve error handling
• Handle throttle responses

Author(s)

This project was written and maintained by the following individuals:

• Marty Sloan

License

This project is licensed under the MIT License - see the LICENSE.md file for details