Job Assignment: Difference between revisions

From EPOD
m (Under construction)
(440290 SCR-440290-4 Job Assignment Additional Search Criteria)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Warning}} This page is currently under construction.
This screen allows you to assign to and de-assign jobs from a load.


When you come to this screen from selecting a load on the loads maintenance screen, the jobs on that load are shown, along with any unassigned jobs. For clarity, the load you selected is shown at the top of the screen.


A new screen will be created in the Admin system.


[[File:EPOD-JobAssignment1.PNG|1000px|border]]  
[[File:EPOD-JobAssignment1.PNG|900px|border]]  
<br />''Job Assignment screen''<br />
<br />''Job Assignment screen''<br />


The jobs table has the following columns:
* ''Load''.
* ''Type''.
* ''Group''.
* ''Code''.
* ''Customer Ref.''.
* ''Planned Start'' and ''End Date'' & ''Time'' .
* ''Customer Name''.
* ''Post Code''.
* ''Weight''


A title will be added to show the load having jobs assigned to it.
Jobs on this load are the first ones shown on the table, highlighted in green. All other jobs shown without highlighting are available to be assigned to the load. You can sort the jobs in the table by clicking on the column header - clicking again will reverse the sort sequence.  


A label displaying the currently selected number of jobs to assign to the load and being removed from the load will be shown in the title bar. This will be updated whenever a job is selected or deselected.


'''Find''', '''Add All''', '''Remove All''', '''Reset''' and '''Save''' buttons will be added to the title bar, as well as a '''Back''' button.
A label is shown in the title bar displaying the status of your changes to the jobs on the load in the title bar. This will be updated whenever you start selecting or de-selecting jobs.


A button bar at the top of the screen has the following buttons:
* '''Find''' - this button allows you to change which unassigned jobs you see in the table.
* '''Add All''' - this button allows you to all all unassigned jobs shown in the table to this load.
* '''Remove All''' - this button de-assigns all jobs assigned to the load.
* '''Reset'''  - this button resets all you changes back to the last time you saved the load, or to the state it was in when you entered the screen.
* '''Save''' - this button saves any changes you have made to the jobs assigned to this load. {{Warning}} You must save for your changes to take effect.
* '''Back''' - this button will return you to the screen you came from.


A ''Search'' panel will be present on this panel, which will initially be hidden and shown when the '''Find''' button is displayed, to allow the user to select by:
* Only show jobs with no load, or all jobs. A drop-down list of options, defaulting to "No Load".
* ''Job Group'' - a text entry box that will be used to 'fuzzy match' against the job group value against the jobs. Blank as default
* ''Job Code'' - a text entry box that will be used to 'fuzzy match' against the job code value against the jobs. Blank as default
* ''Customer Code'' - a drop-down list or (auto-complete text box if the volume of codes is high) that will be used select specific customers against the jobs. Blank as default
* ''Customer Ref'' - a text entry box that will be used to 'fuzzy match' against the Customer Reference value against the jobs. Blank as default
* ''Job Type'' - a drop-down list to select the job types, consisting of "Collection", "Delivery", "Service" or "All" (the default value).
* ''Planned Date'' - a pop-up Calendar to select the Planned Start Date, defaulting to no value. When selected, this should default to today's date. An option to clear the selected data will be provided.


'''Clear''' and '''Search''' buttons will be provided, working exactly as they do on other screens. {{Note}} No export options are required on this ''Search'' panel.
== Finding More Jobs ==
By default, the screen displays jobs that are not assigned to any load. however, you may want to find jobs that are on other loads, to move them to this load. You can do this by clicking the '''Find''' button.


The ''Search'' panel will not be initially displayed on the form, and the jobs matching the default filter criteria will be displayed in the results table.
[[File:EPOD-JobAssignment2.PNG|900px|border]]
<br />''The Search panel''<br />


Clicking '''Search''' will display a results table with the following fields:
This search panel allows you to search for jobs by the following criteria:
* ''Load''.
* ''Job Filter'' - here, you select to Only show jobs with ''No Load'', or ''All Jobs''. This is a drop-down list of options, defaulting to ''No Load''.
* ''Type''.
* ''Job Group'' - this is a text entry box that will be used to 'fuzzy match' against the job group against the jobs.
* ''Group''.
* ''Job Code'' - this is a text entry box that will be used to 'fuzzy match' against the job code value against the jobs.
* ''Code''.
* ''Customer'' - this is an auto-complete text box that selects specific customers against the jobs. Just start typing the customer code or name and a list will be shown you can select from. If you do not select one of the suggestions, the text entered will be used to search for any customer matching this is part or full.
* ''Customer Ref.''.
* ''Search Address'' - this controls whether whether the customers searched for are just on code/name (unchecked, the default) or also on any line of the address or postcode from the customer address or the destination address (checked).
* ''Planned Start'' and ''End Date'' & ''Time'' .
* ''Customer Ref'' - this is a text entry box that will be used to 'fuzzy match' against the customer reference value against the jobs.
* ''Customer Name''.
* ''Job Type'' - this is a drop-down list to select the job types, consisting of "Collection", "Delivery", "Service" or "All", which is the default value.
* ''Post Code''.
* ''Planned From/To'' - this allows you to select a range of planned start dates of the jobs shown in the table. When you click this, a pop-up calendar will be shown, which defaults to today's date.
 
The search panel shows '''Clear''' and '''Search''' buttons.  


{{Note}} These results should be shown on initial start-up of the page.
Clicking '''Search''' will re-display the results table - the jobs of the load being modified are always shown at the top of the table.
Any free jobs (i.e. not assigned to a load) will be shown next, then jobs assigned to other loads


The search for these jobs will be modified to also return the results of the current load in this table, sorted to appear at the top of the list, followed by any free jobs (i.e. not assigned to a load) and then jobs assigned to other loads.
{{Note}} The screen will list the jobs based on the criteria you entered, but will also ensure that:
* the jobs are always at ''Pending'' status.
* the loads the jobs come from are always at ''Pending'' or ''Assigned'' status (i.e. not ''In Progress'', ''Cancelled'' or ''Complete'').


The selection of data for this table will also support all of the filtering shown above, plus the following:
* Only ever select status ''Pending'' jobs.
* Only ever select jobs from loads that are status ''Pending'' or ''Assigned'' (i.e. not ''In Progress'', ''Cancelled'' or ''Complete'').


The table must allow resorting by clicking on a label in the title row of the results table.
== Assigning/De-Assigning Jobs ==
When you click on a job that is not assigned to this load, it will be selected and highlighted. If you click on it again it will be deselected.


The highlighting of the rows indicates what action you are taking with the selection:
* Unassigned jobs are not highlighted initially.
* Jobs already assigned to this load are highlighted green.
* Unassigned jobs that you select are highlighted blue, to signify that they are being added.
* Jobs assigned to another load that you select are highlighted blue, to signify that they are being added.
* Jobs already assigned to this load that you select are highlighted red, to signify that they are being removed.


Each table row will allow selection by clicking on it. Clicking on it again will deselect it.
The label in the title bar displaying the currently selected number of jobs will be updated with each selection you make, adding or taking away from the ''Assign'' and ''De-assign'' counts. This includes the grand total of any weights for the jobs already assigned, and to be assigned.
* Unassigned jobs and jobs assigned to another load that are selected will be highlighted blue.
* Jobs already assigned to this load will be initially highlighted green.
* Jobs already assigned to this load that are selected will be highlighted red.


You can change pages using the pagination buttons at the bottom of the table - the screen will remember which jobs you have selected from all the pages.


The '''Add All''' button will count all jobs not currently assigned to the load in the results table. It will then show a confirmation that this number of jobs will be immediately added to the load. On confirmation, the jobs will be added immediately.


The '''Remove All''' button will count all jobs currently assigned to the load in the results table. It will then show a confirmation that this number of jobs will be immediately removed from the load. On confirmation, the jobs will be removed immediately.
The '''Add All''' button counts up all the jobs in the results table that are not currently assigned to the load. The screen then shows a confirmation that this number of jobs will be immediately added to the load. On confirmation, the jobs will be added.


The '''Remove All''' button counts up all the jobs in the results table that are currently assigned to the load. The screen then shows a confirmation that this number of jobs will be immediately removed from the load. On confirmation, the jobs will be removed.


The titlebar label displaying the currently selected number of jobs to assign to the load and being removed from the load will be updated with each selection:
{{Note}} The counts above show the jobs that are assigned or unassigned, ''not'' selected.
* If a single unassigned job is selected, the "To Assign" number selected will be incremented by one.
* If a selected unassigned job is deselected, the "To Assign" number selected will be decremented by one.
* If a job that is already assigned to the load is selected, the "To Deassign" number will be incremented by 1.
* If a job that is already assigned to the load is deselected, the "To Deassign" number will be decremented by 1.


If the results table is paginated, the screen will remember the checked results of each job on all pages.


Once jobs have been selected for assigning to and de-assigning from the load, these changes can be saved or discarded through the title bar buttons:
Once jobs have been selected for assigning to and de-assigning from the load, these changes can be saved or discarded through the title bar buttons:
* The '''Save''' button will save all changes to assigned jobs (pending a pop-up confirmation).
* The '''Save''' button will save all changes you have made to jobs assigned to this load - the screen will display a pop-up to confirm that you want to make the changes.
* The '''Reset''' button will reset all the selections against jobs in the Assigned Jobs table (pending a pop-up confirmation).
* The '''Reset''' button will reset all the jobs on this load back to the last time that you saved, or to the way that the load was when you first entered the screen.
* The '''Back''' button will exit the screen with no confirmation.
* The '''Back''' button exits the screen with no confirmation.


On clicking any button that changes the data in the grid view, or resets the selections in the grid view (namely '''Save''', '''Add All''', '''Remove All''' and '''Reset'''), the grid view should be refreshed from the server.
When you save or reset changes, the jobs table will be re-displayed showing the current state of jobs assigned to the load. This is the point to which you will return if you click the '''Reset''' button.




[[Category:UG 291094 EPOD Admin User Guide|200_150]]
[[Category:UG 291094 EPOD Admin User Guide|200_150]]

Latest revision as of 13:04, 26 September 2022

This screen allows you to assign to and de-assign jobs from a load.

When you come to this screen from selecting a load on the loads maintenance screen, the jobs on that load are shown, along with any unassigned jobs. For clarity, the load you selected is shown at the top of the screen.


EPOD-JobAssignment1.PNG
Job Assignment screen

The jobs table has the following columns:

  • Load.
  • Type.
  • Group.
  • Code.
  • Customer Ref..
  • Planned Start and End Date & Time .
  • Customer Name.
  • Post Code.
  • Weight

Jobs on this load are the first ones shown on the table, highlighted in green. All other jobs shown without highlighting are available to be assigned to the load. You can sort the jobs in the table by clicking on the column header - clicking again will reverse the sort sequence.


A label is shown in the title bar displaying the status of your changes to the jobs on the load in the title bar. This will be updated whenever you start selecting or de-selecting jobs.

A button bar at the top of the screen has the following buttons:

  • Find - this button allows you to change which unassigned jobs you see in the table.
  • Add All - this button allows you to all all unassigned jobs shown in the table to this load.
  • Remove All - this button de-assigns all jobs assigned to the load.
  • Reset - this button resets all you changes back to the last time you saved the load, or to the state it was in when you entered the screen.
  • Save - this button saves any changes you have made to the jobs assigned to this load. Warning Warning: You must save for your changes to take effect.
  • Back - this button will return you to the screen you came from.


Finding More Jobs

By default, the screen displays jobs that are not assigned to any load. however, you may want to find jobs that are on other loads, to move them to this load. You can do this by clicking the Find button.

EPOD-JobAssignment2.PNG
The Search panel

This search panel allows you to search for jobs by the following criteria:

  • Job Filter - here, you select to Only show jobs with No Load, or All Jobs. This is a drop-down list of options, defaulting to No Load.
  • Job Group - this is a text entry box that will be used to 'fuzzy match' against the job group against the jobs.
  • Job Code - this is a text entry box that will be used to 'fuzzy match' against the job code value against the jobs.
  • Customer - this is an auto-complete text box that selects specific customers against the jobs. Just start typing the customer code or name and a list will be shown you can select from. If you do not select one of the suggestions, the text entered will be used to search for any customer matching this is part or full.
  • Search Address - this controls whether whether the customers searched for are just on code/name (unchecked, the default) or also on any line of the address or postcode from the customer address or the destination address (checked).
  • Customer Ref - this is a text entry box that will be used to 'fuzzy match' against the customer reference value against the jobs.
  • Job Type - this is a drop-down list to select the job types, consisting of "Collection", "Delivery", "Service" or "All", which is the default value.
  • Planned From/To - this allows you to select a range of planned start dates of the jobs shown in the table. When you click this, a pop-up calendar will be shown, which defaults to today's date.

The search panel shows Clear and Search buttons.

Clicking Search will re-display the results table - the jobs of the load being modified are always shown at the top of the table. Any free jobs (i.e. not assigned to a load) will be shown next, then jobs assigned to other loads

Note Note: The screen will list the jobs based on the criteria you entered, but will also ensure that:

  • the jobs are always at Pending status.
  • the loads the jobs come from are always at Pending or Assigned status (i.e. not In Progress, Cancelled or Complete).


Assigning/De-Assigning Jobs

When you click on a job that is not assigned to this load, it will be selected and highlighted. If you click on it again it will be deselected.

The highlighting of the rows indicates what action you are taking with the selection:

  • Unassigned jobs are not highlighted initially.
  • Jobs already assigned to this load are highlighted green.
  • Unassigned jobs that you select are highlighted blue, to signify that they are being added.
  • Jobs assigned to another load that you select are highlighted blue, to signify that they are being added.
  • Jobs already assigned to this load that you select are highlighted red, to signify that they are being removed.

The label in the title bar displaying the currently selected number of jobs will be updated with each selection you make, adding or taking away from the Assign and De-assign counts. This includes the grand total of any weights for the jobs already assigned, and to be assigned.

You can change pages using the pagination buttons at the bottom of the table - the screen will remember which jobs you have selected from all the pages.


The Add All button counts up all the jobs in the results table that are not currently assigned to the load. The screen then shows a confirmation that this number of jobs will be immediately added to the load. On confirmation, the jobs will be added.

The Remove All button counts up all the jobs in the results table that are currently assigned to the load. The screen then shows a confirmation that this number of jobs will be immediately removed from the load. On confirmation, the jobs will be removed.

Note Note: The counts above show the jobs that are assigned or unassigned, not selected.


Once jobs have been selected for assigning to and de-assigning from the load, these changes can be saved or discarded through the title bar buttons:

  • The Save button will save all changes you have made to jobs assigned to this load - the screen will display a pop-up to confirm that you want to make the changes.
  • The Reset button will reset all the jobs on this load back to the last time that you saved, or to the way that the load was when you first entered the screen.
  • The Back button exits the screen with no confirmation.

When you save or reset changes, the jobs table will be re-displayed showing the current state of jobs assigned to the load. This is the point to which you will return if you click the Reset button.