type path parameter.GET /rest/bpm/wle/v1/searches/tasks/meta/{type}[?includeOrigin={boolean}][&includeCaseAlias={boolean}]
constraintFields and the businessDataFields metadata types returned include the full_text_searchable Boolean attribute for the field to indicate whether that field can be used in a full text search. Many String-type and most Business Data constraint fields are full-text searchable. For example:
| Name | Value Type | Description |
|---|---|---|
| includeOrigin | boolean |
To include the origin of the exposed business data fields. This parameter only works when businessDataFields is requested.
|
| includeCaseAlias | boolean |
To include the Case Property aliases. This parameter only works when businessDataFields is requested.
|
type path parameter filters the type of the returned metadata.The default content type is application/json.
{
"title":"Search Defintion Meta Data Results By Type",
"type":"object",
"description":"A list of meta data filtered by type that can be used in a saved or adhoc search definition. It is filtered by type of meta data requested and the elements returned are determined by the type of meta data requested.",
"properties": {
"result":{
"type":"array",
"description":"This type represents individual meta data of the type requested that can be used in a saved or adhoc search definition.",
"properties":{
"name":{
"type":"string",
"description":"The name of this field.",
"required":true
},
"type":{
"type":"string",
"description":"The type of this field. This property is optional.",
"enum":
[
"String",
"Date",
"Time",
"Integer",
"Decimal",
"Boolean"
],
"required":false
},
"full_text_searchable":{
"type":"boolean",
"description":"The attribute to indicate if this field may be used in a full text search. This property is optional.",
"required":false
}
}
}
}
}
{
"status":"200",
"data":{
"result":[
{
"name": "instanceName",
"type": "String",
"full_text_searchable": true
},
{
"name": "instanceId",
"type": "Integer",
"full_text_searchable": false
}
]
}
}
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://rest.bpm.ibm.com/v1/data/savedsearchdefinition"
elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://rest.bpm.ibm.com/v1/data/savedsearchdefinition"
xmlns:common="http://rest.bpm.ibm.com/v1/data/common"
xmlns:pref="http://rest.bpm.ibm.com/v1/data/root">
<import schemaLocation="Common.xsd" namespace="http://rest.bpm.ibm.com/v1/data/common"/>
<import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root"/>
<!--
The saved search definition. This is the format that is returned when a search is retrieved,
and the format that is used for the payload when saving or updating a search.
-->
<complexType name="SavedSearchDefinition">
<complexContent>
<extension base="pref:Data">
<sequence>
<!--
The ID of the saved search definition.
This field is always returned. When supplied as part of the payload:
Create: The ID should be blank when creating a saved search definition.
Update: Optional, if supplied the id must match the id of the saved search definition being updated.
Adhoc execution: This field is optional, if supplied it is ignored."
-->
<element name="id" type="string" />
<!--
"The name of the saved search definition.
This field is always returned. When supplied as part of the payload:
Create: Required and must follow the name validation rules.
Update: Optional, if supplied for the purpose of renameing, must follow the name validation rules
Adhoc execution: This field is optional, if supplied it is ignored."
-->
<element name="name" type="string" />
<!--
The owner of the saved search definition.
Create: If a value is not set, the currently logged on user is set as the owner upon save.
Update: Defaulting rules are applied. (pre 8570 did not have owner)
-->
<element name="owner" type="string" nillable="true"/>
<!--
A string that indicates how the search results are organized.
The value is set to either "byTask" or "byInstance". Defaults if not provided.
-->
<element name="organization" type="string" />
<!-- Indicates whether the saved search is shared. Defaults if not provided. -->
<element name="shared" type="boolean" />
<!-- Indicates if the saved search is shared with a team or global -->
<element name="teams" type="tns:SavedSearchDefnTeam" minOccurs="0" maxOccurs="unbounded"/>
<!-- The pre-predefined size of items to be retrieved. -->
<element name="size" type="integer" nillable="true" />
<!--
The filter to target different Saved Searches for different task categories
(team tasks, claimed tasks, closed tasks, etc).
-->
<element name="interaction" type="string" nillable="true"/>
<!-- fields or columns -->
<element name="fields" type="string" minOccurs="0" maxOccurs="unbounded"/>
<!-- business data aliases -->
<element name="aliases" type="tns:SavedSearchDefnAlias" minOccurs="0" maxOccurs="unbounded"/>
<!-- sort order -->
<element name="sort" type="tns:SavedSearchDefnSort" minOccurs="0" maxOccurs="3"/>
<!-- search condition -->
<element name="conditions" type="tns:SavedSearchDefnCondition" minOccurs="0" maxOccurs="2"/>
</sequence>
</extension>
</complexContent>
</complexType>
<!--
This type represents the meta data of a saved search definition that is returned in list of definitions.
-->
<complexType name="SavedSearchDefinitionMetadata">
<complexContent>
<extension base="pref:Data">
<sequence>
<!--
The ID of the saved search definition.
If a value is not set, a new saved search definition is created upon save.
-->
<element name="id" type="string" />
<!--
The name of the saved search definition.
-->
<element name="name" type="string" />
<!--
The owner of the saved search definition.
-->
<element name="owner" type="string" nillable="true"/>
<!--
A string that indicates how the search results are organized.
The value is set to either "byTask" or "byInstance".
-->
<element name="organization" type="string" />
<!-- Indicates whether the saved search is shared -->
<element name="shared" type="boolean" />
</sequence>
</extension>
</complexContent>
</complexType>
<!--
A list of saved search definitions.
-->
<complexType name="SavedSearchDefinitions">
<complexContent>
<extension base="pref:Data">
<sequence>
<element name="definitions" type="tns:SavedSearchDefinitionMetadata" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</extension>
</complexContent>
</complexType>
<!-- This type represents the sort order of a saved search definition. -->
<complexType name="SavedSearchDefnSort">
<sequence>
<!-- The field to sort on. -->
<element name="field" type="string" />
<!-- This will be set to "DESC" or "ASC". -->
<element name="order" type="string" />
</sequence>
</complexType>
<!-- This type represents the aliases for business data fields of a saved search. -->
<complexType name="SavedSearchDefnAlias">
<sequence>
<!-- The business data field the alias is for. -->
<element name="field" type="string" />
<!-- The alias for the field. -->
<element name="alias" type="string" />
</sequence>
</complexType>
<!-- This type represents the conditions of a saved search definition. -->
<complexType name="SavedSearchDefnCondition">
<sequence>
<!-- The field the condition is based on. -->
<element name="field" type="string" />
<!-- The operation to perform. There is a set list of valid values. -->
<element name="operator" type="string" />
<!-- The value of the condition ". -->
<element name="value" type="string" />
<!-- choice>
<element name="value" type="string" />
<element name="values" type="string" minOccurs="0" maxOccurs="unbounded"/>
</choice-->
</sequence>
</complexType>
<!-- This type represents the teams that are authorized or can execute a shared saved search definition. -->
<complexType name="SavedSearchDefnTeam">
<sequence>
<!-- The team id. -->
<element name="teamId" type="string" />
<!-- The team name. -->
<element name="teamName" type="string" />
<!-- The process app where the team was defined / modeled". -->
<element name="processAppName" type="string" />
</sequence>
</complexType>
<!--
This type represents individual meta data of the type requested that can be used in a saved or adhoc search definition.
It is used to get a list of fields and meta data about those fields. It is filtered by type of meta data requested.
This type is also used for simple enumerations, in which case type and full_text_searchable will be null.
-->
<complexType name="SearchDefinitionMetaData">
<sequence>
<!-- The field name. -->
<element name="name" type="string" />
<!-- The field's type with the type being one of the following: String , Date, Time, Integer, Decimal, Boolean. -->
<element name="type" type="string" />
<!-- The symbolic name of the case property, null for non case property -->
<element name="symbolicName" type="string" />
<!-- Indicate whether the alias is for case level property or activity level property -->
<element name="caseContext" type="string" />
<!-- The attribute to indicate if this field may be used in a full text search. -->
<element name="full_text_searchable" type="boolean" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="SearchDefinitionMetaDataWithOrigins">
<complexContent>
<extension base="tns:SearchDefinitionMetaData">
<sequence>
<element name="origins" type="tns:BusinessDataAliasOrigin" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</extension>
</complexContent>
</complexType>
<complexType name="SearchDefinitionMetaDataWithId">
<complexContent>
<extension base="tns:SearchDefinitionMetaData">
<sequence>
<element name="id" type="string"/>
</sequence>
</extension>
</complexContent>
</complexType>
<complexType name="BusinessDataAliasOrigin">
<sequence>
<element name="type" type="string" />
<element name="projectShortName" type="string" />
<element name="branchName" type="string" />
<element name="snapshotName" type="string" nillable="true" />
<element name="snapshotAcronym" type="string" />
<element name="snapshotId" type="string" nillable="true" />
<element name="processName" type="string" />
</sequence>
</complexType>
<!--
A list of meta data filtered by type that can be used in a saved or adhoc search definition
It is filtered by type of meta data requested and the elements returned are determined by the type of meta data requested.
-->
<complexType name="SearchDefintionMetaDataResultsByType">
<complexContent>
<extension base="pref:Data">
<sequence>
<element name="result" type="tns:SearchDefinitionMetaData" minOccurs="0" maxOccurs="unbounded"/>
<element name="caseResult" type="tns:SearchDefinitionMetaData" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</extension>
</complexContent>
</complexType>
<!--
A list of action policies or available actions a user has based on the Saved Search Definition.
-->
<complexType name="SavedSearchDefinitionUsersAvailableActions">
<complexContent>
<extension base="pref:Data">
<sequence>
<element name="actions" type="string" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</extension>
</complexContent>
</complexType>
<!--
This type describes a failed operation during a bulk savedSearch-related operation.
-->
<complexType name="FailedOperations">
<sequence>
<!-- The saved search ID -->
<element name="savedSearchId" type="string" />
<!-- The error message prefix associated with the error -->
<element name="errorNumber" type="string" />
<!-- The error message associated with the error -->
<element name="errorMessage" type="string" />
</sequence>
</complexType>
<!--
This type is used to return the results from performing a bulk operation on multiple saved searches.
-->
<complexType name="SavedSearchBulkOperation">
<complexContent>
<extension base="pref:Data">
<sequence>
<!-- A list of zero or more failed operations -->
<element name="failedOperations" type="tns:FailedOperations" minOccurs="0" maxOccurs="unbounded" />
<!-- A list of zero or more saved search definitions -->
<element name="definitions" type="tns:SavedSearchDefinition" minOccurs="0" maxOccurs="unbounded" />
<!-- Counts the saved searches on which the requested action was applied successfully. -->
<element name="succeeded" type="int" minOccurs="0" maxOccurs="1"/>
<!-- Counts the saved searches on which the requested action was applied unsuccessfully. -->
<element name="failed" type="int" minOccurs="0" maxOccurs="1"/>
</sequence>
</extension>
</complexContent>
</complexType>
</schema>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bpm:ResponseData xmlns:bpm='http://rest.bpm.ibm.com/v1/data'>
<status>200</status>
<data xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='savedsrchdefn:SearchDefintionMetaDataResultsByType' xmlns:savedsrchdefn='http://rest.bpm.ibm.com/v1/data/savedsearchdefinition'>
<result>
<name>instanceName</name>
<type>String</type>
<full_text_searchable>true</full_text_searchable>
</result>
<result>
<name>instanceId</name>
<type>Integer</type>
<full_text_searchable>false</full_text_searchable>
</result>
</data>
</bpm:ResponseData>
The default content type is application/json.
{ "description": "WLE Error Response",
"type": "object",
"properties":
{ "status": {"type": "string",
"description": "The status of the previous API call."
},
"exceptionType": {"type": "string",
"description": "The classname associated with the exception."
},
"errorNumber": {"type": "string",
"description": "Message ID of the exception."
},
"errorMessage": {"type": "string",
"description": "Message text of the exception."
},
"errorMessageParameters": {"type": ["string"], "optional": true,
"description":"Message text parameters of the exception."
},
"programmersDetails": {"type": "object", "optional": true,
"description":"Additional exception details, for example, a stack trace."
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://rest.bpm.ibm.com/v1/data/exception"
elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://rest.bpm.ibm.com/v1/data/exception"
xmlns:dat="http://rest.bpm.ibm.com/v1/data/root">
<import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" />
<!--
This type represents an error response.
-->
<element name="RestRuntimeException">
<complexType>
<sequence>
<element name="status" type="string"/>
<element name="Data" type="tns:ExceptionData">
</element>
</sequence>
</complexType>
</element>
<!--
This type contains detailed error information associated with an exception.
-->
<complexType name="ExceptionData">
<sequence>
<element name="status" type="string"/>
<!-- This specifies the java class name of the exception -->
<element name="exceptionType" type="string"/>
<!-- The message ID of the error message -->
<element name="errorNumber" type="string" minOccurs="0"/>
<!-- The complete error message -->
<element name="errorMessage" type="string"/>
<!-- The list of strings inserted into the error message -->
<element name="errorMessageParameters" type="string" minOccurs="0" maxOccurs="unbounded"/>
<!--
The stacktrace associated with the exception.
Note that this will be omitted unless the "server-stacktrace-enabled" property
is enabled in the server's 100Custom.xml file.
-->
<element name="programmersDetails" type="string"></element>
<!-- Prior responses. Set if a bulk command was used -->
<element name="responses" type="dat:BulkCommandResponses" minOccurs="0"></element>
<element name="errorData" type="tns:ErrorData" minOccurs="0" />
</sequence>
</complexType>
<complexType name="ErrorData">
<sequence>
<element name="code" type="string" />
<element name="data" type="string" minOccurs="0" />
</sequence>
</complexType>
</schema>
| Code | Description |
|---|---|
| 200 OK | Successful completion.
|
| 400 Bad Request | Bad Request
|
| 401 Unauthorized | The caller is not authorized for this request.
|
| 403 Forbidden | The caller is not authorized to perform this operation.
|
| 404 Not Found | The service could not be found.
|
| 406 Not Acceptable | The requested content type or content encoding is not supported. |
| 500 Internal Server Error | Internal Server Error. See the details provided.
|
8.5.7
Parent Topic: Search Definition MetaData By Type Resource