Orbeon Forms
Search
⌃K

List form data attachments API

Availability

Since Orbeon Forms 4.7.

Internal uses

None.

Purpose

The purpose of the attachments API is to return information about form data attachments.

Interface

  • URL: /fr/service/$app/$form/attachments?document=$document
  • Method: GET
Where:
  • $app is the form definition's application name
  • $form is the form definition's form name
  • $document is the form data's document id
Request parameters:
  • document: the id of the document (form data) to retrieve
Request body:
  • none
Response body:
  • Content-Type: application/xml
  • each child element contains
    • as text data the path to the attachment
    • name attribute: the associated control name
    • filename, mediatype, size: attachment metadata
Example response body:
<?xml version="1.0" encoding="UTF-8"?>
<attachments>
<attachment name="my-image" filename="sunset.png" mediatype="image/png" size="19354">
/fr/service/persistence/crud/a/a/data/cff2bb5313f6e28fa4fc5b96504102931359e902/51c42c10beec2a7a428667c84c4df998ddec2322.bin
</attachment>
<attachment name="other-image" filename="africa.jpg" mediatype="image/jpeg" size="169202">
/fr/service/persistence/crud/a/a/data/cff2bb5313f6e28fa4fc5b96504102931359e902/11b03cbe6d2dab4876c97229dacf9cbb76df5bb7.bin
</attachment>
</attachments>

Permissions

The caller must either call the service internally or have proper credentials to access the data (username, group, roles).

See also