Functionality

The section will teach you how to operate the plugin.

To get started, first, open the plugin. For this, switch to the Tools ribbon tab and click the Import button. From the drop-down list, select Process Side Duties. The Process Side Duties main screen then appears:

Image Added

After processing the timesheets in Adonis Personnel Portal and selecting the side duties payroll entry(ies) to be involved (see Select Payroll Entry), the records containing the selected payroll entry(ies) are then displayed on the main screen:

Image Added

The transactions listed are the payroll transactions imported from the timesheets. The transactions are not yet paid.

Set Location

On defining the payroll field where you to display the location (see Assign Location to Payroll Field), you can now specify the location value. There are three hardcoded location values:

• Domestic Port is set if a crew change takes place in the US port.

• International Port is set if a crew change takes place in a port other than US.

• At Sea is set if a crew change does not take place.

To specify a location value, first, make sure you are in the Side Duties tab of the plugin window:
Image Modified

Within the window, select the crew member to be affected and follow the steps below:

1. At the bottom left-hand corner, click the arrow 

1. Image Added

   to view the list:
   

1. Image Added

2. From the appeared drop-down list, select Location. This opens the Set Location dialog:
   

1. Image Added

2. In the drop-down list, select the location value you want to add.

3. Click Apply to save the selection.
   
   

As a result, the selected location appears in the Location column of the grid based on the selected crew member(s):
Image Modified

When done, click Apply at the bottom right-hand side corner of the plugin window.

Set Cost Group

After defining the cost group(s) (see Define Cost Group), you can set cost groups for crew members. For this, first, make sure you are in the Side Duties tab of the plugin window:

Image Added

Within the window, select the crew member to be affected and follow the steps below:

1. At the bottom left-hand corner, click the arrow 

1. Image Added

   to view the list:
   

1. Image Added

2. From the appeared drop-down list, select Cost Group. This opens the Set Cost Group dialog:
   

1. Image Added

2. In the drop-down list, select the location value you want to add.

3. Click Apply to save the selection.
   
   

As a result, the selected cost group appears in the Cost Group column of the grid based on the selected crew member(s):

Image Added

Once completed, click Apply at the bottom right-hand side corner of the plugin window.

Housekeeping

The section will guide you through the configuration of the plugin. By following the guidelines, you will learn how to:

• Select the payroll entries identifying side duties. For more information, see Select Payroll Entry.

• Define the cost groups. For more information, see Define Cost Group.

• Define the payroll field that will contain the cost group value. For more information, see Assign Cost Group to Payroll Field.

• Define the payroll field that will contain the location value. For more information, see Assign Location to Payroll Field.

Install plugin

To install the plugin, navigate to Install APM Plugin and follow the step-by-step instructions carefully.

Anchor
Select_Payroll_Entry Select_Payroll_Entry

Select Payroll Entry

To specify the side duties payroll entries to be affected, first, make sure you are in the Configuration tab of the plugin interface:
Image Modified

In the grid, select the payroll entry(ies) you want to be involved. 

As a result, the records containing the selected payroll entry(ies) will appear in the Side Duties tab:
Image Modified

Anchor
Define_Cost_Group Define_Cost_Group

Define Cost Group

To define the cost group codes, go to

the Setup

 ribbon tab

> General Codes > Vessel

 > Cost Group and proceed with the following steps:

1. Click the New

1.  button in

1. the Actions

1.  group of

1. the Manage

1.  ribbon tab.

1. The General Code Editor (Cost Group)

1.  dialog appears:
   Image Modified
   

2. Within the dialog, create a new cost group record by filling in the fields below:

   • Enter a

1. •  Code (mandatory field), a unique alpha-

1. • numeric APM

1. •  code.

   • In the Text

1. •  field, indicate the name of a cost group and its alternative name, if needed, in

1. • the Alternative

1. •  field.

   • In the Sort

1. •  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.

2. When completed, click OK to save the record.
   
   

As a result, a new record appears in the grid:
Image Modified

Anchor
Assign_Cost_Group Assign_Cost_Group

Assign Cost Group to Payroll Field

You can define the payroll field that will contain the cost group value. To do this, first, switch to the Configuration tab in the plugin interface:
Image Modified

In the Cost Group drop-down list, select the payroll field where you want to display the cost group value. 

Anchor
Assign_Location Assign_Location

Assign Location to Payroll Field

To define the payroll field that will contain the location value, first, switch to the Configuration tab in the plugin interface:
Image Modified

In the Location drop-down list, select the payroll field where you want to display the cost group value.