GET /rest/bpm/federated/v1/searches/transfer
None
None
The default content type is application/json.
{ "description": "Saved Search Transfer List ",
"type": "object",
"properties":
{
"results" : [
"importName" : {
"description": "The name that will be assigned to saved search at import time",
"required":true,
"type" : "string"
},
"savedSearch" :
{
"id" : {
"description": " The ID of this Saved Search - This is a system generated ID and will be returned in the response.
When doing the following functions the 'id' will be handled differently
Create: The ID must be omitted when creating a saved search definition.
Update: If supplied in the incoming payload it must match the id of the saved search definition being updated.
Ad hoc execution: If supplied in the incoming payload it will be ignored.",
"required":false,
"type" : "integer"
},
"name" : {
"description": " The name of this Saved Search. The name will be checked with the following rules
* An 'owner' may only own one saved search with the name(shared or not shared)
* There may only be one saved search shared with the name
* Saved searches that are not shared may have the same name if they have different owners
* Must not be a number (to avoid name/id conflicts)",
"required":true,
"type" : "string"
},
"owner" : {
"description": " The owner of this Saved Search - This will be assigned by the system to the current logged in user's
unique user ID. When included it must be the unique security name. With many user registries, this is
the user's distinguished name (dn, sometimes referred to as the long name).
Only saved search administrators (users with the action role ACTION_ADMINISTER_SHARED_SAVED_SEARCHES)
can create a saved search using another user's ID
see the following to get the list of action roles for the current user
/rest/bpm/federated/v1/searches/actions",
"required":false,
"type" : "string"
},
"shared" : {
"description": " Should this Saved Search be shared with others, Default is false.
Only users with the action role ACTION_CREATE_SHARED_SAVED_SEARCH
can create a shared saved search.
see the following to get the list of action roles for the current user
/rest/bpm/federated/v1/searches/actions",
"required":false,
"type" : "boolean"
},
"fields" : {
"description": " The list of fields to include in this Saved Search",
"required":false,
"type" : "[string]"
},
"aliases": {
"type": "array",
"description": "The aliases for business data fields of a saved search.",
"required":false,
"properties" : {
"field": {
"type": "string",
"description": "The business data field the alias is for."
},
"processName": {
"type": "string",
"required": false,
"description": "The name of the process for which this alias is defined (optional)."
},
"snapshotId": {
"type": "string",
"required": false,
"description": "The snapshot id for which this alias is defined (optional)."
},
"alias": {
"type": "string",
"description": "The alias for the field."
}
}
},
"organization": {
"description": "Organization of the tasks, Only allowed value is 'byTask'. Default is 'byTask'.",
"enum":
[
"byTask"
],
"required":false,
"type": "string"
},
"interaction": {
"description": "Interaction filter for this search to limit the data based on task state. May be overridden by the 'interaction' query parameter
'claimed' This implies the retrieval of tasks which are already claimed by the current user. Tasks contained in suspended process instances are excluded.
'available' This implies the retrieval of tasks which can be claimed by the current user. Tasks contained in suspended process instances are excluded.
'claimed_and_available' This implies the retrieval of tasks as implied by the claimed or available filter values.
'completed' This implies the retrieval of completed tasks which are claimed by the current user.
'all' This implies the retrieval of tasks for which the current user is allowed to see.",
"enum":
[
"claimed",
"available",
"claimed_and_available",
"completed",
"all"
],
"required":false,
"type": "string"
},
"size" : {
"description": " The number of tasks to be returned when this Saved Search runs.
May be overridden by the 'size' query parameter.
When used with 'offset' query parameter provides the paging function.
Will default to 25 during execution if this saved search did not
specify and the query parameter size was also not specified. ",
"required":false,
"type" : "integer"
},
"sort": {
"description": "Field name to sort on. Only federated system indexes will be included in the task query that have
at least one task indexed with this field. May be overridden by the 'sort' query parameter.
Will default to taskDueDate and taskPriority if this saved search did not specify and the query parameter
sort was also not specified.
see the following to get the lists of fields
/rest/bpm/federated/v1/searches/tasks/meta/constraintFields
/rest/bpm/federated/v1/searches/tasks/meta/businessDataFields"
},
"required":false,
"type" : "[object]",
"object" : {
"field": {
"description" : "The name of the field to sort on.",
"type": "string",
"required" : true
},
"order": {
"type": "string",
"description": "Ordering for this field - ascending or descending.",
"enum":
[
"ASC",
"DESC"
]
}
},
"conditions": {
"description" : "The conditions that will be converted into query filters to run on the search engine.
These conditions are added together to produce a list of tasks.",
"required" : false,
"type" : "[object]",
"object" : {
"field": {
"type": "string",
"description": "Field name to filter on. May be omitted when operator is 'FullTextSearch' to imply that all
fields should be searched.
see the following to get the lists of fields
/rest/bpm/federated/v1/searches/tasks/meta/constraintFields
/rest/bpm/federated/v1/searches/tasks/meta/businessDataFields",
"required" : false
},
"operator": {
"type": "string",
"description": "Operation to perform between the stated field and the stated value.
Will default to 'Equals' if omitted.",
"enum":
[
"Equals",
"NotEquals",
"Contains",
"StartsWith",
"LessThan",
"GreaterThan",
"FullTextSearch"
]
},
"value": {
"type": "string",
"description": "Value to be compared against the actual field value. With 'FullTextSearch' the value may be multiple
words and may contain wildcards (*,?,~). 'FullTextSearch' operator is only allowed for constraint fields
where the full_text_search attribute is true (searchable strings)
see the following to get the lists of fields with attributes
/rest/bpm/federated/v1/searches/tasks/meta/constraintFields
/rest/bpm/federated/v1/searches/tasks/meta/businessDataFields",
}
}
}
}
]
}
}
{
"results": [
{
"importName": "my_bpm_saved_search_1",
"savedSearch": {
"conditions": [],
"id": "1006",
"shared": false,
"organization": "byTask",
"sort": [
{
"field": "taskDueDate",
"order": "ASC"
}
],
"name": "my_bpm_saved_search_1",
"owner": "uid=admin,o=defaultWIMFileBasedRealm",
"interaction": "completed",
"aliases": [],
"fields": [
"taskSubject",
"instanceName",
"taskStatus",
"taskPriority",
"rfc@String",
"GMApproval@Boolean",
"HiringManager@String",
"taskDueDate"
],
"size": 10000
}
},
{
"importName": "my_bpm_saved_search_2",
"savedSearch": {
"conditions": [],
"id": "1004",
"shared": true,
"organization": "byTask",
"sort": [
{
"field": "taskDueDate",
"order": "ASC"
}
],
"name": "my_bpm_saved_search_2",
"owner": "uid=admin,o=defaultWIMFileBasedRealm",
"interaction": "claimed_and_available",
"aliases": [],
"fields": [
"taskSubject",
"instanceName",
"taskStatus",
"taskPriority",
"GMApproval@Boolean",
"EmploymentStatus@String",
"RequisitionNumber@String",
"taskDueDate"
],
"size": 10000,
}
},
],
"status": 200
}
| Code | Description |
|---|---|
| 200 OK | The request completed successfully. |
| 401 Unauthorized | The caller is not authorized for this request. |
| 403 Forbidden | The caller is not allowed to complete this request. |
| 404 Not Found | The resource does not exist. |
| 406 Not Acceptable | The requested content type or content encoding is not supported. |
| 500 Internal Server Error | A severe problem occurred. |
| 503 Service Unavailable | The federated request could not be delivered to individual federation targets. |
| 504 Gateway Timeout | The federated response has partial content because of missing individual responses. |
8.6.0
Parent Topic: Saved Search Transfer Import / Export Resource