put

Upload and store XML document(s) into an XML Library.

Documents are uploaded in POST multipart, then XML-parsed on the server side.

To validate documents with DTD's or XML Schema, OASIS XML Catalogs can be configured in the server. When a DTD or Schema is not found, a fallback DTD is used, so no parsing error should happen.



HTTP Request: POST

Parameters:

NameValueDescription
path Path the Document will have in the XML Library. Can be specified explicitly or as the remainder the HTTP URL.
data

XML contents of the document. This data is parsed on the server side.

This parameter is generally passed as a File part, but can also be a string value.

path2 Library path of additional Document.
data2

XML contents of additional document.

path3 Library path of additional Document ...
data3

XML contents of additional document ...

library Name of Library used (can be empty if exactly one Library in server).

Response:

   mime-type: text/plain

For each document that could not be generated, return a line containing the error code, the destination path of the Document, and the error message separated by tabs.

The last line is of the form: IMPORT ERRORS #errors, where #errors the number of import errors. Therefore a completely successful put returns a single line 'IMPORT ERRORS 0'.

 

Error codes:

AccessControl
when the user is not allowed to write on a Document or Collection.
XMLData
Conflicting path with a Collection.