Can someone a bit closer to the inner sanctum at Microsoft report that there
is no Applescript reference guide for Entourage 2004 at:
http://www.microsoft.com/mac/resources/resources.aspx?pid=asforoffice
although there are for the other Office apps.
They are fully aware of that, since they're the ones that provided the other
References. It would be nice to have an Entourage Reference, too, of course,
but it is much less urgent for the following reasons:
1) Office 2004 completely re-implemented AppleScript for Word, Excel and
PowerPoint (but not for Entourage). The AppleScript object model for those
three applications (but not for Entourage) hooks into the same object model
as the Visual Basic for Applications for those 3 apps. (There is no VBA for
Entourage.)
2) The VBA model and syntax is very, very different from the standard
AppleScript model. As a result, the AppleScript syntax for Word, Excel, and
PowerPoint 2004 is very unorthodox. Trying to use the dictionaries without
additional help would have been extremely puzzling and frustrating, even (or
especially) to expert AppleScripters. So help had be provided. None of this
is true for Entourage (see 4 below).
3) Such help already existed in the Help files for VBA. (Check
Word/Tools/Macros/VBE Editor/Help, and browse the Help there.) So all they
had to do was get someone to "translate" the VBA Help into AppleScript
format, plus provide a general introductory section. It was decided to do it
as a .pdf document rather than as Help files, since there was no way to get
into Script Editor's Help. Again, there is no such pre-existing Help for
Entourage AppleScript.
4) Entourage's AppleScript dictionary is one of the very best and clearest
on the Mac. It was built on top of the earlier Outlook Express AppleScript
dictionary, and was logically designed according to the Apple guidelines as
to how to implement AppleScript. (In fact, it's a lot better than the
AppleScript implementation for all the OX X Apple iApps.) It _does_ have a
few quirks, which really should be explained in a Reference, but ask here if
you hit any: there are quite a few Entourage AppleScript experts here.
If no guide is planned, could they at least make a reference that a person
could open the Script Editor, File menu and Open Dictionary to see classes
etc. that Entourage does recognizes.
5) AppleScripters do not need to be told to look in the Entourage dictionary
in Script Editor. It goes without saying that to script any application you
have to look in its dictionary: that's how AppleScript works. If you are
brand new to AppleScript and don't know that, then what you need to do first
is learn AppleScript: and I believe there are links in the Developer section
to the AppleScript page on the Apple site where you will find more links to
books and tutorials. One of the first things you will learn in any such book
or tutorial is to look in the application's dictionary when scripting an
application. But you also need to learn basic AppleScript language syntax
before you can attempt scripting an application. Recommendations for books:
AppleScript: The Missing Manual (Adam Goldstein/O'Reilly): a basic
introduction to get you started, not enough to learn in detail or become
expert
AppleScript: The Definitive Guide, 2nd ed (Matt Neuburg/O'Reilly): the best
book on the language, especially if you've done any programming before
AppleScript: A Comprehensive Guide (Hanaan Rosenthal/friendsOfEd): really
through and comprehensive, step by step, 900 pages, includes some
application scripting
An AppleScript Handbook, 3rd ed (Danny Goodman/toExcel): a good general
introduction, good on the language
Also The link on the bottom of the above web page that is used to subscribe
to the newsletter does not work. I was able to subscribe using the link on
the right. However, Microsoft needs to check the linkage of their
newsletter pages since I got the 404 error a bit later as well.
That's interesting. There are a lot of links not working (like Help/Send
Feedback in each Office app.)
You found the best resource for help right here.
--
Paul Berkowitz
MVP MacOffice
Entourage FAQ Page: <
http://www.entourage.mvps.org/faq/index.html>
AppleScripts for Entourage: <
http://macscripter.net/scriptbuilders/>
Please "Reply To Newsgroup" to reply to this message. Emails will be
ignored.
PLEASE always state which version of Microsoft Office you are using -
**2004**, X or 2001. It's often impossible to answer your questions
otherwise.