Qualification

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

Elements

The Qualification structure can contain the elements described in the following table. When the structure is used in a request, elements described as Required must be included for the request to succeed.

Name	Description	Required
QualificationTypeId	The ID of the Qualification type for the Qualification Type: String Default: None	Yes
SubjectId	The ID of the Worker who possesses the Qualification. Type: String Default: None	Yes
GrantTime	The date and time the Qualification was granted to the Worker. If the Worker's Qualification was revoked, and then re-granted based on a new Qualification request, GrantTime is the date and time of the last call to the GrantQualification operation. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z Default: None	Yes
IntegerValue	The value (score) of the Qualification, if the Qualification has an integer value. Type: Integer Default: None	No
LocaleValue	The value of the Qualification if the Qualification describes a geographical region or location. Type: a Locale data structure. Default: None	No
Status	The status of the Qualification Type: String Valid Values: Granted | Revoked Default: None	Yes

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>