Get all universal work objects

get

/crmRestApi/resources/11.13.18.05/universalWorkObjects

Request

Query Parameters
  • 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).
  • 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
  • Used as a predefined finder to search the collection.

    Format: ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables:

    • PrimaryKey: Finds an universal work object with the specified primary key.
      Finder Variables:
      • WorkId; integer; The unique identifier of universal work objects.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • 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
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AccountPartyId; integer; The unique identifier of the account party associated with the work object.
    • AccountPartyUniqueName; string; The unique name to identify the account.
    • AgentSkipList; string; A comma separated list of agents unique identifiers to which this work object should not be offered.
    • AppClassification; string; The application classification associated to the work object such as SALES or SERVICE.
    • AssigneeResourceId; integer; The identifier of the resource assigned to this work object.
    • BuOrgId; integer; The unique identifier of the Business Unit Organization associated with this work object. Reserved for future use.
    • CategoryId; integer; The unique identifier of the category to the work request.
    • CategoryName; string; The name of the category associated with the work object.
    • ChannelId; integer; The unique identifier of the channel associated to the work object.
    • ChannelTypeCd; string; The 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; The contact email address as sent from the channel.
    • ContactFirstName; string; The first name of the contact as sent from the channel.
    • ContactLastName; string; The last name of the contact as sent from the channel.
    • ContactPartyId; integer; The unique identifier of the contact party associated with the work object.
    • ContextObjectAssigneeId; integer; The assignee unique identifier of the business object that adds context to the work object.
    • ContextObjectId; integer; The unique identifier of a business object that adds context to the work object.
    • ContextObjectName; string; The visible user name of the business object that adds context to the work object.
    • ContextObjectSeverityCd; string; The severity code of the business object that adds context to the work object.
    • ContextObjectType; string; The business object type that adds context to the work object.
    • CreatedBy; string; The user who created the universal work object.
    • CreationDate; string; The date and time when the universal work object was created.
    • EscalationLevel; integer; The level to which the work object has been escalated to. The default value is 0, which means no escalation.
    • InteractionId; integer; The unique identifier of the interaction associated to this work object.
    • InventoryItemId; integer; The unique identifier of the product associated with the work object.
    • InventoryOrgId; integer; The unique identifier of the organization of the product that is associated work object.
    • LanguageCd; string; The lookup code that indicates customer preferred language for this work object.
    • LastAssignmentDate; string; The last time this request was offered to an agent.
    • LastUpdateDate; string; The date and time when the universal work object was last updated.
    • LastUpdateLogin; string; The login of the user who last updated the universal work object.
    • LastUpdatedBy; string; The user who last updated the universal work object.
    • ObjectId; number; The unique identifier of the business object or client channel instance id associated with this request.
    • ObjectStatus; string; The status of the business object that adds context to the work object.
    • ObjectTypeCd; string; The type of the Business Object if set. For example SVC_SERVICE_REQUESTS.
    • Priority; integer; The priority of the work that needs to be assigned. For example a SR's priority could be calculated based on its severity.
    • ProdGroupId; integer; The unique identifier of the product group associated with the work object.
    • ProductGroupName; string; The name of the product group associated with the work object.
    • ProductItemDescription; string; The description of the product associated with the work object.
    • ProductItemNumber; string; The alternate key identifier of the product associated with the work object.
    • QueueId; integer; The identifier of the queue that the work object has been assigned to.
    • RealtimeFlag; boolean; Indicates whether the channel is in real time or not.
    • ServiceZoneId; integer; The service region unique identifier associated to the work object.
    • ServiceZoneName; string; The service region name associated to the work object.
    • Severity; string; The severity code of the work that needs to be assigned.
    • SocialChannelId; string; The social channel identifier associated to the work object.
    • SocialChannelName; string; The social channel name associated to the work object.
    • SocialChannelTypeCd; string; The social channel type associated to the work object.
    • StatusCd; string; The status of the work object assignment.
    • StripeCd; string; The lookup code that indicates the stripe code, such as CRM, HCM, or PRM.
    • VisitorBrowserHistSessId; string; The unique identifier of the browser history that provides insight into the end-user's page visits.
    • WoName; string; The user visible name of the object associated with the work object.
    • WoTitle; string; The user visible title of the object associated with the work object.
    • WoTypeName; string; The user visible name for the type of work associated with the work object.
    • WorkId; integer; The unique identifier of the universal work object.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
  • 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".
  • 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 Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : universalWorkObjects
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : universalWorkObjects-item-response
Type: object
Show Source
  • Title: Account Party ID
    The unique identifier of the account party associated with the work object.
  • Title: Account
    Maximum Length: 900
    The unique name to identify the account.
  • Title: Skip List
    Maximum Length: 2000
    A comma separated list of agents unique identifiers to which this work object should not be offered.
  • Title: Application Classification
    Maximum Length: 30
    The application classification associated to the work object such as SALES or SERVICE.
  • Title: Assignee Resource ID
    The identifier of the resource assigned to this work object.
  • Title: Business Unit ID
    The unique identifier of the Business Unit Organization associated with this work object. Reserved for future use.
  • Title: Category ID
    The unique identifier of the category to the work request.
  • Title: Category Name
    Read Only: true
    Maximum Length: 255
    The name of the category associated with the work object.
  • Title: Channel ID
    The unique identifier of the channel associated to the work object.
  • Title: Channel
    Maximum Length: 30
    The 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.
  • Title: Contact Email Address
    Maximum Length: 320
    The contact email address as sent from the channel.
  • Title: Contact First Name
    Maximum Length: 150
    The first name of the contact as sent from the channel.
  • Title: Contact Last Name
    Maximum Length: 100
    The last name of the contact as sent from the channel.
  • Title: Contact Party ID
    The unique identifier of the contact party associated with the work object.
  • Title: Context Object Assignee ID
    The assignee unique identifier of the business object that adds context to the work object.
  • Title: Context Object ID
    The unique identifier of a business object that adds context to the work object.
  • Title: Context Object Name
    Maximum Length: 64
    The visible user name of the business object that adds context to the work object.
  • Title: Context Severity Code
    Maximum Length: 30
    The severity code of the business object that adds context to the work object.
  • Title: Context Object Type
    Maximum Length: 30
    The business object type that adds context to the work object.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the universal work object.
  • Title: Creation Date
    Read Only: true
    The date and time when the universal work object was created.
  • Read Only: true
    Default Value: false
    Indicates whether the universal work object can be deleted.
  • Title: Escalation Level
    The level to which the work object has been escalated to. The default value is 0, which means no escalation.
  • Title: Interaction ID
    The unique identifier of the interaction associated to this work object.
  • Title: Inventory Item ID
    The unique identifier of the product associated with the work object.
  • Title: Inventory Organization ID
    The unique identifier of the organization of the product that is associated work object.
  • Title: Language Code
    Maximum Length: 30
    The lookup code that indicates customer preferred language for this work object.
  • Title: Last Assignment Date
    The last time this request was offered to an agent.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the universal work object was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the universal work object.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the universal work object.
  • Links
  • Title: Object ID
    The unique identifier of the business object or client channel instance id associated with this request.
  • Title: Object Status
    Maximum Length: 100
    The status of the business object that adds context to the work object.
  • Title: Object Type
    Maximum Length: 30
    The type of the Business Object if set. For example SVC_SERVICE_REQUESTS.
  • Title: Preferred Resources
    A comma separated list of agents unique identifiers that would be preferred to be assigned to the work object.
  • Title: Priority
    The priority of the work that needs to be assigned. For example a SR's priority could be calculated based on its severity.
  • Title: Product Group ID
    The unique identifier of the product group associated with the work object.
  • Title: Product Group
    Read Only: true
    Maximum Length: 255
    The name of the product group associated with the work object.
  • Title: Product Description
    Read Only: true
    Maximum Length: 255
    The description of the product associated with the work object.
  • Title: Product Number
    Read Only: true
    Maximum Length: 255
    The alternate key identifier of the product associated with the work object.
  • Title: Work Object Properties
    A collection of work object properties as name value pairs in JSON format.
  • Title: Queue ID
    The identifier of the queue that the work object has been assigned to.
  • Title: Real Time
    Maximum Length: 1
    Indicates whether the channel is in real time or not.
  • Title: Region ID
    The service region unique identifier associated to the work object.
  • Title: Service Region
    Maximum Length: 360
    The service region name associated to the work object.
  • Maximum Length: 30
    The severity code of the work that needs to be assigned.
  • Title: Social Channel ID
    Maximum Length: 400
    The social channel identifier associated to the work object.
  • Title: Social Channel Name
    Maximum Length: 400
    The social channel name associated to the work object.
  • Title: Social Channel Type
    Maximum Length: 30
    The social channel type associated to the work object.
  • Title: Status Code
    Maximum Length: 30
    The status of the work object assignment.
  • Title: Stripe Code
    Maximum Length: 30
    The lookup code that indicates the stripe code, such as CRM, HCM, or PRM.
  • Read Only: true
    Indicates whether the universal work object can be updated.
  • Title: Visitor's Browser History ID
    Maximum Length: 100
    The unique identifier of the browser history that provides insight into the end-user's page visits.
  • Title: Reference ID
    Maximum Length: 64
    The user visible name of the object associated with the work object.
  • Title: Work ID
    Read Only: true
    The unique identifier of the universal work object.
  • Title: Title
    Maximum Length: 400
    The user visible title of the object associated with the work object.
  • Title: Work Object Type
    Maximum Length: 30
    The user visible name for the type of work associated with the work object.
Back to Top