Skip to main content

 Services

Web services from /about to /webhooks

uris group export

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

Description

Export document(s) using path or uris parameters. The {group} on the URL is used when downloading the result.

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

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

Parameters

NameDescriptionRequiredTypeDefault value
binary-metadata-onlyFlag to specify if only metadata of non-PSML documents should be included in the export. Requires PageSeeder v5.99 or higher.nobooleanfalse
allurls
Whether to export all URLs used in this groupnoboolean
false
contextContext of the upload (without the site prefix), required if uris is specifiedmaybestring
pathThe path of the URI to export (without the site prefix), required if uris is not specifiedmaybestring
urisComma-separated list of URI IDs of documents to export, required if path is not specified. If there could be many URI IDs use Service: /members/{member}/groups/{group}/export [POST] instead.maybestring
compareValue of the version to compare with, if the value is a float or ISO 8601 date and none match, the closest previous version is loadednostring
excludesComma-separated list of filename patterns to exclude from the export, only used if path is specified and points to a foldernostring
fail-on-errorFlag to specify if the first error should end the exportnobooleantrue
forward-depthThe depth of outgoing cross-references to traversenointeger0
hostThe host of the URI to export nostringsee below
image-metadata-onlyFlag to specify if only metadata of referenced images should be included in the export. DEPRECATED use binary-metadata-only instead.nobooleanfalse
includesComma-separated list of filename patterns to include in the export, only used if path is specified and points to a foldernostring
interpublication-xrefsFlag whether to resolve{parentnumber}, {prefix} and {heading} templates of xrefs between publications. Uses the default publication of the target.nobooleanfalse
load-alternatesFlag to specify if alternate xrefs should be included in the exportnobooleanfalse
load-imagesFlag to specify if referenced images should be included in the exportnobooleantrue
metadata-onlyFlag to specify if only metadata PSML should be included in the exportnobooleanfalse
portThe port of the URI to exportnointegersee below
position
Position in the publication for numberingnointeger
1
process-publicationWhether to process publication numbering and placeholders (requires publicationid). Requires PageSeeder v6.1 or higher.nobooleanfalse
publicationidThe ID of the publication for  processingnopublicationid
reverse-depthThe depth of reverse cross-references to traversenointeger0
schemeThe scheme of the URI to exportnostringsee below
sinceLast modified date used to filter URIs to export, only used if path is specified and points to a foldernostring
versionValue of the version to export. If the value is a float or ISO 8601 date and none match, the closest previous version is loadednostring
version-publicationidThe ID of the publication for version and compare parameters. Requires PageSeeder v6.1 or higher.nopublicationid
withComma-separated list of facets used to filter URIs to export, only used if path is specified and points to a foldernostring
xref-typesComma-separated list of cross-references to traverse (none,embed,transclude)nostring[all types]

If process-publication="true" then transcluded content will be included in documents (except if compare specified), however transclude should still be specified in xref-types to follow xrefs in that content.

scheme

If specified, the scheme must be a valid scheme used in the PageSeeder hosts. Generally http or https. It defaults to the documentScheme global property.

host

If specified, the host must be one of the define PageSeeder hosts. It defaults to the webSiteAddress template property.

port

If specified the port must be a valid port number (1 through 65535) used in a PageSeeder host. It defaults to the documentPort template property.

Permission

User must have access to view the group and documents being exported.

Response

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

<thread ... status="[status]" groupid="[group ID]">
  ...
  [<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 ID or 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 service.

Created on , last edited on