Сhange Log: 

Click here to expand...

Version	Date	Description

Version	Date	Description
2023.10.1.1	Nov 13, 2023	APMPI-1002 In the Replicator plugin, the AdonisHired and AdonisWaitlist parameters are added to the plugin’s parameters: Open In the Prescreen interface, the selected action will be immediately displayed in the Action column when selected and restore the current action when not selected. APMPI-1086 Fixed the issue on handling database names with dots
2024.10.1.1	Mar 5, 2024	APMPI-1124 Enhanced the plugin functionality with the following changes: Crew member’s data is considered as duplicate if name, surname and birthday are the same without regards to the uppercase. Application is set to the ADONIS_Hired status after updating or creating records. New parameters ADONISORGTEAMID, ADONISPINID are configurable: ADONISPINID stands for crew member’s PIN number in APM. ADONISORGTEAMID specifies the Organization name (XREF) under which a crew member must be placed in APM. Open The Address (Country, Address, ZIP) data is not updated in case crew members have the Current or Planned activity. The OLD Crew? and OLD PIN columns are removed from the APM Prescreen plugin.

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:

1. Switch to the Tools ribbon tab and click the Import button:
   
   

2. 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:

1. In the grid, select the record to be affected.

2. On the toolbar, in the Action drop-down list, select Update existing.

3. 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.

To process data as originally imported, follow the steps below:

1. In the grid, select the record to be affected.

2. On the toolbar, in the Action drop-down list, select Create new.

3. 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:

http://download.adonis.no/files/customers/seachefs/Prescreen/Replicator/UpdatePack_PRS_2021.10.0.12.cab

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:

1. On the left-hand side pane, select the service which you got connected to and navigate to Updatable programs.

2. In the Updatable programs node, select the plugin to be affected. Right under the selected plugin, select Plugin parameters.

3. 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:

4. On entering, click OK to proceed.

Below, you will find the description of parameters required for the Prescreen plugin:

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:

1. On the ribbon, click New to make the dialog appear:

2. Enter a Code (mandatory field), a unique alpha-numeric APM code.

3. In the Text field, indicate the name of an interface and its alternative name, if needed, in the Alternative field.

4. In the Sort field, define the order number of a record (where 0 means the first record in the list).

5. 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.

6. 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:

1. Select the organization to which a person is linked.

2. 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”.

3. When completed, click Apply to save the changes.

Field Mapping