Accessing Document-Type Custom Fields - EcoSys - Customization & Programming - Hexagon PPM

EcoSys Web Service API Usage Documentation

Language
English
Product
EcoSys
Search by Category
Customization & Programming
EcoSys Version
9.0

Document-type custom field values, when included in a REST object API response, will provide additional information about the attached document, including a URL to access the content of the attached file.

Document-type custom field values are read-only.

For example:

<SampleProject>

<SimpleAttribute1>simple value</SimpleAttribute1>

<SimpleAttribute2>simple value</SimpleAttribute2>

← Simple object attribute values

<DocumentAttribute3>

← Begin document-type custom field value

<title>My Doc Title</title>

← Document title element

<link

href="http://server/ecosys/api/restdoc/SamplePro

ject/4452-DocumentAttribute3/sampledoc.pdf" 

contentType="application/pdf"

filename="sampledoc.pdf"

sizeBytes="25401"

modifiedTime="2013-02-22T10:30:24"

/>

← Document link element, including document meta data and URL to access attached file contents via HTTP

</DocumentAttribute3>

← End document-type custom field value

. . .

</SampleProject>

The attributes of the document-type custom field value are as follows:

  • href — the API URL for accessing the content of the referenced document — this URL can be accessed through HTTP using the same session or credentials as the referring object API, and the HTTP response is the attached file itself inline

  • contentType — the MIME content type of the attached document referenced

  • filename — the filename assigned to the attached document

  • sizeBytes — the size in bytes of the attached document referenced

  • modifiedTime — the timestamp of the last update of the attached document referenced.