Get an universal work object
get
/crmRestApi/resources/11.13.18.05/universalWorkObjects/{WorkId}
Request
Path Parameters
-
WorkId(required): integer(int64)
The unique identifier of the universal work object.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : universalWorkObjects-item-response
Type:
Show Source
object-
AccountPartyId: integer
(int64)
Title:
Account Party IDThe unique identifier of the account party associated with the work object. -
AccountPartyUniqueName: string
Title:
AccountMaximum Length:900The unique name to identify the account. -
AgentSkipList: string
Title:
Skip ListMaximum Length:2000A comma separated list of agents unique identifiers to which this work object should not be offered. -
AppClassification: string
Title:
Application ClassificationMaximum Length:30The application classification associated to the work object such as SALES or SERVICE. -
AssigneeResourceId: integer
(int64)
Title:
Assignee Resource IDThe identifier of the resource assigned to this work object. -
BuOrgId: integer
(int64)
Title:
Business Unit IDThe unique identifier of the Business Unit Organization associated with this work object. Reserved for future use. -
CategoryId: integer
(int64)
Title:
Category IDThe unique identifier of the category to the work request. -
CategoryName: string
Title:
Category NameRead Only:trueMaximum Length:255The name of the category associated with the work object. -
ChannelId: integer
(int64)
Title:
Channel IDThe unique identifier of the channel associated to the work object. -
ChannelTypeCd: string
Title:
ChannelMaximum Length:30The code indicating the channel type. For example, email, phone, social, and so on. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_TYPE_CD. -
ContactEmailAddr: string
Title:
Contact Email AddressMaximum Length:320The contact email address as sent from the channel. -
ContactFirstName: string
Title:
Contact First NameMaximum Length:150The first name of the contact as sent from the channel. -
ContactLastName: string
Title:
Contact Last NameMaximum Length:100The last name of the contact as sent from the channel. -
ContactPartyId: integer
(int64)
Title:
Contact Party IDThe unique identifier of the contact party associated with the work object. -
ContextObjectAssigneeId: integer
(int64)
Title:
Context Object Assignee IDThe assignee unique identifier of the business object that adds context to the work object. -
ContextObjectId: integer
(int64)
Title:
Context Object IDThe unique identifier of a business object that adds context to the work object. -
ContextObjectName: string
Title:
Context Object NameMaximum Length:64The visible user name of the business object that adds context to the work object. -
ContextObjectSeverityCd: string
Title:
Context Severity CodeMaximum Length:30The severity code of the business object that adds context to the work object. -
ContextObjectType: string
Title:
Context Object TypeMaximum Length:30The business object type that adds context to the work object. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the universal work object. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the universal work object was created. -
DeleteFlag: boolean
Read Only:
trueDefault Value:falseIndicates whether the universal work object can be deleted. -
EscalationLevel: integer
(int64)
Title:
Escalation LevelThe level to which the work object has been escalated to. The default value is 0, which means no escalation. -
InteractionId: integer
(int64)
Title:
Interaction IDThe unique identifier of the interaction associated to this work object. -
InventoryItemId: integer
(int64)
Title:
Inventory Item IDThe unique identifier of the product associated with the work object. -
InventoryOrgId: integer
(int64)
Title:
Inventory Organization IDThe unique identifier of the organization of the product that is associated work object. -
LanguageCd: string
Title:
Language CodeMaximum Length:30The lookup code that indicates customer preferred language for this work object. -
LastAssignmentDate: string
(date-time)
Title:
Last Assignment DateThe last time this request was offered to an agent. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date and time when the universal work object was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the universal work object. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the universal work object. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ObjectId: number
Title:
Object IDThe unique identifier of the business object or client channel instance id associated with this request. -
ObjectStatus: string
Title:
Object StatusMaximum Length:100The status of the business object that adds context to the work object. -
ObjectTypeCd: string
Title:
Object TypeMaximum Length:30The type of the Business Object if set. For example SVC_SERVICE_REQUESTS. -
PreferredResources: string
(byte)
Title:
Preferred ResourcesA comma separated list of agents unique identifiers that would be preferred to be assigned to the work object. -
Priority: integer
Title:
PriorityThe priority of the work that needs to be assigned. For example a SR's priority could be calculated based on its severity. -
ProdGroupId: integer
(int64)
Title:
Product Group IDThe unique identifier of the product group associated with the work object. -
ProductGroupName: string
Title:
Product GroupRead Only:trueMaximum Length:255The name of the product group associated with the work object. -
ProductItemDescription: string
Title:
Product DescriptionRead Only:trueMaximum Length:255The description of the product associated with the work object. -
ProductItemNumber: string
Title:
Product NumberRead Only:trueMaximum Length:255The alternate key identifier of the product associated with the work object. -
PropertyMap: string
(byte)
Title:
Work Object PropertiesA collection of work object properties as name value pairs in JSON format. -
QueueId: integer
(int64)
Title:
Queue IDThe identifier of the queue that the work object has been assigned to. -
RealtimeFlag: boolean
Title:
Real TimeMaximum Length:1Indicates whether the channel is in real time or not. -
ServiceZoneId: integer
(int64)
Title:
Region IDThe service region unique identifier associated to the work object. -
ServiceZoneName: string
Title:
Service RegionMaximum Length:360The service region name associated to the work object. -
Severity: string
Maximum Length:
30The severity code of the work that needs to be assigned. -
SocialChannelId: string
Title:
Social Channel IDMaximum Length:400The social channel identifier associated to the work object. -
SocialChannelName: string
Title:
Social Channel NameMaximum Length:400The social channel name associated to the work object. -
SocialChannelTypeCd: string
Title:
Social Channel TypeMaximum Length:30The social channel type associated to the work object. -
StatusCd: string
Title:
Status CodeMaximum Length:30The status of the work object assignment. -
StripeCd: string
Title:
Stripe CodeMaximum Length:30The lookup code that indicates the stripe code, such as CRM, HCM, or PRM. -
UpdateFlag: boolean
Read Only:
trueIndicates whether the universal work object can be updated. -
VisitorBrowserHistSessId: string
Title:
Visitor's Browser History IDMaximum Length:100The unique identifier of the browser history that provides insight into the end-user's page visits. -
WoName: string
Title:
Reference IDMaximum Length:64The user visible name of the object associated with the work object. -
WorkId: integer
(int64)
Title:
Work IDRead Only:trueThe unique identifier of the universal work object. -
WoTitle: string
Title:
TitleMaximum Length:400The user visible title of the object associated with the work object. -
WoTypeName: string
Title:
Work Object TypeMaximum Length:30The user visible name for the type of work associated with the work object.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Examples
The following example shows how to get an universal work object by submitting a GET request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X GET
https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/universalWorkObjects/{WorkId}
Example of Response Body
The following shows an example of the response body in JSON format.
{
"WorkId": 300100122471265,
"CreationDate": "2017-08-23T09:11:17+00:00",
"CreatedBy": "bi_csmgr11",
"LastUpdateDate": "2017-08-23T09:11:21+00:00",
"LastUpdatedBy": "anonymous",
"LastUpdateLogin": "5769182D74A037C4E0534180F50ABC7E",
"Priority": 1,
"ChannelId": null,
"ChannelTypeCd": "ORA_SVC_NONE",
"RealtimeFlag": false,
"InteractionId": null,
"AccountPartyId": null,
"ContactPartyId": null,
"ContactFirstName": null,
"ContactLastName": null,
"ContactEmailAddr": null,
"AppClassification": null,
"ObjectId": 300100122471257,
"ObjectTypeCd": "SVC_SERVICE_REQUESTS",
"StripeCd": "ORA_SVC_CRM",
"ProdGroupId": null,
"InventoryItemId": null,
"InventoryOrgId": 0,
"CategoryId": null,
"LanguageCd": null,
"QueueId": 100100053060507,
"AssigneeResourceId": null,
"LastAssignmentDate": null,
"AgentSkipList": null,
"StatusCd": "SVC_ROUTING_IN_PROGRESS",
"ProductGroupName": null,
"ProductItemDescription": null,
"AccountPartyUniqueName": null,
"ProductItemNumber": null,
"CategoryName": null,
"WoName": "SR0000011001",
"WoTitle": "Respond Flag-N- Child Message",
"WoTypeName": "Service Request",
"ContextObjectId": null,
"ContextObjectName": null,
"ContextObjectType": null,
"ContextObjectAssigneeId": null,
"BuOrgId": 204,
"Severity": null,
"UpdateFlag": true,
"DeleteFlag": false,
"SocialChannelId": null,
"SocialChannelName": null,
"SocialChannelTypeCd": null,
"ServiceZoneId": null,
"ServiceZoneName": null,
"ContextObjectSeverityCd": null,
"VisitorBrowserHistSessId": null,
"EscalationLevel": 0,
"ObjectStatus": null,
"links": [
{
"rel": "self",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/universalWorkObjects/300100122471265",
"name": "universalWorkObjects",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
}
},
{
"rel": "canonical",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/universalWorkObjects/300100122471265",
"name": "universalWorkObjects",
"kind": "item"
},
{
"rel": "enclosure",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/universalWorkObjects/300100122471265/enclosure/PropertyMap",
"name": "PropertyMap",
"kind": "other"
},
{
"rel": "enclosure",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/universalWorkObjects/300100122471265/enclosure/PreferredResources",
"name": "PreferredResources",
"kind": "other"
}
]
}