Installation

Step 1

To start the installation, go to your ftp area and download the latest version of the SIRE Office Metric Interface plugin.

Once the download is complete, go to the downloaded path and double-click the installation file to launch a setup wizard. This makes the Welcome dialog appear on the screen:

Click Next to continue.

Step 2

Select the directory where the Adonis Personnel Manager application is installed. To do this, click Browse… and indicate the destination folder:

Click Install to initiate the installation process.

Now, you can see the installation in progress:

When completed, click Next.

Step 3

The installation is successfully completed:

Click Finish to close the setup wizard.

Housekeeping

Interface Code Setup

To configure the SIRE Office Metric Interface plugin, go 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:

IMG

Connection Settings Configuration

To configure the SIRE Office Metric Interface connection settings, navigate to the Tools ribbon tab and click the Export button. From the drop-down list, select OCIMF / SIRE Officer Matric. This opens the following dialog:

Within the dialog, click the Settings button to view the dialog:

Define the settings as described below:

• OCIMF Service Url is a URL link to the OCIMF service.
• Secret Token is an authentication data that replaces user credentials. Tokens are issued via PDF for the exclusive use of a named vessel operator.
• XREF Code is the OCIMF code name you have specified in Interface Code Setup.

Click Save to continue.

Rank Codes Setup

To configure the rank codes, go to the Setup ribbon tab > General Codes > Personal Details > Ranks and proceed with the following steps:

1. Click the New button in the Actions group of the Manage ribbon tab. The General Code Editor (Ranks) dialog appears:
   
   
2. Within the dialog, create a new rank record by filling the fields below:

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

3. Within the dialog, go to the Options tab > Interface - xref subtab and select the Q88/Officer Matrix option for the rank. The record automatically becomes passive.
   

   The export to the Q88 function enables users to compile all the data required for the Q88 site in the XML file that may be uploaded.

   
   

4. Switch to the XREF tab and click the Append button. Clicking the command enables the fields to be filled out:
   • Interface. Select OCIMF from the drop-down list. If the OCIMF selection is unavailable, you need to define the SIRE Office Matric interface by following the instructions in Interface Code Setup.

   • Xref Code. Enter a cross reference provided by OCIMF for this particular record.

     Xref codes are not random values, but those provided by OCIMF. It is recommended to make a cross references list agreed with OCIMF beforehand.

   • Comment. Enter any comment you want to add.
     
     
5. When completed, click OK to confirm the changes.

As a result, a passive rank record becomes available in the grid:

IMG

Link Ranks to Q88

You can now link an existing rank to the Q88 rank name. To do this, navigate to the Setup ribbon tab > General Codes > Personal Details > Ranks and double click the rank which you want to link to the Q88 rank name. This makes the dialog appear:

Ranks setup is performed in General Codes -> Ranks. Create new ranks records, input the rank names that correspond to Q88 allowed names*. It is not important, what code will be inputted for the new rank records. You can set a very low sorting on these new records, e.g. 9000. Select the option Q88/Officer Matrix for such ranks. Select the option "Deck", "Engine" or "Other" to show relation to a department where the rank belongs to. The record will become passive automatically. Click OK to save and close new rank record. YearsOnWatch: *Allowed rank names: Master Chief Officer 1st Officer 2nd Officer 3rd Officer 4th Officer Chief Engineer 1st Engineer 2nd Engineer 3rd Engineer 4th Engineer 5th Engineer Gas/Cargo Engineer Electrical Engineer ETO ETO/Radio Officer Junior Engineer Assistant Engineer Electrical Officer
Open existing ranks and link them to the Q88 rank names. For that switch to the tab Interface-xref, and click on the Q88/Officer Matrix drop-down. The list in the drop-down will display all rank records that you linked to

Functionality