Portal Import Tool

Created by Martin Parkinson, Modified on Thu, 6 Jul, 2023 at 2:33 PM by Martin Parkinson

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@youragency.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


VR/00001                                       
 Match this candidate against this Job
Ms
Fred
Flintstone
19051969
01372456363
0715049009
Freddy.Flintsone@company.com
1234
Linkedin Address
Other
PERM
First Line
Town
County
Country
KT198YY
ABC Holdings
Biomedical Engineer
40000
2500.00
2500.00
$
MTH
MTH
MTH
IA

WB
The quick brown fox           
 Notes can be added by adding multiple tags
 jumps over the lazy dog 
Other                                               
 Attributes match up with short name
RGSTRTNV
MDCLDVCS
PRMNT


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(s)
Description
PROFESSWB, Text(19)
CV portal tool detection subject text
The subject of emails to be treated as CV portal submissions  - e.g. Web Registration
WEB, Text (14-18)
Default new candidate web Status
Portal registration XML candidate prefix
Portal registration XML vacancy prefix
Portal registration default Match status
Portal registration default  Attribute text tag
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.
PRO-WBEN, Text(6)
Portal compliance prefix
The prefix to be used for any documents for compliance.
WORKBENCH, Flag(6)
This is used to specify which userID (e.g. AUTO) is allowed to run the Portal tool.
(It prevents other users accidentally clicking on the Portal Import Tool when they mean to choose Mailbox CV Tool.)





NB: You should not change these settings without guidance from Influence.


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.

P5

 



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article