GetPropertySets API¶

Returns all property set rows that have been applied to a document or folder identified by path. The path is resolved as a document first; if no document is found, it is resolved as a folder. Each applied property set is returned with all its data rows and audit information.

Endpoint¶

/srv.asmx/GetPropertySets

Methods¶

• GET /srv.asmx/GetPropertySets?authenticationTicket=...&Path=...
• POST /srv.asmx/GetPropertySets (form data)
• SOAP Action: http://tempuri.org/GetPropertySets

Parameters¶

Response¶

Success Response¶

<response success="true" error="">
  <Propertysets>
    <propertyset Name="PROJECTMETADATA">
      <propertyrow RowNbr="1"
                   PROJECT_CODE="PRJ-2024-001"
                   STATUS="Active"
                   NOTES="Initial entry">
        <Log AppliedBy="jsmith" DateApplied="2024-03-15 14:32" />
      </propertyrow>
      <propertyrow RowNbr="2"
                   PROJECT_CODE="PRJ-2024-002"
                   STATUS="Draft"
                   NOTES="">
        <Log AppliedBy="admin" DateApplied="2024-03-16 09:10" />
      </propertyrow>
    </propertyset>
    <propertyset Name="AUDITINFO">
      <propertyrow RowNbr="1"
                   AUDITOR="bjones"
                   AUDIT_DATE="2024-01-01">
        <Log AppliedBy="admin" DateApplied="2024-01-05 08:00" />
      </propertyrow>
    </propertyset>
  </Propertysets>
</response>

No Applied Property Sets¶

If the document or folder has no property set rows applied, the <Propertysets> element is empty:

<response success="true" error="">
  <Propertysets />
</response>

Error Response¶

<response success="false" error="[901]Session expired or Invalid ticket" />

Response Structure¶

<Propertysets>¶

Container element listing all property sets applied to the object.

<propertyset>¶

<propertyrow>¶

<Log> (child of <propertyrow>)¶

Required Permissions¶

The calling user must have at least read access to the target document or folder.

Anonymous access is supported if the document or folder is publicly accessible.

Example¶

GET Request¶

GET /srv.asmx/GetPropertySets
    ?authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
    &Path=/MyLibrary/Projects/Proposal.pdf
HTTP/1.1
Host: yourserver

POST Request¶

POST /srv.asmx/GetPropertySets HTTP/1.1
Host: yourserver
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c&Path=/MyLibrary/Projects/Proposal.pdf

Notes¶

• The Path resolves to a document first; if not found, it is resolved as a folder. If neither is found, an error is returned.
• Only property sets that have actually been applied (have at least one row) are included in the response.
• Field values are returned as attribute strings. Date and number values are returned in their stored string representation.
• To add a property set row, use AddPropertySetRow. To update one, use UpdatePropertySetRow. To remove one, use DeletePropertySetRow.

Related APIs¶

• AddPropertySetRow -" Add a property set row to a document or folder.
• UpdatePropertySetRow -" Update an existing property set row.
• DeletePropertySetRow -" Delete a property set row from a document or folder.
• GetPropertySetDefinition -" Get the field definitions of a property set.
• GetPropertySetDefinitions1 -" List property sets filtered by library and object type.

Error Codes¶