Get a collaboration action
get
/crmRestApi/resources/11.13.18.05/collaborationActions/{CollabActionNumber}
Request
Path Parameters
-
CollabActionNumber(required): string
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
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 : collaborationActions-item-response
Type:
Show Source
object-
actionAttributes: array
Action Attributes
Title:
Action AttributesThe attributes resource lets you view, create, update, and delete attributes used in a collaboration network. These attributes are sent or received from the collaboration network when an action is performed. -
CatalogCd: string
Title:
REST CatalogMaximum Length:30Default Value:crmRestApiThe REST catalog used to generate the endpoint for the business object. -
ChannelId: integer
(int64)
Title:
Channel IDThe unique identifier of the service channel associated with the collaboration action. -
CollabActionCd: string
Title:
Action CodeMaximum Length:30A unique code that identifier the collaboration action. -
CollabActionId: integer
(int64)
Title:
Action IDRead Only:trueThe unique identifier of the collaboration action. -
CollabActionMethod: string
Title:
Action MethodMaximum Length:64The REST API action invoked by the collaboration action such as GET or POST. -
CollabActionName: string
Title:
Action NameMaximum Length:64The display name of the collaboration action. -
CollabActionNumber: string
Title:
Action NumberMaximum Length:30The alternate unique identifier of the collaboration action. -
CollabActionTypeCd: string
Title:
Action TypeMaximum Length:30Specifies what the collaboration action does when run, such as call an API or show a dialog. -
ControlTypeCd: string
Title:
User Interface ComponentMaximum Length:30The UI controls used to display the action on the collaboration network. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the collaboration action. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the collaboration action was created. -
Description: string
Title:
DescriptionMaximum Length:1000The description of the collaboration action. -
DisplaySequence: integer
(int64)
Title:
Display SequenceThe display sequence of the collaboration action. This is primarily applicable to child actions that are displayed on the collaboration network UI. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the collaboration action was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the collaboration action. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the collaboration action. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ObjectName: string
Title:
Business ObjectMaximum Length:64The business object associated with the collaboration action such as service request or opportunity. -
ParentActionId: integer
(int64)
Title:
Parent Action IDThe unique identifier of the parent action for the collaboration action. -
RequestContentType: string
Title:
Request Content TypeMaximum Length:64The content type of the REST API request payload. -
RequestEndPoint: string
Title:
Request End PointMaximum Length:4000The endpoint of the Request API for the collaboration action. -
RequestPayload: string
(byte)
Title:
Request PayloadThe request payload for the request API. -
ResponseContentType: string
Title:
Response Content TypeMaximum Length:64The content type of the REST API response. -
ResponseEntityTypeCd: string
Title:
Response TypeMaximum Length:30The response type of collaboration actions such as Action Attributes or Payload. -
ResponseMsgTypeCd: string
Title:
Response VisibilityMaximum Length:30Indicates the visibility of the action response in the collaboration network such as private or public. -
ResponsePayload: string
(byte)
Title:
Response PayloadThe response of the collaboration action. -
StatusCd: string
Title:
StatusMaximum Length:30Default Value:DRAFTThe status of the collaboration action such as DRAFT or ACTIVE.
Nested Schema : Action Attributes
Type:
arrayTitle:
Action AttributesThe attributes resource lets you view, create, update, and delete attributes used in a collaboration network. These attributes are sent or received from the collaboration network when an action is performed.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : collaborationActions-actionAttributes-item-response
Type:
Show Source
object-
AttribId: integer
(int64)
Title:
Attribute IDRead Only:trueThe unique identifier of the action attribute. -
AttribName: string
Title:
Attribute NameMaximum Length:64The business object attribute name associated with the collaboration action. -
ChannelId: integer
(int64)
Title:
Channel IDThe channel associated with the action attribute. -
CollabActionId: integer
(int64)
Title:
Action IDThe unique identifier of the collaboration action associated with the attribute. -
ContextAttribFlag: boolean
Title:
Business Object IdentifierMaximum Length:1Default Value:falseIndicates if the action attribute is used as the context attribute for passing to and from the collaboration network and CX Sales. -
ControlTypeCd: string
Title:
User Interface ComponentMaximum Length:30The UI controls used to display the attributes on the collaboration network such as List or Text box. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the action attribute. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the action attribute was created. -
DataSource: string
Title:
End PointMaximum Length:4000The API to get the a list of values for an attribute of type list. -
DataSourceLabelAttrib: string
Title:
Option LabelMaximum Length:64The API attribute used as the display value of the action attribute. This applies to action attributes with control type as List. -
DataSourceValueAttrib: string
Title:
Option ValueMaximum Length:64The API attribute used to save the selected action attribute value. This applies to action attributes with control type as List. -
DataTypeCd: string
Title:
Data TypeMaximum Length:30The data type of collaboration action attributes such as Date Time or Number. -
DeepLink: string
Title:
Deep LinkMaximum Length:1000A deep link URL format that links to the object associated with the action attribute. -
DefaultValue: string
Title:
Default ValueMaximum Length:4000The default value of the action attribute. -
DisplayName: string
Title:
Display NameMaximum Length:64The label of the action attribute displayed when displaying the attribute in the collaboration network. -
DisplaySequence: integer
(int64)
Title:
Display SequenceThe display order of the action attribute. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the action attribute was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the action attribute. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the action attributes. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
RequestAttribFlag: boolean
Title:
Included in RequestMaximum Length:1Default Value:falseIndicates if the action attribute is part of the request payload. -
ResponseAttribFlag: boolean
Title:
Included in ResponseMaximum Length:1Default Value:falseIndicates if the action attribute is part of the response payload.
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.
Links
- CatalogCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_CATALOG_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: CatalogCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- CollabActionMethodLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_ACT_MET_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: CollabActionMethod; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- CollabActionTypeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_ACT_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: CollabActionTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ControlTypeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_ACT_CON_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: ControlTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ResponseEntityTypeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_RES_ENT_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: ResponseEntityTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ResponseMsgTypeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_RES_MSG_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: ResponseMsgTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- StatusCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_COLLAB_ACT_STATUS_CD
The following properties are defined on the LOV link relation:- Source Attribute: StatusCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- actionAttributes
-
Operation: /crmRestApi/resources/11.13.18.05/collaborationActions/{CollabActionNumber}/child/actionAttributesParameters:
- CollabActionNumber:
$request.path.CollabActionNumber
The attributes resource lets you view, create, update, and delete attributes used in a collaboration network. These attributes are sent or received from the collaboration network when an action is performed. - CollabActionNumber:
Examples
The following example shows how to get a collaboration action 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/collaborationActionss/{CollabActionNumber}
Example of Response Body
The following shows an example of the response body in JSON format.
{
"CollabActionId": 100100641458704,
"CollabActionName": "Submit Task",
"CollabActionMethod": "POST",
"RequestEndPoint": "/crmRestApi/resources/latest/activities",
"RequestContentType": "application/vnd.oracle.adf.resourceitem+json",
"ResponseContentType": "application/vnd.oracle.adf.resourceitem+json",
"CreationDate": "2022-06-22T18:46:29.284+00:00",
"CreatedBy": "SEED_DATA_FROM_APPLICATION",
"LastUpdateDate": "2023-04-04T13:38:34.438+00:00",
"LastUpdatedBy": "SEED_DATA_FROM_APPLICATION",
"LastUpdateLogin": "-1",
"ResponseEntityTypeCd": "PAYLOAD",
"ResponseMsgTypeCd": "PRIVATE",
"CollabActionCd": "ec-submit-task",
"CollabActionTypeCd": "INVOKE_API",
"ObjectName": "opportunities",
"ParentActionId": 100100641458698,
"ControlTypeCd": null,
"DisplaySequence": 1,
"ChannelId": null,
"CollabActionNumber": "ec-submit-task",
"Description": null,
"StatusCd": "ACTIVE",
"CatalogCd": "crmRestApi",
"links": [
{
"rel": "self",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/collaborationActions/ec-submit-task",
"name": "collaborationActions",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/collaborationActions/ec-submit-task",
"name": "collaborationActions",
"kind": "item"
},
{
"rel": "child",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/collaborationActions/ec-submit-task/child/actionAttributes",
"name": "actionAttributes",
"kind": "collection"
},
{
"rel": "enclosure",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/collaborationActions/ec-submit-task/enclosure/RequestPayload",
"name": "RequestPayload",
"kind": "other"
},
{
"rel": "enclosure",
"href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/collaborationActions/ec-submit-task/enclosure/ResponsePayload",
"name": "ResponsePayload",
"kind": "other"
}
]
}