Create Phone Book Directory based ADF Files

To start using ADF, you have to create the ADF data and mapping files for the console to use. Follow this procedure to create ADF files that align with a MiVoice Business Phone Book Directory export:

  1. Create an ADF folder on a local or shared drive.

    Note: You may choose the same or a different folder for your ADF data and mapping files as well as your MiVoice Business Phone Book export file.
  2. Copy the example ADF data and map CSV files from C:\ProgramData\Mitel\MiVoice Business Console\config\Example ADF Files\PBSync to your ADF folder.

  3. Export The MiVoice Business ESM Phone Book Directory that your ADF data file will be based on.

    • Schedule a Once-only CSV FTP Phone Book Export on the MiVoice Business. (see the topic Scheduler in the MiVoice Business System Administration Help)

    • Copy the exported file to your ADF folder. Ensure the file name is pre-pended with 'PB'.

  4. Configure ADF on the MiVoice Business Console:

    Note: You will need Administrative Access enabled to perform an ESM sync operation. If it is not already enabled, re-run the configuration wizard to select the option. Administrative access is only needed on the console that is designated to perform the sync operations.
    • In the Directory Administration Configuration panel

      • Enable the Additional Database Fields Feature option.

      • Configure the Directory Data and Mapping files by clicking the browse button to locate your ADF folder and selecting the file.

    • In the Directory Administration Maintenance panel

      • Configure the ESM Directory Synchronization export file location by clicking the browse button to locate the ADF folder.

      • Click the Synchronize Now button.

        • A dialog box is displayed informing you of how many matches were identified, as well as the total number of entries in each file. Press Continue to start the actual synchronization process.

        • Upon completion, your console displays the resulting columns in the console’s Phone Book area.

        • An un-matched entries CSV is created containing the entries that were removed during the sync operation.

          Note: It is recommended that the console be placed in absent mode prior to performing a Synchronize Now operation, since the console will not be able to manage calls for the duration of the process.
  5. Customize the ADF files:

    • Use Excel or another any similar editor to edit the map file columns as follows:

      • Ignore unwanted columns by changing the field type in row 5 to IGN. Note that the FN, DN, TDN and GUID columns are mandatory key fields needed to match entries in subsequent ESM Directory Sync operations, so do not modify the field type of these columns.

      • Add additional columns to the right of other columns by entering the field name in row 4 and the field type in row 5.

      • Customize column header names in row 4 to reflect the names you wish to display in the Phone Book and Busy Lamp Field areas.

      • Save the map file as a CSV (Comma Delimited) file.

      See Create an ADF Mapping File for more details about the ADF mapping file.

    • Use Excel to edit the data CSV file columns as follows:

      • Add new columns in the same order as the map file columns by entering the field name in row 1.

      • Enter new column data for each entry in the data field.

      • Save the data file as a CSV (Comma delimited) file.

      See Create an ADF Data File for more details about the data file.

    • Test your customized ADF files by clicking the Reload Now button in the Directory Maintenance panel of the console.

    • After you have completed the ADF file setup, you are ready to set up automatic synchronization with the MiVoice Business. See Synchronize ADF Files with the MiVoice Business for details.