User's Guide To Voice Mail System

Previous Page TOC Next Page


Chapter 4: The System Editor

Chapter 4: The System Editor


Introduction


Overview

This chapter discusses the concepts of the System Editor that you use to build and maintain your Voice Mail application. You will become familiar with the various objects used as the building blocks of your own system. The manual explains how it works and how you use the editor to create, configure and manipulate that object. Specifically, this chapter explains to you:

Terms

Clipboard

A special storage area in Windows that temporarily stores cut or copied information, such as text or speech files.

Control

A graphic representation on a box that you use to perform a function or feature. A control may be a field, check box, or button.

Default

Any preset or preselected item, control, or field. Most commonly, the default setting of a control is the normal or recommended setting.

Menu Bar

This contains a list of menu headings. Clicking on a menu heading displays the menu corresponding to the selected menu heading. The menu options relate to the menu heading they fall under.

Object ID Number

A number used to identify tree objects in the tree. The ID number of an object is the sum of all touch tones a caller would press to get to that object from the Initial Prompt.

Tool Button Ribbon

This is a vertical display of buttons that allow you to edit and modify the tree. These buttons correspond to menu commands located under the menu headings on the tool bar.

Tree Objects

These are the components you use to make your system. There are three types of tree objects you may use: Prompts, Mailboxes, and Control points. These three objects allow you to design your entire Voice Mail system.

Work Area

This portion of the program window displays the existing tree structure for your Voice Mail system.

The System Tree and What It Means


When we say 'Tree', we're referring to the structure of your Voice Mail application as it appears in the work area. Think of your system tree as a family tree -- a family tree has branches, and so does the system tree of your Voice Mail application. Keeping with this visualization, you can see that this matriarchal family tree has mothers, grandmothers, great grandmothers, daughters, grand-daughters, nieces, and so on. Figure 14 illustrates this comparison of the family tree to the system tree:

Undisplayed Graphic

Figure 14 - The Family tree and the System Tree

As with any family tree, all of the children spring from their ancestors. These children have children, and the tree begins to branch and grow.

To carry the family tree analogy a step further, a family tree has a main ancestor from which branches of relatives grow. From those branches, other branches grow, and branches grow from those branches, and so on. The Voice Mail system works the same way. Knowing this, let's look at the Voice Mail tree again:

Undisplayed Graphic

Figure 15 - The Voice Mail system tree

You can see why the structure is called a tree. All ECS Phone applications share this structure. This tree structure then is a representation of how a caller would use touch-tones to move around the system.

For Example: Suppose a caller calls into the example Voice Mail system. The first thing they hear is the welcome speech on the System Greeting object. They then hear the first menu on the Initial Prompt (Menu). At this point, the caller has a number of choices: They can press the "1" key to leave a message for the Administrator of the system, "2" to access the Harrison Realty Mailbox group, "3" to leave a message for Tom Becket, "4" to leave a message for Arthur Dent, and "99" to exit the system. Figure 16 shows the caller's progress in the tree so far:

Undisplayed Graphic

Figure 16 - The caller's progress in the tree

The Initial Prompt is a type of Prompt, and a Prompt waits for a touch tone before it does anything. The caller decides to press 1, which means they move to the tree object of the same number. This is the System Administrator Mailbox, as shown in Figure 17:

Undisplayed Graphic

Figure 17 - The caller moves to the System Administrator Mailbox

At this point, the caller listens to the Greeting speech on the System Administrator Mailbox. This speech tells the caller to leave a message that includes a number they can be reached at.

The caller hears a beep after this speech, and they leave a message. When they finish, they hang up.

This is how a typical call works. It's as simple as pressing a few buttons, then leaving a message in the appropriate box. A more complicated call may involve the caller moving to a Mailbox within a Mailbox Group. This means that the caller may have to choose from another menu or two before actually leaving a message.

The Tree Objects


There are two permanent tree objects that act as originating ancestors for the system tree, and three objects that you may use to create 'branches' in the Voice Mail system tree. We'll discuss the purpose of each of these elements, and how they work in the system tree.

Undisplayed Graphic

System Greeting - This object appears in the tree in the upper left corner of the Work area (it's that small blue rectangle with an "S" on it). This is the first object in the tree that callers reach when they call into the system. The System Greeting usually contains a speech that welcomes the caller to the system, as well as some system controls. This is a permanent object in the tree.

Undisplayed Graphic

Initial Prompt - This tree object appears as a small red folder, located directly under the System Greeting. Normally, you record instructions for callers using the system, onto this object, as well as a menu of options. This tree object is also a permanent object in the tree.

Undisplayed Graphic

Prompt - This object allows you to do a number of things, but its basic purpose is to prompt the caller for a touch-tone response. A Prompt commonly acts as a menu for its children (i.e. branches coming from this Prompt branch). You may also configure a Prompt to allow a Branch Administrator to control a Mailbox group using this Prompt. A Prompt appears as a small green folder.

Undisplayed Graphic

Mailbox - This tree object's basic purpose is to store the messages that callers leave for the Mailbox owner. You may also configure the Mailbox to limit the number of stored messages, delete old messages, and to use message forwarding. The Mailbox object appears as a small brown rectangle with an "M" on it.

Undisplayed Graphic

Control Point - A Control Point appears as a small pink rectangle with a "C" on it. Control Points allow you to perform special functions. Its primary function is to 'chain' to another ECS Phone application. This means that you may access part of another application through the Voice Mail system tree.

Tree Object Details


Now that you've been introduced to the tree objects, you know their purpose. This section now builds upon the previous discussions by stating the rules and details of each object and its controls. This section also relates each of these objects to the example system tree we shipped to you.

The System Greeting

As stated previously, the System Greeting is the first thing the caller hears when they call into the system. Think of it as a sort of welcome mat at the front door of your system.

The Details

Figure 18 shows how the System Greeting box appears:

Undisplayed Graphic

Figure 18 - The System Greeting box

The parts and purpose of the System Greeting box are as follows:

In The Example System Tree

Looking at the System Greeting box in the example system tree (Figure 18), we can see that the current setup answers the phone after the second ring, plays the greeting speech, then goes to the Initial Prompt. The 'behind the scenes' controls allow for a maximum announcement time of 240 seconds (4 minutes), a maximum recording time of 120 seconds (2 minutes), a message forwarding interval of five minutes, and ten message forwarding retries.

Initial Prompt (menu)

Our discussion of the System Greeting now takes us to the Initial Prompt object. This object, like the System Greeting, is a permanent tree object. Figure 19 shows the Initial Prompt box so you can take a closer look:

Undisplayed Graphic

Figure 19 - The Initial Prompt box

The Details

In the Example System Tree

Looking at the Initial Prompt information, you may deduce the purpose of this tree object: When the caller reaches this tree object, they hear the instructional speech recorded for this object (the script for this speech appears in the Prompt Script field). They then hear the auto-menu, which plays a menu of the Mailboxes and Prompts the caller may access. The auto-menu also tells the caller which numbers to press on their phones to access these messages.

Currently the No TT Jump field contains a "1". This is the ID number for the System Administrator Mailbox. This means that a non-touch tone caller can at least leave a message for the System Administrator regarding the nature of their call. The ID number of an object is the sum of all of the touch tones you would press to get to the object from the Initial prompt.

At this point, the touch-tone caller could branch to one of five places. The auto-menu on the Initial Prompt gave the caller the following choices:

"System Administrator, 1; Harrison Realty, 2; Tom Becket, 3; Arthur Dent, 4; Hang up and leave the system, 99."

Prompts

A Prompt's primary job is to wait for a touch-tone, then go to the object that corresponds to that touch-tone. You may also use a Prompt to control a Mailbox group, as a Branch Administrator would. Figure 20 shows how the Prompt box appears:

Undisplayed Graphic

Figure 20 - The Prompt box

The Details

In the Example Tree

There is only one Prompt in the example system tree, and it is the Harrison Realty Prompt. The caller reaches this Prompt by pressing the 2 key at the Initial Prompt. Figure 21 shows the settings for this Prompt's controls:

Undisplayed Graphic

Figure 21 - The Harrison Realty Prompt's settings

This Prompt is enabled, so callers may access it. When the caller reaches this Prompt, they hear the introductory speech corresponding to the text in the Script field. The Auto-Menu function is currently enabled, so the caller hears the list of Mailboxes in this group. The caller may go to any of the five Mailboxes under this Prompt by pressing the key on their phone that corresponds with the desired Mailbox.

Mailboxes

Let's view the details of a Mailbox:

Undisplayed Graphic

Figure 22 - The Mailbox

The main purpose of the Mailbox tree object is to allow callers to leave messages. The Mailbox stores these messages, and the Mailbox owner may later access his or her Mailbox and retrieve their messages.

The Mailbox box is divided into six groups of buttons and fields. These groups of controls pertain to Mailbox information, left messages, message forwarding, what happens when the object finishes its tasks, other settings, and the Mailbox script and speech. Let's look at the controls in these groups.

The Details

You can select either the Goto option or the Hangup Phone option, but never both. If you select one option, the black dot appears in the corresponding circle. At the same time, the black dot in the other circle disappears, thereby unselecting the corresponding option.

    Goto - The Goto option allows you to go to another part of the tree. Normally, the Goto option is selected (as indicated by the small black dot in the circle), and the field beside the Goto contains "*". The star (asterisk) always sends the caller back to the Mailboxes' parent Prompt. By activating the Goto option and entering a tree object's ID number (which is like its 'address' in the tree), the caller then goes to that object when this object finishes.

    Hangup Phone - This option, when selected, tells the application to hang up the phone after completing the tasks for this Mailbox.

Password - This field allows you to enter a password that the Mailbox owner would use to access their Mailbox, either to retrieve left messages or to record a Mailbox greeting speech. You may use from one to ten numbers for the Mailbox password.

Message Limit - This field allows you to enter the maximum number of messages that may be left in this mailbox. This field is 'number specific', which means that you may only enter numbers into this field.

Delete After __ Days - This field allows you to determine how long (in terms of days) your Voice Mail system will retain messages in the Mailbox before deleting them. You must enter data in this field if you want messages deleted. If you leave this field blank, then the messages will not automatically delete. This field is 'number specific', which means that you may only enter numbers into this field.

Enable Forwarding - When enabled, this check box allows the system to forward a message left in a Mailbox to a phone or beeper. If an "X" appears in the check box, then call forwarding is enabled.

Voice, Beeper, Display, Disabled - These are the different settings for the Enable Forwarding control. The Voice control allows you to forward the message in voice form to the phone number listed in the Phone field. The Beeper control tells the system to dial the Mailbox owner's beeper, notifying them that they have a call. The Display control tells the system to forward the system phone number to the Mailbox owner's display beeper, so they know they have a message in their Mailbox. You may choose only one of these controls at a time. The currently active control has a black dot in the circle to its left.

Default dialing prefixes and suffixes may appear on Mailboxes. These default settings appear if you have entered numbers into the Dialing Prefix and Dialing Suffix fields on the Global Settings box in the Business Manager program. For more information on these controls or the Global Settings box, refer to the User's Guide to Business Manager.

Prefix - This field allows you to enter any numbered code that would come before the forwarding phone number. Many offices and corporations use a dialing code before the phone number to ensure that the call goes to an outside line. This field is disabled when the Long Distance control is enabled. This field is 'number specific', which means that you may only enter numbers into this field.

Suffix - This field allows you to enter any numbered code that would come after the forwarding phone number. Many offices and corporations use a billing code after the phone number to ensure that the call is charged to the correct person. This field is disabled when the Long Distance control is enabled. This field is 'number specific', which means that you may only enter numbers into this field.

Long Distance - This check box determines whether or not the message forwarding will call long distance numbers. If an "X" appears in the check box, then this control is enabled. If this control is enabled, you will also notice that the Prefix and Suffix controls are disabled. Therefore, any prefix, suffix, or other dialing code must be entered into the Phone field.

Phone - This field allows you to enter the phone number that the message will be forwarded to (provided that message forwarding is enabled). This field is 'number specific', which means that you may only enter numbers into this field.

Left Messages - This field displays the date and time of all messages left in this Mailbox. If the word Old appears next to the message, then the message has been listened to. You may select a message to play or delete by clicking on the desired message.

Play Left Messages button - This button allows you to play messages left in this Mailbox. You simply select a message to play, then click this button and pick up your local phone.

Delete Left Messages button - This button allows you to remove messages left in this Mailbox. You simply select a message to delete, then click this button. The designation DEL appears to the left of the message, indicating that it will be deleted when you exit the mailbox by clicking the OK button.

Script - You use this field as part of the speech recording procedure. This field allows you to enter as much text as you wish. This text becomes the 'script' for the speech when you record. This eliminates the need for a bunch of hand-written speech notes cluttering your desk. We'll talk more about recording speech later.

Play button - Clicking on this button allows you to play the speech associated with the object, if the object has a speech recorded for it. This is useful if you want to hear a speech recorded for this object.

Record button - This button allows you to begin recording speech for a tree object. We'll talk more about recording speech later.

OK button - This button confirms the settings on the object. If you made any changes, the changes save and you return to the tree view.

Cancel button - This button allows you to avoid saving any changes and return to the tree view. You use this button when you've made some changes that you decide not to keep, and you want the tree object to return to its original format.

Status line - This is the area at the bottom of the box that displays notes pertaining to the parts of the box. For instance, you can move the mouse pointer to a control on the box and receive information pertaining to the function or purpose of that control.

In the Example Tree

There are eight Mailboxes in the example system tree, and they are divided into two groups. The first Mailbox, the System Administrator Mailbox, is there to allow callers and Mailbox owners to leave messages for the System Administrator. The other two Mailboxes that are children of the Initial Prompt are owned by individuals. The other five Mailboxes are children of the Harrison Realty Prompt, and are a separate Mailbox group.

The System Administrator and Individual Mailboxes

These Mailboxes are direct children of the Initial Prompt. Figure 23 shows these Mailboxes as they appear in the example system tree:

Undisplayed Graphic

Figure 23 - The Initial Prompt and its Mailboxes

These Mailboxes are configured to do nearly the same thing. The only real difference comes in when you look at the Message Forwarding settings and Message Limit control.

System Administrator Mailbox - Figure 24 shows the System Administrator Mailbox:

Undisplayed Graphic

Figure 24 - The System Administrator Mailbox

The caller would press the 1 key at the Initial Prompt to access this Mailbox. Looking at this Mailbox, you can see that the caller who reaches this mailbox hears the System Administrator's greeting speech and can then leave a message. When the caller finishes leaving their message, the Mailbox hangs up (as instructed by the activated Hangup Phone control) .

Some things worth noting are the controls in the Settings and Message Forwarding control groups. The Message Limit field is set to "99", which is the maximum setting for this control. By allowing a large number of messages to be left, the System Administrator can make sure that they receive all important messages. Also, the Delete After field contains "99", which is the maximum for this field. This allows the System Administrator plenty of time to get all of their messages.

Also, the Enable Forwarding control is active, the Voice control for Message Forwarding is selected, and the System Administrator's phone number at work appears in the Phone field. This means that any message left in their Mailbox forwards to the System Administrator's work phone.

Tom Becket Mailbox - Figure 25 shows the information for the Tom Becket Mailbox:

Undisplayed Graphic

Figure 25 - The Tom Becket Mailbox

The caller would press the 3 key at the Initial Prompt to access this Mailbox. Looking at this Mailbox, you can see that the caller who reaches it hears the Mailbox owner's greeting speech, and then the caller may leave a message. When the caller finishes recording their message, they hang up and the system hangs up. If the message limit time is reached, the system also hangs up. This is your basic 'no-frills' Mailbox. The numbers in the Message Limit and Delete After _ Days fields are the default settings for these fields (i.e., values Automatically set by the system). The system also generates the Mailbox Password, but this may be changed by the System Administrator.

Arthur Dent Mailbox - This individual's Mailbox appears as shown in Figure 26:

Undisplayed Graphic

Figure 26 - the Arthur Dent Mailbox

This box appears similar to the Tom Becket Mailbox, and only the Object ID, Password, Description, and Script are different. The function of this Mailbox is once again the 'no-frills' Mailbox.

The Harrison Realty Mailbox Group

Figure 27 shows the Mailboxes that branch from the Harrison Realty Prompt:

Undisplayed Graphic

Figure 27 - The Harrison Mailboxes

Since each of these Mailboxes are very similar (only the ID's, Passwords, Descriptions, Scripts, and speeches are different), let's look at the function of this Mailbox group as a whole.

First, the caller presses 2 on their phone to get to this Mailbox group. They hear the Main speech on the Harrison Realty Prompt, which explains the workings of this Mailbox group. The Prompt's auto-menu plays the Mailbox choices to the caller, and they may leave a message for one of the realty agents. Notice that the first Mailbox is labeled Harrison Mailbox, general. This is so a caller can leave a general message for Harrison Realty, as opposed to a message for an agent.

Control Points

The purpose of the Control Point is to control the flow of events in the system tree. Not only does a Control Point allow you to go to another part of the tree, it also allows you to go to another ECS Phone application. Figure 28 shows the Control Point box:

Undisplayed Graphic

Figure 28 - The Control Point box

The Details

In the Example Tree

The caller accesses the Exit System Control Point by pressing the 99 on their phone. Take a closer look at the Exit System Control Point:

Undisplayed Graphic

Figure 29 - The Exit System Control Point

The first thing you should notice is that this Control Point has "99" as its ID number. The reason for this is so the caller won't accidentally exit the system by pressing a single touch tone.

The only activated control on this object it the Hangup Phone control. When the caller reaches this tree object, the system hangs up the phone.

The purpose of the Exit System Control Point is to give the caller a place to hang up (knowing it's safe to do so at an option called Exit System). You could make a system without a hang up point, but the caller might feel funny about just hanging up. The Exit System Control Point just makes hanging up a more comfortable procedure for the caller. If you decide not to provide your callers with a place to hang up, make sure at least tell them something like "You may hang up at any time during this call to exit this service". A message like this would best be placed with system instructions (like those found on the Initial Prompt).

Another reason for including a hang up Control Point is for using the Chain To function in the Combination Application. This hang up point allows the system to 'unchain' from the current application, and return to the Combination Application. The Combination Application is discussed in more detail in the User's Guide to Business Manager manual.

Object ID's: What They Do And What They Mean


A tree object's ID number allows you to locate that object when you remotely access your system. Also, ID's allow you to know where an object is in the system tree.

If you look at your system tree, you'll notice that each object in the tree has a picture, number, and description associated with it. The number is the relative location of the object.

If you double click a tree object to view the detailed information box, you'll notice that in some cases the ID number for that tree object is different. This is because the ID Number is an absolute reference number for that card.

To illustrate this idea of relative and absolute ID's, let's look at the example tree in Figure 30:

Undisplayed Graphic

Figure 30 - The example system tree

Looking at the Harrison Mailbox, general Mailbox, we see that its relative number is "11". This means that it has this ID relative to its Mailbox group. Now let's look at the detailed information for the Harrison Mailbox, general Mailbox:

Undisplayed Graphic

Figure 31 - The Harrison Mailbox, general Mailbox

As you can see, the Mailbox ID is "211". This is the absolute Reference Number for this tree object. No other tree object may use this number (the application simply won't allow it). Due to the ID's uniqueness, it is this number that you use as a Reference Number when using the remote access part of the Voice Mail System Editor.

The maximum length of any object's ID is ten digits. If you feel the need for more, then your tree structure is too complex.

Also, consider that there is no rule that says an object's relative ID can only be a single digit. If this were the case, then you could only have ten objects at any level (1, 2, 3, 4, 5, 6, 7, 8, 9, 0). This would limit a Mailbox group to ten Mailboxes. In some cases, this is a good thing; a lengthy menu of items may wear on the caller and most callers can only handle four to five options on a menu.

The Script Editor


The Script Editor is a large field that appears at the bottom of Mailboxes and Prompt boxes, as well as the Initial Prompt box. You use this field as part of the speech recording procedure. This field allows you to enter as much text as you wish. This text becomes the 'script' for the speech when you record. This eliminates the need for a bunch of hand-written speech notes cluttering your desk. Figure 32 shows an example of the Script Editor:

Undisplayed Graphic

Figure 32 - The Script Editor

The white area of the box accepts text, as long as the Enable Speech option is active (i.e., the check box contains an "X"). The scroll bar along the right side of the text field allows you to move up and down through the text.

When you move the mouse pointer into the Script Editor field, the mouse pointer changes from an arrow to a script editing cursor. Figure 33 Shows this change:

Undisplayed Graphic

Figure 33 - Mouse pointer change in the Script Editor

When you click anywhere in this field, a cursor appears. You may use the mouse to place the cursor where you want in a body of text.

The following is a list of keys you may use to perform certain movement and editing functions in the Script Editor:

Key or Key Combination

Effect or Function

Up Arrow

Moves the cursor up through the text, one line at a time.

Down Arrow

Moves the cursor down through the text, one line at a time.

Right Arrow

Moves the cursor to the right, one character at a time.

Left Arrow

Moves the cursor to the left, one character at a time.

PgUp

Moves the cursor up one page (screen section).

PgDn

Moves the cursor down one page (screen section).

Home

Moves the cursor to the beginning of the current line.

End

Moves the cursor to the end of the line.

Delete

Deletes the characters to the right of the cursor, one character at a time.

Undisplayed Graphic

Deletes the characters to the left of the cursor, one character at a time.

Ctrl+Home

Moves the cursor to the absolute beginning of the text.

Ctrl+End

Moves the cursor to the absolute end of the text.

Ctrl+ C

Copies the selected (highlighted) text to the Clipboard.

Ctrl+ X

Cuts the selected (highlighted) text from the Script Editor to the Clipboard.

Ctrl+ V

Pastes the text in the Clipboard to the cursor's current location in the text.

You use the Script Editor any time that you may record a speech (other than the ID speech).

The Record Box


The Record box is the box that appears when you click the Record button or the Record ID button on a Prompt box or Mailbox. You also see the Record box if you click the Record button on the Initial Prompt box, or the Record ID button on a Control Point box. You use this box to record the descriptions and speeches for your tree objects. Figure 34 shows how the Record box appears in the application:

Undisplayed Graphic

Figure 34 - The Record box

The fields and controls on the Record box are as follows:

The Play Box


The Play box is the box that appears when you click the Play button or the Play ID button on a Prompt box or Mailbox. You also see the Play box if you click the Play button on the Initial Prompt box, or the Play ID button on a Control Point box. You use this box to play back the descriptions and speeches you recorded for your tree objects. Unlike the Record box, you may not record any speech in the Play box. Figure 35 shows how the Play box appears in the application:

Undisplayed Graphic

Figure 35 - The Play box

The fields and controls on the Play box are as follows:

The Insert Tree Object Box


The Insert Tree Object box appears whenever you add or paste a tree object to your system tree, or move an object to another part of the tree. Figure 36 shows how the Insert Tree Object box appears on the screen:

Undisplayed Graphic

Figure 36 - The Insert Tree Object box

The parts of the Insert Tree Object box are as follows:


Previous Page TOC Next Page