Create a lightbox presentation session feedback item
/crmRestApi/resources/11.13.18.05/presentationSessionFeedback
Request
-
Effective-Of: string
This header accepts a string value. The string is a semi-colon separated list of
= . It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers. -
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.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
- application/json
object-
ContactId: integer
Title:
Contact IDThe unique identifier of the contact providing the feedback. -
ContactName: string
Title:
ContactMaximum Length:450The name of the contact providing the feedback. -
CurrencyCode: string
Title:
CurrencyMaximum Length:30The currency code associated with presentation session feedback. A list of valid values are defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. -
DocumentTitle: string
Title:
Document TitleMaximum Length:255The title of the Lightbox document. -
DocumentVersion: string
Title:
VersionMaximum Length:64The version of the Lightbox document for this feedback. -
FeedbackComment: string
Title:
CommentMaximum Length:240The comment on the session feedback. -
FeedbackRating: integer
(int32)
Title:
RatingThe rating of the session feedback. -
LightboxDocumentId: string
Title:
Document IDMaximum Length:64The unique identifier of the Sales Lightbox document. -
LightboxDocumentPageId: string
Title:
Document Page IDMaximum Length:64The unique identifier of the Lightbox document page. Optionally, you can use LightbocDocumentId and DocumentVersion to specify the document page. The value will be null when the session feedback for the entire document is requested. -
PageSequenceNumber: integer
(int32)
Title:
Page Sequence NumberThe page sequence number of the Lightbox document page. The value will be null when the session feedback for the entire document is requested. -
PageTitle: string
Title:
Page TitleMaximum Length:255The page title of the Lightbox document page. The value will be null when the session feedback for the entire document is requested. -
PresentationSessionId: integer
(int64)
Title:
Session IDThe unique identifier of the presentation session for this feedback. -
SessionFeedbackId: integer
(int64)
Title:
Feedback IDThe unique identifier of the session feedback.
Response
- application/json
Default Response
-
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.
object-
AccountId: integer
(int64)
Title:
Account IDRead Only:trueThe unique identifier of the account. -
AccountName: string
Title:
Organization NameRead Only:trueMaximum Length:360The name of the account associated with the presentation session. -
AccountPartyNumber: string
Title:
Registry IDRead Only:trueMaximum Length:30The party number of the account associated with the presentation session. -
ActivityId: integer
(int64)
Title:
Activity IDRead Only:trueThe unique identifier of the activity. -
ActivitySubject: string
Title:
SubjectRead Only:trueMaximum Length:500The subject of the activity. -
ContactId: integer
Title:
Contact IDThe unique identifier of the contact providing the feedback. -
ContactJobTitle: string
Title:
Job TitleRead Only:trueMaximum Length:100The job title of the contact providing the feedback. -
ContactName: string
Title:
ContactMaximum Length:450The name of the contact providing the feedback. -
ContactPartyNumber: string
Title:
Party NumberRead Only:trueMaximum Length:30The party number of the contact providing the feedback. -
ContactTitle: string
Title:
TitleRead Only:trueMaximum Length:60The title of the contact providing the feedback. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CurrencyCode: string
Title:
CurrencyMaximum Length:30The currency code associated with presentation session feedback. A list of valid values are defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. -
DeleteFlag: boolean
Read Only:
trueIndicates if the current user has the permission to delete the feedback record. The default value is true. -
DocumentTitle: string
Title:
Document TitleMaximum Length:255The title of the Lightbox document. -
DocumentVersion: string
Title:
VersionMaximum Length:64The version of the Lightbox document for this feedback. -
FeedbackComment: string
Title:
CommentMaximum Length:240The comment on the session feedback. -
FeedbackRating: integer
(int32)
Title:
RatingThe rating of the session feedback. -
FileName: string
Title:
File NameRead Only:trueMaximum Length:1000The file name of the Lightbox document. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the record. -
LightboxDocumentId: string
Title:
Document IDMaximum Length:64The unique identifier of the Sales Lightbox document. -
LightboxDocumentPageId: string
Title:
Document Page IDMaximum Length:64The unique identifier of the Lightbox document page. Optionally, you can use LightbocDocumentId and DocumentVersion to specify the document page. The value will be null when the session feedback for the entire document is requested. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PageCount: integer
(int32)
Title:
Page CountRead Only:trueDefault Value:0The page count of the Lightbox document. -
PageSequenceNumber: integer
(int32)
Title:
Page Sequence NumberThe page sequence number of the Lightbox document page. The value will be null when the session feedback for the entire document is requested. -
PageTitle: string
Title:
Page TitleMaximum Length:255The page title of the Lightbox document page. The value will be null when the session feedback for the entire document is requested. -
PresentationSessionId: integer
(int64)
Title:
Session IDThe unique identifier of the presentation session for this feedback. -
SessionDate: string
(date-time)
Title:
Date and TimeRead Only:trueThe date and time when the presentation session occurred. -
SessionFeedbackId: integer
(int64)
Title:
Feedback IDThe unique identifier of the session feedback. -
SessionOwnerEmailAddress: string
Title:
Owner Primary EmailRead Only:trueMaximum Length:320The e-mail address of the owner of the presentation session. -
SessionOwnerId: integer
(int64)
Title:
Session Owner IDRead Only:trueThe unique identifier of the owner of the presentation session. -
SessionOwnerName: string
Title:
Owner NameRead Only:trueMaximum Length:360The name of the owner of the presentation session. -
SessionOwnerTitle: string
Title:
Owner TitleRead Only:trueMaximum Length:60The title of the owner of the presentation session. -
TotalTimeAttendeeViewedDocument: integer
Title:
Total Document Attended DurationRead Only:trueThe total duration for which the attendee viewed a Lightbox document. -
TotalTimeAttendeeViewedDocumentPage: integer
Title:
Total Page Attended DurationRead Only:trueThe total duration for which the attendee viewed a document page. The value will be null when the session feedback for the entire document is requested. -
TotalTimeAttendeeViewedSession: integer
Title:
Total Session Attended DurationRead Only:trueThe total duration for which the attendee viewed the session. -
TotalTimeDocumentPagePresented: integer
Title:
Total Page Display DurationRead Only:trueThe total duration for which the document page was presented during a session. The value will be null when the session feedback for the entire document is requested. -
TotalTimeDocumentPresented: integer
Title:
Total Document Display DurationRead Only:trueThe total duration for which the document was presented during a session. -
UpdateFlag: boolean
Read Only:
trueIndicates if the current user has the permission to update the feedback record. The default value is true.
arrayLinksobject-
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.
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
- ContactVA
-
Operation: /crmRestApi/resources/11.13.18.05/contactsThe list of values indicating the contact person.
The following properties are defined on the LOV link relation:- Source Attribute: ContactName; Target Attribute: ContactName
- Display Attribute: ContactName
- PresentationFeedbackRatingVA
-
The list of values indicating the rating value.
The following properties are defined on the LOV link relation:- Source Attribute: FeedbackRating; Target Attribute: RatingValue
- Display Attribute: RatingValue, Meaning
- PresentationSessionVA
-
The list of values indicating the presentation session.
The following properties are defined on the LOV link relation:- Source Attribute: SessionDate; Target Attribute: SessionDate
- Display Attribute: SessionDate
- RatedCurrencies
-
The list of values indicating the currency code used by the organization, such as USD and GBP.
The following properties are defined on the LOV link relation:- Source Attribute: CurrencyCode; Target Attribute: CurrencyCode
- Display Attribute: CurrencyCode
- SharedLightboxDocumentVA
-
The list of values indicating the Sales Lightbox document.
The following properties are defined on the LOV link relation:- Source Attribute: DocumentTitle; Target Attribute: DocumentTitle
- Display Attribute: DocumentTitle
Examples
The following example shows how to create a lightbox presentation session feedback item by submitting a POST request on the REST resource using cURL.
Create a lightbox presentation session feedback for a Lightbox document
cURL Command
curl -u <username:password> \ -X POST -d @example_request_payload.json
https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/presentationSessionFeedback
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"PresentationSessionId":300100110457468,
"ContactId":300100049609065,
"LightboxDocumentId":"bc6c78fa-556a-4d31-86c1-0b522f539333",
"FeedbackRating":"3",
"FeedbackComment":"Good document!"
}
Example of Response Body
The following example shows the contents of the response body in JSON format.
{
"SessionFeedbackId": 300100110457880,
"PresentationSessionId": 300100110457468,
"SessionDate": "2017-02-15T16:30:00-08:00",
"ContactId": 300100049609065,
"ContactPartyNumber": "CDRM_79483",
"ContactName": "Nicolas Cage",
"ContactTitle": null,
"ContactJobTitle": null,
"LightboxDocumentId": "bc6c78fa-556a-4d31-86c1-0b522f539333",
"FileName": "16x4 Template.pptx",
"DocumentTitle": "16x4 Template",
"PageCount": 7,
"DocumentVersion": "1",
"PageSequenceNumber": null,
"LightboxDocumentPageId": null,
"PageTitle": null,
"FeedbackComment": "Good document!",
"FeedbackRating": 3,
"ActivityId": 300100110456944,
"ActivitySubject": "Payload Examples",
"AccountId": 1004,
"AccountName": "Hilman and Associates",
"AccountPartyNumber": "1004",
"SessionOwnerId": 100010032752947,
"SessionOwnerName": "Ryan,Katy",
"SessionOwnerEmailAddress": "email@your_organization.com",
"SessionOwnerTitle": null,
"CreatedBy": "KRyan",
"CreationDate": "2017-02-21T01:30:29-08:00",
"LastUpdatedBy": "KRyan",
"LastUpdateDate": "2017-02-21T01:30:30-08:00",
"LastUpdateLogin": "490390FD885C4E55E053780CF10ADBC8",
"CurrencyCode": "USD",
"TotalTimeAttendeeViewedDocumentPage": 0,
"TotalTimeAttendeeViewedDocument": 0,
"TotalTimeAttendeeViewedSession": 0,
"TotalTimeDocumentPresented": 0,
"TotalTimeDocumentPagePresented": 0,
"DeleteFlag": true,
"UpdateFlag": true,
"links":
...
}
Create a lightbox presentation session feedback for a Lightbox document page
cURL Command
curl --basic --user user_name:passwd -H "Content-Type: application/vnd.oracle.adf.resourceitem+json"
-X POST -d https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/presentationSessionFeedback
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"PresentationSessionId":300100110457468,
"ContactId":300100011501118,
"LightboxDocumentPageId":"19a8ff7d-8126-451d-b9fd-b934e0dfed92",
"FeedbackComment":"excellent diagram",
"FeedbackRating":"4"
}
Example of Response Body
The following example shows the contents of the response body in JSON format.
{
"SessionFeedbackId": 300100110457882,
"PresentationSessionId": 300100110457468,
"SessionDate": "2017-02-15T16:30:00-08:00",
"ContactId": 300100011501118,
"ContactPartyNumber": "CDRM_2897",
"ContactName": "AFrst8282012101218183692 ALast8282012101218183693",
"ContactTitle": null,
"ContactJobTitle": null,
"LightboxDocumentId": "bc6c78fa-556a-4d31-86c1-0b522f539333",
"FileName": "16x4 Template.pptx",
"DocumentTitle": "16x4 Template",
"PageCount": 7,
"DocumentVersion": "1",
"PageSequenceNumber": 5,
"LightboxDocumentPageId": "19a8ff7d-8126-451d-b9fd-b934e0dfed92",
"PageTitle": "5 of 7",
"FeedbackComment": "excellent diagram",
"FeedbackRating": 4,
"ActivityId": 300100110456944,
"ActivitySubject": "Payload Examples",
"AccountId": 1004,
"AccountName": "Hilman and Associates",
"AccountPartyNumber": "1004",
"SessionOwnerId": 100010032752947,
"SessionOwnerName": "Ryan,Katy",
"SessionOwnerEmailAddress": "email@your_organization.com",
"SessionOwnerTitle": null,
"CreatedBy": "KRyan",
"CreationDate": "2017-02-21T01:31:23-08:00",
"LastUpdatedBy": "KRyan",
"LastUpdateDate": "2017-02-21T01:31:23-08:00",
"LastUpdateLogin": "490390FD885C4E55E053780CF10ADBC8",
"CurrencyCode": "USD",
"TotalTimeAttendeeViewedDocumentPage": 0,
"TotalTimeAttendeeViewedDocument": 0,
"TotalTimeAttendeeViewedSession": 0,
"TotalTimeDocumentPresented": 0,
"TotalTimeDocumentPagePresented": 0,
"DeleteFlag": true,
"UpdateFlag": true,
"links":
...
}