ToodledoSync Application Information

Application Information

This utility allows you to synchronize tasks between Outlook and the Toodledo online task manager application

The download page for this application can be found here.

You can install the application by running the *.msi file that you obtain from the download page.

General Information

Once you install the application it will create an link in your start menu. This will start the application automatically when you next log in. If you don't want to wait until the next login you can run the application manually by executing double clicking the shortcut in your Start Menu.

The first time that the application runs you will need to set up any required proxy settings.
You will then need to enter your toodledo Unique Id and password and verify the authentication.

Please note that you need to use your Toodledo Unique ID to authenticate. This is different to your normal Toodledo login name. You can find your Unique ID on the account settings page once you have logged in to the Toodledo web site.

Once you get past this stage the application will live in your task bar. You can right click the application icon to access a menu. This menu will let you either change the application options, manually run the synchronization process or exit the application.

On the options form you can change the synchronization settings, change your proxy settings or change the account details that you use to connect to Toodledo.

Synchronization Settings

The Synchronization options panel allows you to modify how the Toodledo Sync application interacts with Toodledo and Outlook

The following synchronization settings can be applied

• Enable Automatic Synchronization
• Synchronization Interval
• Enable Toodledo Updates
• Create Folders For Categories
• Add Outlook Tasks to Folders
• Enable Toodledo Deletions
• Enable Outlook Updates
• Enable Outlook Deletions
• Use Unique Outlook Instances
• Preserve Long Outlook Notes
• Ignore Existing Completed Tasks
• Use Unique Outlook Instances

Enable Automatic Synchronization

Check this box to enable the application to automatically synchronize your tasks at scheduled intervals.

Synchronization Interval

This option sets the interval in minutes between automatic synchronization attempts

Enable Toodledo Updates

Check this box to allow new Outlook task items to be created in Toodledo and to allow changes to Outlook task items to be propogated to Toodledo.

Enable Toodledo Deletions

Check this box to allow Toodledo tasks to be deleted when a corresponding Outlook task item is deleted.

Create Folders For Categories

Check this box to create Toodledo folders to match your task Categories in Outlook. This option will create a new Toodledo folder for each task Category an Outlook that has incomplete tasks assigned to it.

Please note that the new Toodledo folders will not be updated or deleted if you rename or delete the original Outlook category.

Add Outlook Tasks to Folders

Check this box to allow a new Toodledo to be placed in a Toodledo folder that has the same name as the category of the Outlook task it was created from. If a name match cannot be found then the new Toodledo task will not be assigned to a folder.

Enable Outlook Updates

Check this box to allow new Toodledo tasks to be created in Outlook and to allow changes to Toodledo tasks to be propogated to Outlook.

Enable Outlook Deletions

Check this box to allow Outlook tasks to be deleted when a corresponding Toodledo task is deleted.

Preserve Long Outlook Notes

Check this box to allow Outlook tasks longer than 2048 bytes to be preserved. Notes longer than 3072 bytes will be truncated when sent to Toodledo. This option prevents the truncated notes from being synchronized back to Outlook when a change is made to the Toodledo task.

Ignore Existing Completed Tasks

Check this option to enable to tool to skip the creation of a synchronized task where the source task is already completed. This prevents the tool from copying existing completed Outlook tasks to Toodledo (and vice versa) when it is first run.

Use Unique Outlook Instances

When this box is checked the application will start and stop an Outlook instance whenever a sync operation occurs.
When the box is unchecked the application keeps a single background instance of Outlook running permanently.

Context Settings

The Context settings tab allows you to configure how the application processes Toodledo Contexts. There are two areas that you can configure

• Context Filtering
• Default Context

Please note that you have to click the Refresh Contexts button on the Context panel to enable the Context settings.

Context Filtering

The Contexts filtering options allow you to configure the tool to only synchronize Toodledo tasks that belong to a specific set of Contexts. This allows you to synchronize only some of your Toodledo tasks to Outlook.

Check the Synchronize Selected Contexts Only box to configure the application to only create Toodledo tasks that belong to certain Contexts in Outlook. When this box is checked, only Tasks that belong to Contexts that are listed in the Selected Contexts box will be syncrhonized.

Default Context

The Default Contexts section allows you set the Context that new Toodledo tasks will be created in. Check the Set Default Context box and select ' a context from the drop down list to ensure that all new Toodledo tasks are created in that context.

Proxy Settings

The Connection options panel allows you to change the proxy settings that the application uses to communicate with Toodledo

The following proxy settings can be applied

• Use a Proxy Server
• Default Proxy Address
• Manual Proxy Address
• Default Credentials
• Manual Credentials

Use a Proxy Server

Check this box to configure the application to use a proxy server when connecting to the Toodledo web site.

Default Proxy Address

Check this radio button to use the system default settings for a proxy server. These should be the same proxy settings as the ones that are configured in the Internet Options feature of the Control Panel.

Manual Proxy Address

Check this radio button to manually enter the address of the proxy to use. The proxy address needs to be entered as a Uniform Resource Locator in the URL box.

Default Credentials

Check this radio button to use the default network credentials to authenticate with the proxy server. These should be the credentials that you use to log in to your machine.

Manual Credentials

Check this radio button to manually specify the network credentials to use when authenticating with the proxy server. The user name and password to use when authenticating to the proxy should be entered in the Username and Password text boxes. You can also optionally enter a Domain name if your network login requires it.

Diagnostics Settings

The Diagnostics options panel allows you to display trace information that can be used to diagnose problems with the operation of the application.

Recovery Settings

The Recovery options panel provides a tool that allows you to clear the application's internal synchronization database.

This is a dangerous option that will almost certainly create many duplicate tasks if used incorrectly.

Custom User Fields

You can set up custom fields in Outlook to show some Toodledo specific information for your tasks

Use the following process for Outlook 2007

• right-click on your Tasks page and select 'Show Fields'
• click 'New Field'
• type in the name of the user property to display(see below)
• Ensure the type for all properties is set to 'Text'

The following properties are currently supported

• toodledoid - shows the toodle id of the task
• tdstar - displays/sets whether or not the task is starred on the Toodledo site
• tdcontext - shows/sets the name of the tasks's toodledo category.
• tdfolder - shows the id of the tasks's toodledo folder
• tdparent - shows the task id of the tasks's parent. If this task is a parent task it will show '(parent}' next to the id
• tdtag - syncs to the Toodledo Tag field

Changing the 'tdcontext' field will change the Toodledo Context that the task syncs to. The value of this field needs to exactly match the name of a Toodledo context for this to work.

Please note that only changes to the tdcontext and tdtag fields are synched back to Toodledo. The other proprty fields are currently for information purposes only.

Recurring Tasks

The ToodledoSync application has partial support for recurring tasks.

When a recurring task in Outlook repeats, the originally created Toodledo task will be updated and vice versa for Toodledo

Plese note that a recurrence pattern should be set at one end of the sync relationship only (i.e. in Outlook or on Toodledo, but not at both ends).

Sync and Exit

The application can optionally be started with the command line option /syncandexit. This will cause the application to start, perform a single sync run then exit instead of staying resident in the taskbar

You can uninstall the application from the Add/Remove Programs feature of the Control Panel

Please consult the Toodledo Third Party Applications Forum for the latest information about this application. You can find it here.

• The application does not currently support an environment where Outlook tasks have been previously imported into Toodledo by some other process (e.g. manual import). It will treat these imported tasks as new Toodledo tasks which will duplication when synchronizing. It is recommended to backup, then delete any Outlook tasks that have previously been manually imported into Toodledo before running the tool.
• Outlook shows a security prompt when synchronizing in some environments.
  If you are using Outlook 2007 you may be able to disable this by either updating your anti-virus software or using the Trust Centre options (Tools -> Trust Center -> Programmatic Access)
  If you are using Outlook 2003 then you need to look at some third party utilities. Other users have found some success with these utilities:
  http://www.mapilab.com/outlook/security/
  http://www.contextmagic.com/express-clickyes/
  
• The Toodledo servers will block any application that performs too many operations is a given time period. In order to avoid triggering this block the application will only send updates to the server at the rate of 1 update every 20 seconds. This can cause the first synchronizatio to take quite some time
• You must manually shutdown and uninstall an old version of this application before upgrading
• The application may resync all of your Outlook tasks the first time that you sync after upgrading to a new version
• Outlook task notes over 2048 bytes long will be truncated went transmitted to Toodledo.

Go back to the Software page.