| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Bulk Handler manages the bulk export or import of extensions, DIDs, user manager users, user manager groups, and contacts. You can export any of these as a CSV file. You can also upload a CSV file to save time versus having to enter each item individually. The module provides required/recommended headers for your CSV files.
...
Click the Export button at the top if it is not already selected. (Dark background = selected)
Click the tab for the type of information you want to export.
In our example we'll export Extensions.
Click the Export button near "CSV File." Your browser will download a .csv file that you can open in a spreadsheet application.
...
Import a CSV File
| Tip |
|---|
Tip Perform an export first, if you would like to see all of the available headers and edit the file from there. You can also create a CSV file from scratch. The "Import" section will show you the minimum required/recommended headers. |
Click the Import button at the top if it is not already selected. (Dark blue background = selected)
Click the tab for the type of information you want to import. In our example, we'll be importing extensions, but the general process below applies to any kind of import.
.jpg?version=1&modificationDate=1705086006420&cacheVersion=1&api=v2&width=736)
If you are creating a CSV file from scratch, note the Required/Recommended Headers:
If you are importing... | Required/Recommended Headers |
|---|---|
Extensions |
...
extension |
...
(Extension), |
...
|
...
(Name), |
...
|
...
(Description), |
...
|
...
(Device |
...
Technology), |
...
|
...
(Secret |
...
[Enter |
...
"REGEN" |
...
to |
...
regenerate]), |
...
|
...
(Call |
...
Waiting |
...
Enabled: |
...
ENABLED |
...
to |
...
enable, |
...
blank |
...
to |
...
disable), |
...
|
...
(Follow |
...
Me |
...
Enabled |
...
[Blank |
...
to |
...
disable]), |
...
|
...
(Follow |
...
Me |
...
List), |
...
|
...
(Voicemail |
...
Enable |
...
[Blank |
...
to |
...
disable]), |
...
|
...
(Voicemail |
...
Password), |
...
|
...
(Voicemail |
...
E-Mail), |
...
|
...
(Voicemail |
...
Options |
...
is |
...
a |
...
pipe-delimited |
...
list |
...
of |
...
options. |
...
Example: |
...
attach=no|delete=no), |
DIDs |
...
description |
...
(Description), |
...
|
...
(Incoming |
...
DID), |
...
|
...
(Caller |
...
ID |
...
Number), |
...
|
...
(The |
...
context, |
...
extension, |
...
priority |
...
to |
...
go |
...
to |
...
when |
...
this |
...
DID |
...
is |
...
matched. |
...
Example: |
...
app-daynight,0,1), |
...
|
...
(Fax |
...
Enabled), |
...
|
...
(Type |
...
of |
...
fax |
...
detection |
...
to |
...
use |
...
(e.g. |
...
SIP |
...
or |
...
DAHDI)), |
...
|
...
(How |
...
long |
...
to |
...
wait |
...
and |
...
try |
...
to |
...
detect |
...
fax), |
...
|
...
(Where |
...
to |
...
send |
...
the |
...
faxes), |
User Manager Users |
...
username |
...
(Login |
...
Name), |
...
password |
...
(Password |
...
- |
...
plaintext), |
...
|
...
(Primary |
...
Linked |
...
Extension), |
...
|
...
(Description), |
...
|
...
(First |
...
Name), |
...
|
...
(Last |
...
Name), |
...
|
...
(Display |
...
Name), |
User Manager Groups |
...
groupname |
...
(Group |
...
Name), |
...
|
...
(Description), |
Contacts |
...
groupname |
...
(Name |
...
of |
...
group |
...
for |
...
contact. |
...
If |
...
group |
...
does |
...
not |
...
exist, |
...
it |
...
will |
...
be |
...
created.), |
...
|
...
(Type |
...
of |
...
group |
...
for |
...
contact.), |
...
|
...
(Display |
...
Name), |
...
|
...
(First |
...
Name), |
...
|
...
(Last |
...
Name), |
...
title |
...
(Title), |
...
|
...
(Company), |
...
|
...
(Address), |
...
|
...
(User |
...
Manager |
...
username |
...
this |
...
contact |
...
should |
...
point |
...
to. |
...
Internal |
...
contacts |
...
only.), |
...
phone_1_number |
...
(Phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Type |
...
of |
...
phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Extension. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Comma-delimited |
...
list |
...
of |
...
flags. |
...
(Example: |
...
sms,fax) |
...
External |
...
contacts |
...
only.), |
...
|
...
(Phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Type |
...
of |
...
phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Extension. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Comma-delimited |
...
list |
...
of |
...
flags. |
...
(Example: |
...
sms,fax) |
...
External |
...
contacts |
...
only.), |
...
|
...
(Phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Type |
...
of |
...
phone |
...
number. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Extension. |
...
External |
...
contacts |
...
only.), |
...
|
...
(Comma-delimited |
...
list |
...
of |
...
flags. |
...
(Example: |
...
sms,fax) |
...
External |
...
contacts |
...
only.), |
...
|
...
...
address. |
...
External |
...
contacts |
...
only.), |
...
|
...
...
address. |
...
External |
...
contacts |
...
only.), |
...
|
...
...
address. |
...
External |
...
contacts |
...
only.), |
Click the Browse button.
...
...
Select your .csv file from your computer. Your selected filename will appear next to the browse button.
...
Click the Submit button at the bottom. You're not done yet -- this will take you to a data validation page.
...
At the top, use the Yes/No toggle button to indicate whether you want to replace and update all of your existing data with the contents from the CSV file.
...
The contents of your CSV file are displayed in the table, but only a few main headers are shown.
...
Optional: You can edit the details of each item at this time before completing the import. You will be able to edit all headers, not just the ones shown in the table.
Click the edit
...
button
for any item you want to edit.
...
A window will pop up for this item. Note that you can scroll in the window to see all fields.
...
Click the Close button if you are not making any changes. Otherwise, make your changes in the appropriate fields and click the Save changes button.
Wait while the import is performed. The status bar near the top will show the progress of your import. The rows of the table will also turn green as each item is imported.
...
Click the Finished button when done.
...
Click the Apply Config button.
...
