Join us on facebook 1-855-DAIRTEL (toll free 1-855-324-7835)
1-650-494-7081 (local tel)
email: DennisR@dair.com

DairTel Console

Overview

A DairTel account has a DairTel-provided programmable telephone number. That programming is provided inside a file called a profile. The console provides tools to manage all your profiles.

The console consists of two main functions, accessible across the top of the main menu: the Profile_Mgr and the XML_Editor.

You may have multiple profiles. Only one can be active (control your phone number) at a time. The Profile_Mgr allows you to clone, delete, and activate profiles and designate which one you want to edit.

The XML editor allows you to edit the contents of the file designated in the Profile manager.

Profile_Mgr

The profile_mgr consists of two panels. The top panel shows designates which profile may be edited. The bottom one allows you to clone, delete, or activate a profile.

Starting with the bottom panel, the clone function lets you select an existing profile and copy it to a new name you supply. The delete function lets you select an existing profile and delete it provided you have not selected the active profile for deletion.

The activate function lets you select an existing profile and set it to control your phone number. If the functionality of your profile requires DairTel to take a message, it needs to know which format to use. "Workflow" is an excellent choice. If you have an associated Telephone Message Pad account, you have other choices which correspond to the forms listed under the Forms menu in your account (DairTel only accounts do not have this menu).

Moving to the top panel, one of the profiles is shown as selected for editing. There is telephone number shown next to the active profile. In this case, the active profile and one selected for editing are the same but that need not always be the case.

If you ever forget your DairTel telephone number, you can always find the page listing it by following the links to DairTel >> DairTel_console >> Profile_Mgr.

XML_editor preface

Before we address the XML_Editor functions, we urge you not to edit the active profile. Rather, use the Profile_Mgr to clone a copy of the active profile and edit the clone. Then, when you are satisfied with your edits, use the Profile_Mgr again to change the active profile to the cloned file.

We urge this approach for three reasons: (1) the concepts and organization of the profile file may be unfamiliar and "mistakes" are quite possible in the beginning, (2) you may have a live system and do not want to expose operation of your system to transitional, in-progress edits, (3) this approach allows you to roll back or audit whatever changes were made.

XML_editor: navigation

The profile file is a hierarchical data structure rendered in a simplified version of XML. Whew!

Hierarchical simply means that data is represented in various levels of detail. A good example is finding a specific house in a country (say, the USA). The highest level is shows the USA level listing each of the 50 states. Click on (descend into) one of the states and you now see a list of cities within that state. Descend further and you see a listing of the streets composing the city. Click on a street and you see a list of house numbers. You can reverse the process and ascend up the hierarchy as well.

In simplified XML, each level is encloses the data beneath it surrounded by <tag>...</tag> text where "tag" is a name for that enclosed data. Thus, the data structure to define DAIR's office would be:

  • <usa>
    • <california>
      • <palo_alto>
        • <kenneth>
          • <3440>...<3440>
        • </kenneth>
      • </palo_alto>
    • </california>
  • </usa>

You can move UP or DOWN such a data structure. The further down you go (i.e. the more specific), the less data you will have to contend with. Even more importantly, the context sensitive help you see will change.

If you find yourself lost, not knowing "what to do next", try changing levels (up or down). The help you need might be at a more/less specific level.

XML_Editor: structure

When you enter the XML_Editor, you are at the top level. There are 5 buttons which take you lower: actions, admin, outdial, when_block, and who_block. In the edit window, you can see the admin block (do not edit this) and beginning of the actions block.

We click on the actions button and now see the navigation has changed. The "actions" button we just clicked has moved from DOWN to UP and has a white background. The white background is a "you are here" marker. The dt_dispatch link has now turned to a button, allowing us to ascend. The DOWN buttons have changed entirely to reflect what actions we may perform.

What we may do next is extensively commented so we will not repeat that here. Our purpose here is to give you an introduction to the console facilities.