Vessel Report System (VRS) Logic

Short Description

The Dataloy Vessel Report System (VRS) Logic page explains the logic behind locating and updating port calls in the VRS.

Chapter Contents:

Long Description

IF Departure Report

1. Initial Port Call Locator
   The first port call for a vessel code that is not budget, not estimate, not redelivery, event is departure, event log date (ETD) > report date from vessel report, exclude straits (Torres, Bosporus and Maggelan). If no port call is found then use exception: No departure port call found for the reported date and vessel.

   A port call in Dataloy VMS can be registered multiple times after each other with different reason for calls. The Dataloy VRS rule for Departure Reports is to update the ETA and ETB for the first port call that is not a redelivery port call and the ETD for the last port call that is not a redelivery port call. The report should be inserted to the last port call. This action also controls if the ETD of the previous port call is fixed. The check is necessary as a departure vessel report may be sent both before or after the ETD. If the ETD for a previous port call is not fixed, then VRS will assume that this is the port call to update (see Step 2).

2. Locate Pervious Non-Redelivery Port Call but has Port not Equal to Located Port Call in Step 1
1. IF previous port call ETD from Step 2 is fixed:
1. Locate last port call where port is equal to the port located in Step 1.
1. IF ETD for port from Step 2ai is not fixed: choose this port call as the port call to update.
2. IF ETD for port from Step 2ai is fixed: throw exception Can not find a matching departure port.
2. IF previous port call ETD from Step 2 is not fixed:
   1. Choose previous port call as the main port call where the vessel report should be inserted.
3. Get the next port call for the port call located in Steps 2a or 2b (is the next arrival port call).
1. If no arrival port call is found: throw exception Can not find next arrival port call.

Top

IF Noon, Arrival OR In Port Report

1. Initial Port Call Locator
   The first port call for a vessel code that is not budget, not estimate, not redelivery, event is departure, event log date (ETD) > report date from vessel report, exclude straits (Torres, Bosporus and Maggelan). If no port call is found then use exception: No departure port call found for the reported date and vessel.
   1. Start with port call from Step 1, loop port calls backwards and locate the first port call where ETD is not fixed (new feature in VRS 2.0).

2. Registering Port Calls in Dataloy VMS
   A port call in Dataloy VMS can be registered multiple times after each other with different reason for calls. The Dataloy VRS rule is to update ETA and ETB for the first port call that is not a redelivery port call and the ETD for the last port call that is not a redelivery port call. The report should be inserted to the first port call for Arrival and Noon and to the port call from Step 1 for In Port Reports.

1. Get the last port call where the port is equal to the portCall.port from Step 1.
2. Get the first port call where the port is equal to portCall.port from Step 1.
3. IF Arrival OR Noon Report
   1. Choose the port call from Step 2b as the main port call where the vessel report should be inserted.
4. IF In Port Report
   1. Choose the port call from Step 1 as the main port call where the vessel report should be inserted.

Top

Check Reported Ports - Applies to All Vessel Report Types

1. Check Reported Ports
   Check that reported port and the next arrival port call from the vessel report matches the ports for located port calls the IF Departure Report and IF Noon, Arrival OR In Port Report.
   1. If reported port does not match the located port, use exception: The port reported by vessel, [port name] (id: [port id]). Does not match the port in Dataloy: [port name] (id: [port id]).
   2. If reported port for next arrival port call does not match the located arrival port use exception: The port reported by vessel, [port name] (id: [port id]). Does not match the port in Dataloy: [port name] (id: [port id]).

Top

Update Port Call Data

1. IF Arrival Report

   1. Update the following data for port call from the IF Arrival OR Noon Report: DistanceActual, DaysStoppages, FoRobArrival, DoRobArrival, FlRobArrival, DlRobArrival
2. IF Departure Report
   1. Update the following data for port call from Locate Pervious Non-Redelivery Port Call but has Port not Equal to Located Port Call in Step 1, Step 2b: FoRobDeparture, DoRobDeparture, FlRobDeparture, DlRobDeparture, FoBunkered, FlBunkered, DoBunkered, DlBunkered.

Top

Update ETA, ETB, ETD - The Fixed Flag Behind ETA, ETB and ETD will Automatically be Set to True if Updated Date is in the Past.

1. IF Departure Report
   1. Update the ETD to departure port call and ETA to arrival port call.
   2. Ensure that the ETD fixed flagg is always set to true, even when the ETD date is in the future.
2. IF Noon, Arrival or In Port Report
1. Update the ETA and ETB for the port call located in the IF Noon, Arrival OR In Port Report, Step 2b.
2. Update the ETD for the port call located in the IF Noon, Arrival OR In Port Report, Step 2a.
3. Ensure that the ETD fixed flag is never set to true, even when the ETD date is in the past.

Top
Back

Related Content