upload

Description

Upload a single file to PageSeeder with the contents of the file in the body of the request.

Administrators can upload on behalf of another member using the member parameter.

There are two modes of operation depending on whether the autoload parameter was used.

By default, the file is uploaded into the loading zone. When the autoload  parameter is true, the file is upload directly into the target folder of the specified group.

Some limitations are controlled by global properties:

• The maximum upload size is defined by the maxUploadSize global property.
• The maximum number of attachments to a comment are defined by the maxAttachmentNumber global property.
• The maximum number of workflow notifications is defined by the maxWorkflowNotifications global property.

Loading zone upload (default)

The loading zone is a temporary container for files on the server before they are loaded into PageSeeder.

There is a separate loading zone for each member on each group. Within a group a member can have multiple loading zones by specifying a unique uploadid or xlinkid for each one. An xlinkid is used to upload attachments to a draft comment before it is submitted (the xlinkid is the same as the comment ID).

After files have been uploaded, the various load services can be used to modify, unzip them and start loading them into PageSeeder.

Direct upload (autoload)

When autoload parameter is true , the file is loaded directly into the target group and folder using a default configuration.

You can specify the target location using the url or the folder parameter. If neither is specified, the file is uploaded into the root folder of the group.

Use the overwrite-properties parameter if you want to update the title, description, document ID, labels, or metadata of the target URI if it exists. This parameter has no effect if overwrite is not set to true. The title, description, docid, and labels can be specified as parameters on the request.

Parameters

Permission

The permission required depends on the target context.

When attaching a file to a comment, the user must be a member of the group. Otherwise, the user must have edit permissions on the target folder (contributor and higher).

An Anti-CSRF-Token token is required to use this service.

Response

The response depends on whether the autoload parameter was used.

Loading zone upload (default)

By default, this service returns the details of the file that was uploaded:

 <upload member="[member ID]" [uploadid="[uploadid]"] max-workflow-notifications="20">
   <file name="[filename]" path="[path]" type="file" ... />
 </upload>

Direct upload

If autoload is true, this service returns the details of the URI created as a result of the upload in a <uri> element:

<upload member="[member ID]" [uploadid="[uploadid]" 
        status="[failed|completed]"]
        max-workflow-notifications="20">
  <message>[explanation or error]<message>
  <uri id="[uri id]" ... />
</upload>

Error handling