Platform API

<back to all web services

GetObjectDimensionValues

Get a list of dimensionValues linked to a specified object

Requires Authentication
The following routes are available for this service:
All Verbs/api/dimensionvalues/object/{ObjectId}
GetObjectDimensionValues Parameters:
NameParameterData TypeRequiredDescription
LicenseeIdqueryGuidNoLicensee Id to retrieve dimensionValues for.
ObjectIdqueryGuidNoObject Id to retrieve dimensionValues for.
GetObjectDimensionsResponse Parameters:
NameParameterData TypeRequiredDescription
DimensionsqueryList<DimensionModel>NoList of dimensions.
ResponseStatusformResponseStatusNo
DimensionModel Parameters:
NameParameterData TypeRequiredDescription
DimensionIdformGuidNoId of the Dimension itself.
NameformstringNoDimension name.
DescriptionformstringNoDimension description.
ShortNameformstringNoDimension shortened name.
HasTrafficLightForValuesformboolNoTrue if the values for the dimension should have colours associated with them.
HasImageformboolNo
OwnerContactIdformGuidNoOwner Id of the dimension.
RecordStatusformstringNoRecord status of the dimension.
DimensionValuesformList<DimensionValueModel>NoDimension values for this dimension.
ObjectConnectionIdformGuidNoId that links this dimension to an object.
DimensionValueModel Parameters:
NameParameterData TypeRequiredDescription
DimensionValueIdbodyGuidNoId of the dimension value.
DimensionIdbodyGuidNoDimension Id this value is for.
NamebodystringNoName of the dimension value.
DescriptionbodystringNoDescription of the dimension value.
ShortNamebodystringNoShort Name for the dimension value.
TrafficLightIdbodyGuidNoId of the colour associated.
TrafficLightColourbodystringNoColour associated with the dimension value.
ObjectConnectionIdbodyGuidNoId that links this dimension value to an object.
OwnerContactIdbodyGuidNoOwner Id of the dimension value.
RecordStatusbodystringNoRecord status of the dimension value.

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/dimensionvalues/object/{ObjectId} HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"LicenseeId":"00000000-0000-0000-0000-000000000000","ObjectId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Dimensions":[{"DimensionId":"00000000-0000-0000-0000-000000000000","Name":"String","Description":"String","ShortName":"String","HasTrafficLightForValues":false,"HasImage":false,"OwnerContactId":"00000000-0000-0000-0000-000000000000","RecordStatus":"String","DimensionValues":[{"DimensionValueId":"00000000-0000-0000-0000-000000000000","DimensionId":"00000000-0000-0000-0000-000000000000","Name":"String","Description":"String","ShortName":"String","TrafficLightId":"00000000-0000-0000-0000-000000000000","TrafficLightColour":"String","ObjectConnectionId":"00000000-0000-0000-0000-000000000000","OwnerContactId":"00000000-0000-0000-0000-000000000000","RecordStatus":"String"}],"ObjectConnectionId":"00000000-0000-0000-0000-000000000000"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}