VERSION 1.1.0 - QUICK REFERENCE
Introduction 
Script Language Reference 
Events Triggering Scripts Reference
 
CyberSecretary
Built-In Command Reference
 
Command Parameters 

Outlook Folder Commands 
StartOutlook 
CloseOutlook 
GoHome 

StartFolder 
ShowFolder 

General Item Commands 
Send 
AttachItem 
LinkItem 
DisplayItem 
CloseItem 
 

CopyItem 
MoveItem 
DeleteItem 
PrintItem 
PrintAttachments 
RemoveAttachments 
CopyAttachments 

Mail Message 
Commands 
ReadMessage 
ReplyToSender 
ReplyToAll 
Flag 
FollowUp 
SaveFile 
FileMessage 
Diary 
 

Outlook Task Commands 
CreateTask 
GetNextTask 

Appointment Commands 
ReadSchedule 
SetAppointmentReminders 
CancelReminder 
MailCalendar 

Contact Commands 
CreateDocument 
ComposeMessage DisplayMap 
PhoneMessage 
ResolveCall

Journal Commands 
MakeJournal 
FindJournal 
GetJournal 
ShowJournalItem 

PostExpense 

Miscellaneous 
BranchToItemType 
SendKeys 
ProgramGroup 
SearchInternet 
GetStockPrice 
GetUpdate 
PickScript 
Game

CyberSecretary includes the following built-in commands which can be called to perform useful tasks with Microsoft Outlook data, or with the Internet.

Command Parameters

Many of the built-in commands require either one or two parameters.  The types of parameters that are valid for a particular command is included with the description of each command.  In some cases, the parameter may be the name of a file, file folder, Outlook folder, or URL.  In addition, the following parameters are used to specify particular Outlook items, Outlook folders, or other items of information.
 
Inbox 
Outbox 
SentMail 
Calendar 
Appointments 
Tasks 
Diary 
Drafts 
Notes 
Journal 
Trash 
OutlookToday 
 

CurrentItem 
LastItem 
LastReceived 
LastQueued 
LastSent 
LastJournal 
LastMessage 
LastAppointment 
LastContact 
LastTask 
LastNote 
NewestContact 
NewestTask 
NewestAppointment 
NewestJournal 
NewestNote 
LastDeleted 
OriginalMessage 
LastFile 
Clipboard 
UserInput 
ListSelection

The default Outlook Inbox folder. 
The default Outlook Outbox folder. 
The default Outlook Sent Mail folder. 
The default Outlook Calendar folder. 
The default Outlook Calendar folder. 
The default Outlook Tasks folder. 
The Outlook Diary folder (created by CyberSecretary). 
The default Outlook Drafts folder. 
The default Outlook Notes folder. 
The default Outlook Journal folder. 
The default Outlook Trash (deleted items) folder. 
The Outlook Today page. 
     (Note: Other Outlook folders can be specified by stating the full name of the folder, 
     preceded by the name of the parent folder and a period, e.g. Saved Messages.June.) 
The currently open Outlook item. 
The last Outlook item referenced by a script. 
The most recently received message in the Inbox. 
The most recently queued message in the Outbox. 
The most recently sent message in the Sent Mail folder. 
The last journal item referenced by a script. 
The last mail message referenced by a script. 
The last appointment item referenced by a script. 
The last contact item referenced by a script. 
The last task item referenced by a script. 
The last note item referenced by a script. 
The most recently created contact. 
The most recently created task. 
The most recently created appointment. 
The most recently created journal item. 
The most recently created note. 
The most recently deleted item. 
The previous message (e.g. when using the Reply, ReplyToAll, Forward commands). 
The last specified file (e.g. when using the SaveAsFile command). 
The contents of the Windows clipboard. 
The user input (from the CyberSecretary dialog box). 
The user list selection (from the CyberSecretary dialog box).
General Outlook Folder Commands

The following commands are used to control the Microsoft Outlook application, including starting and shutting down Outlook and displaying particular folders.

StartOutlook

This command launches Microsoft Outlook. You may want to include this command in the Startup script. Or, you can control which Outlook folder is displayed on startup (Today, Inbox, Calendar, Contacts, Tasks, etc.) by using the ShowFolder or StartFolder commands instead.

CloseOutlook

This command closes Microsoft Outlook. You may want to include this command in the ShutDown script (to automatically shut down CyberSecretary when you close Outlook), or in a script that will be given as a choice when you right-click on the CyberSecretary tray icon (to close down both Outlook and CyberSecretary).

GoHome

This command closes CyberSecretary. You may want to include this command in the ShutDown script, after the CloseOutlook command.

ShowFolder Folder

This command activates Microsoft Outlook and displays the specified folder.

You may specify any of the default Outlook folders using the following names, even if the user has renamed the folder:
Inbox, Outbox, SentMail, Drafts (Outlook 98), Today (Outlook 98), Calendar, Contacts, Tasks, Journal, Notes or Trash.  You may also specify Diary or Expenses, folders created by CyberSecretary.

You may specify any other folder by giving its full name, preceded by its parent folder name and a period.  For example, Saved Messages.June will display the folder June, which is a subfolder of Saved Messages.  The parent folder and the period may be omitted if the folder is a top-level subfolder of the Outlook Today folder.

Also, you may specify any file system folder.  File system folders will be displayed in Windows Explorer rather than Outlook.

StartFolder Folder

This command is similar to ShowFolder except that the folder is displayed in a separate Outlook explorer.  To save time in switching from folder to folder, you may open your Inbox, Calendar, Contacts and Tasks in separate Outlook explorers using the following command:

General Outlook Item Commands

The following commands are used to work with particular Outlook items, including mail messages, appointments, contact items, task items, journal items, notes and post items.

Send Source to Target
 
This command is a very powerful command which can be used to work with Outlook items of all types, files, file folders, URL's and Outlook folders.  For example, you can use the Send command to do the following:

The action taken depends on the context in which the command is used. The following table shows how different combinations of source items and target items or folders are handled.

Note that if you specify ? as the target, the target will be treated as a mail recipient to be specified by the user.  Thus, you can use the following script fragment to forward a mail message to a recipient entered by the user at the time the message is forwarded:

 
Target è
Source ê
MAPI Folder File System Folder Mail Recipient
Text File (*.txt) Creates a post item with the root of the file name as the subject, with the text of the file as the body of the post item. Copies the file to the specified folder (if a folder is specified) or file (if a file name is specified). Creates a mail message with the root of the file name as the subject, and the text of the file as the body.
HTML File Creates a post item with the root of the file name as the subject, with the HTML body of the file as the body of the post item (preserves HTML formatting). Copies the file to the specified folder (if a folder is specified) or file (if a file name is specified). Creates a mail message with the root of the file name as the subject, and the HTML text of the file as the body (preserves HTML formatting but does not include embedded graphics).
Binary File Creates a post item with the root of the file name as the subject, with the file as an attachment. Copies the file to the specified folder (if a folder is specified) or file (if a file name is specified). Creates a mail message with the root of the file name as the subject, and with the file as an attachment.
Mail Message Moves the mail message to the folder, if the folder’s default message class is mail message. Otherwise, creates an item of the folder's default type, and attaches the mail message to the item.  Saves the mail message to the folder as a .MSG file. Forwards the mail message to the recipient(s). If the recipient names can be resolved, sends the message without prompting; otherwise, displays the message.
Post Item Moves the post item to the folder, if the folder’s default message class is post item.  Otherwise, creates an item of the folder's default type, and attaches the post item to the item. Saves the post item to the folder as a .MSG file. Forwards the post item to the recipient(s). If the recipient names can be resolved, sends the message without prompting; otherwise, displays the message.
Appointment Item Moves the appointment to the folder, if the folder’s default message class is appointment.  Otherwise, creates an item of the folder's default type, and links the appointment to the item. Saves the appointment item to the folder as an Outlook item (.MSG file). Creates a mail message with a Vcal item as an attachment. If the recipient names can be resolved, sends the message without prompting; otherwise, displays the message.
Contact Item Moves the contact to the folder, if the folder’s default message class is contact.  Otherwise, creates an item of the folder's default type, and links the contact to the item. Saves the contact item to the folder as an Outlook item (.MSG file). Creates a mail message with a Vcard as an attachment. If the recipient names can be resolved, sends the message without prompting; otherwise, displays the message.
Task Item Moves the task item to the folder, if the folder’s default message class is task item.  Otherwise, creates an item of the folder's default type, and links the task item to the item. Saves the task item to the folder as an Outlook item (.MSG file) Assigns the task to the recipient. Displays the assigned task so due date, etc. can be set.
Journal Item Moves the journal item to the folder, if the folder’s default message class is journal item. Otherwise, creates an item of the folder's default type, and links the journal item to the item. Saves the journal item to the folder as an Outlook item (.MSG file). Forwards the journal item to the mail recipient.
Note Item Moves the note item to the folder, if the folder’s default message class is note item. Otherwise, creates an item of the folder's default type, and attaches the note to the item..  Saves the note to the folder as an Outlook item (.MSG file). Forwards the note item to the mail recipient.
AttachItem SourceItem to TargetItem

This command attaches (embeds) a source item (Outlook item or file) to the target item (Outlook item).  For example, the following command will create a Journal item for a mail message, and attach (embed) the mail message in the Journal item:

LinkItem SourceItem to TargetItem

This command links (creates a shortcut to) a source item (Outlook item or file) to the target item (Outlook item).  This saves space in the Outlook personal folders file (since a link is smaller than the file itself).  However, the linked item cannot be moved to another folder without breaking the link; and the link will not work if the Outlook file is accessed from another computer, unless the linked file is accessible at the same path.  The following command will save a mail message as a file, and then link that item to a Journal entry:

DisplayItem Item

This command causes the specified item to be opened in its own inspector.  For example, the following command, if placed in the NewMail script, will cause a received mail message to be automatically opened:

CloseItem Item

This command closes the specified item.  This is useful in a script which responds to the opening of a particular Outlook item, to finish the script by closing that item.  For example, if you wanted a phone log entry to be automatically created when a contact item is opened, you could include the following command in the OpenContact script:

CopyItem SourceItem to TargetFolder

This command copies the specified item (source) to the specified folder (target). The source must be a valid Outlook item. The target must be a valid Outlook or file system folder.  If the target is an Outlook folder, the item will be copied to the specified folder.  Note that this will work only if the Outlook item is of the proper type for the folder; e.g. a mail message cannot be copied to the Contacts folder.  (See the Send command for a way to create an item in the target folder and attach the source item.)  If the target is a file system folder, the item will be saved as a mail message file in the target folder.

MoveItem SourceItem to TargetFolder

This command moves the specified item (source) to the specified folder (target). The source must be a valid Outlook item. The target must be a valid Outlook or file system folder.  If the target is an Outlook folder, the item will be moved to the specified folder.  Note that this will work only if the Outlook item is of the proper type for the folder; e.g. a mail message cannot be moved to the Contacts folder.  (See the Send command for a way to create an item in the target folder and attach the source item.)  If the target is a file system folder, the item will be saved as a mail message file in the target folder.
 
DeleteItem Item

This command deletes the specified item, which may be an Outlook item or a file. Please note that this command does not prompt the user, so if prompting is desired, that must be included in the script.

PrintItem Item

This command prints the specified item, which may be an Outlook item or a file. This command does not prompt the user, so if you wish to prompt the user before printing, this will need to be built into the script.

PrintAttachments Item

This command prints all files attached to the specified item, using their associated applications. Please note that this command does not prompt the user, so if prompting is desired, that must be included in the script.

RemoveAttachments Item

This command removes all attachments from the specified item. Please note that this command does not prompt the user, so if prompting is desired, that must be included in the script.

CopyAttachments Source to Target

This command copies all attachments from one item to another.  It is most useful in connection with the ReplyToSender and ReplyToAll commands, if it is desired to include the attachment with the response (Outlook by default removes attachments when replying to a message).  This is useful if you plan to edit the attachment and want to return the edited attachment to the sender; or if you want your filed copy of the message to include the attachment.

For example, the following command will reply to the sender and all other recipients of the earlier message, including any attachments that were in the original message, and then will delete the original message:

Outlook Mail Message Commands

The following commands are designed to perform useful functions related to mail messages, including reading incoming messages, filing sent messages, and creating replies and follow-ups.

ReadMessage Message

This command takes the specified message (usually the most recently received mail message in the inbox), announces the name of the sender and the subject, and, if the user wishes, reads the first 50 words or so, giving the user the option to open the message. For example, use the following command in the NewMail.CYB script to automatically read incoming mail messages as they are received:

ReplyToSender Message

Creates a reply message addressed only to the sender of the specified message.  For example, you could include the following command in the [Inbox] section of LeftClick.CYB to create a reply message addressed to the sender of the currently open message, and to delete the original message:

ReplyToAll Message

Creates a reply message addressed to the sender and all other recipients of the specified message.  For example, use the following command in the [Inbox] section of LeftClick.CYB to create a reply message addressed to all recipients of the currently open message, and to delete the original message:

Flag Message to Status

Sets the flag status for the selected mail message.  The following choices are valid for the Status parameter:

If the Status refers to a date, you may optionally specify a time, as follows: Note that the time should be specified in 24 hour format (0:00 to 23:59).

Also, if the Status parameter is followed by an exclamation point (!), the importance will be set to high:

This command is useful in a script for working with mail messages (OpenInbox.cyb, NewMail.cyb or the [Inbox] section of LeftClick.cyb) as a simple way to set reminders for incoming mail messages.  For example, look at the following script section: FollowUp Message

Creates a new message (follow-up), which is a forwarded copy of the original message, addressed to the original recipients of the specified item. This is useful when working with items in the Diary folder.  For example, use the following command in the [Diary] section of LeftClick.CYB to create a follow-up message, if you left-click on the CyberSecretary tray icon while a message in the Diary folder is opened:

SaveFile Message

This command saves the specified message as a file. Files are saved in chronological folders branching off the folder specified as SaveFilePath under HKEY_CURRENT_USER\ Software\VB and VBA Program Settings\CyberSecretary\Outlook in the Registry. This is, upon installation, by default set to your personal documents folder. For example, if SaveFilePath = c:\My Documents, then a mail message sent on September 1, 1998 will be saved in c:\My Documents\1998\September.

The file format is specified by SaveFileFormat under the same Registry key. Choices are RTF (rich text - default), DOC (MS Word), MSG (mail message) and TXT (text). The file name will include the subject of the message, the first recipient’s last name, and the date sent; you will be prompted to confirm the file name.

If the message contains attachments, you will be prompted whether the attachments should be deleted before the message is saved.  If you answer No (i.e. attachments should be saved), and have specified RTF as the default save format, the file will instead be saved as a Word document (DOC), in order to save space (RTF files with embedded attachments are much larger than DOC files with embedded attachments).

This command is useful in scripts that process messages in the Sent Items folder; e.g. OpenSent.CYB (automatically processes items in the Sent Mail folder when those items are opened), SentMail.CYB (automatically processes mail messages when they are sent and added to this folder), and LeftClick.CYB (when placed in the [Sent Items] section, processes items when you left-click on the tray icon).

FileMessage Message

Moves the specified mail message in a chronological mail folder. E.g., a mail message sent in July 1998 will be moved to mail folder Personal Folders/1998/July.

Diary Message to Days

Your CyberSecretary can automatically help you with follow-ups to sent mail messages using this command and the Diary folder.  This command moves the specified item to an Outlook folder called Diary (which is created if it does not exist) and sets the Diary date for the specified number of days in the future.  This is one of the options presented by the OpenSent.CYB script, SentMail.CYB script, or by the LeftClick.CYB script if you left-click on your CyberSecretary's tray icon while a sent mail message is open.

You will probably want to add the "Diary" field to the Outlook view of this folder. Right-click on the gray fields header and select Field Chooser. Look in User Defined Fields in Folder, and drag to the gray fields header.

You will probably also want to create a view for this folder that is filtered to only show items where the date in the "Diary" column has been reached.

You will probably also want the Diary folder to be automatically displayed daily or weekly, so that you can follow up on your reminders.  To do this, create a scheduled script containing the ShowFolder Diary command.

Note: By default, if you left-click on the CyberSecretary tray icon while a message in this folder is open, a follow-up message is created.  See the FollowUp command for details.

Outlook Task-Related Commands

The following commands perform actions related to creating and accessing items in the Outlook task list.

CreateTask Message

This command creates a task from the specified item, e.g. CreateTask CurrentItem or CreateTask LastReceived. The item (e.g. a new mail message) is attached to the task. You are given the opportunity to choose a priority and due date for the task. This command is, by default, executed when you left-click on the tray icon while an Inbox message is open.

GetNextTask

This command displays a list of the most urgent uncompleted tasks, as well as options to view the Inbox or phone messages. By default, this command is executed when closing a task.

Outlook Calendar-Related Commands

The following commands perform useful functions related to the Outlook calendar, including providing reminders of upcoming appointments, and mailing your calendar to your human assistant.

ReadSchedule Today|Tomorrow|Date

This command causes your CyberSecretary to read your appointments for the specified date. You may specify Today, Tomorrow, or any calendar date.

Include the following command in StartUp.CYB to have your CyberSecretary read today's appointments at the start of the day:

Include the following command in ShutDown.CYB to have your CyberSecretary remind you of tomorrow's appointments at the end of the day: SetAppointmentReminders

This command scans all of today’s appointments whose starting times have not passed, and places reminders in the Registry. Those reminders are scanned throughout the day. If the script Reminder.cyb is located in the Outlook scripts folder, then a reminder is displayed at the appropriate time.

CancelReminder ItemID

This command is, by default, placed in the Reminder.cyb script.  This command cancels the regular Outlook reminder, after your CyberSecretary reminds you of the appointment.

MailCalendar Days

This command mails the user’s calendar for the number of days specified to the person specified by the CalendarRecipient value in the HKEY_CURRENT_USER\Software\VB and VBA Program Settings\CyberSecretary\Outlook Registry key. If that key doesn't exist (e.g. the first time this command is run), the user will be prompted for that information.

For example, use the command MailCalendar 90 to mail the calendar for the next 90 days.

Outlook Contact-Related Commands

The following commands perform useful functions with Outlook contact items, including creating merged documents, getting street maps via the Internet, and maintaining a list of phone messages.  Also, you can create phone log entries from Outlook contacts using the MakeJournal command.
 
CreateDocument Template

With this command, your CyberSecretary can create customized documents, such as letters preaddressed to your selected contact.

The CreateDocument command creates a document using the specified template which must be located in the Templates subfolder of the CyberSecretary folder. The template may be a Microsoft Word template (.DOT), a Microsoft Outlook template (.OFT), an HTML file or a text file.

If the template is a text file, a new mail message is created and addressed to the person whose name appears as the first line of the text file. The balance of the text file becomes the message body. The file name of the template (minus the .TXT extension) becomes the subject of the message.

If the template is an HTML file, a new HTML mail message is created. The subject of the mail message is taken from the Title tag of the HTML document. The recipient(s) of the mail message is taken from a Meta tag, Meta Recipient. (This function requires Outlook 98.)

The Word templates supplied with CyberSecretary contain macros which automatically extract name, address and phone number information from the currently open contact item, if any.

ComposeMessage Contact

This command creates a new Outlook mail message.  If a contact item is specified, the Outlook mail message is addressed to the specified contact.  This is useful to add a choice for creating a mail message to the OpenContact script, or to the [Contact] section of the LeftClick script.

DisplayMap Contact

This command uses the Internet and MapBlast™ maps to obtain a street map and driving directions for the specified contact item. The URL for the Internet mapping service is stored in the Registry as the GetMap value under the key HKEY_CURRENT_USER\Software\VB and VBA Program Settings\CyberSecretary\General.  Requires an Internet connection.

PhoneMessage Contact

This command takes the currently selected contact item, and displays it in a familiar phone message pad. With this command, your CyberSecretary can offer to take down phone messages and manage a call list whenever you open a contact item (OpenContact.CYB), or when you left-click on her tray icon while a contact is opened (the [Contact] section of LeftClick.CYB).

You will probably want to define a view in the Contacts folder to display all messages. To do this, right click on the gray bar at the top of the columns and select Field Chooser. Select Frequently Used Fields and drag Categories onto the gray bar. Then, filter the view to include only items for which Categories = Call or Categories = Left Msg. (See Microsoft Outlook documentation for more information.)

Please note: if the contact item has a category assigned, that category is temporarily stored in the YomiFirstName field, a seldom-used field, and is restored when the call is marked Resolved.

Attention PalmPilot users!  Since the Categories field is standardly mapped to the Pilot's Category field when synchronizing using products such as Desktop To Go, your call list will be displayed automatically on your Pilot, simply by selecting the Call category on your Pilot after a synchronization.

ResolveCall Contact

This command clears any phone message stored with the specified contact item.  It has the same effect as the PhoneMessage command followed by selection of the Resolved option.  This command clears the Outlook contact's body field, and resets the Category to whatever is found in the YomiFirstName field.  It is a quick way to cancel a phone message taken using the PhoneMessage command.

Outlook Journal Commands

The following commands are designed to perform tasks related to Journal items.
 
MakeJournal Item

Creates a new Journal item from the specified Outlook item or file. If this command is called by a script section that obtains input from the user in the user input box, this text is placed in the body of the journal item. If this command is called by a script section that obtains a selection from the user in the drop-down list box, the selected value is used as the category for the Journal item. Note: the source item is not attached to or linked to the Journal item; you must use the LinkItem or AttachItem command to do so.

If the Journal item is created from a contact item, a phone log entry is created and the Journal item is automatically displayed and the timer is started. In other cases, Journal information is intelligently extracted from the specified item.

FindJournal Item

Finds an existing Journal item matching the specified source item or file. The search is limited to Journal items added within the last seven days. If no matching Journal item is found, nothing is returned.

If this command is called by a script section that obtains input from the user in the user input box, this text is placed in the body of the journal item. If this command is called by a script section that obtains a selection from the user in the drop-down list box, the selected value is used as the category for the Journal item. Note: the source item is not attached to or linked to the Journal item; you must use the LinkItem or AttachItem command to do so.

GetJournal Item

This command tries to find an existing Journal item matching the specified source item or file. The search is limited to Journal items added within the last seven days. If no matching Journal item is found, then one is created.

If this command is called by a script section that obtains input from the user in the user input box, this text is placed in the body of the journal item. If this command is called by a script section that obtains a selection from the user in the drop-down list box, the selected value is used as the category for the Journal item. Note: the source item is not attached to or linked to the Journal item; you must use the LinkItem or AttachItem command to do so.

If the Journal item is created from a contact item, a phone log entry is created; the Journal item is automatically displayed and the timer is started. In other cases, if a new Journal item is created, Journal information is intelligently extracted from the specified item.

ShowJournalItem StartTimer

Shows the last created (or found) Journal item. If this command is followed by the StartTimer parameter, the timer for the Journal item is started.

PostExpense

This command is used to keep records of reimbursable expenses and to prepare an expense report. The first time this command is run, it creates an Outlook folder called "Expenses" as well as a new type of Journal entry called "Expense."  Your CyberSecretary will then ask you for the date, type and amount of the expense, and offer to add an expense item. You will also be given an opportunity to create a mail message containing an expense report, listing and totaling all previously unreported expenses.

Miscellaneous Commands

The following commands perform various functions not otherwise classified.  
 
BranchToItemType Item

This command is used to cause a script to perform different actions depending on what type of Outlook item is selected.  This command checks the item type of the specified item, and branches to the section of the script determined by the item type. This is very useful in a script that will respond to the tray icon (LeftClick.cyb) by taking appropriate actions depending on what type of Outlook item is open. For example, you could have your CyberSecretary create a phone log entry if a contact item is open; prepare a follow-up message if a message in the Diary folder is open; or create a Journal entry if a message in the Sent Mail folder is open.

Valid choices are:
 
ReplyMail 
NewMail 
Inbox, Outbox, etc. 
NewAppointment 
FutureAppointment 
PastAppointment 
NewContact 
Contact 
NewTask 
Task 
NewJournal 
Journal 
Note 
None
Item is a new message replying to (or forwarding) an existing message. 
Item is a new message. 
Item is a message in the specified folder (any folder specified by name). 
Item is a newly created appointment (not yet saved). 
Item is an existing appointment whose end time has not passed. 
Item is an existing appointment whose end time has passed. 
Item is a newly created contact (not yet saved). 
Item is an existing contact. 
Item is a newly created task (not yet saved). 
Item is an existing task. 
Item is a newly created Journal entry (not yet saved). 
Item is an existing Journal entry. 
Item is a note. 
No item is opened.
 
This command is most useful in scripts to respond to left-clicking or right-clicking on the tray icon (LeftClick.cyb and RightClick.cyb), to enable the CyberSecretary to respond appropriately depending on the type of Outlook item currently open. For example, such a script could perform the following tasks:

Note that your script need not respond to all of the different possibilities but can choose to ignore some. For example, if the script does not contain a [Note] section, then the script will terminate if the current item happens to be a note. Note that a section can branch to one or more additional sections, and two or more sections can branch to the same section. See the supplied LeftClick.cyb as an example.

SendKeys Keystrokes to Window

This command is used to send keystrokes to Outlook folders or items.  This is useful for controlling Outlook in ways that are not directly supported by other commands.

The Keystrokes parameter is a string which indicates the keystrokes to send.  Please note the following:

The Window parameter may be any Outlook folder or item.

For example, use the following command to display the Outlook calendar and display it in monthly format:

Please note, the CyberSecretary script will pause execution until the receiving application processes the keystrokes.  In some cases, the receiving application may not process keystrokes sent by CyberSecretary, which may cause CyberSecretary to hang.  Please test all scripts using this command.

ProgramGroup Folder

This command causes all items in the specified folder to be listed in the CyberSecretary drop-down list box.  This command is called by default when you right-click on your CyberSecretary's tray icon, and displays all items in the \Menu subfolder of the CyberSecretary program folder.  You can use this command in other scripts to present a menu of items contained in any folder.

SearchInternet Engine

This command uses the Internet to make a search using the search engine named as a parameter. If no search engine is specified, CyberSecretary first looks to see if one is named in the drop-down list box; otherwise, the default is taken from the Registry. Note that URL’s for leading search engines are included in the Registry under HKEY_CURRENT_USER\ Software\VB and VBA Program Settings\CyberSecretary\SearchInternet and more can be added. You can get a query URL by looking at the location of the page generated by any search engine. Substitute a * for the actual query string when adding the URL to CyberSecretary.INI. Note that the search query is read from the user input box; to make a search script, have the first section of the script seek user input using the InputLines= directive.

GetStockPrice Ticker Name

This command gets a current stock price through Yahoo! Personal Finance. The ticker symbol and name should be specified as a parameter, e.g GetStockPrice CI CIGNA. If no parameter is specified, the user is prompted for a ticker symbol and stock name.  If this command was called by a script, the ticker symbol and name are remembered as part of the script.  The user has the option, when this command is run, to get a full stock price report.  Requires an Internet connection.

GetUpdate

This command checks the CyberSecretary web site for a special update script, and, if a new update script is found, runs that script. New scripts will be periodically posted to inform you of product updates, tips and tricks, and to make you aware of specific CyberSecretary features. By default this command is included in the random script 250.cyb, which will result in checking the CyberSecretary web site for updates approximately weekly.

PickScript Folder to Action

This command brings up a Windows File Open dialog and allows you to choose a script to be launched or edited.  You may specify any subfolder of the CyberSecretary program folder (e.g. Schedule, Outlook, Random or Scripts); if no folder is specified, the CyberSecretary program folder is displayed.  Only CyberSecretary scripts are displayed.  The permitted actions are Open (or Launch or Run) and Edit.  For example:

Game Datafile
 
Your secretary's capabilities are not limited to "all business."  This command plays a guessing game. The game data file should be specified as a parameter.  If the path and extension are omitted it is assumed to be an .INI file in the CyberSecretary program folder.  The guessing game requires the user to think of a person or object in the category; your CyberSecretary then asks a series of yes/no questions to guess. If you let her, your CyberSecretary will try to guess a president of the United States when her installation is finished. Watch it – she gets better with practice!