View source for FS 325462 SCR-HEW-2.5 PDA Trailer selection

<div class="noprint">
{{#vardefine:Client|HEW}}
{{#vardefine:ClientName|Hewicks Haulage}}
{{#vardefine:System|''CALIDUS'' EPOD}}
{{#vardefine:Doc_Title|PDA Trailer selection}}
{{#vardefine:Version|1.0}}
{{#vardefine:Date|27th March 2015}}
{{#vardefine:Reference|325462 SCR-HEW-2.5}}
{{#vardefine:Year|2015}}
</div>
{{Doc_Title
|Client={{#var:ClientName}}
|System={{#var:System}}
|Title={{#var:Doc_Title}}
|Reference=FS {{#var:Reference}}
|Version={{#var:Version}}
|Date={{#var:Date}}
|Year={{#var:Year}}
}} 

<!-- TOC --> 
<div class="noprint">
= Functional Overview  =

== Client Requirement  ==
The customer requires the ability to enter the trailer ID at the start of the Load.


== Solution Overview  ==
The prompt for a trailer ID will be a free text field rather than a static list of trailer ID's to allow the driver to enter the trailer ID onto the device. This will then be stamped on to the driver's load.

== Scope  ==

<!-- NEW PAGE --> 

= Set-up  =

== Pre-requisites  ==
A valid {{#var:System}} system is required.


== Menu Structure  ==

== Data  ==
Load Metrics will be configured to be required at the start of the load, through the {{#var:System}} Admin Site Maintenance screen:

[[File:FS_325462_Site_Config.PNG|border|600px]]
<br />''Admin Site Configuration Screen''<br />

Load Metrics will be configured to request the Trailer ID through UDF configuration:
 <FORM NAME="Trailer Entry" REQUIRED="Y">
   <FIELD ID="PDALOAD.EPL_TRAILER_ID">
       <TEXT>Trailer ID</TEXT>
       <FORMAT>T</FORMAT>
       <REQUIRED>Y</REQUIRED>
   </FIELD>
 </FORM>


<!-- NEW PAGE --> 

= Functional Description  =
== Mobile Device  ==

== Load Start ==
The {{#var:System}} mobile device application will be modified to store a Trailer ID against the Load in the local database. If any Trailer ID value is sent through from the {{#var:System}} server, this will be stored on the device database.


The {{#var:System}} mobile device application will be configured to display Load Metrics when starting a load. This will be configured to prompt only for the Trailer ID, and will prompt only at Load Start.

<gallery widths=260px heights=400px perrow=2>
File:FS_325462_Load_Metrics.PNG|''Load Metrics Pop-up Screen''
</gallery><br />

This pop-up screen will be configured to require the driver to enter the Trailer ID before hitting the '''Complete''' button.

{{Note}} The Trailer ID may also be configured to be optional, or to be required that it matches a pattern, for example, 2 letters followed by several numbers. The configuration of this validation can be changed after implementation.

This process will be modified in several ways:

The title of the pop-up screen and any pop-up messages or alerts will now be derived from the NAME of the configuration file.

The configurable entry on the screen will set the value of the field from any received value against the load (for example if the load has been started on any previous devices and already stored on the server), by checking the ID of the configured field - if this has been set to a PDALOAD field (as can be seen in the example), the application will recognise this and pre-set the value.

The configurable entry on the screen will update the new Trailer ID field on the local database from the entry by the driver, by checking the ID of the configured field - if this has been set to a PDALOAD field (as can be seen in the example), the application will recognise this and update the appropriate field on the database.


Once the detail has been entered and the driver confirms the entry on the pop-up screen, the device will display all the jobs on the load. In the background, a Load Update will be sent to the {{#var:System}} server, with the Load Metrics populated with the trailer ID (and any other configured elements), and the Trailer ID will also be sent in the new field.

== Job Completion ==
Whenever any jobs are started on the device, the value in the Load Trailer ID will be stored against the job. This trailer ID will be sent back to the {{#var:System}} server when the jobs are updated.


== Server ==
The {{#var:System}} server will be modified to store the Trailer ID against the Load.

The server will be changed to expect to receive the Trailer ID from the mobile device when Loads are updated (when starting a load and when completing a load). When a Load Update is received from the device, the server will use this value to update the Trailer ID against the load. In addition, this (and any Load metrics) will be stored in XML format against the load.

The server will be changed to expect to receive the Trailer ID from the mobile device when Jobs are updated (when completing a job). When a Job Update is received from the device, the server will use this value to update the Trailer ID against the job. 


== Admin  ==
The {{#var:System}} Admin Load screen will be modified to display the Trailer ID against the Load. This will be displayed in the pop-up Details window displayed when the '''Select''' button is clicked against the Load in the table.

[[File:FS_325462_Load_Details.PNG|border|600px]]
<br />''Admin Site Configuration Screen''<br />


Additionally, when creating a new Load, the user will be able to enter a Trailer ID against new load. No validation will be performed against this - this will be optional entry, and will allow the Admin user to enter a blank value.


<!-- MEDIA LANDSCAPE NO --> 
{{Doc_Appendix
|Appendix=A
|Estimate=Y
|Glossary=EPOD
|Ref1=322793 - REQ-Hewicks Haulage
|RefV1=3.0
|RefDate1=12/03/2015
|REQ=0
|EST=0
|FS=1.0
|TS=1.0
|DEV=4.25
|ST=1.0
|IMP=0
|PM=0
|EREQ=0
|EEST=0
|EFS=0.75
|ETS=0.75
|EDEV=2.75
|ESTT=0.5
|EIMP=0
|Client={{#var:Client}}
|Year={{#var:Year}}
|FSEST=Y
|Rev1=Matt Tipping
|Rev1Title=OBS Logistics Representative
|Rev2=Christopher Hewick
|Rev2Title={{#var:ClientName}} Representative
|Rev3=Carl Brinkley
|Rev3Title={{#var:ClientName}} Representative
}}</div> 
[[Category:{{#var:Client}} FS]]