This article is written like a manual or guidebook. Please help rewrite this article from a descriptive, neutral point of view, and remove advice or instruction. (January 2012)

In Microsoft Windows applications programming, OLE Automation (later renamed to simply Automation^[1][2]) is an inter-process communication mechanism created by Microsoft. It is based on a subset of Component Object Model (COM) that was intended for use by scripting languages – originally Visual Basic – but now are used by several languages on Windows. All automation objects are required to implement the IDispatch interface. It provides an infrastructure whereby applications called automation controllers can access and manipulate (i.e. set properties of or call methods on) shared automation objects that are exported by other applications. It supersedes Dynamic Data Exchange (DDE), an older mechanism for applications to control one another.^[3] As with DDE, in OLE Automation the automation controller is the "client" and the application exporting the automation objects is the "server".

Contrary to its name, automation objects do not necessarily use Microsoft OLE, although some of Automation objects can be used in OLE environments. The confusion has its roots in Microsoft's earlier definition of OLE, which was previously more or less a synonym of COM.

Advantages and limitations [edit]

To ensure interoperability, automation interfaces are limited to use a subset of all COM types.^[4][5] Specifically, automation interfaces must use SAFEARRAY instead of raw COM arrays.

Automation-compatible COM servers can, however, rely on the in-built OLE marshalling implementation.^[6] This avoids the need for additional proxy/stub projects for marshalling out-of-process.

Usage [edit]

Automation was designed with the ease of scripting in mind, so controllers often provide languages such as Visual Basic for Applications to end users, allowing them to control automation objects via scripts. Automation objects are often written in conventional languages such as C++,^[7] where C++ attributes can be used to simplify development,^[8] Languages such as Visual Basic and Borland Delphi also provides a convenient syntax for Automation which hides the complexity of the underlying implementation.

Type libraries [edit]

In order to automate an application, the developer of an automation controller must know the object model that is employed by the target application exporting activation objects.^[9] This requires that the developer of the target application publicly document its object model. Development of automation controllers without knowledge of the target application's object model is "difficult to impossible".^[10] Because of these complications, Automation components are usually provided with type libraries, which contain metadata about classes, interfaces and other features exposed by an object library. Interfaces are described in Microsoft Interface Definition Language. Type libraries can be viewed using various tools, such as the Microsoft OLE/COM Object Viewer (oleview.exe, part of the Microsoft Platform SDK) or the Object Browser in Visual Basic (up to version 6) and Visual Studio .NET. Type libraries are used to generate Proxy pattern/stub code for interoperating between COM and other platforms, such as Microsoft .NET and Java. For instance, the .NET Framework SDK includes tools that can generate a proxy .NET DLL to access Automation objects using both early binding (with information about interfaces extracted from a type library) and late binding (via IDispatch, mapped to the .NET Reflection API), with the built-in .NET-to-COM bridge called COM Interop.^[11] While Java lacks built-in COM support, toolsets like JACOB^[12] and jSegue^[13] can generate proxy source code (consisting of two parts, a set of Java classes and a C++ source for a Java Native Interface DLL) from type libraries. These solutions only work on Windows.

Microsoft has publicly documented the object model of all of the applications in Microsoft Office,^[14] and some other software developers have also documented the object models of their applications. Object models are presented to automation controllers as type libraries, with their interfaces described in ODL.

Language support [edit]

Automation is available for a variety of languages, including, but not limited to:

• ABAP
• C
• C++ (with Compiler COM Support,^[15] or with libraries like MFC or ATL)
• Visual Basic and Visual Basic for Applications
• Delphi^[16]
• Microsoft .NET languages^[11]
• APL (most Windows versions)
• Java (only with third-party tools)
• JScript^[9] and VBScript
• Open Object Rexx^[17]
• Perl^[18]
• PHP^[19]
• PowerBuilder
• Python ^[20][21]
• Ruby (via the 'win32ole' library included in the standard Ruby 1.8.x or later distribution)
• Tcl ^[22]
• Visual DataFlex
• WinBatch^[23]

References [edit]

See also [edit]

• Object linking and embedding
• Component Object Model

External links [edit]

• OLE Automation General paper on the introduction and problems implementing OLE.
• "VOLE - A Neat C++ COM/Automation Driver" — an open-source, compiler-independent C++ COM Automation driver library, for use when having to drive IDispatch directly. VOLE is highly robust, fully encapsulates all "low-level" aspects of IDispatch, and is very flexible, taking and returning normal C++ types.
• Microsoft Corporation (December 1993). OLE 2 Programmer's Reference: Creating Programmable Applications with OLE Automation v. 2. Programmer's Reference Library. Microsoft Press. ISBN 1-55615-629-4. 
• Kraig Brockschmidt (1995). Inside OLE. Microsoft Press. 
• Microsoft Corporation (1996). OLE Automation Programmer's Reference. Programmer's Reference Library. Microsoft Press. ISBN 1-55615-851-3. 
• Microsoft Corporation (1999). Microsoft Office 2000 Visual Basic for Applications Language Reference. Microsoft Press. ISBN 1-57231-955-0.  — full printed documentation of the object model of Microsoft Office