ContactGenie for Microsoft® Outlook® '2000-'2007                                                                              
ContactGenie DataPorter 2.0 & Importer 1.3 ContactGenie DataPorter 2.0 & Importer 1.3
Home   FAQ Contact  
 Home Product Overview ContactGenie Support Contact Info About Us

Importing at a Glance
Exporting at a Glance
DataPorter 2.0
Importer 1.3
Exporter
Msg Class Modifier
Supported File Types
Screenshots
Subscription Option
Download/Order
About Custom Forms
FAQ

  

FAQ - updated 12/11/2007

 Question Summary
  1. How many templates can I create?

  2. I imported contacts into an Outlook folder that uses a custom form but it doesn't work properly, why?

  3. Why won't the program suddenly import into my target contact folder after I deleted it and re-added it using the same name?

  4. The new imported contacts aren't in the default contact folder I'm using or contacts are imported but the default contact folder doesn't exist?

  5. How long does it take to import data using CG Importer 1.3 or CG DataPorter 2.0?

  6. Not all the records in my input data file are being imported - why are they missing?

  7. I don't see MS SQL or MySQL as an option when selecting the input data file type?

  8. I'm trying to import from my MySQL database on my website but it seems to take a long time?

  9. I click on some of the fields on the DataPorter template form but sometimes it won't let me do anything?

  10. After upgrading from Importer 1.3 to DataPorter 2.0 - some of my MS Excel field names have number signs in them or the program reports that some field names are invalid on my text based files (i.e. CSV, TAB etc). This also happens on some of my user-defined fields when I use an Outlook contact folder as input data source, why?

  11. Importer and DataPorter are rejecting date fields that are in the proper format - why?

  12. I run Importer or DataPorter in command line mode but nothing happens - no records are getting imported - why not?

  13. Am encountering an <Access Violation> error or program fails to start - why?

 

 Answers
1. How many templates can I create?

For Importer 1.3 and DataPorter 2.0 you can create and use an unlimited number of templates.    <return to top>

2. I imported contacts into an Outlook folder that uses a custom form but it doesn't work properly, why?

Outlook contact folders that use a default custom form very often have custom programming to validate information before Outlook updates the contact folder. If these validation checks fail at the Outlook level, these updates are reported as "Outlook Update Failures" in the import statistics.

To verify whether your form has code that prevents a contact being added, simply try to add a blank contact record to the folder directly from within Outlook. If there are any issues, it should show up there.
 
<return to top>

3. Why won't the program suddenly import into my target contact folder after I deleted it and re-added it using the same name?

Importer 1.3 records and uses the internal Outlook Store and Entry ID's for the the folder. Each contact folder created are assigned these unique identifiers when the folder gets created and as such, these wouldn't match when a new folder gets created even when using the same name.

DataPorter 2.0 works differently in that if it cannot locate the folder by this ID, it will attempt to locate a folder by the same name and use it.


Also - see Question #4.
<return to top>

4. The new imported contacts aren't in the default contact folder I'm using or contacts are imported but the default contact folder doesn't exist?

You should also read question #3 since it is directly related. If you have deleted a contact folder and created a new one using the exact same name, the new contacts will be imported to the original contact folder which will be located in the "Deleted Items" folder if you haven't encountered an error message first. The new contact folder with the same name will be empty (or not have the new contacts you have just imported). This also applies if you have simply deleted the contact folder designated as a "default" folder for a CGI template. The only way to ensure that this does not occur is to delete the item from the "Deleted Items" folder. 

 

DataPorter 2.0 does not check to see if the folder it finds using the Store and Entry ID's are in a Deleted folder and therefore will not attempt to resolve the folder by name. <return to top>

5. How long does it take to import data using CG Importer 1.3 or CG DataPorter 2.0?

For CG Importer 1.3, this really depends strictly on the total number of fields you have mapped in your import template.

For CG DataPorter 2.0, there are a whole series of things that can impact the time it takes to import your data including the number of import fields included.

These factors include the type of input source file being used and whether or not you are "updating" versus "adding". Updates will always take longer since CGD first builds a recordset from the target Outlook contact folder and can be very time consuming if this is a very big folder. This would be compounded if an Outlook contact folder is also being used as the Input record source. Once these folders have been converted to recordsets, then the speed would be based on the number of fields being added/updated.

<return to top>

6. Not all the records in my input data file are being imported - why are they missing?

Both Importer and DataPorter perform some key validation checks before updating the Outlook contact folder. You should check the Data Error log to see what errors were encountered with the source data or verify that these are not "Outlook Update Failures" as described in question #2.      <return to top>

7. I don't see MS SQL or MySQL as an option when selecting the input data file type?

Dataporter verifies that the appropriate driver has been installed and if it cannot be located, you are no presented with the option.

 <return to top>

8. I'm trying to import from my MySQL database on my website but it seems to take a long time?

A number of factors can be affecting that. CGD uses the standard MySQL ODBC driver (v3.51) to access the database. If your net connection is slow or otherwise affected by other things on your network, getting the initial data can take some time and is outside the control of the program. <return to top>

9. I click on some of the fields on the DataPorter template form but sometimes it won't let me do anything?

The DataPorter program has been designed to only activate elements when it the rules allow you to do something. For instance, the "Save Template" button will not activate unless at least one field has been mapped and a process option has been selected to prevent you from creating an invalid template. This is by design to avoid needless continuous validation and error messages especially when templates are distributed to remote clients. If something is not active, it generally means that you need to do something else first in the logical scheme of things. <return to top>

10. After upgrading from Importer 1.3 to DataPorter 2.0 - some of my MS Excel field names have number signs in them or the program reports that some field names are invalid on my text based files (i.e. CSV, TAB etc). This also happens on some of my user-defined fields when I use an Outlook contact folder as input data source, why?

DataPorter processes data from Excel differently then Importer. If the Microsoft Jet engine encounters invalid field names when reading an Excel spreadsheet, it replaces invalid characters with the number (#) sign before turning the data over to CGD and there is no real way to know which number signs would have been originally included versus ones that have been replaced.

 

With the release of CGD 2.0.161, any invalid character found in a text file column name will be automatically replaced with an "*" (asterisk).

 

When creating user-defined fields in Outlook, you are advised to use only standard characters for all internal field names to avoid problems in the future when exporting your data. This is even more imperative to minimize potential problems when exporting data to an XML format.

 

You should read the CGD help file for more info but in short, the 7 characters that should not be used in a field name are:

space (as the first character in the name)

.  (period)

!  (exclamation point)

` (accent)

[  (left square bracket)

]  (right square bracket)

"  (double quotation mark)  

<return to top>

11. Importer and DataPorter are rejecting date fields that are in the proper format - why?

Both programs verify every date field to ensure it is also a valid Outlook date. Any dates earlier then 04/01/1601 or greater then 08/31/4500 are considered invalid. This could easily occur when process data captured from a website where people enter 11/11/1111 to bypass the field. <return to top>

12. I run Importer or DataPorter in command line mode but nothing happens - no records are getting imported - why not?

The first thing to check is making sure that the scheduling program you are using is actually invoking the program. If the program is being invoked, then the cause of the problem is likely identified in the Program Error message log (for Importer this would found where the program was originally installed - for DataPorter, the default location would be in a subfolder where the program was installed unless the location was changed).

 

When either program runs in command line mode, they run in "silent mode" meaning that no error messages are ever displayed. However, every message generated by the program is record in the log file (unless you have opted not to have log files generated).

<return to top> 

 

13. Am encountering an <Access Violation> error or program fails to start - why?


For some reason, on SOME PCs running Windows 'XP-SP2 or Windows 2003-SP2, the Data Execution Prevention feature, prevents ContactGenie programs from starting or an immediate  Access Violation error is encountered.

If either of these cases occurs when launching the CG program you have installed, please try the following:
  1. Go to the Control Panel.
     
  2. If your Control Panel is divided into right and left panes, and you can see  "Switch to Classic View"  in the left pane, then click it to switch the Display to Classic View.
     
  3. Double-click on the SYSTEM icon (found under Performance & Maintenance if Control panel is using Category View in Windows 'XP)
     
  4. Click on the ADVANCED tab.
     
  5. Click on the SETTINGS button in the PERFORMANCE section.
     
  6. Click on the DATA EXECUTION PREVENTION tab.
     
  7. At this point the simplest thing is to choose the first option :  "Turn on DEP for essential Windows programs and services only"  then click  OK  and reboot your PC.   Alternatively continue on with Point 8 below.
     
  8. Make sure that the next screen is exactly as the screenshot below.  Click on  "Turn on DEP for all programs and services except those I select",  then click ADD and browse to the folder where the ContactGenie program you've selected has been installed:

    Examples:

               C:\Program Files\ContactGenie\CGEXP\  'CG Exporter Adv/Prem
               C:\Program Files\ContactGenie20\            'CG DataPorter
     
    and double-click on the ".EXE file" located in the respective folder.




     
  9. Once you have the applicable ContactGenie program showing as one of the programs to exclude from Data Execution Prevention, click  OK  all the way out.
     
  10. Reboot your PC and now you should be able to run.
     
Print this Page


 



 Copyright © 2002-2008 The Claxton Group | Privacy Policy | Contact Info