...
After installation an icon will appear on your desktop labelled 'AHSRI QuickSnap'. Double click this icon to run QuickSnap for the first time.
Troubleshooting a QuickSnap installation
The most common problems with QuickSnap installation relate to the 'SQL Server Compact' database which it uses.
When you try to open the interactive grouper, or perform a batch grouping operation you will know you have a problem with your installation if you see a screen which looks something like the following:
If you click the 'Details' button, you will see more information about the error which occurred.
There are three you may encounter, this text will appear somewhere near the top of the error text:
- The specified store provider cannot be found in the configuration, or is not valid. ---> System.ArgumentException: Unable to find the requested .Net Framework Data Provider. It may not be installed.
This error means that you have not installed the SQL Server Compact 3.5 pre-requisite. The link to download this software is provided above. System.NullReferenceException: Object reference not set to an instance of an object.
This error most likely means you have an outdated copy of the database on your computer. The best solution here would be to uninstall and then re-install QuickSnap from the install files.
If that doesn't work, it may be more complicated and you are welcome to contact AHSRI for some help.System.Data.EntityException: The underlying provider failed on Open. ---> System.Data.SqlServerCe.SqlCeException: The database file cannot be found. Check the path to the database. [ Data Source = C:\Users\{your_userid}\AppData\Roaming\SNAP\snap_compact.sdf ]
This error occurs when QuickSnap was installed using a different user profile. There are two solutions for this problem:1 - install QuickSnap on this user's profile
2 - copy the file 'snap_compact.sdf' from the user profile where QuickSnap was originally installed, into the corresponding folder on this user's profile.
(That folder is C:\Users\{user_id}\AppData\Roaming\SNAP)
These are the three known errors which occur with QuickSnap installations, and hopefully the resolutions listed will solve them for you.