...
This file describes Switchvox version 8.0 and later. If you are using an earlier version, use SETUP-EXTENSIONS-Manage-Import-Extensions (6.6).
Import Extensions
The Import Extensions tool lets you create and update multiple SIP or Virtual extensions from data in an imported CSV file. To do this, you need an Extension File that is formatted correctly with specific extension information. Then, you can use the Import Extension tool to identify that file, evaluate the extensions that will be created or modified, and perform the import.
The Export Extensions button downloads a file that already defines the headers and contains the data about your existing SIP Phone extensions. If you have not already created any extensions, the file is empty. You can add or modify extension information, and import the file.
The Import Extensions File
The Import Extensions File must be in Comma Separated Value (CSV) format, with the following format:
The first line of the file must be a header line that labels each column. Each subsequent line should be an extension line that contains the values of an extension.
Depending on the type of extensions you are working with (SIP or Virtual) different information is required or accepted. You can use a file that has additional columns of information (Switchvox ignores this information) as long as the required extension information is included correctly.
The order of the labels in the header is not important, but the values of each extension must match the order of the labels.
If you are updating an existing extension and you have some information that you do not want to change, use just the comma with no spaces or text. If you want to make it blank, put a space in that column.
If you have set Switchvox to LDAP mode (Setup > Extension Settings), the header-line must include the label username. Values for username are not required in each extension-line, but the label must be in the header. For examples of a CSV file with username, see Switchvox with Active Directory and LDAP.
When your Extension File is ready, go to Setup > Extensions > Manage and click Import Extensions (see “Import Options”).
File Information
This table describes the data for each type of import:
...
x = REQUIRED ::: A = ACCEPTED ::: NA = NOT USED
File Examples
SIP Extension File
| Code Block |
|---|
ext,fname,lname,login_email,email,password,voicemail_password,phone_password,digium_phone_mac_address 100,Joe,Smith,jsmith@home.com,jsmith@home.com,!@#$12As,1000,,0019159C0646 101,Jane,Doe,jdoe@home.com,jdoe@home.com,!@#$12As,1010,,0013174C5532 102,Dan,Jackson,djackson@home.com,djackson@home.com,!@#$12As,1020,, |
...
| Code Block |
|---|
ext,fname,lname,email,password,voicemail_password,phone_password,location 100,Joe,Smith,jsmith@home.com,jsmith@home.com,,,,2A 101,Jane,Doe,jdoe@home.com,jdoe@home.com,,,,3B 102,Dan,Jackson,djackson@home.com,djackson@home.com,,,,2C |
Import Options
The Import Extensions options determine how to manage this import. When the settings are correct, click Evaluate Import to evaluate the Extension File and to see what will happen if you import the file.
...
Update Information: Update the existing extension with the values from the file and the chosen extension template. NOTE: the update is only applied if the extension types are the same. For example, if you have an existing Virtual extension of 100 and have a line in your file to create a SIP extension of 100, this line in the file is skipped even if you have Update Information chosen.
Import Extensions Evaluation
When you click Evaluate Import, Switchvox opens your Extension File and evaluates it against the extensions that already exist.
...