Get all service requests

get

/crmRestApi/resources/11.13.18.05/hrHelpDeskRequests

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:

    • MyCriticalSRsFinder :Finds critical service requests assigned to a user.
      Finder Variables:
      • AssigneeResourceId :The unique identifier of the assignee resource.
    • MySRsByStatusFinder :Finds a service requests with a specific status that are assigned to a user.
      Finder Variables:
      • AssigneeResourceId :The unique identifier of the assignee resource.
      • StatusCd :The status code of the service request.
    • MySRsFinder :Finds a service requests assigned to the user.
      Finder Variables:
      • AssigneeResourceId :The unique identifier of the assignee resource.
    • PrimaryKey :Finds a service request with the specified primary key.
      Finder Variables:
      • SrId :The unique identifier of the service request.
    • SRListMySRTeamSRsFinder :Finds service requests for the team.
      Finder Variables:
      • SRsCreatedByMeFinder :Find a service request created by a user.
        Finder Variables:
        • CreatedBy :The user who created the service request.
      • SRsListByResource :Finds a service requests by resource ID.
        Finder Variables:
        • ResourceId :The resource ID passed as parameter to the service request finder service.
      • ServiceRequestByNumber :Finds a service request by SR number.
        Finder Variables:
        • SrNumber :The service request number passed as parameter to the finder service.
      • ServiceRequestByStripeCd :Finds a service requests by stripe code.
        Finder Variables:
        • StripeCd :The stripe code passed as parameter to the service request finder service.
    • 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:
      • AffectedPartyAssignmentNumber; string; The unique assignment number of the affected party person for the service request.
      • AffectedPartyPersonName; string; The display name of the affected party person in the service request.
      • AssigneePersonName; string; The email address of the assignee.
      • AssigneeResourceId; integer; The unique identifier of the assignee resource.
      • AssigneeResourceNumber; string; The alternative key for the resource identifier of the assignee.
      • BUOrgId; integer; The unique identifier of the business unit associated to the service request.
      • CategoryCode; string; Indicates the alternate key of the category associated to the service request.
      • CategoryId; integer; The unique identifier of the service request category.
      • CategoryName; string; The name of the category associated to the service request.
      • ChannelTypeCd; string; The channel type.
      • ChannelTypeCdMeaning; string; The display value corresponding to the channel type lookup code for the service request.
      • ClosedDate; string; The date when the service request was closed, if closed.
      • ComplianceFlag; boolean; The compliance status of the milestone.
      • CreatedBy; string; The user who created the service request.
      • CreationDate; string; The date and time when the service request was created.
      • CriticalFlag; boolean; Indicates whether the service request is critical. If critical, the value is Y, else the value is N.
      • DueDate; string; The date when the milestone is due.
      • FirstTransferDate; string; The date when the service request was first transferred.
      • HeaderFlag; boolean; Indicates whether the current milestone should be saved on the service request header.
      • InternalPriorityCd; string; The internal priority of the service request.
      • InventoryItemId; integer; The unique identifier of the product associated to the service request.
      • InventoryOrgId; integer; The unique identifier of the organization of the product that's associated with the service request.
      • LanguageCd; string; The customer's preferred language for the service request.
      • LastReopenDate; string; The date and time when the service request was last reopened.
      • LastResolvedDate; string; The date and time when the service request was resolved.
      • LastTransferDate; string; Indicates the date and time of the last transfer of the service request.
      • LastTransferredBy; string; The user who last transferred the service request.
      • LastUpdateDate; string; The date and time when the service request was last updated.
      • LastUpdatedBy; string; The user who last updated the service request.
      • LastUpdatedByDisplayName; string; The display name of the user who last updated the service request.
      • LastUpdatedByEmailAddress; string; The e-mail address of the person who last updated the service request.
      • LastUpdatedByPartyId; integer; The unique party identifier of the person who last updated the service request.
      • MilestoneConfigId; integer; The unique identifier of the milestone configuration associated with the service request.
      • MilestoneLabel; string; The name of the milestone.
      • MilestoneStatusCd; string; The status of the milestone.
      • OpenDate; string; The date when the service request was reported by the customer.
      • OriginalSystemReference; string; The reference to the service request record in the original system from which service request was imported.
      • PrimaryContactAssignmentNumber; string; The unique assignment number of the primary contact of the service request.
      • PrimaryContactDoNotContactFlag; boolean; The primary contact of the service request doesn't want to be contacted.
      • PrimaryContactPartyId; integer; The unique identifier of the primary contact of the service request.
      • PrimaryContactPartyName; string; The name of the service request primary contact.
      • PrimaryContactPartyNumber; string; The alternative key for the primary contact identifier.
      • PrimaryContactPersonId; integer; The unique identifier of the primary contact of the service request.
      • PrimaryContactPersonIdTransient; string; The unique identifier of the primary contact of the service request.
      • PrimaryContactPreferredContactMethod; string; The preferred contact method of the primary contact of the service request.
      • ProblemCd; string; The problem code of the service request.
      • ProblemDescription; string; The service request's problem description or statement and the steps to reproduce the issue.
      • ProdGroupName; string; The name of the product group associated to the service request.
      • ProductGroupReferenceNumber; string; The alternative key for the product group identifier.
      • ProductItemDescription; string; The description of the product associated with the service request.
      • ProductItemNumber; string; The product number or code of the product associated with the service request.
      • QueueId; integer; The unique identifier of the queue to which the service request is assigned.
      • QueueName; string; The name of the queue associated to the service request.
      • QueueNumber; string; The alternative key for the queue identifier.
      • RecordSet; string; The record set used by REST API to run saved searches.
      • ReportedByEmailAddress; string; The e-mail address of the person who reported the service request.
      • ReportedByPartyId; integer; The user who created the request.
      • ReportedByPartyName; string; The name of the reported party.
      • ReportedByPartyNumber; string; The alternative key for the party identifier of the person reporting the service request.
      • ReportedByPartyUniqueName; string; The unique name of the user who created the service request.
      • ResolutionCd; string; The resolution code of the service request.
      • ResolutionCdMeaning; string; The display value corresponding to the resolution lookup code for the service request.
      • ResolveDescription; string; The description of how the service request has been resolved.
      • ResolveOutcomeCd; string; The outcome of a service request resolution.
      • ResolveOutcomeCdMeaning; string; The display value corresponding to the resolution outcome lookup code for the service request.
      • ResolvedBy; string; The user who resolved the service request.
      • ServiceZoneId; integer; The unique identifier of the service request region.
      • ServiceZoneName; string; The name of the service request region.
      • SeverityCd; string; The severity of the service request.
      • SeverityCdMeaning; string; The display value corresponding to the severity lookup code for the service request.
      • SeverityCdTransient; string; The severity of the service request.
      • SeverityRank; integer; The numeric code of the service request severity.
      • SourceCd; string; Indicates how the service request was created in the application.
      • SrId; integer; The unique identifier of the service request record.
      • SrMilestoneId; integer; The unique identifier of the milestone associated to the service request.
      • SrNumber; string; The unique number that's used to identify a service request. You can edit the service request number to a format that's best suitable to your organizational requirements.
      • StatusCd; string; The status code of the service request.
      • StatusCdMeaning; string; The display value corresponding to the status lookup code for the service request.
      • StatusTypeCd; string; The status type of the service request.
      • StatusTypeCdMeaning; string; The display value corresponding to the status type lookup code for the service request.
      • StripeCd; string; The application stripe of the service request.
      • SurveyResponseDate; string; The date and time when the response to this survey was submitted.
      • SurveySentDate; string; The date and time when survey was last sent for this service request.
      • TimeRemaining; string; The time remaining in the milestone.
      • TimezoneCode; string; The service request time zone optionally used for computing the milestone due date.
      • Title; string; The brief title of the service request.
      • TransferCount; integer; The count showing how many times a service request has been transferred.
      • TransferNote; string; This field contains information about transfer note.
      • TransferReasonCd; string; The lookup code that indicates the transfer reason.
      • UniqueExternalSystemReference; string; The unique alternative identifier of the service request in the original reference system. You can this column to store the identifier of the service request in the external application you're integrating with.
      • WarnedFlag; boolean; Indicates whether the milestone passed the warning threshold.
    • 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 : hrHelpDeskRequests
    Type: object
    Show Source
    Nested Schema : Items
    Type: array
    Title: Items
    The items in the collection.
    Show Source
    Nested Schema : hrHelpDeskRequests-item-response
    Type: object
    Show Source
    Nested Schema : Activities
    Type: array
    Title: Activities
    The activities resource is used to view, create, update, and delete an activity.
    Show Source
    Nested Schema : Attachments
    Type: array
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
    Show Source
    Nested Schema : Service Request Message Communications
    Type: array
    Title: Service Request Message Communications
    The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
    Show Source
    Nested Schema : Contact Members
    Type: array
    Title: Contact Members
    The list of contacts associated to the serivce request.
    Show Source
    Nested Schema : Messages
    Type: array
    Title: Messages
    The list of service request messages.
    Show Source
    Nested Schema : Resources
    Type: array
    Title: Resources
    The list of resources associated to the service request.
    Show Source
    Nested Schema : Smart Actions
    Type: array
    Title: Smart Actions
    This VO stores the endpoint and security details for every user action.
    Show Source
    Nested Schema : Interaction References
    Type: array
    Title: Interaction References
    Indicates the list of interaction references for a service request.
    Show Source
    Nested Schema : Milestones
    Type: array
    Title: Milestones
    Indicates the milestone associated with the service request.
    Show Source
    Nested Schema : References
    Type: array
    Title: References
    The list of other objects associated to the service request. E.g. Knowledge articles.
    Show Source
    Nested Schema : Tags
    Type: array
    Title: Tags
    The tags resource is used to create, view, and delete keywords or terms assigned to a service request. Tags help in describing and classifying a service request.
    Show Source
    Nested Schema : hrHelpDeskRequests-activities-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-Attachment-item-response
    Type: object
    Show Source
    Nested Schema : AttachmentsDFFVL
    Type: array
    Show Source
    Nested Schema : Attachments Preview
    Type: array
    Title: Attachments Preview
    The attachments preview resource is used to preview the attachment pages.
    Show Source
    Nested Schema : hrHelpDeskRequests-Attachment-AttachmentsDFFVL-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-Attachment-AttachmentsPreview-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-channelCommunication-item-response
    Type: object
    Show Source
    • Title: Account Name
      Read Only: true
      Maximum Length: 400
      The account name associated with the channel. For example, for email the account name would be the inbound mailbox for support.
    • Title: Display Name
      Maximum Length: 400
      The display name of the channel.
    • Title: Channel ID
      The unique identifier of the channel.
    • Title: Channel Short Name
      Maximum Length: 450
      The public unique identifier of the channel.
    • Title: Channel Type
      Read Only: true
      Maximum Length: 30
      The code indicating the channel type. For example, email or phone. A list of accepted values are defined in the lookup ORA_SVC_CHANNEL_TYPE_CD.
    • Title: Collaboration ID
      Read Only: true
      Maximum Length: 255
      The unique identifier of the collaboration network user in the corresponding network, such as Slack Id.
    • Title: Resource Name
      Read Only: true
      Maximum Length: 400
      The user name of the external user on the collaboration network.
    • Title: Collaboration Resource Identifier
      The unique identifier of the collaboration network user that the internal users are communicating with.
    • Title: Contact Point ID
      The unique identifier of the contact point record of the contact who's being communicated with. A contact point is a contact's identifier for a specific channel of communication. For example, the contact point for the email channel would be an email address.
    • Title: Created By
      Read Only: true
      Maximum Length: 64
      The user who created the communication channel.
    • Title: Creation Date
      Read Only: true
      The date and time when the communication channel was created.
    • Title: Can Delete
      Read Only: true
      Indicates whether the channel communication has been deleted.
    • Title: Inbound Message Object Identifier
      The unique identifier of the inbound object that resulted in the creation of the service request.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the communication channel was last updated.
    • Title: Updated By
      Read Only: true
      Maximum Length: 64
      The user who last updated the communication channel.
    • Title: Update Login
      Read Only: true
      Maximum Length: 32
      The session login associated to the user who last updated the communication channel.
    • Links
    • Title: Network
      Read Only: true
      Maximum Length: 30
      The code indicating the social network of the post. For example, Facebook, Twitter. A list of accepted values is defined in the lookup HZ_INSTANT_MESSENGER_TYPE.
    • Title: Object ID
      The unique identifier of the object. Depending on the object type, indicates the service request Id or the service request message Id associated with the channel communication.
    • Title: Object Type
      Read Only: true
      Maximum Length: 30
      Default Value: SVC_SERVICE_REQUESTS
      The code indicating whether the channel communication record is associated to the service request or the service request message. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_OBJECT_TYPE_CD.
    • Title: Party ID
      The unique party identifier of the person who's being communicated with.
    • Title: Party Name
      Read Only: true
      Maximum Length: 360
      The party name of the person who's being communicated with.
    • Title: Party Number
      Read Only: true
      Maximum Length: 30
      The public unique identifier of the contact associated with the service request communication.
    • Title: Party Endpoint
      Maximum Length: 1000
      The endpoint used to communicate with the customer contact. For example, email address, phone number, and so on. When Party_ID is NULL and PartyViaEndPoint is not NULL, the endpoint belongs to a party.
    • Title: Person ID
      The unique person ID of the contact.
    • Title: Post Identifier
      Maximum Length: 1000
      The unique identifier of the social media post record that was used to create the service request or the service request message.
    • Title: Resource ID
      Read Only: true
      The unique identifier of the resource associated with the service request. This is a foreign key that can identify the collaboration network user the internal users are communicating with.
    • Title: Resource Type
      Read Only: true
      Maximum Length: 30
      The code indicating the type of the collaborative network user, such as USER, PUBLIC_CHANNEL, or PRIVATE_CHANNEL. A list of accepted values is defined in the lookup ORA_SVC_COLLAB_RES_TYPE_CD.
    • Title: Routing Code
      Maximum Length: 30
      The code indicating how the message was routed through the endpoint. For example, if the endpoint is email address the field indicates if the recipient was a TO, a CC, or a BCC recipient.
    • Title: Can Update
      Read Only: true
      Indicates whether the channel communication has been updated.
    • Title: ID
      Read Only: true
      The unique identifier of the service request channel communication record.
    Nested Schema : hrHelpDeskRequests-contacts-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-messages-item-response
    Type: object
    Show Source
    • Attachments
      Title: Attachments
      The attachments resource is used to view, create, and update attachments.
    • Service Request Message Communications
      Title: Service Request Message Communications
      The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
    • Title: Channel
      The unique identifier of the channel.
    • Title: Channel Type
      Maximum Length: 30
      The channel type, such a email, phone, social, and so on.
    • Title: Collaboration Resource
      The unique identifier of the collaboration network user that the internal users are communicating with.
    • Title: Created By
      Read Only: true
      Maximum Length: 64
      The user who created the message.
    • Title: Created by Email ID
      Read Only: true
      Maximum Length: 320
      The email Id of the person who created the service request message.
    • Title: Created by Party ID
      Read Only: true
      Maximum Length: 80
      The unique party identifier of the person who created the service request message.
    • Title: Creation Date
      Read Only: true
      The date and time when the message was created.
    • Title: Can Delete
      Read Only: true
      Indicates whether the user has access to delete the record.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the message was last updated.
    • Title: Last Updated By
      Read Only: true
      Maximum Length: 64
      The user who last updated the message.
    • Title: Last Update Login
      Read Only: true
      Maximum Length: 32
      The login of the user who last updated the message.
    • Links
    • Title: Message Content
      The content of the service request message.
    • Title: Created By
      Maximum Length: 64
      The user who created the message in the original source system. This is applicable if the service request message was imported from another system.
    • Title: Message Expand State
      The message expanding state.
    • Title: Message ID
      The unique identifier of the service request message.
    • Title: Last Updated Date
      The date when the message was last updated in the original source system. This is applicable if the service request message was imported from another system.
    • Title: Last Updated By
      Maximum Length: 64
      The user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
    • Title: Last Update Login
      Maximum Length: 32
      The login of the user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
    • Title: Message Number
      Maximum Length: 30
      The public unique identifier of the service request message.
    • Title: Message Subtype
      Maximum Length: 30
      The service request message subtype.
    • Title: Message Type Code
      Maximum Length: 30
      The message type. The accepted values are Response, Customer Entry, System Note, System Response, and Internal Note.
    • Title: Network
      Read Only: true
      Maximum Length: 30
      The type of social network.
    • Title: Notification Processing Status Code
      Maximum Length: 30
      The notification processing status code.
    • Title: Notification Retry Count
      The notification retry count.
    • Title: Object ID
      The unique identifier of the object.
    • Title: Object Type Code
      Maximum Length: 30
      Default Value: SVC_SR_MESSAGES
      The code indicating whether the channel communication record is associated to the service request or the service request message. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_OBJECT_TYPE_CD.
    • Title: Original System
      Maximum Length: 255
      The unique identifier of the message record in the original source system from where the message was imported. This is applicable if the service request message was imported from another system.
    • Title: Origination Date
      The date the message was created in the original source system. This is applicable if the service request message was imported from another system.
    • Title: Parent Message ID
      The unique identifier of the parent message.
    • Title: Posted By
      Read Only: true
      Maximum Length: 360
      The party name of the user who posted the message. The user can be an internal resource or a customer contact.
    • Title: Posted by ID
      The unique identifier of the user who the posted the message. The user can be an internal resource or a customer contact.
    • Title: Posted by Party Number
      Read Only: true
      Maximum Length: 30
      The alternative key for the party identifier of the person posting the service request message.
    • Title: Contains PII Data
      Maximum Length: 1
      Indicates whether the message contains personally identifiable information.
    • Title: Processing ID
      Read Only: true
      The unique identifier of the processing.
    • Title: Processing Status
      Maximum Length: 30
      Default Value: ORA_SVC_READY
      The processing status of the message. The accepted values are Ready, Processing, Error, and Success.
    • Title: Reply to Message ID
      Read Only: true
      The unique identifier of the customer message to which the agent is replying to.
    • Title: Rich Text
      Maximum Length: 1
      Default Value: true
      Indicates whether the message content is in rich text format. If the format is rich text, then the value is Y, else the value is N.
    • Title: Root Message Identifier
      Read Only: true
      The identifier of the root message in the message hierarchy.
    • Title: Root Message Thread Count
      Read Only: true
      The number of messages under a root message in a service request.
    • Title: Root Message Thread Last Updated Date
      Read Only: true
      The last updated date for all messages under the root message in a service request.
    • Title: Root Thread Message Last Updated Date
      Read Only: true
      The date when all messages under the root message in a service request were last updated.
    • Title: Sent Date
      The date and time when the message was sent.
    • Title: Private Message
      Maximum Length: 1
      Indicates whether the service request was created from a private social post.
    • Title: Source Code
      Maximum Length: 30
      The source of the message.
    • Title: Service Request Business Unit
      Read Only: true
      The identifier of the business unit associated with the service request.
    • Title: Service Request ID
      The unique identifier of the service request to which the message is associated.
    • Title: Inline Attachment Identifiers
      Maximum Length: 1000
      The list of inline attachment identifiers associated with the service request
    • Title: Service Request Number
      Maximum Length: 30
      The alternative key for the service request number.
    • Title: Service Request Application Stripe
      Read Only: true
      Maximum Length: 30
      The application stripe of the service request.
    • Title: Status Code
      Maximum Length: 30
      The status of the message. The accepted values are Draft, Committed, and Corrected.
    • Title: Subject
      Maximum Length: 1000
      The subject of the service request message.
    • Title: Template Name
      Maximum Length: 240
      The name of the template that's used for outbound communication of the message.
    • Title: Thread Count
      Read Only: true
      The number of threads in a service request message.
    • Title: Thread Hierarchy Level
      Read Only: true
      The thread hierarchy level.
    • Title: Thread Identifier
      Read Only: true
      The unique identifier of the service request message thread.
    • Title: Thread Last Updated Date
      Read Only: true
      The date when the thread was last updated.
    • Title: Thread Message Last Updated Date
      Read Only: true
      The date when the thread message was last updated.
    • Title: Can Update
      Read Only: true
      Indicates whether the user has access to update the record.
    • Title: Visibility Code
      Maximum Length: 30
      The privacy level of the message. The accepted values are Internal and External. Null value indicates that the message is External.
    Nested Schema : Attachments
    Type: array
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
    Show Source
    Nested Schema : Service Request Message Communications
    Type: array
    Title: Service Request Message Communications
    The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
    Show Source
    Nested Schema : hrHelpDeskRequests-messages-Attachment-item-response
    Type: object
    Show Source
    Nested Schema : AttachmentsDFFVL
    Type: array
    Show Source
    Nested Schema : Attachments Preview
    Type: array
    Title: Attachments Preview
    The attachments preview resource is used to preview the attachment pages.
    Show Source
    Nested Schema : hrHelpDeskRequests-messages-Attachment-AttachmentsDFFVL-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-messages-Attachment-AttachmentsPreview-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-messages-channelCommunication-item-response
    Type: object
    Show Source
    • Title: Account Name
      Read Only: true
      Maximum Length: 400
      The account name associated with the channel. For example, for email the account name would be the inbound mailbox for support.
    • Title: Display Name
      Maximum Length: 400
      The display name of the channel.
    • Title: Channel ID
      The unique identifier of the channel.
    • Title: Channel Short Name
      Maximum Length: 450
      The public unique identifier of the channel.
    • Title: Channel Type
      Read Only: true
      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: Collaboration ID
      Read Only: true
      Maximum Length: 255
      The unique identifier of the collaboration network user in the corresponding network. An example of this is the slack user Id of a user.
    • Title: Resource Name
      Read Only: true
      Maximum Length: 400
      The user name of the external user on the collaboration network.
    • Title: Collaboration Resource Identifier
      The unique identifier of the collaboration network user that the internal users are communicating with.
    • Title: Contact Point ID
      The unique identifier of the contact point record of the contact who's being communicated with. A contact point is a contact's identifier for a specific channel of communication. For example, the contact point for the email channel would be an email address while the contact point of a person for twitter would be the twitter handle.
    • Title: Created By
      Read Only: true
      Maximum Length: 64
      The user who created the communication channel.
    • Title: Creation Date
      Read Only: true
      The date and time when the communication channel was created.
    • Title: Inbound Message Object Identifier
      The unique identifier of the inbound object that resulted in the creation of the service request.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the communication channel was last updated.
    • Title: Updated By
      Read Only: true
      Maximum Length: 64
      The user who last updated the communication channel.
    • Title: Update Login
      Read Only: true
      Maximum Length: 32
      The session login associated to the user who last updated the communication channel.
    • Links
    • Title: Message Number
      Read Only: true
      Maximum Length: 30
      The public unique identifier of the service request message.
    • Title: Network
      Read Only: true
      Maximum Length: 30
      The code indicating the social network of the post. For example, Facebook, Twitter. A list of accepted values is defined in the lookup HZ_INSTANT_MESSENGER_TYPE.
    • Title: Object ID
      The unique identifier of the object. Depending on the object type, indicates the service request Id or the service request message Id associated with the channel communication.
    • Title: Object Type
      Read Only: true
      Maximum Length: 30
      Default Value: SVC_SR_MESSAGES
      The code indicating whether the channel communication record is associated to the service request or the service request message. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_OBJECT_TYPE_CD.
    • Title: Party ID
      The unique party identifier of the person who's being communicated with.
    • Title: Party Name
      Read Only: true
      Maximum Length: 360
      The party name of the person who's being communicated with.
    • Title: Party Number
      Read Only: true
      Maximum Length: 30
      The public unique identifier of the contact associated with the service request message.
    • Title: Party Endpoint
      Maximum Length: 1000
      The endpoint used to communicate with the customer contact. For example, email address, phone number, and so on. When Party_ID is NULL and PartyViaEndPoint is not NULL, the endpoint belongs to a party.
    • Title: Person ID
      The unique person ID of the contact.
    • Title: Post Identifier
      Maximum Length: 1000
      The unique identifier of the social media post record that was used to create the service request or the service request message.
    • Title: Resource ID
      Read Only: true
      The unique identifier of the resource associated with the service request. This is a foreign key that can identify the collaboration network user the internal users are communicating with.
    • Title: Resource Type
      Read Only: true
      Maximum Length: 30
      The code indicating the type of the collaborative network user, such as USER, PUBLIC_CHANNEL, or PRIVATE_CHANNEL. A list of accepted values is defined in the lookup ORA_SVC_COLLAB_RES_TYPE_CD.
    • Title: Routing Code
      Maximum Length: 30
      The code indicating how the message was routed through the endpoint. For example, if the endpoint is email address the field indicates if the recipient was a TO, a CC, or a BCC recipient.
    • Title: ID
      Read Only: true
      The unique identifier of the service request channel communication record.
    Nested Schema : hrHelpDeskRequests-resourceMembers-item-response
    Type: object
    Show Source
    • Title: Created By
      Read Only: true
      Maximum Length: 64
      The user who added the service request resource member.
    • Title: Creation Date
      Read Only: true
      The date and time when the service request resource member was created.
    • Title: Can Delete
      Read Only: true
      Indicates whether the user has access to delete the record.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the service request resource member record was last updated.
    • Title: Last Updated By
      Read Only: true
      Maximum Length: 64
      The user who last updated the service request resource member record.
    • Title: Last Update Login
      Read Only: true
      Maximum Length: 32
      The login of the user who last updated the service request resource member.
    • Links
    • Title: Member ID
      A unique identifier of the service request resource member.
    • Title: Service Request Team Member Resource ID
      The unique identifier of the service request resource member.
    • Title: Object Type
      Read Only: true
      Maximum Length: 30
      Default Value: ORA_SVC_RESOURCE
      Indicates whether the resource is an individual or a team.
    • Title: Assigned To
      Indicates whether the service request is assigned to the resource member. If yes, the value is True, else the value is False.
    • Title: Unique Party Name
      Read Only: true
      Maximum Length: 900
      The unique name of the service request resource member.
    • Title: Email
      Read Only: true
      Maximum Length: 320
      The email address of the resource member.
    • Title: Resource Formatted Address
      Read Only: true
      The formatted address of the SR resource member.
    • Title: Phone
      Read Only: true
      The formatted phone number of the resource member.
    • Title: Name
      Maximum Length: 360
      The name of the service request resource member.
    • Title: Resource Number
      Read Only: true
      Maximum Length: 30
      The alternative key for the service request resource.
    • Title: Service Request ID
      The unique identifier of the service request.
    • Title: Service Request Number
      Maximum Length: 30
      The alternative key for the service request number.
    • Title: Can Update
      Read Only: true
      Indicates whether the user has access to update the record.
    • Title: User GUID
      Read Only: true
      Maximum Length: 64
      The global unique identifier of the service request resource member.
    • Title: User ID
      Read Only: true
      The unique user identifier of the service request resource member.
    • Title: User Name
      Read Only: true
      Maximum Length: 100
      The user name of the resource member.
    Nested Schema : hrHelpDeskRequests-smartActions-item-response
    Type: object
    Show Source
    Nested Schema : Smart Action User Interface Definitions
    Type: array
    Title: Smart Action User Interface Definitions
    UI navigation metadata striped by app usage.
    Show Source
    Nested Schema : Smart Action REST Payload Definitions
    Type: array
    Title: Smart Action REST Payload Definitions
    If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here.
    Show Source
    Nested Schema : Smart Action User Interface Definitions
    Type: array
    Title: Smart Action User Interface Definitions
    Binding metadata for a variable in the URL.
    Show Source
    Nested Schema : hrHelpDeskRequests-smartActions-UserActionNavigation-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-smartActions-UserActionRequestPayload-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-smartActions-UserActionURLBinding-item-response
    Type: object
    Show Source
    • Title: URL Binding Type
      Maximum Length: 64
      This is a hint for processing the Url Binding runtime.
    • Links
    • Title: System Action
      Maximum Length: 1
      Default Value: false
      Boolean indicator.
    • Uniquely identifies the URL Bind for smart actions. For internal use.
    • Title: URL Binding Parameter Name
      Maximum Length: 50
      For action REST endpoints that require runtime binding, this is the key in the key value pair.
    • Title: URL Binding Parameter Value
      Maximum Length: 80
      For action REST endpoints that require runtime binding, this is the value in the key value pair.
    Nested Schema : hrHelpDeskRequests-srInteractionReferences-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-srMilestone-item-response
    Type: object
    Show Source
    Nested Schema : Milestones History
    Type: array
    Title: Milestones History
    The list of changes in the service request milestone status.
    Show Source
    Nested Schema : hrHelpDeskRequests-srMilestone-SrMilestoneHistory-item-response
    Type: object
    Show Source
    Nested Schema : hrHelpDeskRequests-srReferences-item-response
    Type: object
    Show Source
    • Title: Article ID
      Maximum Length: 64
      The unique identifier of the referenced article.
    • Title: Article Locale
      Maximum Length: 10
      The locale of the knowledge management article.
    • Title: Created By
      Read Only: true
      Maximum Length: 64
      The user who added the reference to the service request.
    • Title: Creation Date
      Read Only: true
      The date and time when the service request reference was created.
    • Title: Can Delete
      Read Only: true
      Indicates whether the user has access to delete the record.
    • Title: Document ID
      Read Only: true
      Maximum Length: 50
      The unique document identifier associated with the referenced article.
    • Title: Helpful
      Maximum Length: 1
      Indicates whether the service request reference was helpful.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the record was last updated.
    • Title: Last Updated By
      Read Only: true
      Maximum Length: 64
      The user who last updated the service request reference.
    • Title: Last Update Login
      Read Only: true
      Maximum Length: 32
      The login ID of the user who last updated the service request reference.
    • Title: Linked
      Maximum Length: 1
      Indicates whether the reference is linked with the service request.
    • Links
    • Title: Object ID
      Indicates whether the object is referenced to the service request.
    • Title: Object Type
      Maximum Length: 30
      The object type of the reference object.
    • Title: Reference ID
      Read Only: true
      The unique identifier of the current reference record.
    • Title: Relation Type
      Maximum Length: 30
      The relationship type between the service request and the referenced object.
    • Title: Resolution Code
      Maximum Length: 30
      Indicates whether the referenced object helps in resolving the service request.
    • Title: Shared
      Maximum Length: 1
      Indicates whether the service request reference is shared with the customer.
    • Title: Service Request ID
      The unique identifier of the service request.
    • Title: Service Request Number
      Maximum Length: 30
      The alternative key for the service request number.
    • Title: Title
      Maximum Length: 1000
      The title of the referenced object.
    • Title: Can Update
      Read Only: true
      Indicates whether the user has access to update the record
    Nested Schema : hrHelpDeskRequests-srTags-item-response
    Type: object
    Show Source
    Back to Top