Description

The SIRE Officer Metrix Interface plug-in is intended for collecting APM data and exporting it to OCIMF.

Functionality

This section will guide you through the procedure of exporting the required data to OCIMF / SIRE Officer Metric.

Exporting Data

On performing all the necessary setup as well as assigning assigning ranks and competences to crew members, you can now export data to OCIMF / SIRE Officer Metric. For this, simply switch to the Tools ribbon bar and click the Export button. From the drop-down list, select the OCIMF / SIRE Officer Metric option to make the following dialog appear on the screen:

Within the dialog, proceed as described below:

1. On the toolbar, define the settings for crew selection:
   • Company. From the drop-down list, select the company which crew members are linked to.
   • Vessel. From the drop-down list, select the vessel which crew members are linked to.

   • Date From. Specify the date when crew members are active (those with the Current onboard activity) on the selected vessel(s).

     Info
     The grid displays a list of crew members with the Current onboard activity only.

     
     

2. Specify the records you would like to be exported by selecting the corresponding checkboxes. In addition, you can use the Tag All button to select all the records and Untag All to cancel the applied selection.

3. Click Export to see the export in progress:
   
   

   Info
   When exporting crew data, the plugin checks whether a document is available for the selected vessel in OCIMF. In case the document exists, it is used for exporting crew data. Otherwise, a new document is created.

   
   

4. When successfully completed, click Close to finish.
   
   

Housekeeping

Before getting started with the plugin, cover the sections below to perform a one-time setup.

Anchor
Interface Code Setup Interface Code Setup

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:

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 Metric. 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 web 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 3660742829.

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:
   Image Modified
   
2. Create a new rank record by filling in 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.
   

   Info
   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 Metric interface by following the instructions in 3660742829.

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

     Info
     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:

Linking 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:

Within the dialog, follow the steps below:

1. Navigate to the Options tab > the Interface - xref subtab.
2. In the Q88/Officer Matrix drop-down list, select the rank code you have defined specifically for the code rank. The Q88/Officer Matrix drop-down list displays all rank records that you linked to Q88/Officer Matrix interface.
3. Click OK to save the changes.

Anchor
Competence Codes Setup Competence Codes Setup

Competence Codes Setup

To configure the competence codes, go to the Setup ribbon tab > General Codes > Competence > Competence Codes and proceed with the following steps:

1. Click the New button in the Actions group of the Manage ribbon tab. The General Code Editor (Competence) dialog appears:
   Image Modified
   
2. Within the dialog, create a new competence record by filling in 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).
   • In the STCW Code field, enter a code that specifies the standard of competence achieved by a crew member.

3. Within the dialog, go to the Options tab > the Details subtab and set the Document Type to Certificate of Competence:
   

   Image Modified
   

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 Metric interface by following the instructions in 3660742829.

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

     Info
     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 new competence record becomes available in the grid:

Adding Proficiency Level Competence

To determine the proficiency level of English, you can create a competence with specific options. For this, go to the Setup ribbon tab > General Codes > Competence > Competence Codes and follow the steps below:

1. Click the New button in the Actions group of the Manage ribbon tab. The General Code Editor (Competence) dialog appears:
   Image Modified
   
2. Within the dialog, create a new competence record by filling in 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).
   • In the STCW Code field, enter a code that specifies the standard of competence achieved by the seafarer.

3. Within the dialog, go to the Options tab > the Details subtab and set the Document Type to Language Proficiency:
   

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 Metric interface by following the instructions in 3660742829.

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

     Info
     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 new competence record becomes available in the grid:

Now, you can create a competence with the defined competence code in the Competence datagroup for a selected crew member under the following conditions:

• Crew members have the Current sea-service activities;

• Crew members have the corresponding competence document for Rank.

Defining Certificate Options

Based on the certificate type you have defined in 3660742829, you can define the options as described below. To do this, open the competence code which you want to define options for and switch to the Interface - xref subtab on the Options tab:

The following options are available:

• Certificate of competence. For this certificate type, select one of the options: Class 1, Class 2, EOOW, OOW or None.

  Info
  The options are available only in case the Certificate of Competence document type has been set on the Details subtab.

  
  

• STCW certificate. For this certificate type, define one of the options: Para 1, Para 2 or N/A.

  Info
  The options are available only in case the STCW option has been set on the Details subtab.

  
  

• Radio Qualification Certificate. Select the option if the certificate relates to radio qualifications.
• Is Tanker Certificate. Select the option if it is a Tanker Certificate. On selecting, the Tanker Certification options become available: Chemical, Gas, Oil, All/General.
• Administrative Accepters / Endorsement certificate. Select the option if it is an endorsement certificate.
• Watch Keeping Certificate. Select the option if it is a watch keeping certificate.

Nationality Setup

You can now determine nationality names. To do this, navigate to the Setup ribbon tab and click the Tables button. From the drop-down menu, select the Regions Editor option. The functionality becomes active from the Manage ribbon tab, where you can view the list of available countries as well as the corresponding nationality names:

Make sure the nationality names in the grid matches the names used by SIRE Office Metric Interface.

Installation

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

Access Rights

On installing the plugin, make sure that the access rights are granted to you. For this, log into Adonis Control Center and proceed with the following steps:

1. Switch to the Plugins tab
2. On the left-hand Security Levels pane, select the users' security levels you want to assign permissions to.
3. In the working area, select the OCIMF/ SIRE Office Metric interface checkbox in the Enabled column:
   
   
4. Click Save on the ribbon.