Toodledosync Troubleshooting
Common Issues:
-
I am getting 'authentication failed' on the first run screen
details
-
I am getting a 'could intialize Outlook Interface' error
details
-
I am receiving a security prompt whenever ToodledoSync tries to access Outlook
details
-
I have just installed Toodledosync. Only some of my tasks are being copied to Toodledo
details
-
I am getting duplicate tasks
details
-
Tasks are being synced from Toodledo to Outlook, but are not being synced from Outlook to Toodledo
details
-
Tasks are being synced from Outlook to Toodledo, but are not being synced from Toodledo to Outlook
details
-
My flagged emails are not syncing
details
-
I am getting a 'Key not valid for use in specified state' error
details
-
I am getting an XML error when trying to sync
details
-
I am getting a 'Your server administrator has limited the number of items you can open simultaneously' error
details
-
I have changed my Toodledo account and things have stopped working
details
-
My problem is not listed here.
details
Troubleshooting Processes:
-
How to generate a diagnostics trace
details
-
How to upgrade the application
details
-
How to clear Folder and Context filtering
details
-
How to reset the synchronization database
details
-
How to delete user settings
details
-
How to start from scratch
details
Authentication Failures
The most likely reasons for being unable to get past the initial authentication screen are:
- confusing the Toodledo Unique id with your Toodledo login id. They are different - the Toodledo unique id is found on the account settings panel once you log in to the web site.
- inadvertently cutting and pasting spaces or additional characters when copying the Unique Id from the web site
- If there is a proxy server on your network and the proxy settings are not configured correctly. Try checking your web brower configuration
- you may have a software firewall, VPN, anti-spyware or other security product that is blocking Toodledosync from accessing the internet. Try temporarily disabling these to see if that makes a difference
Could not Initialize Outlook Interface error
This error is raised when ToodledoSync is unable to establish communcations with Outlook. Some common causes of this error are:
- the Microsoft Primary Interop Assemblies for your version of Office have not been installed on your PC. These can be downloaded and installed from Microsoft
- your installation of Microsoft Office may be corrupt or incomplete. Try a repair installation
- you may have a software firewall, VPN, anti-spyware or other security product that is blocking Toodledosync from accessing Outlook. Try temporarily disabling these to see if that makes a difference
- if you are running a 32-bit version of Office 2010 on a 64-bit OS you might need to repair your PIA bindings. Try this process
Security Prompt
For some PC configurations, Outlook may display a security prompt whenever ToodledoSync attempts to synchronize tasks. This is a design feature of Outlook and does not normally represent a security risk.
Toodledosync Flood Limit
The Toodledo web site API implements flood protection algortihm that restricts the number of updates that a client application such as ToodledoSync can send at one time. This restricts the Toodledosync application to sending 25 updates to the Toodledo server per sync run.
If you have more than 25 tasks then it can take some time for them all to be copied to the Toodledo server.
Our advice is to leave the application running for several hours after it is first installed
Similarly, if you make changes to more than 25 tasks in Outlook it can take several sync runs for all of these changes to be persisted to the Toodledo web site.
Duplicate tasks
Duplicate tasks are usually caused by errors occurring in the synchronization process. If you are consistently getting task duplications then the best way to resolve these is to generate a diagnostics trace (see Generating a diagnostics trace) and email it to us.
Tasks are not being synced from Outlook to Toodledo
This is usually caused by an error occurring in the sync process. Use the Generating a diagnostics trace process given below to view any errors that may be occurring.
One of the most common causes of this error is having a large number of tasks in your root Tasks folder in Outlook. There is a resource leak in the Outlook API that can cause issues for client applications that try to read more than 250 or so tasks. This includes tasks that have been marked as completed
You can eliminate this as a possible cause of the issue by
- Deleting or archiving your completed tasks
- Moving any tasks that you do not want to sync to Toodledo to a tasks sub folder
Tasks are not being synced from Toodledo to Outlook
Some common causes of this issue are
- Your time zone may not be correctly specified on Toodledo. The timezone settings that are configured for your account on the Toodledo web site need to match the timezone settings on your PC
- You may have inadvertently enabled a Context or Folder filter. Use the Clearing context filters process given below to reset these settings
Todo List Items are not supported
The ToodledoSync application is only able to sync items in the Tasks view in Outlook. Todo List items such as flagged emails are not supported and will not be synced.
Although Todo List items looks very similar to Tasks, they are programatically very different objects and are prohibitively difficult to support.
The only way to sync a Todo List item via Toodledo is to drag it to your Tasks folder to turn it into a Task.
Key not valid for use in specified state
This error indicates a corruption of the user settings file for the application. Use the Deleting user settings process given below to reset this file.
Error during synchronization: There is an error in XML document
This error can occur if a non-ascii character gets added into a Toodledo task. One possible way to resolve this is to uncheck the 'enable extended characters' checkbox on the Options page. Warning, this will remove all extended characters for non-English language users.
Another possible way to resolve this is to rebuild your Toodledo tasks form your Outlook tasks using the Resetting the syncronization database process given below
'Your server administrator has limited the number of items you can open simultaneously' error
This issue is caused by the Toodledosync client exceeding the number of maximum items that the Outlook API allows simulataneous access to. The easiest way to fix this is to reduce the total number of tasks in your root tasks folder to below 255.
Please note that this includes completed tasks and it is recommended that you delete or archive your completed tasks if you are receiving this error.
If you have more than 255 tasks , you can move any tasks that you do not wish to sync to Toodledo to a tasks sub folder
Changing Toodledo Accounts
If you change Toodledo accounts it will be necessary to enter follow this process to reset the ToodledoSync application
General Troubleshooting
If you are still having problems
- Ensure that your timezone settings are correcly configured on the Toodledo web site
- Use the Generating a diagnostics trace process to generate a diagnostics trace
- Mail the trace to our development team with a description of the problem that you are experiencing
Troubleshooting Processes
Troubleshooting Process Details:
Repairing the PIA bindings for 32-bit Office 2010 running on a 64-bit Operating System
This process details how to fix the PIA interop bindings for a 32-bit installation of Office 2010 on a 64-bit installation of Windows Vista or Windows 7
- Back up this file if it exists on your system C:\Program Files\Microsoft Office\Office14\MSOUTL.OLB
- Copy C:\Program Files (x86)\Microsoft Office\Office14\MSOUTL.OLB to C:\Program Files\Microsoft Office\Office14\MSOUTL.OLB
Generating a diagnostics trace
This process details how to generate a diagnostics trace in the application
- RIght click on the ToodledoSync icon in your system tray and select 'Options'. The application Options Page should appear
- Navigate to the 'Diagnostics' tab
- Check the 'show trace' checkbox
- Run a Manual Sync from the File menu
- Copy all of the green text that appears
Upgrading the application
This process details how to upgrade to a newer version of the application
- Shut down and uninstall the previous version of the application
- Install the latest copy of the application
Clearing context filters
This process details how to ensure that context and folder filtering is disabled
- RIght click on the ToodledoSync icon in your system tray and select 'Options'. The application Options Page should appear
- Navigate to the Contexts tab
- Click the 'Refresh Contexts and enable' button. The rest of the panel should now be enabled
- Ensure that the Synchronize Selected Contexts only' checkbox is not checked
- Navigate to the Folder tab
- Click the 'Refresh Folders and enable' button. The rest of the panel should now be enabled
- Ensure that the Synchronize Selected Folders only' checkbox is not checked
Resetting the syncronization database
This process details how to reset the ToodledoSync application's local synchronization database
Warning: You are strongly advised to back up your Toodledo and Outlook tasks before performing this process
- Right click on the ToodledoSync icon in your system tray and select 'Options'. The application Options Page should appear
- Navigate to the Recovery tab
- Check the 'Enable Recovery Options' check box
- Click the 'Reset Synchronization Database' button
- Read the warning text and check the acknowledgement check box
- Click the Proceed button if you wish to reset your synchronization records
Deleting user settings
Toodledosync stores user configuration settings in a .NET isolated storage application settings file. This file is not removed after an uninstall and needs to be manually deleted if the need arises. The process to delete this file is as follows:
-
Locate the following folder:
(Windows XP) C:\Documents and Settings\[your username]\Local Settings\Application Data\Chromatic_Dragon
(Windows Vista) C:\Users\[your username]\AppData\Local\Chromatic_Dragon
-
Delete all files and subfolders in this folder and reboot
Starting from scratch
This process details how to completely start from scratch with the application
Warning: You are strongly advised to back up your Toodledo and Outlook tasks before performing this process
- Follow the Resetting the syncronization database process to reset your synchronization database
- Follow the Deleting user settings process to clear all user settings
- Follow the Upgrading the application process to upgrade to the latest version of the software
- Log on to Toodledo and use the Toodledo account settings to delete all tasks in your Toodledo account
- Start Toodledsync and reconfigure your account settings
- Wait for your Toodledo tasks to be rebuilt from your Outlook tasks. This may take some time
Go back to the Home page.