Internal Registry Dispatch Day Board (sys-viewer-vdsptchbrd-day)

Purpose:

The Day Board is displayed when you click the switch orientation button on the Classic Board view. If this registry entry is not implemented, standard system defaults (and the various sys-dispatchboard-colors registry entries) will be used to display the Day Board. The individual options specified in this registry override the system defaults. It is only necessary to specify the configuration options that you wish to change from the system defaults.

Usage:

The default day board configuration used in the absence of this registry entry is described in Default Day Board Configuration .

A Powerpoint presentation on setting dispatch board registry entries is available. Contact your support representative to obtain this step-by-step presentation.

Error Handling of Bad or Incomplete Registries

In releases prior to 9.1.611.043, it was possible to completely disable the Classic and./or Day boards by making an incorrect or missing infof# registry entries: a Runtime error: Key is missing would be displayed and the board could not be accessed.  In version 9.1.611.043 and above, a missing infof# setting will be replaced by the default WorkOrder,10,0@0 setting instead so that the user will at least be able to access the board. This also corrects a second 'Key is missing' error when the #infoFields registry key used by the Day and/or Classic board registries is missing.

Important Fields:

Id: sys-viewer-vdsptchbrd-day

Maximum Calls

Setting Key: maxcalls Setting Value: #

This line controls the maximum number of calls (information cells) that will appear on the day board. The default value is set to 50. Since the Day Board only displays one day at a time, you would typically set this field based on the number of techs on the board (plus ‘unassigned’) and the maximum number of work orders per day that might be assigned to a tech. A large number of calls may impact performance.

Default Font

Setting Key: font Setting Value: facename:pointsize:bold

This option sets the default font and point size for the Day board infocells. Note that the :bold specification is optional. This default may be overridden for individual fields.

 Examples:

 Setting Key: font Setting Value: arial:7:bold

 Setting Key: font Setting Value: tahoma:8

Default Forground (text) Color

Setting Key: foreground Setting Value: 0:ClrDefault or foreground=color:Custom

This option sets the default text color for the Day board. The default option sets the text to black. To set a custom color, do the following.

A. To enter the index number, enter all information up to the word Custom. In this example, you would type foreground=color:

B. After entering the colon : double-click on the line to display the Windows color selector palette, click on the desired color and then click OK.

Warning: Do Not Choose Dithered Colors on standard Citrix Systems)
On systems with color limitations (e.g., standard Citrix desktops), dithered colors should not be selected. Doing so may result in the text being indistinguishable from the background. Dithered colors can be identified by their spotty appearance on the color palette.

C. The system will replace the color text that you typed with the system color you selected in the palette.

Background Color – Empty Cells

Setting Key: background Setting Value: color:Custom

This option sets the default background color for the Day board for cells that are not occupied by a work order. See the Foreground option above for details on setting the custom color.

Background Colors – Occupied Cells

Setting Key: infobackground Setting Value: field or

Setting Value: infobackground Setting Value: color:Custom

This registry sets the infocell background color based on a specific field: pr for priority, workcode, status or zone (for service zone) or to a specific color. By default, this field is set to status.

The field option sets the color by keying it to the dispatch board field that is referenced in one of the following settings:

sys-dispatchboard-colors (to set by Priority)

sys-dispatchboard-colors-status (to set by Status)

sys-dispatchboard-colors-workcode (to set by Work Code)

sys-dispatchboard-colors-zone (to set by Service Zone)

 

Tip: This colors the entire cell background, and may make the text difficult to read. You may prefer to set the foreground text (or background behind the text) of one or more of your info fields to your color-coding scheme as discussed in the colf# entry discussed below.

Column Header Configuration

Setting Key: colforeground Setting Value: 0:ClrDefault or color:Custom

This option sets the column header text color for the Day board. The default option sets the text to black.

Setting Key: colbackground Setting Value: color:Custom

This option sets the column header background color for the Day board.

Setting Key: colheight Setting Value: #pixels

This option sets the column header height in pixels. It should match the gp-col-height-day setting in the sys-viewer-dsptchbrd registry setting. If it is larger, however, lines will appear in the column header. (Note that the column width is effectively set by the infocellsize entry described below.)

Setting Key: colfont Setting Value: facename:pointsize:bold

This entry sets the default font and point size for the Day board column headers. Note that the :bold specification is optional. This default may be overridden for individual fields in the column header.

Setting Value: colfields Setting Value: 1

Setting Value: colf1 Setting Value: Index,#characters

The above entries display an index number for each column. We do not recommend overriding the default values.

Row Header Configuration

Setting Key: rowforeground Setting Value: 0:ClrDefault or color:Custom

This option sets the row header text color for the Day board. The default option sets the text to black.

Setting Key: rowbackground Setting Value: color:Custom

This option sets the row header background color for the Day board.

Setting Key: rowwidth Setting Value: #pixels

This option sets the row header width in pixels. It should correspond to the gp-row-width-day setting in the sys-viewer-dsptchbrd register setting. (Note that the header row height is effectively set by the infocellsize entry described below.)

Setting Key: rowfont Setting Value: facename:pointsize:bold

This entry sets the default font and point size for the Day board row headers. Note that the :bold specification is optional. This default may be overridden for individual fields in the row header.

Setting Key: rowfields Setting Value: #

This entry specifies the number of fields that will appear in the row headers of the Day board. You must create a rowf# entry (described below) for the number of rowfields that you specify.

Setting Key: rowf#

Setting Value: fieldname,#char,x@y,facename:pointsize:bold,endx@y,background,foreground

You must create one entry for each of the rowfields you specified above. These entries define how the fields will be displayed in the row headers.

Fieldname

The following fieldnames pertain to corresponding fields in the Technician record – except for Hours. If you create an Hours entry, the total Hours selected for that Technician/Day will be displayed.  ID

Name
 User1
 User2
 Skills  (Special Skills? – displays as Y or N)
 Insurance  (Insurance? – displays as Y or N)
 Zip
 Addrs1
 Addrs2
 State
 City
 Phone
 Pager
 Cell
Email
 EmailFax
 EmailPager
 Hours (Estimated Hours for All calls for this tech - always set to 7 characters)

#characters

The number of characters that will be displayed for this fieldname.

x@y

The position of the text in pixels as defined by the upper left-hand corner of the first character.

facename:pointsize:bold

This font information is optional: it will default from the colfont entry if not specified here.

endx@y

This setting is optional and only needs to be included if you are specifying the background and foreground colors of this field.

background,foreground

These optional settings enable you to control the foreground and background colors of this field.

Infocell Settings

Setting Key: infocellsize Setting Value: x@y

This option specifies the size, in pixels, of the information cells in the Day board. This also effectively sets the column width and the row height of the headers.

Setting Key: infofields Setting Value: #

This entry specifies the number of fields that will appear in the information cells of the Day board. You must create a infof# entry (described below) for each field you add or change.

Setting Key: infof#

Setting Value: fieldname,#char,x@y,facename:pointsize:bold,endx@y,background,foreground

Create one entry for each of the infofields you want to add or change from the default. These entries define how the fields will be displayed in the information cells of the Day Board.

Fieldname

Valid fieldnames correspond to the fields labels displayed in the dispatch board’s work order list (for example, Site Alpha, Work Order, Workcode, Pr, Zone, etc.).

#char
The number of characters that will be displayed for this field.

x@y

The pixel position within the cell of the text as defined by the upper left-hand corner of the first character (e.g, 0@20).

facename:pointsize:bold

This font information is optional: it will default from the font entry if not specified here.

endx@y

This setting is optional and only needs to be included if you are specifying the background or foreground colors of this field.

background,foreground

These optional settings enable you to control the foreground and background colors of this field. You may specify a custom color, or the field used to set the color-coding scheme.

Example:
Assuming a color-coding scheme of Status, the following entry displays the first 15 characters of the work order’s Site Alpha text at the upper left-hand corner of the cell in Arial 10pt bold text. The text is displayed in black (0:ClrDefault) against a background the color determined by the status of this work order.

infof1=Site Alpha,15,0@0,Arial:10:bold,0@0,Status,0:ClrDefault