REST interface for IBM Process Federation Server resources - Search Metadata Resource - GET Method

Use this method to retrieve the metadata of the requested type via the type path parameter.

Sample method invocation

GET /rest/bpm/federated/v1/searches/meta/{type}[?searchType={string}][&instanceType={string}][&syncCacheUpdate={boolean}]

Usage Notes

The return list will contain different attributes depending on the path parameter {type} requested.
Each item in the return list will have the attributes as listed
fields
field name and field type attributes
constraintFields
field name, field type, and full_text_searchable attributes
businessDataFields
field name, field type, and full_text_searchable attributes
taskStatus
name of the value
taskState
name of the value
instanceStatus
name of the value
priority
name of the value
The possible field types are

Parameters

Optional parameters
NameValue TypeDescription
searchType string

Possible values are:

  • TASK_SEARCH (default): returns the metadata that applies for a task search
  • INSTANCE_SEARCH: returns the metadata that applies for a process instance search

instanceType string

Only applies when setting the searchType parameter to value INSTANCE_SEARCH.
Possible values are:

  • BPD: returns the metadata that applies for a BPD instance search
  • Case: returns the metadata that applies for a Case instance search
  • All (default): returns the metadata that applies for a BPD and Case instance search

syncCacheUpdate boolean

A boolean value that specifies whether or not this function should wait until the cache data is updated and then return, or if the function should asynchronously update the cache data and return immediately. If this parameter is not specified, false is used as the default value.

Request content

None

Response content

The default content type is application/json.

MIME type: application/json


+ View schema
{  "description": "Search Meta Typed Result", 
   "type": "object",
   "properties":
   { 
      "result": 
      [  {  "type": "object",
            "description": "List for the request 'type' information to use for building saved searches."
            "properties":
             {
                 "name" : { "type" : "string",
                     "description": " The name of a valid field when the type is 'field', 'constraintFields', or 'businessDataFields' 
                                      or the name of a valid value when the type is 'taskStatus', 'taskState', 'instanceStatus', or 'priority'"
                  },
                  "type" : { "type" : "string",
                  "description": " The type of this field. This attribute will be included when the type is 'field', 'constraintFields', and 'businessDataFields'"
                  "enum":
                     [
                       "String",
                       "Date",
                       "Time",
                       "Boolean",
                       "Integer",
                       "Decimal"
                     ]
                  },
                 "full_text_searchable" : { "type" : "boolean",
                     "description": " Is this field full text searchable, this attribute will be included when type is 'constraintFields'"
                  },                  
         }
      ]
   }
}
+ View example content
{
  "result": [
    {
      "full_text_searchable": true,
      "name": "applicationName",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "assignedToRoleDisplayName",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "assignedToUser",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "bpdId",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "bpdName",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "businessCategoryId",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "instanceId",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "instanceName",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "instanceProcessApp",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "instanceSnapshot",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "instanceSnapshotId",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "instanceStatus",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "invokedInstanceId",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "isEscalated",
      "type": "Boolean"
    },
    {
      "full_text_searchable": false,
      "name": "isRead",
      "type": "Boolean"
    },
    {
      "full_text_searchable": false,
      "name": "isSuspended",
      "type": "Boolean"
    },
    {
      "full_text_searchable": false,
      "name": "isTransferredToWorkBasket",
      "type": "Boolean"
    },
    {
      "full_text_searchable": false,
      "name": "isWaitingForSubTask",
      "type": "Boolean"
    },
    {
      "full_text_searchable": false,
      "name": "kind",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "resumptionTime",
      "type": "Date"
    },
    {
      "full_text_searchable": false,
      "name": "starter",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "supportsClaimIfSuspended",
      "type": "Boolean"
    },
    {
      "full_text_searchable": true,
      "name": "taskActivityName",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskAtRiskTime",
      "type": "Date"
    },
    {
      "full_text_searchable": false,
      "name": "taskClosedDate",
      "type": "Date"
    },
    {
      "full_text_searchable": false,
      "name": "taskDueDate",
      "type": "Date"
    },
    {
      "full_text_searchable": false,
      "name": "taskId",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskIsAtRisk",
      "type": "Boolean"
    },
    {
      "full_text_searchable": true,
      "name": "taskNarrative",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskPriority",
      "type": "Integer"
    },
    {
      "full_text_searchable": false,
      "name": "taskReceivedDate",
      "type": "Date"
    },
    {
      "full_text_searchable": false,
      "name": "taskReceivedFrom",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskState",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskStatus",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "taskSubject",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "taskTemplateId",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "type",
      "type": "String"
    },
    {
      "full_text_searchable": false,
      "name": "workBasketId",
      "type": "String"
    },
    {
      "full_text_searchable": true,
      "name": "workBasketName",
      "type": "String"
    }
  ]
}

Status codes

The method returns one of the following status codes:
CodeDescription
200 OKThe request completed successfully.
400 Bad RequestThe parameters are not valid or they are missing.
401 UnauthorizedThe caller is not authorized for this request.
404 Not FoundThe resource does not exist.
406 Not AcceptableThe requested content type or content encoding is not supported.
500 Internal Server ErrorA severe problem occurred.
503 Service UnavailableThe federated request could not be delivered to individual federation targets.
504 Gateway TimeoutThe federated response has partial content because of missing individual responses.

Available since

21.0.2

Parent Topic: Search Metadata Resource