QualificationRequest Data Structure

Description

The QualificationRequest data structure represents a request a user has made for a Qualification.

The QualificationRequest data structure is used as a response element for the following operations:

Example

The following example of a QualificationRequest data structure could be returned by the GetQualificationRequests operation. This operation returns the requests for Qualifications of a Qualification type to the author of the type. The author will use these Qualification requests to grant the Qualifications using the GrantQualification operation. 

<QualificationRequest>
  <QualificationRequestId>789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE</QualificationRequestId>
  <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId>
  <Answer>
    &lt;QuestionFormAnswers&gt;
      [XML-encoded Question data]
    &lt;/QuestionFormAnswers&gt;
  </Answer>
  <SubmitTime>2005-12-01T23:59:59Z</SubmitTime>
</QualificationRequest>

Elements

The QualificationRequest structure may contain the following elements.

Name Description Value
QualificationRequestId

The ID of the Qualification request, a unique identifier generated when the request was submitted. The Qualification type author retrieves these IDs using the GetQualificationRequests operation.

A valid Qualification request ID

QualificationTypeId

The ID of the Qualification type the user is requesting, as returned by CreateQualificationType.

A valid Qualification type ID

Answer

The user's answers for the Qualification type's test, if the type has a test and the user has submitted answers. The user creates the request and submits the test answers in two separate steps. A request for a type with a test will not have Answer data until the user submits it.

This value is an XML data structure. See the QuestionFormAnswers data structure for more information.

XML data for the answer, a QuestionFormAnswers data structure

SubmitTime

The date and time the Qualification request had a status of Submitted.

This is either the time the user submitted answers for a Qualification test, or the time the user requested the Qualification if the Qualification type does not have a test. If the Qualification type has a test and the user has not yet submitted answers, SubmitTime will not be present.

A dateTime in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z