Service Directory > v31.2 > Talent > Manage_Certifications
 

Operation: Manage_Certifications

This operation allows adding new certifications and editing existing certifications for a worker.


@ - A parameter name with this symbol denotes an XML attribute within the document instead of an XML element.


Contents

 

Web Service

 

Request

 

Response

 

Element(s)

 

Request Element: Manage_Certifications_Request

Request element for Manage Worker Certification.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Business_Process_Parameters  Business_Process_Parameters  [0..1]  Container for the processing options for a business process. If no options are submitted (or the options are submitted as 'false') then the business process is simply initiated as if it where submitted on-line with approvals, reviews, notifications and to-do's in place. If the Initiator is an Integration System User, any validations you configured on the Initiation step are ignored.   
Manage_Certifications_Data  Manage_Certifications_Data_for_Role  [1..1]  Wrapper element for Certification Data.   
top
 

Response Element: Manage_Certifications_Response

Response element for Manage Worker Certification.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Worker_Certification_Event_Reference  Unique_IdentifierObject  [0..1]  Reference to an instance of Worker Certification Event   
Certification_Reference  Certification_SkillObject  [0..*]  Reference to an instance of certification   
top
 

Business_Process_Parameters

part of: Manage_Certifications_Request
Container for the processing options for a business process. If no options are submitted (or the options are submitted as 'false') then the business process is simply initiated as if it where submitted on-line with approvals, reviews, notifications and to-do's in place. If the Initiator is an Integration System User, any validations you configured on the Initiation step are ignored.
 
Parameter name Type/Value Cardinality Description Validations
Auto_Complete  boolean  [0..1]  When set to "true" or "1", the business process is automatically processed. This means that all approvals will be automatically approved in the system, all reviews and to-do's will be automatically by-passed, and all notifications will be automatically suppressed.   
Run_Now  boolean  [0..1]  Indicates the transaction should process to completion before the response is generated. Note: All < v12 operations will process with Run_Now = True for backwards compatibility but please review this setting in your environment for performance conditions.   
Comment_Data  Business_Process_Comment_Data  [0..1]  Captures a comment for the Business Process.   
Business_Process_Attachment_Data  Business_Process_Attachment_Data  [0..*]  Element for the attachments pertaining to a Event entered through a web service. 
Validation Description
This Business Process Type has been configured to not accept Event Attachments.   
 
top
 

Business_Process_Comment_Data

part of: Business_Process_Parameters
Captures a comment for the Business Process.
 
Parameter name Type/Value Cardinality Description Validations
Comment  string  [0..1]  Free form comment regarding the business process. 
Validation Description
This Business Process has been configured to disable comment. Please remove the comment or change the setting in the Business Process Policy or tenant setup.   
 
Worker_Reference  WorkerObject  [0..1]  Default the Person making the comment to the processing person if not submitted via the web service.   
top
 

WorkerObject

part of: Business_Process_Comment_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  WorkerObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

WorkerObjectID

part of: WorkerObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Contingent_Worker_ID, Employee_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Business_Process_Attachment_Data

part of: Business_Process_Parameters
Element for the attachments pertaining to a Event entered through a web service.
 
Parameter name Type/Value Cardinality Description Validations
File_Name  string (255)   [1..1]  Filename for the attachment.   
Event_Attachment_Description  string  [0..1]  Free form text comment about the attachment.   
Event_Attachment_Category_Reference  Event_Attachment_CategoryObject  [0..1]  Category of attachment. 
Validation Description
This Business Process Type has been configured to not accept Attachment Categories.   
 
File  base64Binary  [0..1]  Binary file contents.   
Content_Type  string (80)   [0..1]  Text attribute identifying Content Type of the Attachment.   
top
 

Event_Attachment_CategoryObject

part of: Business_Process_Attachment_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Event_Attachment_CategoryObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Event_Attachment_CategoryObjectID

part of: Event_Attachment_CategoryObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Document_Category__Workday_Owned__ID, Document_Category_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Manage_Certifications_Data_for_Role

part of: Manage_Certifications_Request
Wrapper element for Certification Data.
 
Parameter name Type/Value Cardinality Description Validations
Role_Reference  RoleObject  [1..1]  Reference to a role   
Source_Reference  Person_Skill_Source_CategoryObject  [0..1]  Reference to the source of the skill.   
Certification  Certification_Achievement  [0..*]  Wrapper element for Certification information. 
Validation Description
That Skill is already in use by another person. Select another one or leave it blank.   
 
top
 

RoleObject

part of: Manage_Certifications_Data_for_Role
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  RoleObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

RoleObjectID

part of: RoleObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Academic_Affiliate_ID, Academic_Contact_ID, Academic_Person_ID, Applicant_ID, Beneficiary_ID, Business_Entity_Contact_ID, Candidate_ID, Company_Reference_ID, Contingent_Worker_ID, Cost_Center_Reference_ID, Custom_Organization_Reference_ID, Dependent_ID, Emergency_Contact_ID, Employee_ID, Extended_Enterprise_Contact_Person_ID, Extended_Enterprise_Learner_ID, External_Committee_Member_ID, Former_Worker_ID, Instructor_ID, Learning_Instructor_ID, LearningUserName, Organization_Reference_ID, Recruiting_Agency_User_ID, RecruitingUserName, Region_Reference_ID, Service_Center_Representative_ID, Student_ID, Student_Proxy_ID, Student_Recruiter_ID, StudentUserName, SupplierUserName, System_User_ID, System_User_OpenID, System_User_OpenID_Connect_Internal, System_User_OpenID_Internal, WorkdayUserName  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Person_Skill_Source_CategoryObject

part of: Manage_Certifications_Data_for_Role
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Person_Skill_Source_CategoryObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Person_Skill_Source_CategoryObjectID

part of: Person_Skill_Source_CategoryObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Skill_Source_Category_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Certification_Achievement

part of: Manage_Certifications_Data_for_Role
Wrapper element for Certification information.
 
Parameter name Type/Value Cardinality Description Validations
Certification_Reference  Certification_SkillObject  [0..1]  The reference to the certification profile.   
Certification_Data  Certification_Achievement_Data  [1..*]  Wrapper element for Certification data. 
Validation Description
You must either submit a Certification Reference or a Certification Name and Issuer.  As of v13, certification name and issuer are no longer required. You may submit a certification reference or a name and issuer. 
There is an in progress event for this worker for the certification: [cert]. Only one in progress event is allowed.  Only one change can be in progress (the event in progress and not complete or canceled) for a certification for a particular worker. 
Exam Date must be less than or equal to Issued Date.  Exam Date must be less than or equal to Issued Date. 
Expiration Date may not be prior to Issued Date.  Expiration Date may not be prior to Issued Date. 
Issued Date must be less than or equal to today's date.  Issued Date must be less than or equal to today's date. 
Exam Date must be less than Expiration Date.  Exam Date must be less than Expiration Date. 
You must first select Enable Specialties for Certifications on the Maintain Skills and Experience Setup task.   
This certification is already in use.  Checks that there are either no duplicates, or the only duplicate returned is this instance (an edit is happening) 
 
Validation Description
That Skill is already in use by another person. Select another one or leave it blank.   
top
 

Certification_SkillObject

part of: Certification_Achievement, Manage_Certifications_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Certification_SkillObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Certification_SkillObjectID

part of: Certification_SkillObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Certification_Skill_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Certification_Achievement_Data

part of: Certification_Achievement
Wrapper element for Certification information.
 
Parameter name Type/Value Cardinality Description Validations
Certification_ID  string  [0..1]  Certification ID. If no value is provided, a new certification will be created. If a value is passed in and a corresponding certification is not found, a new certification will be created with the provided id.   
Remove_Certification  boolean  [0..1]  Used for inbound operations to indicate that the certification should be removed for the person. Will always return false for outbound operations. 
Validation Description
Remove Certification is true without a Certification Skill or valid Certification ID. A Certification or valid Certification ID must be specified in order to remove the Certification.   
 
Certification_Reference  CertificationObject  [0..1]  Wrapper element for the Certification Reference, i.e. from the list of pre-defined certifications.   
Country_Reference  CountryObject  [0..1]  The country in which the certification is used.   
Certification_Name  string  [0..1]  The name of the Certification.   
Issuer  string  [0..1]  The authority issuing the certification.   
Certification_Number  string  [0..1]  Certification Number for the Certification.   
Issued_Date  date  [0..1]  The date the certification was issued.   
Expiration_Date  date  [0..1]  The date of expiration of the certification.   
Examination_Score  string  [0..1]  The person's score on the certification examination.   
Examination_Date  date  [0..1]  The date the certification examination was taken.   
Specialty_Achievement_Data  Specialty_Achievement_Data_with_Dates  [0..*]  This data contains information about any specialties and subspecialties associated with the certification achievement. 
Validation Description
The subspecialty must be associated with the entered specialty.   
You can't specify a restricted specialty for a certification that isn't included in your Certifications library.   
The Specialty Date must be associated with a Specialty.   
End Date may not be prior to Start Date.   
[subspecname] is inactive. Specify an active subspecialty.   
You entered at least 1 duplicate specialty. Enter a Specialty that isn't already in use.   
Enter Start Date   
The specialty must be associated with the certification on the Create Certification or Edit Certification task.   
[specname] is inactive. Specify an active specialty.   
Enter a Specialty Date that is on or after January 1, 1930.   
 
Worker_Document_Data  Certification_Attachment_Data  [0..*]  Worker Document Data is only used for worker certifications. Do not use this for applicants.   
Validation Description
You must either submit a Certification Reference or a Certification Name and Issuer.  As of v13, certification name and issuer are no longer required. You may submit a certification reference or a name and issuer. 
There is an in progress event for this worker for the certification: [cert]. Only one in progress event is allowed.  Only one change can be in progress (the event in progress and not complete or canceled) for a certification for a particular worker. 
Exam Date must be less than or equal to Issued Date.  Exam Date must be less than or equal to Issued Date. 
Expiration Date may not be prior to Issued Date.  Expiration Date may not be prior to Issued Date. 
Issued Date must be less than or equal to today's date.  Issued Date must be less than or equal to today's date. 
Exam Date must be less than Expiration Date.  Exam Date must be less than Expiration Date. 
You must first select Enable Specialties for Certifications on the Maintain Skills and Experience Setup task.   
This certification is already in use.  Checks that there are either no duplicates, or the only duplicate returned is this instance (an edit is happening) 
top
 

CertificationObject

part of: Certification_Achievement_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  CertificationObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

CertificationObjectID

part of: CertificationObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Certification_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

CountryObject

part of: Certification_Achievement_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  CountryObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

CountryObjectID

part of: CountryObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, ISO_3166-1_Alpha-2_Code, ISO_3166-1_Alpha-3_Code, ISO_3166-1_Numeric-3_Code  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Specialty_Achievement_Data_with_Dates

part of: Certification_Achievement_Data
This element contains data about each Specialty-Subspecialty combination associated with the certification achievement
 
Parameter name Type/Value Cardinality Description Validations
Specialty_Reference  Specialty_ParentObject  [0..1]  Enter the Speciality associated with the certification achievement.   
Start_Date  date  [0..1]  Enter the Specialty Start Date associated with this certification achievement.   
End_Date  date  [0..1]  Enter the Specialty End Date associated with this certification achievement.   
Subspecialty_Reference  Specialty_ChildObject  [0..*]  Enter the subspecialty ID associated with the specialty.   
Validation Description
The subspecialty must be associated with the entered specialty.   
You can't specify a restricted specialty for a certification that isn't included in your Certifications library.   
The Specialty Date must be associated with a Specialty.   
End Date may not be prior to Start Date.   
[subspecname] is inactive. Specify an active subspecialty.   
You entered at least 1 duplicate specialty. Enter a Specialty that isn't already in use.   
Enter Start Date   
The specialty must be associated with the certification on the Create Certification or Edit Certification task.   
[specname] is inactive. Specify an active specialty.   
Enter a Specialty Date that is on or after January 1, 1930.   
top
 

Specialty_ParentObject

part of: Specialty_Achievement_Data_with_Dates
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Specialty_ParentObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Specialty_ParentObjectID

part of: Specialty_ParentObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Specialty_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Specialty_ChildObject

part of: Specialty_Achievement_Data_with_Dates
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Specialty_ChildObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Specialty_ChildObjectID

part of: Specialty_ChildObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Subspecialty_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Certification_Attachment_Data

part of: Certification_Achievement_Data
Attachments for Certification.
 
Parameter name Type/Value Cardinality Description Validations
File_Name  string (255)   [1..1]  Filename for the attachment.   
Comment  string  [0..1]  Free form text comment about the attachment.   
File  base64Binary  [0..1]  Binary file contents.   
Document_Category_Reference  Document_Category__All_Object  [1..1]  Category of attachment.   
Content_Type  string (80)   [0..1]  Text attribute identifying Content Type of the Attachment.   
top
 

Document_Category__All_Object

part of: Certification_Attachment_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Document_Category__All_ObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Document_Category__All_ObjectID

part of: Document_Category__All_Object
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Document_Category__Workday_Owned__ID, Document_Category_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Unique_IdentifierObject

part of: Manage_Certifications_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Unique_IdentifierObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Unique_IdentifierObjectID

part of: Unique_IdentifierObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  IID, WID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

Event_Attachment_CategoryReferenceEnumeration

part of: Event_Attachment_CategoryObjectID
Base Type
string
top
 

RoleReferenceEnumeration

part of: RoleObjectID
Base Type
string
top
 

Person_Skill_Source_CategoryReferenceEnumeration

part of: Person_Skill_Source_CategoryObjectID
Base Type
string
top
 

Certification_SkillReferenceEnumeration

part of: Certification_SkillObjectID
Base Type
string
top
 

CertificationReferenceEnumeration

part of: CertificationObjectID
Base Type
string
top
 

CountryReferenceEnumeration

part of: CountryObjectID
Base Type
string
top
 

Specialty_ParentReferenceEnumeration

part of: Specialty_ParentObjectID
Base Type
string
top
 

Specialty_ChildReferenceEnumeration

part of: Specialty_ChildObjectID
Base Type
string
top
 

Document_Category__All_ReferenceEnumeration

part of: Document_Category__All_ObjectID
Base Type
string
top
 

Unique_IdentifierReferenceEnumeration

part of: Unique_IdentifierObjectID
Base Type
string
top