OL97: Automatic Resource Booking Available with Sample Scripts

• Microsoft Outlook 97
• Microsoft Exchange Server version 5.5

SUMMARY

Automatic resource booking, a scheduling feature, is the ability to have a "resource" account, conference room, piece of equipment, or such, automatically accept or reject meeting requests based on availability. The Microsoft Schedule+ implementation of this feature allows the automatic processing of meeting requests to take place without the use of a delegate account, and without the resource account logging on. The implementation is different in Microsoft Outlook 97. Outlook requires that either a delegate be assigned to the resource account to accept/decline requests, or that the account be logged on continuously so that automatic processing can be enabled.

Microsoft Exchange Server 5.5 introduces a new feature that allows events, such as a meeting request arriving in a mailbox, to trigger automated scripts. This feature is the Microsoft Exchange Scripting Agent. One of the Sample scripts on the Microsoft Exchange Server 5.5 compact disc, automates the processing of meeting requests. Using this server script provides the same level of automatic booking in Outlook as in Schedule+, and provides several additional benefits.

NOTE: This is a sample script; support is not available for the script beyond this explanation of how to install and use it. This sample is provided as an example of how to use the scripting agent.

MORE INFORMATION

There are several steps to complete in order to configure the Microsoft Exchange Scripting agent install it and use the sample auto-booking script.

• Install the Scripting Agent
• Assign Client Permissions
• Install the AutoAccept Sample Script
• Test the script

Install the Scripting Agent

To verify that the scripting agent is already installed:

   In Control Panel, click Services and in the Service list check for the
   "Microsoft Exchange Event Service."

1. Re-run Setup from the Microsoft Exchange Server compact disc. This will start Maintenance Mode Setup.

2. Click Add/Remove Components.

3. Click to select Microsoft Exchange Server, then click Change Options.

4. Click to select "Microsoft Exchange Event Service."

5. Click OK twice to start Setup.

6. Restart the server if prompted.

Assign Client Permissions

To install and manage scripts, the resource account must be specifically granted a permission in the Event_Root container of the folder. To assign permission so the resource account can install and manage the script, follow these steps:

1. Navigate to the Events Root entry that is under the site container.

2. Select the EventConfig entry for the server that contains the accounts that you want to install scripts for. For example, if a conference room account is on the server named CORPORATE, select the entry titled "EventConfig_Corporate".

3. On the File menu, click Properties and on the General tab, click Client Permissions to grant permission to the resource account.

Install the AutoAccept Sample Script

To install the AutoAccept sample script, start from a computer that is logged into the resource mailbox. To configure the script, follow these steps:

1. On the Server compact disc, open:

   Server\Support\Collab\Sampler\Scripts\AUTOACCEPT.

2. Double-click the Autoaccept.txt file to open it in Notepad.

3. On the Edit menu, click Select All, and on the Edit menu click Copy to copy the script to the clipboard.

4. In Outlook 8.03, click the Inbox of the Resource account mailbox.

5. On the File menu, click Properties and click to select the Agents tab. If you do not see an Agents tab, refer to the third question in the "Common Questions and Answers" section below.

6. In Agents, click New. Type an appropriate name for the script such as, Process Meeting Requests.

7. Click to select the event "A New Item Is Posted In This Folder."

8. Click Edit Script. This will launch Notepad with boilerplate text.

9. On the Edit menu, click Select All and then press DELETE to clear the text.

10. On the Edit menu, click Paste. The text from Autoaccept.txt appears.

11. On the File menu, click Save, and then quit Notepad.

Test the Script

To see the script work:

1. Quit any client that is logged onto the resource account. The resource account does not need to be logged on for the script to execute.

2. Using a different account, in the Outlook Calendar folder on the Calendar menu, click New Meeting Request. Include the resource account in the meeting request.

Common Questions and Answers

The AutoAccept script is a sample script. Microsoft offers no technical support for samples; however there are several helpful resources that will aid you in authoring and managing scripts.

Q. Where can I get additional help?

A. Additional help on configuring the event service and assigning client

     permissions can be obtained in the Agents.hlp Help file located in the
     Server\Support\Collab\Sampler\Scripts folder. Additional information
     on the specific autoaccept script can be found in the Readme.txt file
     in the Server\Support\Collab\Sampler\Scripts\Autoaccept folder. Also,
     since most scripts are written to take advantage of the Collaborative
     Data Object (CDO) object model, all reference information on CDO on
     the Microsoft Web (www.microsoft.com) is applicable.

A. It probably was not installed during Microsoft Exchange Server 5.5

     Setup. Use the maintenance mode of Setup to add the event service
     component.

     from Outlook?

     is automatically added during the Outlook 8.03 Typical Setup. To make
     sure that the extension is installed, on the Tools menu click Options
     and on the General tab click Add-In Manager. There should be an entry
     for Server Scripting. If the entry is not there, rerun Outlook 8.03
     Setup and use the Add/Remove option to add the Server Scripting
     extension. If the extension is installed  and checked, and no Agent
     tab appears, then you do not have client permissions to install and
     manage scripts. These must be granted using the Microsoft Exchange
     Admin program as described in the section above titled "Assign Client
     permissions".

     What's wrong?

     there may be a couple of minutes lag time between processing.
     If you have waited more than 10 minutes with no action, then recheck
     the event that you selected for the script. For this sample, the event
     "A Message Is Posted To This Folder" is the only event that should be
     selected. Also verify that your code did in fact get copied intact
     into the script by using the Edit-Script button.

     Schedule+ implementations of resource booking?

     method does not require delegate interaction to manually
     accept/decline requests, and it does not require that the resource
     account be logged in to automatically process the request. The
     advantages over the Schedule+ implementation are that the processing
     works even when the meeting organizer is offline, and the meeting
     organizer does not have to be granted specific permission for the
     direct booking.

     available. Why?

     your appointment is greater than 30 minutes in duration, the request
     will always be denied due to the decision logic in the script.
     Microsoft plans to remove this limitation in a subsequent sample
     script and will post more information here when that revision becomes
     available.