Create a questionnaire participant
post
/hcmRestApi/resources/11.13.18.05/questionnaireParticipants
Request
Header Parameters
-
Effective-Of:
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:
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.
-
Upsert-Mode:
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ParticipantId: string
Title:
Participant Id
Maximum Length:240
Identifier for the participant responding to the questionnaire. Person identifier is the participant ID for General Surveys subscriber. -
ParticipantNumber: string
Title:
Participant Number
Maximum Length:30
Person number of the participant responding to the questionnaire. -
QuestionnaireCode: string
Title:
Questionnaire Code
Maximum Length:240
Alphanumeric value which uniquely identifies a questionnaire defined for a subscriber. -
QuestionnaireId: integer
(int64)
Title:
Questionnaire Id
Surrogate identifier for the questionnaire that's assigned to the participant. -
QuestionnaireParticipantId: integer
(int64)
Title:
Questionnaire Participant Id
Surrogate identifier for the questionnaire participant. -
questionnaireResponses: array
Questionnaire Responses
Title:
Questionnaire Responses
The questionnaireResponses resource provides the responses by a participant for the questions in a specific version of a questionnaire. -
SubscriberCode: string
Title:
Subscriber Code
Maximum Length:30
Alpha numeric value which uniquely identifies a subscriber. Valid values include GSVY for General Surveys subscriber. -
SubscriberId: integer
(int64)
Title:
Subscriber Id
Surrogate identifier for subscriber. -
SubscriberName: string
Title:
Subscriber Name
Maximum Length:240
Name of the subscriber. Valid values include General Surveys.
Nested Schema : Questionnaire Responses
Type:
array
Title:
Questionnaire Responses
The questionnaireResponses resource provides the responses by a participant for the questions in a specific version of a questionnaire.
Show Source
Nested Schema : questionnaireParticipants-questionnaireResponses-item-post-request
Type:
Show Source
object
-
QuestionnaireResponseId: integer
(int64)
Title:
Questionnaire Response Id
Surrogate identifier for the questionnaire response. -
QuestionnaireVersionNumber: integer
(int64)
Title:
Questionnaire Version
Version number of the questionnaire that the participant responds to. -
questionResponses: array
Question Responses
Title:
Question Responses
The questionResponses resource provides the responses provided by the participant to a specific question in a questionnaire. -
Status(required): string
Title:
Response Status Code
Maximum Length:30
Status of the questionnaire response. I denotes the response is In progress and isn't submitted yet, while S denotes a submitted response.
Nested Schema : Question Responses
Type:
array
Title:
Question Responses
The questionResponses resource provides the responses provided by the participant to a specific question in a questionnaire.
Show Source
Nested Schema : questionnaireParticipants-questionnaireResponses-questionResponses-item-post-request
Type:
Show Source
object
-
AnswerCode: string
Title:
Answer Code
Maximum Length:240
Code of the answer that a participant chose when responding to a single choice question. -
AnswerCodeList: string
Title:
Answer Code List
Concatenated list of answer choices (separated by a delimiter) selected by the participant when responding to a multiple choice question. -
AnswerComments: string
Title:
Comments
Maximum Length:4000
Additional comments provided by the participant when responding to a question. -
AnswerLargeObject: string
(byte)
Title:
Answer
Attachment provided by the participant to respond to the question. -
AnswerList: string
Title:
Answer List
Maximum Length:2000
Concatenated list of answer identifiers (separated by a delimiter) selected by the participant when responding to a multiple choice question. -
ChoiceCodeList: string
Title:
Choice List Code
Concatenated list of answer codes (separated by a delimiter) that are presented to the participant when responding to a question enabled for random order. -
ChoiceList: string
Title:
Choice List
Maximum Length:2000
Concatenated list of answer identifiers (separated by a delimiter) that are presented to the participant when responding to a question enabled for random order. -
QuestionAnswerId: integer
(int64)
Title:
Question Answer Id
Surrogate identifier of the answer that a participant chose when responding to a single choice question. -
QuestionCode(required): string
Title:
Question Code
Maximum Length:240
Alphanumeric value that uniquely identifies a question defined for a subscriber. -
QuestionId: integer
(int64)
Title:
Question Id
Surrogate identifier for the question. -
QuestionnaireQuestionId(required): integer
(int64)
Title:
Questionnaire Question Id
Surrogate identifier for the question in a questionnaire. -
questionResponseAttachments: array
Question Response Attachments
Title:
Question Response Attachments
The questionResponseAttachments resource provides the attachments submitted by a participant while responding to a question. -
QuestionResponseId: integer
(int64)
Title:
Question Response Id
Surrogate identifier for the question response.
Nested Schema : Question Response Attachments
Type:
array
Title:
Question Response Attachments
The questionResponseAttachments resource provides the attachments submitted by a participant while responding to a question.
Show Source
Nested Schema : questionnaireParticipants-questionnaireResponses-questionResponses-questionResponseAttachments-item-post-request
Type:
Show Source
object
-
AsyncTrackerId: string
Title:
Asynchronous Upload Tracker Id
Attribute provided exclusively for the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document Id
Unique identifier of the attached document. -
CategoryName: string
Title:
Category
Maximum Length:30
Category name of the attachment. This is a read-only attribute. - ContentRepositoryFileShared: boolean
-
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Attachment type supported for the question. Only the attachment type, FILE, is supported. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmDocumentId: string
Maximum Length:
255
Surrogate identifier of the document attached to the questionnaire. -
DmFolderPath: string
Title:
Dm Folder Path
Maximum Length:1000
Path of the folder. -
DmVersionNumber: string
Maximum Length:
255
Version number of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string that contains information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status Code
Error status code of the attachment. -
ErrorStatusMessage: string
Title:
Error Status Message
Error status message of the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration Date
Expiration date of the attachment. This is a read-only attribute. -
FileContents: string
(byte)
Title:
File Contents
File contents of the attachment. -
FileName: string
Title:
File Name
Maximum Length:2048
Name of the attachment file. -
FileUrl: string
Title:
File Url
File URL of the attachment. -
PostProcessingAction: string
Title:
PostProcessingAction
The name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content Type
Content type of the uploaded file. This is a read-only attribute. -
UploadedFileLength: integer
Title:
File Size
Size of the uploaded file. This is a read-only attribute. -
UploadedFileName: string
Title:
Uploaded File Name
Name of the uploaded file. This is a read-only attribute. -
UploadedText: string
Title:
Uploaded Text
Text uploaded in the attachment. -
Uri: string
Title:
Uri
Maximum Length:4000
URI of the attachment. This is a read-only attribute. -
Url: string
Title:
Url
Maximum Length:4000
URL of a web page type of attachment.
Response
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 : questionnaireParticipants-item-response
Type:
Show Source
object
-
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
Name of the user who created the questionnaire participant. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date and time when the questionnaire participant was created. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the questionnaire participant was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
Name of the user who last updated the questionnaire participant. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ParticipantId: string
Title:
Participant Id
Maximum Length:240
Identifier for the participant responding to the questionnaire. Person identifier is the participant ID for General Surveys subscriber. -
ParticipantName: string
Title:
Participant Name
Read Only:true
Maximum Length:2000
Name of the participant (person name) responding to the questionnaire. -
ParticipantNumber: string
Title:
Participant Number
Maximum Length:30
Person number of the participant responding to the questionnaire. -
ParticipantType: string
Title:
Participant Type
Read Only:true
Maximum Length:30
Default Value:PERSON
Type of the participant. Valid values include PERSON for General Surveys subscriber. -
QuestionnaireCode: string
Title:
Questionnaire Code
Maximum Length:240
Alphanumeric value which uniquely identifies a questionnaire defined for a subscriber. -
QuestionnaireId: integer
(int64)
Title:
Questionnaire Id
Surrogate identifier for the questionnaire that's assigned to the participant. -
QuestionnaireName: string
Title:
Questionnaire Name
Read Only:true
Maximum Length:240
Name of the questionnaire that a participant has responded to. -
QuestionnaireParticipantId: integer
(int64)
Title:
Questionnaire Participant Id
Surrogate identifier for the questionnaire participant. -
questionnaireResponses: array
Questionnaire Responses
Title:
Questionnaire Responses
The questionnaireResponses resource provides the responses by a participant for the questions in a specific version of a questionnaire. -
Status: string
Title:
Participant Status Code
Read Only:true
Maximum Length:30
Default Value:I
Status of the questionnaire participant. For General Surveys subscriber, this value is I to denote a status of in progress. -
StatusMeaning: string
Title:
Participant Status
Read Only:true
Maximum Length:80
Status of the questionnaire participant. -
SubscriberCode: string
Title:
Subscriber Code
Maximum Length:30
Alpha numeric value which uniquely identifies a subscriber. Valid values include GSVY for General Surveys subscriber. -
SubscriberId: integer
(int64)
Title:
Subscriber Id
Surrogate identifier for subscriber. -
SubscriberName: string
Title:
Subscriber Name
Maximum Length:240
Name of the subscriber. Valid values include General Surveys.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Questionnaire Responses
Type:
array
Title:
Questionnaire Responses
The questionnaireResponses resource provides the responses by a participant for the questions in a specific version of a questionnaire.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed 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.
Nested Schema : questionnaireParticipants-questionnaireResponses-item-response
Type:
Show Source
object
-
AttemptNumber: integer
(int64)
Title:
Attempt Number
Read Only:true
Attempt number by the participant in responding to a questionnaire. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
Name of the user who created the questionnaire response. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date and time when the questionnaire response was created. -
LastUpdateDate: string
(date-time)
Title:
Last Updated Date
Read Only:true
Date and time when the questionnaire response was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
Name of the user who last updated the questionnaire response. -
LatestAttemptFlag: boolean
Title:
Latest Attempt
Read Only:true
Maximum Length:30
Default Value:false
Setting that indicates if this is the latest response attempt by a participant to the questionnaire. This is a read-only attribute. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
QuestionnaireResponseId: integer
(int64)
Title:
Questionnaire Response Id
Surrogate identifier for the questionnaire response. -
QuestionnaireVersionNumber: integer
(int64)
Title:
Questionnaire Version
Version number of the questionnaire that the participant responds to. -
questionResponses: array
Question Responses
Title:
Question Responses
The questionResponses resource provides the responses provided by the participant to a specific question in a questionnaire. -
Status: string
Title:
Response Status Code
Maximum Length:30
Status of the questionnaire response. I denotes the response is In progress and isn't submitted yet, while S denotes a submitted response. -
StatusMeaning: string
Title:
Response Status
Read Only:true
Maximum Length:80
Meaning of the status code. -
SubmittedDateTime: string
(date)
Title:
Submitted Time
Read Only:true
Date on which the questionnaire response was submitted. -
TotalScore: number
Title:
Total Score
Read Only:true
Total score for the responses submitted by the participant to a questionnaire.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Question Responses
Type:
array
Title:
Question Responses
The questionResponses resource provides the responses provided by the participant to a specific question in a questionnaire.
Show Source
Nested Schema : questionnaireParticipants-questionnaireResponses-questionResponses-item-response
Type:
Show Source
object
-
AnswerCode: string
Title:
Answer Code
Maximum Length:240
Code of the answer that a participant chose when responding to a single choice question. -
AnswerCodeList: string
Title:
Answer Code List
Concatenated list of answer choices (separated by a delimiter) selected by the participant when responding to a multiple choice question. -
AnswerComments: string
Title:
Comments
Maximum Length:4000
Additional comments provided by the participant when responding to a question. -
AnswerLargeObject: string
(byte)
Title:
Answer
Attachment provided by the participant to respond to the question. -
AnswerList: string
Title:
Answer List
Maximum Length:2000
Concatenated list of answer identifiers (separated by a delimiter) selected by the participant when responding to a multiple choice question. -
AnswerShortdescription: string
Title:
Answer Short Description
Read Only:true
Maximum Length:240
Text of the answer chosen by a participant when responding to a single choice question. -
AnswerShortDescriptionList: string
Title:
Answer Short Description
Read Only:true
Concatenated list of answer texts (separated by a delimiter) selected by the participant when responding to a multiple choice question. -
ChoiceCodeList: string
Title:
Choice List Code
Concatenated list of answer codes (separated by a delimiter) that are presented to the participant when responding to a question enabled for random order. -
ChoiceList: string
Title:
Choice List
Maximum Length:2000
Concatenated list of answer identifiers (separated by a delimiter) that are presented to the participant when responding to a question enabled for random order. -
ChoiceShortDescription: string
Title:
Choice Short Description
Read Only:true
Concatenated list of answer texts (separated by a delimiter) that are presented to the participant when responding to a question enabled for random order. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
Name of the user who created the question response. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date and time when the question response was created. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the question response was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
Name of the user who last updated the question response. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
QuestionAnswerId: integer
(int64)
Title:
Question Answer Id
Surrogate identifier of the answer that a participant chose when responding to a single choice question. -
QuestionCode: string
Title:
Question Code
Maximum Length:240
Alphanumeric value that uniquely identifies a question defined for a subscriber. -
QuestionId: integer
(int64)
Title:
Question Id
Surrogate identifier for the question. -
QuestionnaireQuestionId: integer
(int64)
Title:
Questionnaire Question Id
Surrogate identifier for the question in a questionnaire. -
questionResponseAttachments: array
Question Response Attachments
Title:
Question Response Attachments
The questionResponseAttachments resource provides the attachments submitted by a participant while responding to a question. -
QuestionResponseId: integer
(int64)
Title:
Question Response Id
Surrogate identifier for the question response. -
QuestionText: string
Title:
Question Text
Read Only:true
Maximum Length:2000
Text of the question that the participant responds to. -
Score: integer
(int64)
Title:
Answer Score
Read Only:true
Calculated score for the responses provided for a question by the participant.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Question Response Attachments
Type:
array
Title:
Question Response Attachments
The questionResponseAttachments resource provides the attachments submitted by a participant while responding to a question.
Show Source
Nested Schema : questionnaireParticipants-questionnaireResponses-questionResponses-questionResponseAttachments-item-response
Type:
Show Source
object
-
AsyncTrackerId: string
Title:
Asynchronous Upload Tracker Id
Attribute provided exclusively for the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document Id
Unique identifier of the attached document. -
CategoryName: string
Title:
Category
Maximum Length:30
Category name of the attachment. This is a read-only attribute. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:255
User who created the attachment. -
CreatedByUserName: string
Title:
Created By User Name
Read Only:true
User name of the person who created the attachment. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date when the attachment was created. -
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Attachment type supported for the question. Only the attachment type, FILE, is supported. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmDocumentId: string
Maximum Length:
255
Surrogate identifier of the document attached to the questionnaire. -
DmFolderPath: string
Title:
Dm Folder Path
Maximum Length:1000
Path of the folder. -
DmVersionNumber: string
Maximum Length:
255
Version number of the attachment. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string that contains information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status Code
Error status code of the attachment. -
ErrorStatusMessage: string
Title:
Error Status Message
Error status message of the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration Date
Expiration date of the attachment. This is a read-only attribute. -
FileContents: string
(byte)
Title:
File Contents
File contents of the attachment. -
FileName: string
Title:
File Name
Maximum Length:2048
Name of the attachment file. -
FileUrl: string
Title:
File Url
File URL of the attachment. -
FileWebImage: string
(byte)
Title:
File Web Image
Read Only:true
Base64 encoded image of the file displayed in .png format when the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date when the attachment record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:255
Name of the user who last updated the attachment record. -
LastUpdatedByUserName: string
Title:
Last Updated By User
Read Only:true
User name of the user who last updated the attachment. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingAction
The name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content Type
Content type of the uploaded file. This is a read-only attribute. -
UploadedFileLength: integer
Title:
File Size
Size of the uploaded file. This is a read-only attribute. -
UploadedFileName: string
Title:
Uploaded File Name
Name of the uploaded file. This is a read-only attribute. -
UploadedText: string
Title:
Uploaded Text
Text uploaded in the attachment. -
Uri: string
Title:
Uri
Maximum Length:4000
URI of the attachment. This is a read-only attribute. -
Url: string
Title:
Url
Maximum Length:4000
URL of a web page type of attachment. -
UserName: string
Title:
User Name
Read Only:true
Maximum Length:255
User name of the person who uploaded the attachment.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- QuestionnaireLov
-
The following properties are defined on the LOV link relation:
- Source Attribute: QuestionnaireCode; Target Attribute: QuestionnaireCode
- Display Attribute: QuestionnaireCode
- StatusLookupLov
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DHRQ_RESPONSE_STATUS
The following properties are defined on the LOV link relation:- Source Attribute: Status; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
- SubscriberLov
-
The following properties are defined on the LOV link relation:
- Source Attribute: SubscriberName; Target Attribute: SubscriberName
- Display Attribute: SubscriberName, SubscriberId
- questionnaireResponses
-
Parameters:
- questionnaireParticipantsUniqID:
$request.path.questionnaireParticipantsUniqID
The questionnaireResponses resource provides the responses by a participant for the questions in a specific version of a questionnaire. - questionnaireParticipantsUniqID: