Cisco Cisco Configuration Engine 3.5 Entwickleranleitung

5-29

Cisco Configuration Engine Software Development Kit API Reference and Programmer Guide 3.5

OL-17661-02

Chapter 5 Web Services: Admin, Config, Image, Exec, NSM

Depreciated Image Web Service

Exception Handling:

•

AdminServiceException if there is an error in exporting templates.

•

RemoteException if there is an error communicating with the service.

bulkUpload

Usage:

String bulkUpload(String xml)

Description:

Uploads object data to the Cisco Configuration Engine Device, Group, Image and Application objects
can be defined in XML and uploaded. For detailed information on this feature, see the Cisco
Configuration Engine Administration Guide.

With Cisco Configuration Engine, objects can be edited or deleted by means of the Bulk Upload tool.

Note

Only one bulkUpload operation is permitted to execute at any time. If you attempt to execute two or more
concurrent bulkupload requests, all but the first received are ignored, are not queued, and must be
resubmitted. A CISException with a warning message is returned for all ignored requests.

Parameters:

xml—the bulkupload XML file. See the DTD for the correct format.

Returns:

String – a success message.

Exception Handling:

CISException—If a bulkupload request is already in progress or any system error occurs processing the
request. For more information, see the Cisco Configuration Engine Administration Guide.

Types

To ensure maximum interoperability, the types used are only the standard XML Schema (XSD) simple
types. All are nillable and support the ID and HREF attributes, so in an RPC-encoded context (such as
the Image Web Service) multi-ref serialization (for arrays) is supported.

Any custom types (CnsMessage) are XSD complex types that are only comprised of XSD simple types
or other complex types. They are essentially like Javabeans; simply an object with properties.

In the following example, the XML schema type JobDTO is actually a bean with properties that are each
an XSD simple type, like boolean, string, dateTime. Nesting is supported, so a complex type can contain
property whose type is yet another complex type.

<multiRef id="id0" soapenc:root="0"

soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

xsi:type="ns2:JobDTO"

xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"

xmlns:ns2="http://job.websvc.imgsrv.cns.cisco.com">