Get All Resource Details

Returns a list of relationships between people or assets and time templates for the specified tenant.

Command

GET https://{server}/api/v1/{tenantId}/objectData/ResourceDetail

Parameters

Name

Required

Data Type

Description

Parameter Type

tenantId

Yes

String

Unique identifier of the tenant.

Path

filter

No

String

Spring Expression Language (EL) filter. Allows you to filter by a set of records (for example: name eq 'name'). The following fields are filterable:

  • resourceDetailId

  • resourceId

  • timeTemplateId

  • timeTemplateName

  • effectiveDate

  • createTime

  • lastModifiedTime

  • createdBy

  • lastModifiedBy

For more details on using the filter query parameter, see Filtering Guidelines.

Query

offset

No

String

The number of items to skip before starting to collect the result set. Used with limit.

Query

limit

No

String

The maximum number of results to return. Used with offset. Together, they determine the start index and number of records to return. For example, to return records 5 through 15 that have been sorted by name, use the following:

ResourceDetail?offset=5&limit=10&orderBy=name

Query

orderBy

No

String

Order by fields, sort order.

Query

select

No

String

Select the specific fields to be returned.

Query

count

No

String

The number of records to fetch from the database.

Query

groupBy

No

String

Categorization of results (group by a field).

Query

Responses

Status and Error Codes

See Common Status and Error Codes.

Successful Response Body

Field

Description

hostId

The identifier of the host instance that is returning the request.

status

The status of the request. Valid values:

  • SUCCESS - The operation was a success.

  • ERROR - A validation error occurred.

content

Returns an array of records.

Field

Description

resourceDetailId

The globally unique database-level identifier of the resource detail record.

resourceId

The globally unique database-level identifier of the resource record.

timeTemplateId

The globally unique database-level identifier of a time template.

timeTemplateName

The unique name of the time template.

effectiveDate

The date the time template is effective for the specified resource.

attributes

A list of attributes, if any. The actual subfields depend on the attributes defined in the attribute definition. If there aren't any attributes, this field is null.

createTime

The date and time that the record was created.

lastModifiedTime

The date and time that the record was last modified.

createBy

The ID of the user who created the record.

lastModifiedBy

The ID of the user who updated the record.

messages

If the status is SUCCESS, this field is always blank. If the status is ERROR, a validation error occurred. For example, the object definition name in the URL is invalid.

count

The number of records returned.

Examples

Sample API Call

 
GET http://company.com/api/v1/pX3459712f8/objectData/ResourceDetail
X-Application-Key: 30b5f27a684744116537882dda0e50efb8c5a6e26a7b7ad2f3fcb2c24436a840
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImprdSI6Imh0dHB=

Successful Responses

Response Body Sample

 
{
    "hostId": "5809b7757b7e9f8deba297a28cc0849b",
    "status": "SUCCESS",
    "content": [
        {
            "resourceDetailId": "z20090116144702507703853",
            "resourceId": "z20090116144694507670853",
            "timeTemplateId": "z20090115482511392905853",
            "timeTemplateName": "TimeBundleAutoverificationTemplateWithCombinerRule",
            "effectiveDate": "2020-01-02",
            "attributes": {
                "supplierCode": "All"
            },
            "createdTime": "2020-09-01 16:14:47.023131"
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        },
        {
            "resourceDetailId": "z20090116144717207743853",
            "resourceId": "z20090116144708807710853",
            "timeTemplateId": "z20090115482511392905853",
            "timeTemplateName": "TimeBundleAutoverificationTemplateWithCombinerRule",
            "effectiveDate": "2020-01-02",
            "attributes": null,
            "createdTime": "2020-09-01 16:14:47.169833"
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        },
        {
            "resourceDetailId": "z20090116144730907783853",
            "resourceId": "z20090116144722807750853",
            "timeTemplateId": "z20090115482511392905853",
            "timeTemplateName": "TimeBundleManualverificationTemplate",
            "effectiveDate": "2020-01-02",
            "attributes": null,
            "createdTime": "2020-09-01 16:14:47.306581",
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        },
        {
            "resourceDetailId": "z20090116144744907823853",
            "resourceId": "z20090116144736507790853",
            "timeTemplateId": "z20090115482475492858853",
            "timeTemplateName": "TimeBundleAutoverificationTemplateWithCombinerRule",
            "effectiveDate": "2020-01-02",
            "attributes": null,
            "createdTime": "2020-09-01 16:14:47.446786",
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        },
        {
            "resourceDetailId": "z20090116144759107863853",
            "resourceId": "z20090116144750707830853",
            "timeTemplateId": "z20090115482495992882853",
            "timeTemplateName": "TimeTemplateWIthMultipleAttrsMandatoryPicklistAttrs",
            "effectiveDate": "2020-01-02",
            "attributes": {
                "SupplierCode": "SupplierCode_ACME"
            },
            "createdTime": "2020-09-01 16:14:47.588907",
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        },
        {
            "resourceDetailId": "z20090316220517408178a06",
            "resourceId": "z20090116335774619884853",
            "timeTemplateId": "z20090115482535492985853",
            "timeTemplateName": "TimeBundleAutoverificationTemplate",
            "effectiveDate": "2020-01-01",
            "attributes": null,
            "createdTime": "2020-09-03 16:22:05.178105",
            "lastModifiedTime": null,
            "createdBy": "z20102717121205036001d99",
            "lastModifiedBy": null
        }
    ],
    "messages": [],
    "count": 6
}

Error Responses

Response Body Error Sample - Object Definition Doesn't Exist on the Tenant

 
{
    "hostId": "964ce899bb9fca9271494665fb876e89",
    "status": "ERROR",
    "content": null,
    "messages": [
        {
            "type": "ERROR",
            "message": "Failed to Load Resource of Type ObjectDefn with Arguments [ResourceDetails, pX2f8122a19]",
            "code": "error.resourceNotFound",
            "arguments": {
                "type": "ObjectDefn",
                "arguments": "[ResourceDetails, pX2f8122a19]"
            },
            "key": "ObjectDefn"
        }
    ],
    "count": -1
}
Related Information