This profile property enables you to run a Visual Basic script (.vbs) before and after running a profile.

Upon Profile Startup/Completion

The file path of the specified VB script is shown in the box. Red highlighting indicates that the VB script couldn't be found by AllSync. The following buttons are available:

• New – Create new VB script
• Select – Select VB script
• Edit – Edit VB script
• Remove – Remove VB script
• Test – Test VB script

Run script for:

This option enables you to specify the operation during which the script is to be started. The following options are available:

• Copy Operation
• Copy Preview
• Process Copy Preview
• Filter Wizard
• Command Line

• Visual Basic scripts can't be used with AllSync unless Microsoft Windows Scripting Host is installed on your computer. You can check this by running the sample script Test.vbs.
• The properties and methods of the WScript object have to be called without "WScript." Example: Instead of WScript.CreateObject only CreateObject has to be used.
• Some properties and methods of the WScript object, e.g. Sleep or Echo, cannot be used in the script or possess limited functionality. For more information, consult the Microsoft website.

You also have the option of directly starting your scripts that use the WScript object using the External/Programs profile property (e.g.: "wscript.exe" test.vbs) and thus circumvent any restrictions.

The activated source and destination folder can be used by inserting the following placeholders in the script:

• [Source1] is replaced by the first source folder activated in the source folder list, [Source2] by the second one, etc.
• [Destination1] is replaced by the first destination folder activated in the destination folder list, [Destination2] by the second one, etc.
• [Profil] is replaced by the profile name.

Automatically abort script after:

This option enables you to specify that the script be automatically aborted after a certain number of seconds. When activating the Script may use GUI language elements (e.g. MsgBox) option, a dialog containing a warning pops up when the time has elapsed. The user has to acknowledge the warning.

Script may use GUI language elements (e.g. MsgBox)

An error is generated when this option is deactivated and GUI language elements have been used in the script, e.g. the MsgBox command. Deactivate this option when the profile is run automatically via AllSync Scheduler so that no dialog pops up and has to be acknowledged by the user.

Abort profile ....

This option causes the profile to be terminated if an error occurs in the script or the script cannot be run for launching the profile. No error message will be generated if the script returns the special error code -99. See sample script 'CheckDestinationDrive.vbs'.

The sample scripts supplied with AllSync are located in the Scripts subdirectory of the AllSync application folder. The sample scripts are continuously updated and adapted by us as needed. When making changes to the sample scripts, make sure to save them under a different name otherwise they will be overwritten and your changes lost the next time you update AllSync.

The following scripts are currently available:

Test.vbs

This script enables you to test the functionality of Microsoft Windows Scripting on your system and get an impression of the possibilities offered by Visual Basic Scripting.

Outlook.vbs

This script enables you to shut down Microsoft Outlook.

OutlookExpress.vbs

This script enables you to shut down Microsoft Outlook Express.

Run.vbs

This script enables you to run any program by inserting the Prg variable in the program path.

KillTask.vbs

This script enables you to end a task. Call Windows Task Manager to find out the requisite taskname.

ScreensaverOff.vbs \ ScreensaverOn.vbs

These two scripts enable you to respectively deactivate and reactivate your screensaver.

CheckDestinationFolder.vbs

This script checking the first destination folder to see if it exists. The script returns the error code -99 if the folder is not accessible. In conjunction with the option "Abort profile ..." the profile will be aborted without any error message. The profile will be aborted and generate a error message if the script returns a other error code than -99.

CheckDestinationFolderWithMessageBox.vbs

This script checking the first destination folder to see if it exists. A info dialog pop up if the folder is not accessible. Now the user can retry the folder check or cancel the profile.

ExportRegistry.vbs

This script enables you to export a registry key to a file at the destination folder.

CloseApp.vbs

This script enables you to close other applications.

• Microsoft Windows Script
• VBScript User's Guide
• VBScript Forum
• VBScript Newsgroup
• DevGuru VBScript Quick Reference guide