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
   
   If vessel is reporting voyage reference number and reason for call: The first port call for reported vessel code, reference number, reason for call and port that is not budget and not estimate. If not port call is found then use exception: No port call found for this combination of vessel, voyage number, reason for call and port where departure fixed is not set.
   
   If vessel is not reporting voyage reference number and reason for call: The first port call for a vessel code that is not budget, not estimate, not redelivery, event is departure, event log date (departure date) > report date from vessel report. 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 arrival and berthing date for the first port call that is not a redelivery port call and the departure date 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 departure date of the previous port call is fixed. If the departure date 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 Previous Non-Redelivery Port Call but has Port not Equal to Located Port Call in Step 1
1. IF previous port calls departure date from Step 2 is fixed:
1. Locate last port call where port is equal to the port located in Step 1.
1. IF departure date for port from Step 2ai is not fixed: choose this port call as the port call to update.
2. IF departure date for port from Step 2ai is fixed: throw exception Can not find a matching departure port.
2. IF previous port calls departure date 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
   
   If vessel is reporting voyage reference number and reason for call: The first port call for reported vessel code, reference number, reason for call and port that is not budget and not estimate. If not port call is found then use exception: No port call found for this combination of vessel, voyage number, reason for call and port where departure fixed is not set.
   
   If vessel is not reporting voyage reference number and reason for call: The first port call for a vessel code that is not budget, not estimate, not redelivery, event is departure, event log date (departure date) > report date from vessel report. 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 departure date 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 arrival and berthing date for the first port call that is not a redelivery port call and the departure date 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 Arrival, Berthing , Departure - The Fixed Flag Behind Arrival, Berthing and Departure will Automatically be Set to True if Updated Date is in the Past.

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

Top
Back

Related Content