Prescreen Recruitment plugin (APM/Replicator)
Сhange Log:
Description
The Prescreen plugin is designed to import data from the Prescreen recruitment tool directly to Adonis Personal Manager. The workflow foresees the installation of two plugins: Prescreen Replicator and Prescreen APM.
The Prescreen Replicator plugin is required to import crew from Prescreen, assign data to proper companies, check for duplicates, update the statuses of the data imported to Prescreen. The APM Prescreen plugin allows users to decide on how to process data in APM.
- 1.1 Сhange Log:
- 2 Description
- 3 Functionality
- 3.1 Get Started
- 3.1.1 Overview of APM Plugin
- 3.1.2 Manage Data
- 3.1 Get Started
- 4 Housekeeping
- 4.1 Prescreen Replicator Plugin
- 4.1.1 Downloading Plugin
- 4.1.2 Installing Plugin
- 4.1.3 Setting Parameters
- 4.1.4 Prescreen Code Setup
- 4.2 Prescreen APM Plugin
- 4.2.1 Download & Install
- 4.2.2 Set Code Reference
- 4.3 Define Organization Cross Reference
- 4.4 Field Mapping
- 4.1 Prescreen Replicator Plugin
Make sure to install both the Prescreen Replicator and Prescreen APM plugins. For more information, see the Housekeeping section.
Functionality
The section will teach you how to process data available in the APM Prescreen plugin.
Get Started
To access the plug-in, log into APM and follow the steps below:
Switch to the Tools ribbon tab and click the Import button:
From the drop-down list, select Prescreen. The Prescreen main screen then appears:
Overview of APM Plugin
For each candidate to be imported to APM, the system allows you to choose whether you want to import a new candidate to APM or update the records of the existing candidate.
Let us review the grid columns:
S allows selecting the fields that you want to be exported.
Action shows the actions to be applied: Create new or Update existing.
ID is an identification number a candidate fetched from Prescreen.
Duplicate Pin is a pin number to be selected in case you want to process the record as Duplicate. The selected PIN will be then updated with new records.
First Name specifies the candidate's first name.
Last Name specifies the candidate's last name.
Birth Date is the candidate’s date of birth.
Gender is the candidate’s gender: F - female, M - male.
Nationality is the candidate’s nationality.
eMail is the candidate's e-mail address.
Phone is the candidate's phone number.
Country is a name of the country where a candidate lives. The data is represented as an ISO country code.
Address is a candidate's actual address.
Zip is a numeric post code.
AdonisTeam ID is a cross reference of the orgamization name to which a candidate is to be linked.
AdonisTeam Name is the APM organization name to which a candidate is linked.
Manage Data
The plugin enables you to decide on how to process the data: create a new record or update the existing one. To update the exisiting record, follow the steps below:
In the grid, select the record to be affected.
On the toolbar, in the Action drop-down list, select Update existing.
Click Apply.
As a result, the system shows you the message stating the request is processing:
As a result, the records will be updated in the database.
Candidate’s data is considered as duplicate if first name, lastname and birthday are the same without regards to the uppercase. If a duplicate record is found, it is not not imported in to APM, instead, it is pending in Waiting Room.
The Address (Country, Address, ZIP) data is not updated in case crew members have the Current or Planned activity.
To process data as originally imported, follow the steps below:
In the grid, select the record to be affected.
On the toolbar, in the Action drop-down list, select Create new.
Click Apply.
As a result, the system shows you the message stating the request is processing:
Original data will be added to the database as a new record.
Housekeeping
The section covers the download, installation and configuration procedures of both the AMP Prescreen and Replicator Prescreen plugins.
Prescreen Replicator Plugin
The section allows you to perform a one-time setup of the plug-in.
Downloading Plugin
To download the plugin, go to your ftp area by following the link below:
Installing Plugin
Once the download is complete, follow the link below to get the instructions on how to install the plugin:
Installing and distributing the Replicator plug-in
Setting Parameters
After the plugin is installed, it is necessary to specify parameters for the Site(s). To do this, follow the steps below:
On the left-hand side pane, select the service which you got connected to and navigate to Updatable programs.
In the Updatable programs node, select the plugin to be affected. Right under the selected plugin, select Plugin parameters.
In the Update parameters workspace, select the Site for which you want to add parameters and click the Add button. Clicking the command displays the Add new command dialog where you can enter the parameters one by one:
On entering, click OK to proceed.
Below, you will find the description of parameters required for the Prescreen plugin:
Name | Value |
|
---|---|---|
APIKEY | BSoA2CThNqqStbNqTF4v1JGaDmvCVaZa |
|
CLIENTID | pworg.NUMORGID “value”, ex. “10000005” |
|
CVODE | CV |
|
DATABASE | Enter the database name used when installing Adonis Personnel Manager. |
|
DEBUGLOG | 3 |
|
NOHIRE | Parameter needed for testing. Values can be '1' or ‘0’ - if this parameter is set to ‘0’, the “ApplicationStatus” will be set to 'Adonis Hired', after that processed application will not be available and cannot be used for testing again; |
|
RCFCODE | RCF |
|
SERVER_NAME | Specify the server name to which to connect. |
|
SERVICE_URL |
| |
XREF | Enter the Prescreen plugin code defined in Adonis Personnel Manager. |
|
ADONISORGTEAMID | Specifies the Organization name (XREF) under which a crew member must be placed in APM. The field value is configurable. |
|
ADONISHIRED | Contains a numeric field value identifying that a candidate is successfully imported to APM. The field value is configurable. |
|
ADONISWAITLIST | Contains a numeric field value identifying that a candidate is in the waiting list. The field value is configurable. |
|
ADONISPINID | Stands for crew member’s PIN number in APM. The field value is configurable. |
|
Prescreen Code Setup
To export data, it is required to define the Prescreen plugin code reference. To do this, first, log into the Adonis Personnel Manager. Once logged in, navigate to the Setup ribbon tab > General Codes > Miscellaneous > Interfaces and proceed with the following steps:
On the ribbon, click New to make the dialog appear:
Enter a Code (mandatory field), a unique alpha-numeric APM code.
In the Text field, indicate the name of an interface and its alternative name, if needed, in the Alternative field.
In the Sort field, define the order number of a record (where 0 means the first record in the list).
In the Is Passive field, specify whether the code is to be active or passive. Passive codes appear as disabled. It is recommended to set a code to Passive if it will no longer be in use.
Click OK to proceed.
As a result, a new record appears in the grid of Interfaces:
Prescreen APM Plugin
The section allows you to perform a one-time setup of the APM plug-in.
Download & Install
To download the plugin, go to your ftp area by following the link below:
http://download.adonis.no/files/customers/seachefs/Prescreen/APM_Plugin_Prescreen_2021.10.0.7.exe
Once the download is complete, follow the link below to get the instructions on how to install the plugin:
Installing and distributing the Replicator plug-in
Set Code Reference
To configure the plug-in, first, start it and click Settings on the toolbar of the plug-in main screen. This opens the Settings dialog:
In the XREF Code field, set the Prescreen plugin code reference that you have defined in the Prescreen Code Setup section.
Define Organization Cross Reference
To define a cross reference for an organization, go to the Setup tab > Organization structure:
Select the organization to which a person is linked.
Switch to the XRef tab and click the Append button. Clicking the command enables the fields to be filled out:
Interface. Select the Prescreen interface code from the drop-down list. If the Prescreen code selection is unavailable, you need to define it by following the instructions in Prescreen Code Setup.
Xref Code. Enter a cross reference of the candidate ID.
Comment. Enter the nationalities of the candidates linked to the Organization, ex. “AT, DE, CH” or “All except AT, DE, CH”.
When completed, click Apply to save the changes.
Field Mapping
Prescreen | Adonis | Comments | Insert | Update |
candidate_id | Xref PIN |
| Yes | Yes |
Org level in Personal Details | Mapped by Team Xref | Yes | Yes | |
profile.firstname | First name in personal details |
| Yes | No |
profile.middlename | Mid name in personal details |
| Yes | No |
profile.lastname | Last name in personal details |
| Yes | No |
profile.phone | Mobile Phone in personal details |
| Yes | Yes |
Birthday | Birth date in personal details |
| Yes | No |
Gender | gender in personal details. | Adonis -- Prescreen | Yes | Yes |
Street | Address in personal details |
| Yes | Yes |
zip_code | Zip in personal details |
| Yes | Yes |
city_name | City in personal details |
| Yes | Yes |
country_of_residence | Country in personal details | Use Alpha-2 codes. Eg: DE | Yes | Yes |
E-mail in personal details |
| Yes | Yes | |
CV | Enclosed documents under CV group |
| Yes | Yes |
custom_field_id (131907) | Nationality | Use Alpha-2 codes. Eg: DE | Yes | Yes |
Recruiter files | Put the files on the basket |
| Yes | Yes |