Import Command

Location: File Menu -> Import

Top  Contents  Index 

The Import command loads the contents of XML or CSV (comma-separated-value) files into the call list, contact list, action list, or location list, depending on the option selected, as well as importing settings and data from previous versions of Ascendis Caller ID.

 

Importing Files

 

You will be prompted to specify the name and location of the file to import.

 

Use this command to transfer the lists from another program, or another copy of Ascendis Caller ID (XML format only).

 

Please note the following:

When importing calls, existing calls will be ignored, not replaced.  Ascendis Caller ID examines the RawNumber and CallBegan fields to determine whether a call matches.
When importing contacts, a warning will be shown if a contact already exists in the list.  The imported contact will be ignored.  Ascendis Caller ID will try to map similar column names to the column names it uses.  If you want to overwrite existing contacts with imported contacts, hold down the control key while selecting the command from the menu.
When importing actions, a warning will be shown if an action already exists in the list.  The imported action will be ignored.  If you want to overwrite existing actions with imported actions, hold down the control key while selecting the command from the menu.  Overwriting only works with actions imported from XML files.

 

 

Importing Files in CSV Format

Details about and samples of the Calls CSV format can be found under Calls CSV Format.

Details about and samples of the Contacts CSV format can be found under Contacts CSV Format.

 

To determine the best format for the import file, export the corresponding list from Ascendis Caller ID, and examine it.  Here are some specifics:

The first row must contain the names of the columns.
All subsequent rows contain data to import.
Values (or header names) containing commas must be contained within double quotes since commas are used to separate values.
Embedded double quotes must be replaced with '\"' (see contacts.csv, below, for sample).
Newlines in scripts must be replaced with '\n' (see contacts.csv, below, for sample).

 

 

Sample actions.csv:

"ActionName","ActionTypeName","SimpleScript","Script","Notes","Modified"

"Anonymous","Easy","//hangup;\n//sound \"\";\n//run \"\";\n//sendmail \"\" \"\" \"Call from {Name} at {Number}\" \"\";\nspeak \"The caller is anonymous\";\n","","",""

"Block","Easy","hangup;\n//sound \"\";\n//run \"\";\n//sendmail \"\" \"\" \"Call from {Name} at {Number}\" \"\";\n//speak \"Call from {Name}\";\n","","","09/21/2006 7:36:48 PM"

 

 

Importing Files in XML Format

The XML formats are intended for Ascendis Caller ID use.  We recommend using CSV if you want to get data into Ascendis Caller ID from other programs.  If you wish to know the details of the XML format, please export to XML and examine the file.

 

 

Importing Previous Version Settings

 

If previous versions of Ascendis Caller ID are or were installed on the computer and their data remains, commands to import settings from them will appear on the Import menu. Importing settings will overwrite the current settings, and cannot be undone!  Please make sure you want to do this before proceeding.

 

 

Importing Previous Version Databases

 

If previous versions of Ascendis Caller ID are or were installed on the computer and their data remains, commands to import data from them will appear on the Import menu.  Importing a version 1 database will merge the version 1 data with the current data, but it could make unintended changes if the data overlaps. Importing a version 2 database will overwrite the current database completely.  In both cases, please backup your database before importing.

 

If you want to import from a version 1 database that is no longer installed, press the CONTROL key while bringing up the File -> Import menu.  This will force the "Import Database from Version 1..." command to appear.  When selected, Ascendis Caller ID will prompt you to locate the folder containing the version 1 database.  This would normally be located in

C:\Documents and Settings\All Users\Application Data\Ascendis Software\Caller ID\Db

 

If you want to replace your database with a version 2 database that is no longer installed, do the following:

1.Backup your database using the Backup Database command.
2.Locate the Ascendis Caller ID data folder: open the About box, right-click on "Ascendis Software", and choose "Open Data Folder".
3.Terminate Ascendis Caller ID using "Exit" on the "File" menu.
4.Rename the "Db" folder in the data folder to "Db-Backup" or similar.
5.Copy the version "Db" folder into the data folder.
6.Start Ascendis Caller ID.

 

 

See also

 

Use the Export command to export data from Ascendis Caller ID.