Candidate PIF Webservice

Please Note: this webservice is to be used with Old Appliciation Forms and is NOT to be used with RAC - Responsible Application Component.

The Candidate PIF Webservice (Simplified ApplicationProcess WS) gives a customer the possibility to create a flexible and bespoke one-page application process and implement it on their career site.

Using the Methods available within that web service it is possible to create candidates with their applications within TalentLink as well as adding their attachments.

This Web service includes three new methods:

• getPifStructure – this method is used to get the most recent structure of Personal Information Form (PIF) assigned to the  relevant posting
• submitApplication - this method is used to create the candidate’s application in TalentLink based on provided filled forms.
• savePif – this method creates the candidate’s application in TalentLink with correctly structured PIF
• addAttachment – this method adds attachment/s to the candidate’s application created by savePif method

Typical workflow

Use Case

This new Web service supports customers in the creation of a simple application process which allows candidates to put all their data onto a single page and submit this application without going through a more complex application process extended over several pages as traditional with TalentLink.

Customers can build a custom one page application process based on the structure of the assigned PIF. Customers may then build their career site with no lay-out and style constraints.

Pre-requisites:

A candidate’s application will be created against relevant postings which first have to be fetched using dedicated web service methods available in different bundles/projects.

The structure of the PIF has to be defined in TalentLink back office and assigned to relevant application process and to relevant advertisements (known as postings). Advertisement should be posted to career site (technical ID) from where candidates will be created.

An example scenario

   Building one page application process

1. A configurable PIF is created in TalentLink and set as career site PIF or defined in standard /default application process for the specific organization (it is also possible to link one page application process with customized application process but then if different application processes take advantage of different PIFs, one page application process has to be created per posting, which is less stable but flexible solution)
2. To retrieve the structure of the PIF assigned to relevant career site or standard application process an advertisement (or example advertisement) has to be published on that site and the interface has to call getPifStructure method.
3. Based on the structure provided in the response a one page application process can be built.

   Creating Candidates

1. The one page application process is built.
2. A job is created in TalentLink and posted to a relevant career site where a one page application process is implemented.
3. The candidate completes the form (PIF) and submits their application. 
4. To create the candidate’s application in TalentLink against the relevant job the interface has to call the savePif method and then it passes the relevant data provided by the candidate as well as data related to posting (postingTargetID) and form (formID) 
5. If the candidate added attachment/s, the interface has to fetch a token from the response after running the savePif method. 
6. To add the attachment/s to the relevant candidate’s application the method addAttachment should be called with the file defined in a binary format (coding: Base64) as well as relevant information about attachment which should be provided in the call. 
7. If the candidate added more than one attachment, step 6 should be repeated as many times as required for number of attachments. 

Response Format

XML