Python library that helps with accessing Cisco Call Manager over the AXL interface
Reason this release was yanked:
Not fit for use
Project description
What is jabberwock?
jabberwock is a Python 3 library that helps with accessing Cisco CallManger over the AXL interface. This library is a refactoring of pyaxl to use zeep instead of suds-jurko as the SOAP-based web service client for calls to the AXL API. I recommend SoupUI it if you want to work with this library, as it helps in analyzing and understanding how the WSDL from Cisco CallManager is composed.
jabberwock is licensed under the ZPL 2.1, see LICENSE.txt for details.
Import WSDL
The WSDL files are not included with this library for licensing reasons. The AXL WSDL is included in the AXL SQL Toolkit download, which is available from your Cisco Unified CM server:
- Log into the Cisco Unified CM Administration application.
- Go to Application | Plugins
- Click on the Download link by the Cisco CallManager AXL SQL Toolkit Plugin.
- Extract the contents of the downloaded .zip file to an accessible location.
The axlsqltoolkit.zip file contains the complete schema definition for different versions of Cisco Unified CM. The important files for each version are:
- AXLAPI.wsdl
- AXLEnums.xsd
- axlSoap.xsd
Note: Do not modify the folder structure of the extracted files. Proper use of jabberwock requires the following folder structure for the schema directory:
schema/
9.0/
AXLAPI.wsdl
AXLEnums.xsd
AXLSoap.xsd
9.1/
AXLAPI.wsdl
AXLEnums.xsd
AXLSoap.xsd
...
...
...
11.5/
AXLAPI.wsdl
AXLEnums.xsd
AXLSoap.xsd
12.5/
AXLAPI.wsdl
AXLEnums.xsd
AXLSoap.xsd
current/
AXLAPI.wsdl
AXLEnums.xsd
AXLSoap.xsd
Configuration
Import jabberwock
>>> from jabberwock.configuration import registry
>>> from jabberwock.configuration import AXLClientSettings
>>> from jabberwock import ccm
>>> settings = AXLClientSettings(host='callmanager.fake.com',
username='super-admin',
password='wouldntyouliketoknow',
schema_path='C:\\axlsqltoolkit\\schema',
version='12.5')
>>> jabberwock.registry.register(settings)
jabberwock supports multiple settings. To use that, pass the configuration name as the second attribute in the register method.
>>> settings = AXLClientSettings(host='callmanager-test.fake.com',
username='super-admin',
password='noneofyourbusiness',
schema_path='C:\\axlsqltoolkit\\schema',
version='10.0')
>>> jabberwock.registry.register(settings, 'test-config')
pyaxl.testing import validate >>> from pyaxl.testing.transport import TestingTransport
For these tests we use a fake transport layer. For this we must tell which xml the transporter should use for the response.
>>> transport = TestingTransport() >>> transport.define('10.5_user_riols') >>> transport_testing = TestingTransport() >>> transport_testing.define('8.0_user_riols')
>>> settings = pyaxl.AXLClientSettings(host='https://callmanger.fake:8443', ... user='super-admin', ... passwd='nobody knows', ... path='/axl/', ... version='10.5', ... suds_config=dict(transport=transport)) >>> pyaxl.registry.register(settings)
pyaxl supports multiple settings. To use that, pass the configuration name as second attribute in the register method.
>>> settings_testing = pyaxl.AXLClientSettings(host='https://callmanger-testing.fake:8443', ... user='super-admin', ... passwd='nobody knows', ... path='/axl/', ... version='8.0', ... suds_config=dict(transport=transport_testing)) >>> pyaxl.registry.register(settings_testing, 'testing')
if you want to use a custom configuration, you also need to pass it when you are getting the object:
>>> user = ccm.User('riols', configname='testing')
if you don't need multiple settings, you can just use the default.
>>> user = ccm.User('riols')
Don't forget to build the cache for the defined configuration name:
$ ./pyaxl_import_wsdl -p -c testing path_to_wsdl/10.5/AXLAPI.wsdl
Working with pyaxl
Get all information for a specific user.
>>> transport.define('10.5_user_riols') >>> user1 = ccm.User('riols')
>>> validate.printSOAPRequest(transport.lastrequest()) getUser: userid=riols
>>> user1.firstName Samuel >>> user1.lastName Riolo
Get the same user with his UUID.
>>> transport.define('10.5_user_riols') >>> user2 = ccm.User(uuid='{5B5C014F-63A8-412F-B793-782BDA987371}') >>> user1._uuid == user2._uuid True
Search and list information
>>> transport.define('10.5_user_armstrong') >>> users = ccm.User.list(dict(lastName='Armstrong'), ('firstName', 'lastName')) >>> validate.printSOAPRequest(transport.lastrequest()) listUser: searchCriteria: lastName=Armstrong returnedTags: firstName=True lastName=True
>>> list(users) [(Lance, Armstrong), (Neil, Armstrong)]
Search and fetch information as objects
>>> transport.define('10.5_user_riols') >>> users = ccm.User.list_obj(dict(lastName='Riolo', firstName='Samuel')) >>> for user in users: ... print(user.firstName, user.lastName) Samuel Riolo
Reload an object
>>> transport.define('10.5_user_riols') >>> user = ccm.User('riols') >>> user.firstName = 'Yuri' >>> user.lastName = 'Gagarin' >>> print(user.firstName, user.lastName) Yuri Gagarin >>> user.reload() Traceback (most recent call last): ... pyaxl.exceptions.ReloadException: Error because some field are already changed by the client. Use force or update it first. >>> user.reload(force=True) >>> print(user.firstName, user.lastName) Samuel Riolo
Update an object
>>> transport.define('10.5_user_riols') >>> user = ccm.User('riols') >>> user.firstName = 'Claude' >>> user.lastName = 'Nicollier' >>> user.update() >>> validate.printSOAPRequest(transport.lastrequest()) updateUser: uuid={5B5C014F-63A8-412F-B793-782BDA987371} firstName=Claude lastName=Nicollier
Remove an object
>>> transport.define('10.5_user_riols') >>> user = ccm.User('riols') >>> user.remove() >>> validate.printSOAPRequest(transport.lastrequest()) removeUser: uuid={5B5C014F-63A8-412F-B793-782BDA987371}
Create a new object
>>> transport.define('10.5_user_riols') >>> user = ccm.User() >>> user.lastName = 'Edison' >>> user.firstName = 'Thomas' >>> user.userid = 'tedison' >>> user.presenceGroupName = 'SC Presence Group' >>> user.ipccExtension = None >>> user.ldapDirectoryName = None >>> user.userProfile = None >>> user.serviceProfile = None >>> user.primaryDevice = None >>> user.pinCredentials = None >>> user.passwordCredentials = None >>> user.subscribeCallingSearchSpaceName = None >>> user.defaultProfile = None >>> user.convertUserAccount = None
>>> user.update() Traceback (most recent call last): ... pyaxl.exceptions.UpdateException: you must create a object with "create" before update
>>> user.create() {12345678-1234-1234-1234-123123456789} >>> validate.printSOAPRequest(transport.lastrequest()) addUser: user: firstName=Thomas lastName=Edison userid=tedison presenceGroupName=SC Presence Group
If you try to create a user twice, an Exception of the type CreationException is thrown:
>>> user.create() Traceback (most recent call last): ... pyaxl.exceptions.CreationException: this object are already attached
Clone an object
>>> transport.define('10.5_user_riols') >>> user = ccm.User('riols') >>> clone = user.clone() >>> clone.userid = 'riols2' >>> clone.update() Traceback (most recent call last): ... pyaxl.exceptions.UpdateException: you must create a object with "create" before update >>> clone.create() {12345678-1234-1234-1234-123123456789}
Running the doc tests
$ tox -- <path to axlsqltoolkit directory>
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.