The Dock Commitment Properties page will conditionally restrict Start Times for dock commitments.
If the Restricted Start Times for Dock Commitments in Global Settings is True, in Create or Edit mode, Start Time will be presented as both a text box and a combo box containing eligible Start Times for the applicable Dock and Start Date. The combo box for Start Time will be loaded only after the Dock ID and Start Date have been established. This combo box will be loaded with eligible Start Times in ascending chronological order using the 24 hour time format.
If the Restricted Start Times for Dock Commitments in Global Settings is False, or the Dock Commitment Properties page is presented in View mode, Start Time will be presented only as a text box.
For users that are not allowed to apply any type of change that would result in any type of violation condition, the combo box will include:
Start Times for which there are no other dock commitments that would overlap with a dock commitment for the applicable Start Date and Dock ID.
Start Times for which the dock commitment would not be wholly or partially outside of business hours for the dock.
The combo box will be populated based on the setting for Dock Commitment Eligible Start Times for the applicable Dock:
If Dock Commitment Eligible Start Times for the dock is On the Hour, the minutes portion of the Start Time for the dock commitment must be ":00". For example, if the dock will be open from 9:00 to 18:00 and there are no existing dock commitments and duration of dock commitments will be one hour, the combo box will include the following values:
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
If Dock Commitment Eligible Start Times for the dock is Hourly on the Half Hour, the minutes portion of the Start Time for the dock commitment must be ":30".
If Dock Commitment Eligible Start Times for the dock is On the Half Hours, the minutes portion of the Start Time for the dock commitment must be ":00" or ":30".
If Dock Commitment Eligible Start Times for the dock is On the Quarter Hours, the minutes portion of the Start Time for the dock commitment must be ":00", ":15", ":30" or ":45".
If Dock Commitment Eligible Start Times for the dock is On the Twenties, the minutes portion of the Start Time for the dock commitment must be ":00", ":20", or ":40".
If Dock Commitment Eligible Start Times for the Dock is On the Tens, the minutes portion of the Start Time for the dock commitment must be ":00", ":10", ":20", ":30", ":40" or ":50".
Establish Duration:
In Edit Mode, Duration will be the difference between the current Start Date/Time and End Date/Time.
In Create Mode:
If the Dock Commitment Type is Unassociated: Duration will be the Fixed Loading/Unloading Time for dock; if this is not defined, Duration will be the Fixed Loading/Unloading Time for the applicable shipping location.
If the Dock Commitment Type is Associated with Stop: Duration will be the difference between Last Computed Scheduled Arrival and Departure Dates/Times for the applicable stop; if these dates have not been established, Duration will be the Fixed Loading/Unloading Time for dock; if this is not defined, Duration will be the Fixed Loading/Unloading Time for the applicable shipping location.
Duration will be added to the potential Start Time to compute a corresponding End Date/Time.
For each potential Start Time:
An overlap violation would exist if there are any other dock commitments that start or end between the potential Start Time and computed End Time.
A business hours violation would exist if any of the time between the potential Start Time and computed End Time falls outside of the business hours for the dock (if defined for dock) or the shipping location (if not defined for the dock).
The combo box will be loaded with all available Start Times for the applicable Start Date and Dock ID. If the Eligible to Maintain Dock Commitment with Violations flag for the user group for the current user is True, the user will see all potential start times for the applicable date where the dock commitment would be wholly or partially within business hours; otherwise, the combo box will only include times where an overlap scenario does not exist and the date/time range is fully within business hours.
If there would be an overlap situation or the range is partially outside business hours, the time will be presented within squared brackets (for example, [12:00]). Times where conflicts / problems exist will not be presented to users that are not eligible to edit dock commitments with violations.
When a user supplies/selects a value for Start Time in the text box or combo box, the value in the other input field will be cleared immediately.
When the page is initially loaded in Edit mode, only the text box for Start Time will be populated. The combo box will be populated when user clicks to expand the combo box.
Optimizer will observe the same constraints when assigning Start Times to dock commitments.
In addition to standard time validation, the following edits will be performed for Start Time in the text box:
If the Restricted Start Times for Dock Commitments flag in the Global Settings, the minutes portion of Start Time must be valid for the Dock Commitment Eligible Start Times (Override) for the applicable dock.
If the Eligible to Maintain Dock Commitment with Violations flag for the user group for the current user is not enabled, Start Time must refer to a block of time that is wholly within the business hours for the dock and does not overlap with any other Dock Commitments.