Tidomat Interface

Сhange Log: 

Click here to expand...

Version	Date	Description

Version	Date	Description
2022.30.0.5	Feb 10, 2023	APMPI-797 Changed internal request used to fetch cardholders from Tidomat
2023.20.1.1	May 18, 2023	APMPI-877 Added new field <KOD> while registering and updating cardholders data. The information will be fetched from person`s birthdate in YYMM format and fetched in Tidomat as Pin Code. APMPI-879 Added new field 'Avdelning' to the export: It will fetch Xref from PWORG_Xref for the department above the position, defined on the activity; If PWORG_Xref is empty, then the plugin will check PW001C000_XREF; If both PWORG_Xref and PW001C000_XREF are empty, then message will appear and person will be skipped; Open
2023.30.1.1	Jun 16, 2023	APMPI-925 - Added converting of the card data from Hexadecimal to Decimal. So from now Cards data will be sent in decimal format to Tidomat.
2023.30.3.1	Oct 25, 2023	APMPI-958 - From now on Mifare and E-Marine RFIDs will be expanded with zeros at the beginning in case they have less than 13 characters.   APMPI-1017 - Provided the following enhancements in the plugin: Added the DaysGap plugin parameter. Added the DaysGap parameter to the persons selection. From now on, the Tidomat plugin selects all persons with the Current and Planned Seaservice Activities with DateFrom <= Today+DaysGap. Selected persons will be sent to Tidomat. When updating and creating records in Tidomat, StopDatTid=NULL and ExpiredDate = NULL are set.   APMPI-1018 - applied the following changes: StopDatTid is set to DateTo if a person is not included in the plugin selection, but active on the Tidomat side. ExpiredDate is set to CurrentDate:23:59:59 if a person is not included in the plugin selection, but active on the Tidomat side.
2023.30.4.1	Nov 13, 2023	APMPI-1079 - In the Tidomat plugin, set StopDatTid to P03.TODATEESTIMATED based on the following logic: IF PW001P03.TODATEESTIMATED < CURRENTDATE THEN SET STOPDATTID=CURRENTDATE+23:59:59 ELSE PW001P03.TODATEESTIMATED = > CURRENTDATE THEN SET STOPDATTID=PW001P03.TODATEESTIMATED+23:59:59 The ExpiryDate is disregarded and not updated.
2023.30.5.1	Dec 19, 2023	APMPI-1098 - The StartDat and StopDat data has been removed from the Access Areas details.
2023.30.6.1	Apr 26, 2024	APMPI-1194 - Both RFIDs are converted to DEC: Mifare RFID is converted to a decimal number during export and becomes a number with leading zeroes (11-digit number). Em-Marine RFID is converted to a decimal number during export and becomes a number with leading zeroes (14-digit number). Open   APMPI-1197 - Changed the format of RFIDs sent to Tidomat: Leading zeros are added to Mifare card RFIDs to display a 13-digit number. Leading zeros are added to Em-Marine RFIDs to display a 13-digit number.

Compatibility

Compatible with APM 2020.10 or higher*

Terminology

Tidomat PW32 Easy Client

Security product TIDOMAT PW32 is a door lock system to give access/permission to each on-boarding crew member. Using magnetic stripe that is printed on the card or paper.

Access Areas Module

The Access Areas module is specifically designed to grant/restrict access of crew members to various onboard areas. The main purpose of the module is to ensure the security of each access to areas.

For more information please read https://adonishr.atlassian.net/l/cp/eqVRgMyd

Tidomat Replicator Plugin

The replicator is an application intended for executing plug-ins to perform tasks like exchanging data to 3rd party systems. These plug-ins are scheduled similar as the replication tasks but execute in separate thread using there own scheduler.

For more information please read Installing and distributing the Replicator plug-in.

Process Flow

The Replicator will send the parameters needed to Tidomat. The System Administrator can schedule a DateTime when to update the web service.

If the crew member is not existing in Tidomat, then a new account will be created.

If the crew member is existing in the Tidomat but is not on the scheduled update, then the account will be deleted in Tidomat. This is for security purposes, so the crew member can no longer access the decks and departments.

Sequence Diagram

MOF - Mapping of Fields

The Replicator is sending the following to Tidomat

Functionality

You can grant/restrict crew members' access to various onboard areas. For this, log into Adonis Personnel Manager and follow the instructions of the Access Area module.

On granting access areas permissions, run Replicator Manager and start the replication task. As a result, the Replicator Manager will send the required parameters to the Tidomat interface.

Housekeeping

Downloading Plugin

To download the plugin, go to your FTP area by following the link below:

http://download.adonis.no/files/upgrade/PersonnelManager/Plugins/Replicator/TDM/

Be advised to download the latest version of the plugin.

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 Plugin 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 to which you got connected 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 the parameters required for the Tidomat plugin:

Configuring Access Areas

You can define the areas for which you want to provide secure access. The system allows for defining access areas for a vessel and a department. For more information, see the following chapter:

Define Access Areas

Monitoring Surveillance

Execution Status

To retrieve the latest interface execution status, open Replicator Manager.

On the left-hand side pane, select the Tidomat interface plugin in the Status node. On the workspace, you can find the status of the latest execution.

Execution Log

In the directory where the Tidomat interface plugin is installed, you can find the log file containing the execution status for the last 4 weeks.   

Open the file rescoint.log using Notepad, and you find the latest entries at the bottom of the log file.