REST API - Comment - Case Reference - GET

This table summarizes the REST API - comment - case reference - GET.

Request

Format
GET <baseurl>/audit/comment/case/<caseReference>
Path Parameters caseReference. The reference to the case object. Whenever a case object is created, a unique case reference is also created. Providing the case reference provides access to the case data object. You can obtain case references using findAllCases.
Query Parameters
  • requireallattributes=string (optional, default=false). Whether all attributes should be returned. Can be obtained from getAllAttributes or getAttributes. The default is false.
  • requiredattribute=string (optional). Specific attributes that should be returned for each event found. Can be obtained from getAllAttributes or getAttributes.
  • sortorder=string (0-n, optional): What attribute or attributes the results should be sorted on, and in what direction the sort should run. Specify this in the following format:
    attribute 1:ASCENDING|DESCENDING;attribute 2:ASCENDING|DESCENDING; … attribute n:ASCENDING|DESCENDING
  • gettotalcount=string (optional, default=true). Whether to include a count of the total number of events in the list. The count is returned in the totalItems value in the response. You should set getTotalCount to false unless you specifically need the total figure, because setting it to true is expensive in terms of database access time. Note that:
    • If you pass false in this attribute, and there is at least one item in the list, the totalItems value returned in the response is -1. However, if you pass false and there are no work items in the list, the totalItems value in the response is 0 (zero).
    • If you pass true in this attribute but numberOfItems is set to zero, the totalItems value in the response is 0 regardless of how many items are actually in the list. The total count of items is only available when you are fetching one or more items.
  • numberofitems=integer (optional, default=-1). The maximum number of events to return. Specifying -1 returns all events for the process instance.
  • populateattributenames=string (optional). Specify that attribute names be returned in the list of events.
  • startposition=integer (optional, default=-1). The position in the list from which to start the page of results. The list is zero-based. To start at the first item, specify 0.

Response

JSON Returns a JSON representation of the content of the getCommentAuditResponse element.
XML Returns the content of the getCommentAuditResponse element (from the EventCollectorReportService schema).

Example

Request
GET <baseurl>/audit/comment/case/BDS-1-com.example.sample.EmployeeInfo-1-0
Response
{
    "xml-fragment": {
        "endPosition": 1,
        "startPosition": 0,
        "totalItems": 1,
        "reference": {
            "caseRef": {
                "reference": "BDS-1-com.example.sample.EmployeeInfo-1-0"
            }
        },
        "comment": {
            "id": 6522,
            "creationTime": "2016-04-11T10:59:46.077Z",
            "componentId": "EC",
            "messageId": "EC_COMMENT_CASE",
            "severity": "AUDIT",
            "message": "Case Comment",
            "priority": "MEDIUM",
            "correlationId": "f407ffb6-1679-4fda-8126-c3c36a59b02f",
            "contextId": "f407ffb6-1679-4fda-8126-c3c36a59b02f",
            "messageCategory": "GLOBAL_DATA",
            "principalId": "tibco-admin",
            "principalName": "tibco-admin",
            "managedObjectId": "BDS-1-com.example.sample.EmployeeInfo-1-0",
            "managedObjectType": "AUDIT_COMMENT",
            "managedObjectVersion": -1,
            "extendedMessage": "This is a case."
        }
    }
}