Qualification

Prev		Next

Description

The Qualification data structure represents a Qualification assigned to a user, including the Qualification type and the value (score).

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

GetQualificationScore
GetQualificationsForQualificationType

Example

The following example illustrates a Qualification with an integer value.

<Qualification>
  <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId>
  <SubjectId>AZ3456EXAMPLE</SubjectId>
  <GrantTime>2005-01-31T23:59:59Z</GrantTime>
  <IntegerValue>95</IntegerValue>
</Qualification>

Elements

The Qualification structure may contain the following elements. When the structure is used in a request, elements described as "required" must be included for the request to succeed.

Name	Description	Type	Value
`QualificationTypeId`	The ID of the Qualification type for the Qualification.	Required	A valid Qualification type ID
`SubjectId`	The ID of the user that possesses the Qualification.	Required	A valid user ID
`GrantTime`	The date and time the Qualification was granted to the user. If the user's Qualification was revoked, then re-granted based on a new Qualification request, `GrantTime` will be the date and time of the last call to the `GrantQualification` operation.	Required	A dateTime in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as `2005-01-31T23:59:59Z`
`IntegerValue`	The value (score) of the Qualification, if the Qualification has an integer value.	Optional	An integer
`LocaleValue`	The value of the Qualification if the Qualification describes a geographical region or location.	Optional	A Locale data structure.
`Status`	The status of the Qualification, either `Granted` or `Revoked`.	Required	`Granted` \| `Revoked`