Editing Requests

This help file applies to an out-of-date version of MainBoss.
The most recent version of MainBoss is MainBoss 4.2.4.
For the latest version of this help file can be found here.

< Previous section  |  Table of Contents  |  Index  |  Next section >

You create or modify requests using the request editor. The usual way to open the editor is to click New Request or Edit in the View section of Requests. However, you can also get to this window by clicking Edit Defaults in the Defaults for Request section of the Requests viewer.

The request editor window contains the following:

Details section: Shows basic information for the record.

Number: A code identifying this work request. No two requests may have the same code.

Subject: A subject line that briefly states the nature of the problem.

Number Format [only appears when editing defaults]: Specifies the format to be used when numbering new requests. The default is WR {0:D8}. This means that the numbering format consists of the letters WR followed by a space and then eight decimal digits.

The 0 before the : is necessary. The number after the D is the minimum number of decimal digits in the resulting number. As an example, suppose you want to include the year in your request numbers. If you set "Number Format" to Req 2007-{0:D6}, you'll get numbers like Req 2007-000001. You can also put text after the closing }; for example, you could write Req {0:D6}-2007 to get numbers like Req 000001-2007.

For more on number formats, see Number Formats.

We recommend that you use enough digits in your numbers to ensure that there is always a leading zero.

Number Sequence [only appears when editing defaults]: Specifies the number to used the next time you create a new request. For example, if you set this to 1000, the next request you create will be given the number 1000.

If you include the year in "Number Format", you should change the format at the beginning of each year and reset "Number Sequence" to 1.

Requests are automatically set In Progress when linked to a work order, and are closed when work order closes [only appears when editing defaults]: If you checkmark this option, closing a work order automatically closes all linked requests, provided that the requests are only linked to a single work order. (If a request is linked to multiple work orders, it will never be closed automatically, even if you close all the linked work orders.) In addition, if you create a work order from a request, the request is automatically marked as "in progress".

If you leave this option blank, closing a work order does not affect any linked requests and creating a work order from a new request does not change the request's state.

Comment to requestor for requests that are automatically set In Progress when linked to a work order [only appears when editing defaults]: Lets you specify a generic comment that will be emailed to requestors when you mark a request as In Progress. (This comment is only emailed if you have licensed the MainBoss Service module.) If you mark the request as In Progress by clicking the In Progress (With Comment) button, then the comment you specify at that time will be used instead of the default one you specify in this window.

Comment to requestor for requests that are automatically closed when their linked work order closes [only appears when editing defaults]: Lets you specify a generic comment that will be emailed to requestors when a request is closed automatically because it's linked to a work order that is also being closed. (This comment is only emailed if you have licensed the MainBoss Service module.) If you close a request explicitly (by clicking the Close Request button, the default comment in this field is not emailed to the requestor.

Current: Read-only fields indicating the request's current status.

State: Whether the request is New (recently created), In Progress (accepted by the maintenance department), Void (rejected by the maintenance department or otherwise cancelled), or Closed (marked as complete).

Status: A user-defined status code for this request. Typically, a code means that the request requires someone's attention. For more on request statuses, see Request Status Codes.

Effective Date: The date/time that the request entered its current state.

Estimated Completion Date: A read-only field telling when the job is expected to be completed. This date is taken from information specified when you change the state of the request; for example, when you mark a request as "in progress", you have a chance to specify the estimated completion date. The date shown in this field is taken from the most recent state history change record.

Requestor: The person who submitted the work request (and the person's phone number). You specify this person by referring to (or creating) an entry in the Requestors table. For more about requestors, see Requestors.

Unit: The unit where the work is needed. For more on units, see Units.

Use access code from unit: If this is checkmarked, MainBoss will fill in "Access Code" with the default access code associated with the unit. If this is blank, you can fill in "Access Code" with any available code.

Access Code: An access code indicating any restrictions on access to the unit. For more on access codes, see Access Codes.

Request Priority: A code indicating the priority of this job. For more on priorities, see Request Priorities.

Requests with explicit priorities are considered more urgent than requests where the priority field is blank. Therefore, if you sort your requests by priority, those with no explicit priority will come last.

Description: A more detailed description of the problem.

Comments: Any additional comments that may be useful to maintenance personnel.

Select for Printing: If this box is checkmarked, the request will be marked Select for Printing. This makes it simpler to print requests after they have been generated. For more on the use of Select for Printing, see Select For Printing.

Assignees section: Lists people who have been assigned to this request. For more information on assignments, see Assignments.

New Request Assignment: Opens a window where you can assign someone to this request. For more details, see Assigning Someone to a Request.

Edit/View: This drop-down button offers several possible actions:

Edit: Opens an editor window to let you edit the selected record.

View: Opens an editor window where you can examine the selected record.

View Request Assignee: Opens a window where you can view the request assignee record associated with the assignment that's currently selected.

Delete: Deletes the selected assignment from the list.

Refresh: Updates the list to reflect any recent changes.

Search: Lets you search through the list of records for a particular record. For more information, see Searching for a Particular Record. The Search button has an accompanying drop-down list containing the following:

Find Next: Uses the same search condition(s) as your most recent search and finds the next record in the table that matches the condition(s). If the search reaches the end of the table without finding a matching record, it goes to the start of the table and continues the search.

Find Previous: Same as Find Next except that it goes backward in the table. If the search reaches the start of the table without finding a matching record, it goes to the end of the table and continues the search.

E-mail Request section: If this request originated from an e-mail message, this will list the contents of the message. (E-mail requests are only possible if you have licensed the MainBoss Service module.)

Received: Date the e-mail was received.

Sender E-mail: E-mail address that sent the request.

State: Current state of the request.

E-mail message: The text of the e-mail message.

Comments: Any comments that the maintenance department might have about the e-mail. (These comments are not sent to the requestor.)

Work Orders section: Lists information about work orders associated with this request. Note that this section has no New button. If you want to associate a new work order with this request, use Create Work Order at the bottom of window. If you want to associate an existing work order with the request, use Link to Work Order.

Work Order: Click on this heading to sort the list by work order number. Click again to reverse the order.

Unit: Click on this heading to sort the list by unit. Click again to reverse the order.

Subject: Click on this heading to sort the list by subject line. Click again to reverse the order.

Edit/View: This drop-down button offers several possible actions:

Edit: Opens a window where you can edit the link to the work order. Note that you aren't editing the actual work order, just the information linking this request to the work order.

View: Opens an editor window where you can examine the selected link to a work order.

Delete: Deletes the selected work order from the list. The work order will still exist, but it will no longer be associated with this request.

Refresh: Updates the list to reflect any recent changes.

Search: Opens a window to search for a particular work order.

State History section: Lists the states that this request has been in and the date/times when the request entered each state.

Effective Date: Shows the effective date/time when the request entered the associated state. Effective date can be set manually by clicking the associated Edit button.

Entry Date: Shows the actual date/time when MainBoss put the request into the associated state. The entry date cannot be changed.

Request State: Shows the states through which the request has passed.

Edit/View: This drop-down button offers several possible actions:

Edit: Opens a window to edit the selected state history record. For more, see Editing Request State History Records.

View: Opens an editor window where you can examine the selected state history record.

Refresh: Updates the list to reflect any recent changes.

Search: Opens a window to search for a particular record.

Save: Saves the current record. The editor window stays open in case you want to make more changes to the same record.

Save & New: Saves the current record and sets up the window for you to enter a new record. Fields in the new record will be blank or set to default values.

Save & Close: Saves the current record and closes the editor window.

Save & Print: Saves the current record and opens a window for printing this request.

Print: Opens a window for printing this request.

Save Defaults [only appears when editing defaults]: Saves the current set of default values. The window stays open in case you want to make any more changes.

Close Request: Closes the currently selected work request. Close Request also has the following drop-down choices:

Close Request (With Comment): Closes the selected request, and also opens a window where you can record a comment about what you're doing.

Reopen: Reopens a request that has been closed or voided. MainBoss will also open a window where you may record a comment explaining why you're reopening the request.

In Progress: Marks the request as "in progress".

In Progress (With Comment): Marks the request as "in progress". MainBoss will also open a window where you can record a comment about what you're doing.

Void: Cancels the selected request. MainBoss will also open a window where you can record a comment explaining why you are canceling the request.

As noted above, some of the "state-change" operations open a window where you can record comments about what you're doing. This window also gives you an opportunity to record comments to be sent to the original requestor. If you have the MainBoss Service module, these comments are automatically e-mailed to the requestor. The comments are also recorded in the request's State History section. For further information, see Editing Request State History Records.

Cancel: Closes the window without saving any changes you've made to the record since the last time you saved. When you Save the record, the Cancel button changes to Close, indicating that you can safely close the window without losing any changes.

Close: Closes the window. This button only appears after you've saved changes with Save or before you've entered any data at all. Otherwise, the button is labeled Cancel.

Link to Work Order: Lets you indicate that this request is associated with an existing work order. This is useful if you get several requests reporting the same problem. The first time someone submits a particular complaint, you can use Create Work Order to make a work order to fix the problem. If other people complain about the same thing, you can use Link to Work Order to associate their requests with the work order you've already created. This makes it easier to keep track of which requests are associated with which work orders.

Note that it's also possible for a single request to be associated with multiple work orders. For example, you might create one work order for a short-term work-around fix, and another work order for a more permanent repair. Using Link to Work Order lets you associate the request with both work orders.

A request may be linked to any number of work orders and vice versa. When you click Link to Work Order, you get the window described in Requested Work Orders.

Create Work Order: Opens a window that lets you create a work order based on this request. Information from the request will be copied into the new work order; however, this information can be changed if desired. For more on creating and editing work orders, see Editing Work Orders.

New Requestor Comment: Lets you record a comment for the requestor. If you have the MainBoss Service module, this comment will be automatically e-mailed to the requestor. If not, you will have to convey the comment to the requestor in some other way.

You can click New Requestor Comment on a request as often as you like; each time, MainBoss will give you a chance to record a comment about the request. New Requestor Comment therefore gives you a good way to keep track of problems, delays, and other special situations that arise during the course of a request, and to keep the requestor informed about these situations.

Each requestor comment is recorded in the request's State History section. For more on state histories, see Editing Request State History Records.

For more on requests, see Requests. For more on viewing requests, see Viewing Requests. For more on editors in general, see Using Editors.

< Previous section  |  Table of Contents  |  Index  |  Next section >