Web service API

How to use PageSeeder's Web service API

uri group export

/members/{member}/groups/{group}/uris/{uri}/export [GET]

com.pageseeder.export.Export

Description

Export a document (URI) and any of its referenced documents. The {group}on the URL is used to export any edits private to that group onfor shared documents.

This service exports the document(s) specified using the Universal Portable Format.

Note

It is also the service supporting the export Ant task. If you're working with Ant or outside a Web environment, it may be more appropriate to use the Ant task.

If there are more than 20 documents included in the export, this service will start an Asynchronous process.

Parameters

NameDescriptionRequiredTypeDefault value
contextContext of the upload (without the site prefix), required if "uris" is specified.maybestring
compareValue of the version to compare with, if the value is a float or ISO 8601 date and none match, the closest previous release is loaded.nostring
excludesComma-separated list of file name patterns to exclude from the export, only used if "path" is specified and points to a folder.nostring
fail-on-errorFlag to specify if the first error should kill the export.nobooleantrue
forward-depthThe depth of outgoing cross-references to traverse.nointeger0
image-metadata-onlyFlag to specify if only metadata of referenced images should be included in the export.nobooleanfalse
includesComma-separated list of file name patterns to include in the export, only used if "path" is specified and points to a folder.nostring
load-alternatesFlag to specify if alternate XRefs should be included in the export.nobooleanfalse
load-imagesFlag to specify if referenced images should be included in the export.nobooleantrue
metadata-onlyFlag to specify if only metadata PSML should be included in the export.nobooleanfalse
publicationidThe ID of the publication for release and compare parameters.nopublicationid
releaseValue of the version to export, if the value is a float or ISO 8601 date and none match, the closest previous release is loaded.nostring
reverse-depthThe depth of reverse cross-references to traverse.nointeger0
sinceLast modified date used to filter URIs to export, only used if "path" is specified and points to a folder.nostring
withComma-separated list of facets used to filter URIs to export, only used if "path" is specified and points to a folder.nostring
xref-typesComma-separated list of cross-references to traverse (none,embed,transclude).nostring

Permission

Permissions requirements to be updated.

Response

This service returns the following XML (even if an asynchronous process has not been started):

<thread ... status="[status]">
    ...
    [<processing current="[number processed]" 
                 total="[total processing]"/>]
    [<packaging current="[number packaged]" 
                total="[total packaging]"/>]
    [<zip>[zip file name]</zip>]
</thread>

When status="complete" the export can be downloaded using the URL:

[scheme]://[my server]/ps/member-resource/[group name]/[zip file name]

For example:

https://example.org/ps/member-resource/example-specs/export-1449617820208.zip

Error Handling

No specific errors expected for this generator.

Created on , last edited on