MOW Route Mapping

Executive Summary

MOW Route Mapping shows on a map the clients that meal-on-wheels routes visit on a chosen day. A coordinator picks a service date, optionally narrows the list by group, chooses one or more meal routes and clicks Show Map. The system reads the day's visits for each route from AlayaCare, places each client at the visit address, and draws a coloured route per meal route with numbered waypoints. A side grid summarises every route and can be expanded to list the stops in order. From the grid a coordinator can also change the start time of individual stops; those changes are written back to the visits in AlayaCare.

Key Features

Map one or more meal routes for a service date, one colour per route
Narrow the list of routes by group
Optionally show a chosen client's home location on the map
Show the route's starting and ending location (depot) as the first and last stops when they are set up for the route
See per route: clients, mapped clients, skipped clients (no map location), total visit time, travel time and distance in KM
Expand a route to list each stop with start time, visit time, client and address
Change the start time of stops in a route and update the matching visits in AlayaCare
Print the map

Typical Workflow

Choose a Service Date. Optionally choose a Client to show that client's home on the map.
Optionally choose one or more Groups to narrow the routes listed.
Choose one or more Routes.
Click Show Map. A progress panel shows the routes as they are processed and can be cancelled.
Review the routes on the map and the grid. Expand a route to see its stops.
To change start times, click the edit icon on a route (or right-click it and choose Edit). Edit the stops' start times, then click Ok to update the visits in AlayaCare.
Click Print Map to print the map, or Clear Map to start again.

Available Permissions

The following permissions are available to be assigned to AlayaCare Roles:

Attribute	What It Controls
View	Open the page, show the map, print it, and change visit start times

Main Grid

The route grid appears beside the map after Show Map. It lists one row per meal route.

Column	Description
Route Name	The meal route, with the route's colour.
Clients	Number of stops (client visits, grouped as described under Processing Overviews).
Mapped	Stops placed on the map.
Skipped	Stops that could not be placed on the map because they have no location.
Visit Time	Total scheduled visit time in minutes.
Travel Time	Driving time of the route in minutes.
KM	Driving distance of the route.
Manage Records	An edit icon that opens the route for editing start times.

Expand a route to list its stops.

Column	Description
(numbered dot)	The waypoint number on the map. Blank when the stop has no location.
Start	Start time of the stop.
Visit Time	Start and end time of the stop.
Client	Client name and address. A depot stop shows the starting or ending location name and address.

Main Grid Filters

These selections decide what is mapped and are locked while a map is displayed.

Filter	Purpose
Service Date	The day whose visits are mapped. Changing it refreshes the Routes list to meal routes in use on that date.
Client	Optional. Shows the client's home location as a marker on the map.
Groups	Optional. Lists the active groups that contain meal routes. After you leave the field, Routes lists only meal routes in the chosen groups (all meal routes when none are chosen). Use Select All to choose every group.
Routes	The meal routes to map. Use Select All to choose every route listed.

Actions

Button	Description
Show Map	Builds the routes and shows the map. Replaced by Clear Map and Print Map once a map is showing.
Clear Map	Clears the map and re-enables the selections.
Print Map	Prints the map.
Edit (icon on a route row, or right-click a route row)	Opens the route's start times for editing.

Dialog Components

Route (edit start times)

Opens from the edit icon or right-click Edit on a route. The title is the route name. It lists the client stops of the route (the starting and ending depot stops are not editable) and lets the start time of each be changed.

Grid

Column	Description
Client	Client name.
Start Time	Current start time of the stop.
New Start Time	The new start time entered for the stop, when one has been entered.
Manage Records	An edit icon (also right-click Edit) that opens Edit Start Time.

The grid has 14 rows per page.

Grid Actions

Button	Description
Ok	Saves the new start times: updates every visit at the changed stops in AlayaCare, redraws the map and shows how many visits were updated or failed.
Cancel	Closes the dialog. New start times already entered stay on the stops, but no visits are changed.

Edit Start Time

Opens from a stop in the route dialog.

Field	Purpose
Current Start Time	The stop's current start time (read-only).
New Start Time	The new start time (hours and minutes), in the meal route's time zone.

Click Ok to keep the new time on the stop (it is not sent to AlayaCare until Ok is clicked on the route dialog), or Cancel to discard it.

Dependencies

The following tables must be configured for lookups on this view to work:

Table	Description
Facilities	Meal routes (facility type Meal Route) offered for the date, each route's time zone, route colour, and its optional starting and ending location (name, address, coordinates, starting time and depot visit time).
Groups	Active groups that contain meal routes, used to narrow the route list.

Processing Overviews

This section describes what happens after you confirm a processing action.

Show Map

Opens a progress panel that can be cancelled and signs in to AlayaCare.
If a client was chosen, loads the client's record so the client's home location can be shown.
For each selected meal route, works out the start and end of the service day in the route's time zone and loads the route's visits for that day from AlayaCare, keeping only visits that have a client.
Leaves out cancelled visits, visits on hold and visits without a client. For each remaining visit, loads the client, the service and the visit's details.
Works out each visit's location: the service's own address when the service overrides the address, otherwise the client's home address.
Groups visits for the same client, address and start time into one stop. Stops with a location count as Mapped; stops without a location count as Skipped.
Orders the stops by start time. When the route has a starting location, adds it as the first stop (at the route's starting time, if set, with the depot visit time). When the route has an ending location (or is set to end where it starts), adds it as the last stop, five minutes after the last visit starts. A starting or ending location is only used when its longitude falls in the range used for the service area.
A route is drawn only when it has at least two stops (including depot stops). Each route is drawn in the route's colour, or in a colour from the standard sequence (red, orange, green, blue, indigo, violet). The map calculates the driving route, travel time and distance, which fill the grid.
If no route was selected, "Please select at least one Route" is shown. If none of the selected routes has visits to map, "Please select at least one route with active visits" is shown. If a route has no stops, "Route has no clients" is shown, and if no route has stops, "Routes do not have any clients" is shown.

Ok (on the Route dialog)

For every stop with a new start time, works out the new start (in the route's time zone) and keeps the same visit length for the new end time.
For each visit grouped at that stop, updates the visit's start and end time in AlayaCare, keeping its service and employee. The update is sent with every AlayaCare override switched on (overlapping visit, service instructions, reason code, locked visit, blocked employee, unavailable employee, blocked facility and authorization), so AlayaCare accepts the change even when those checks would normally stop it.
Closes the dialog, redraws the map with the new times, and shows "{n} Visit(s) updated", or "{x} Visits failed, {n} Visit(s) updated" when AlayaCare rejects any.