ToodledoSync Troubleshooting

Frequently asked questions and troubleshooting for the ToodledoSync Application

Please consider a donation if you find this information useful

Toodledosync Troubleshooting

Contents

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

Common Issues

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

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

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

Troubleshooting Processes

Troubleshooting Process Details:

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 ToodledoSync information page.