Introduction
...
To access the plugin, log into APM and follow the steps below:
Switch to the Tools ribbon tab and click the Export button:
From the drop-down list, select Traficom Export. The Traficom Export main screen then appears:
Export Data
On accessing the plugin, you can now proceed with the following steps:
Define the date range to be covered. On the toolbar, pick the Date From and Date To dates. This shows a list of seafarers:
In the list, select the records to be exported and click Send To Trafi. In the Confirm dialog, click Yes to proceed to data export:
You can see the data export in progress. When completed, click Close to exit the dialog.
As a result, the records are exported to Trafi.
...
The latest plug-in version is available here: Traficom Export.
Connection Settings Configuration
...
API BaseAddress is the API address of Traficom Export: https://sosotes.trafi.fi/henkilo/tapahtuma/meripalvelu/v1.0/
Organization ID is a unique company ID number.
System ID is a unique system ID number provided by Traficom after the registration.
Certificate Path is a path to the local directory where the business certificate is to be saved. See step 1, Installing the Browser Certificate, below.
Certificate Password is used to unzip the business certificate. The password is provided after the registration.
Enable dry-run mode (The changes will not be not committed), if selected, enables the testing mode. This means no changes will be exported.
...
Enable store session’s data, if selected, allows storing LOG files locally.
Output The output folder (available if the Enable to sore session’s data is selected) is a path to the local directory where the LOG files will be saved.
...
A business certificate is a confirmation of your identity. It is specifically intended for protecting data and establishing a secure network connection. Let us follow Follow the steps below to install the business certificate in a browser.
...
To get started, first, download the PrivateKey.zip file and unzip it. Once the download is complete, go to the downloaded path and double-click the installation file (*.p12) to launch a setup wizard.
Step 2
When the Welcome dialog dialogue appears, select the certificate store to be used:
...
Step 3
In the File to Import dialog dialogue, specify the file name to be imported:
...
In the Private key protection dialog dialogue, enter the key password:
...
When the Certificate store dialog dialogue appears, specify the certificate location by selecting one of the options:
...
If the import is successful, you are then notified as follows:
...
To export data, it is required to define the Traficom Export 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:
...
To configure the rank codes, go to the Setup ribbon tab > General Codes > Personal Details > Ranks and proceed with the following steps:
Click the New button in the Actions group of the Manage ribbon tab. The General Code Editor (Ranks) dialog appears:
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)
Switch to the XREF tab and click the Append button. Clicking the command enables the fields to be filled in:
Interface. Select Trafi from the drop-down list. If the Trafi selection is unavailable, you need to define the Trafi interface by following the instructions in Traficom Code Setup.
Xref Code. Enter a cross-reference provided by Trafi for this particular record.
Comment. Enter a rank name provided by Trafi.
When completed, click OK to confirm the changes.
| Info |
|---|
Xref codes are not random values, but those provided by Trafi. It is recommended to make a cross references list agreed with Trafi beforehand. |
...