Controls how Dispatch Board settings are saved and the status set by the Done button. This registry also enables Unavailable Technician functionality and the ability to display the Description from the Work Order Work Requested.
Testing Your Registry Entries
The system does not verify the validity of registry entries. Be sure to test your registry entries after completing them to verify that they are functioning correctly.
Setting Values are Uppercase-Lowercase Sensitive:
The Setting Value is case-sensitive: be sure that you enter the value exactly as specified in the documentation. If the documentation specifies a value of true, do NOT enter True or TRUE.
Registry Entry to Set Color Coding on Lower Section of DBoard
Registry Entry to Set Classic/Day Board Colors by Priority
Registry Entry to Set Classic/Day Board Service Zone Colors
Registry Entry to Set Classic/Day Board Status Colors
Warn or Error if Date Scheduled Set to Past Date
Id: sys-viewer-vdsptchbrd
See the Standard Registry section in Registry Viewer for additional Registry Id formats to allow entries for specific Users, Branches, Security, or User Groups to override the main entry.
The Powerboard Tech Summary shows the 'active' work order the Tech is assigned to. By default, 'active' work orders have a Tech Tab status of travel or onsite. The following registry allows the user to override the default, and specify their only list of 'active' statuses. Note the following registry does NOT impact the WO Escalation Status, only the Powerboard's Tech Summary.
Registry Id: sys-viewer-vdsptchbrd
Setting Key: ActiveDBoardStatuses Setting Value: list of status
Example:
Setting Key: ActiveDBoardStatuses Setting Value: travel,onsite,parts pickup
By default, selecting Edit Daily Workorders from Dispatch Board causes log types to be used from Dispatch Board. If the following registry is set, the standard WorkOrder Daily Edit settings (included those defined in sys-start-swrkordrdlyedt) to be used instead.
Registry Id: sys-viewer-vdsptchbrd
Setting Key: UseStandardWorkOrderDailyEditSettings Setting Value: true (default false)
This registry option is used to remove unwanted selections from the Status List that appears in the Dispatch Board viewer when right-clicking on a dispatch, or clicking the Change WO Status button.
Setting Key: filterstatusremove Setting Value: status1,status2,status3
where status1,status2,status3 (etc.) specify the statuses that you want removed from the list.
For example,
Setting Key: filterstatusremove
Setting Value: waitcustapprvl,waitdispapprvl,invoiceapproved,invoicedisputed
This reduces the options to a more typical list. This way the list can be configured to match the anticipated use of SAMPRO by the end-user.
Version 8.2+ extends multiple registry line support to the filterstatusremove key:
Setting Key: filterstatusremove Setting Value: status1,status2,status3
Setting Key: filterstatusremove Setting Value: status4,status5,status6
…. And additional lines as needed
By default, only work orders for the selected Day appear on the lower section of the Classic board. This registry option uses the Power Board date range filter (instead of the selected Day) for displaying calls on the lower section of the Classic board.
Setting Key: showallgridwos Setting Value: true
The Dispatch board and other viewers in the system are now able to indicate that a Technician is unavailable. The following registry entry is required to turn this functionality on. The Unavailable Days are set in the Unavailable Tab in the Technician record:
On the Classic board, unavailability is indicated with a red background on the column or row header displaying the Technician’s information for those days that he or she is unavailable. On the Power board, a currently unavailable Technician’s line in the Technician Summary (upper portion of the board) will be displayed in red.
In New Call, if the Technician and Date scheduled are both entered, a Warning will appear saying the Tech is Unavailable when the New Call is saved.
In TechFinder, the word ‘OFF’ will appear on the Technician hours pane if the technician is Unavailable. A Warning will appear saying the Tech is Unavailable if you select an Unavailable date.
In the Work Order Technician Tab, when the Tech Id or Date Scheduled is added or changed, the user will be warned if the Technician is Unavailable.
To implement this functionality, the following registry option must be enabled:
Setting Key: IdentifyUnavailableTechs Setting Value: true
The Description field on the Dispatch Board’s Work Order List defaults from the Work Order Name first, and the first 40 characters of the Work Order Work Requested if the Name field is blank. The following registry option may be implemented to display the first 40 characters of the Work Order Work Requested in the Description first. If the Work Order Work Requested is blank, the Work Order name will be displayed instead.
Setting Key: DescriptionFromWorkRequested
Setting Value: Value: true (default false)
When implemented, the following registry setting substitutes the Client Site Name for the Client Site Alpha wherever it is referenced on the Dispatch Board. Note that only the first 20 characters of the Client Site Name for the Client Site Alpha on the upper portion of the Power Board. The column heading/title of this field will not be changed.
Setting Key: ShowFullSiteName Setting Value: true (default false)
Setting Key: PreferencesByBoard Setting Value: yes
This registry option enables you to save your Dispatch Board preferences (status filter, date range, sort order, and column order) by user and board instead of just by user. For example, if you regularly access 2 or 3 boards, your settings will be maintained for each board. This is especially useful since this version allows multiple dispatch boards to be opened simultaneously. If you do not implement this entry, your dispatch board will behave as it does now (settings are saved only by user) - when you switch to a new board, the settings you created for the last one will be maintained.
Setting Key: SaveRanges Setting Value: true
This option enables you to save the contents of all the Dispatch Board’s filter ranges, not just the log type settings. These will be saved by Board if the above registry option is set.
By default, the Completed button on the Dispatch Board sets the Tech Status to completed. This registry option enables you to specify a different status.
Setting Key: DoneButton Setting Value: any valid tech status code
Example:
Setting Key: DoneButton Setting Value: invoice review
This option may be implement to allow the user-definable setting for Available Hours. By default, Available Hours are set to 8.
Setting Key: availableHoursPerDay Setting Value: ##.## (enter a decimal number with 2 places)
Example:
Setting Key: availableHoursPerDay Setting Value: 10.50
Setting Key: TopRatio Setting Value: aFraction
This option controls the ratio of the top section of the board.
Example:
Setting Key: TopRatio Setting Value: 5/8
In this example, the upper section of the board (both for the Power Board and Classic Board) would take up 5/8’s of the space, and the lower section (work order list) would take up 3/8’s.
The following options partially control the column header height and row header width for the Classic and Day views. (The size of the informational cells is set in the sys-viewer-vdsptchbrd-classic and sys-viewer-vdsptchbrd-classic registry entries, which also effectively set the column width and the row height of the headers.)
Setting Key: gp-row-width-classic Setting Value: #pixels
Sets the width of the left-hand row headers in the classic board.
Setting Key: gp-col-height-classic Setting Value: #pixels
Sets the height of the top header in the classic board. If a line appears in top header of the classic board, the colheight option in the sys-viewer-vdsptchbrd-classic registry entry should be adjusted to this value also.
Setting Key: gp-row-width-day Setting Value: #pixels
Sets the width of the left-hand headers in the day board.
Setting Key: gp-col-height-day Setting Value: #pixels
Sets the height of the top header in the day board. If a line appears in top header of the classic board, the colheight option in the sys-viewer-vdsptchbrd-day registry entry should be adjusted to this value also.
The following example displays the default values for these entries:
Setting Key: gp-row-width-classic Setting Value: 20
Setting Key: gp-col-height-classic Setting Value: 40
Setting Key: gp-row-width-day Setting Value: 110
Setting Key: gp-col-height-day Setting Value: 20
In certain installations, the Classic Dispatch Boards may display with the last technician column twice. If this occurs, the following registry setting may be enabled to force a redraw of the last quarter of the classic board to prevent the problem. This may result in additional flashing during the redraw, so this registry should only be implemented if the problem exists and it bothers the users.
Registry Id: sys-viewer-vdsptchbrd
Setting Key: useCase8798code Setting Value: true (default is false)