AppleScript Support

iSynCal 4, among the others, has a new useful feature: the ability to be AppleScript-driven for its most important functions. Most precisely, you can write your own AppleScript to start all of the synchronizations listed in a previously saved MultiSync document, either to clear all the entries of the iSynCal log file.

Please note that the iSynCal application must be placed inside the /Applications or /Users/UserName/Applications folder to allow the AppelScript engine to properly work.

In the iSynCal preferences there is an option which can be useful when running an AppleScript, the Create Untitled document on launch/activate, which avoids an empty document named Untitled to be automatically opened every time iSynCal is launched or reactivated.

You can find below an extract of the iSynCal AppleScript dictionary, listing only the commands of the iSynCal suite (as usual, the Standard suite is also enabled to allow the user to accomplish some basic application tasks like quitting the application or managing the open windows).

synchronize: Synchronize all the calendar pairs listed in the given MultiSync document, automounting and unmounting the network disks as specified

synchronize reference -- the object for the command

documentAtPath Unicode text -- The path of the MultiSync document to run

Result: boolean -- the reply for the command

clearLog: Delete all the entries in the iSynCal's synchronization Log file

clearLog reference -- the object for the command

For example, a simple script like this:

tell application "iSynCal"

synchronize documentAtPath "~/Documents/HomeCalendars.msync"

end tell

will automatically launch iSynCal if not running, open a MultiSync document named HomeCalendars which you previously saved in your Documents folder, automount the active network volumes listed in its AutoMount table, run all the synchronizations between the calendar pairs listed in its MultiSync table with the options specified there and eventually unmount the network volumes when finished.

The command

tell application "iSynCal" to clearLog

can be used instead to clear all the entries in the iSynCal synchronization log file, resulting in an empty file.