Administrative XML (AXL) > Discover > Versioning

Versioning

The AXL interface supports multiple AXL schema versions which provide an abstraction layer between AXL Applications and the Unified CM database. Use of AXL Versioning enables developers to support multiple Unified CM releases and maintain backward compatibility during customer upgrades.

Developers can specify the schema that they wish to use in the SOAP Action Header of the request. If a schema version is not specified, the oldest supported schema will be used. The AXL versioning guidelines are illustrated in the following table and explained below.

AXL Request with Version Specified

No Version Specified in Request CUCM:DB ver=12.0 CUCM:DB ver=11.5 CUCM:DB ver=11.0 CUCM:DB ver=10.0 CUCM:DB ver=9.1 CUCM:DB ver=9.0 CUCM:DB ver=8.5 CUCM:DB ver=8.0 CUCM:DB ver=7.1
Release 12.0(1) 10.0 schema applied 12.0 schema applied 11.5 schema applied 11.0 schema applied 10.0 schema applied          
Release 11.5(1) 9.0 schema applied   11.5 schema applied 11.0 schema applied 10.0 schema applied 9.1 schema applied 9.0 schema applied      
Release 11.0(1) 9.0 schema applied     11.0 schema applied 10.0 schema applied 9.1 schema applied 9.0 schema applied      
Release 10.5(1) 8.0 schema applied       10.0 schema applied 9.1 schema applied 9.0 schema applied 8.5 schema applied 8.0 schema applied  
Release 10.0(1) 8.0 schema applied       10.0 schema applied 9.1 schema applied 9.0 schema applied 8.5 schema applied 8.0 schema applied  
Release 9.1(1) 7.1 schema applied         9.1 schema applied 9.0 schema applied 8.5 schema applied 8.0 schema applied 7.1 schema applied
Release 9.0(1) 7.1 schema applied           9.0 schema applied 8.5 schema applied 8.0 schema applied 7.1 schema applied
Release 8.5(1) 7.0 schema applied             8.5 schema applied 8.0 schema applied 7.1 schema applied
Release 8.0(1) 6.1 schema applied               8.0 schema applied 7.1 schema applied
Release 7.1(2) 6.0 schema applied                 7.1 schema applied

Release 8.6(x) did not include a new schema. Developers should use the 8.5 schema with Release 8.6(x). All new 8.6 database objects have been added to the 9.0 schema in Release 9.0(1).

AXL Guidelines (beginning with Unified CM 10.0)

  • Developers should always plan to implement support for the newest AXL schema available.
  • AXL schemas will be available for two major Unified CM release cycles.
  • New AXL schemas will be added in each Unified CM major and minor release, for example N.N.n.
  • Old AXL schemas will only be deprecated in the first major (N.n.n) release of Unified CM. This means that upon the first major release of an UCM version (N.n.n), all schemas for the N-3 major and minor releases (N-3..) will be deprecated and removed.
    For example:
    • Cisco Unified CM 10.0 supports AXL schemas for 8.x, 9.x, and 10.0, while the 7.x schemas are deprecated and removed.
    • Cisco Unified CM 11.0 supports AXL schemas for 9.x, 10.x, and 11.0, while the 8.x schemas are deprecated and removed.
  • Maintenance releases never include new AXL schemas (for example, n.n.N).
  • Developers should always specify the desired AXL schema version in the SOAPAction Header to ensure the desired schema is applied to the request.
  • Developers who do not request a specific AXL schema will always connect to the oldest schema available.
  • Use of the executeSQLQuery and executeSQLUpdate interfaces provide no backward compatibility between Unified CM releases. Cisco recommends developers avoid using these interfaces, as they bypass the schema abstraction layer and interoperate with the database schema directly. Applications which make use of these interfaces may break when the database schema changes. Cisco reserves the right to change the database schema in any release, at any time, for any reason, without any notice.

AXL Guidelines (Unified CM 6.x through 9.x)

  • AXL schemas will be available for two major Unified CM release cycles, such that AXL applications will require minor updates every two years.
  • New AXL schemas are added in the first major (N.n.n) and first minor (n.1.n or n.5.n) release of each Unified CM version.
  • Old AXL schemas are deprecated in the first major (N.n.n) and first minor (n.1.n or n.5.n) release of each Unified CM version.
  • Maintenance releases never include new AXL schemas, for example n.n.N.
  • Developers should always specify the desired AXL schema version in the SOAPAction Header to ensure the desired schema is applied to the request.
  • Developers who do not specify a desired AXL schema will always connect to the oldest schema available.
  • Use of the executeSQLQuery and executeSQLUpdate interfaces provide no backward compatibility between Unified CM releases. Cisco recommends developers avoid using these interfaces, as they bypass the schema abstraction layer and interoperate with the database schema directly. Applications which make use of these interfaces may break when the database schema changes. Cisco reserves the right to change the database schema in any release, at any time, for any reason, without any notice.