Start a conversation

Portal Import Tool

Overview

The Influence Candidate Portal Import Tool can be found in the Toolbox in the workbench.  It scans a dedicated Outlook Mailbox, creating Candidates, matching them to Vacancies and updating their Compliance documents.  It can be run an ad-hoc fashion or automatic mode when logging in as a specific user (normally "AUTO").

Typically a Web Developer would create a set of web pages for you to catch Candidate registrations and validate all the data entered. The applicant then uploads their CV along with any required compliance documentation.  The web site then submits an email to the dedicated mailbox,
e.g. applications@your_agency.co.uk with all the attachments. (The find out more about attaching compliance documents, click HERE)

On the Influence database the portal program will recognise a candidate registration email by the contents of the Subject (Normally "Website CV Registration") and the fact that it has an attachment, i.e. the CV of the applicant.  If no CV has been uploaded a dummy CV must be attached to trigger the Portal Import to process the application.

The body of the email contains an XML segment which is used to load the Candidate record, Match them to Jobs, Update Notes and save the Compliance docs in the correct section of the database.

Example Email Body

<influence>
<vac_gen_ref>VR/00001</vac_gen_ref>                                       
 Match this candidate against this Job
<cand_title>Ms</cand_title>
<cand_forename>Fred</cand_forename>
<cand_surname>Flintstone</cand_surname>
<cand_dob>19051969</cand_dob>
<cand_phone>01372456363</cand_phone>
<cand_mobile>0715049009</cand_mobile>
<cand_email>Freddy.Flintsone@company.com<cand_email>
<cand_basic_sal>1234</cand_basic_sal>
<cand_soc_net_site1>Linkedin Address </cand_soc_net_site1>
<cand_expertise>Other</cand_expertise>
<cand_type>PERM</cand_type>
<cand_addr_line_2>First Line</cand_addr_line_2>
<cand_addr_line_3>Town</cand_addr_line_3>
<cand_addr_line_5>County</cand_addr_line_5>
<cand_addr_line_6>Country</cand_addr_line_6>
<cand_postcode>KT198YY</cand_postcode>
<cand_curr_emp>ABC Holdings </cand_curr_emp>
<cand_job_desc>Biomedical Engineer</cand_job_desc>
<cand_current_sal>40000</cand_current_sal>
<cand_pay_rate1>2500.00</cand_pay_rate1>
<cand_req_rate>2500.00</cand_req_rate>
<cand_currency>$</cand_currency>
<cand_rate_type>MTH</cand_rate_type>
<cand_cont_rate_type>MTH</cand_cont_rate_type>
<cand_notice>MTH</cand_notice>
<cand_perm_yn>IA</cand_perm_yn>
<cand_cont_yn></cand_cont_yn>
<cand_enq_src>WB</cand_enq_src>
<cand_*notes>
The quick brown fox</cand_*notes>           
 Notes can be added by adding multiple tags
<cand_*notes>
 jumps over the lazy dog </cand_*notes>
<cand_*attribs>Other</cand_*attribs>                                               
 Attributes match up with short name
<cand_*attribs>RGSTRTNV</cand_*attribs>
<cand_*attribs>MDCLDVCS</cand_*attribs>
<cand_*attribs>PRMNT</cand_*attribs>
</influence>

System Setup

In order for this to work, there are certain parameters which must be setup within the system. These can be found in Maintenance > Setup > Parameters.

Parameters

Choose the following parameters to set the system up.

Parameter Set=Influence Professional, Tab=Text

This will tell the system what to look for as the Subject of any emails received, so that it knowsto treat these as Portal Import emails.


Parameter Set=Web Parameters, Tab=Text

These parameters tell the system which TAGS are used in the body of the XML, and what status to create any MATCH record at, if you are using the system to create matches (NB: You should not change these settings without guidance from Influence.)


Parameter Set=Influence Professional Workbench, Tab=Text


Parameter Set=WORKBENCH, Tab=Flags


This parameter is used to specify a particular UserID which can use the 'CV Portal' tool -> it prevents other users accidentally clicking on the Portal Import Tool when they mean to choose Mailbox CV Tool.

Example Of Usage

 If you login to the system as the nominated UserID e.g. (AUTO) you are then able to navigate to WORKBENCH > TOOLS > Portal Import Tool.

Once you select this option,  the portal import tool  will begin to scan the nominated mailbox looking for emails with the relevant subject and will then try to process the BODY of the email in order to create a candidate record.

 

 

Choose files or drag and drop files
Helpful?
Yes
No
  1. Desmond Jones

  2. Posted
  3. Updated

Comments