Difference between revisions of "Documentation/DevGuide/Scripting/Scripting Framework"

Revision as of 13:05, 15 February 2008

A OpenOffice.org macro is a short program used to automate a number of steps. The Scripting Framework is a new feature in OpenOffice.org [VERSION]. It allows users to write and run macros for OpenOffice.org in a number of programming and scripting languages including:

• BeanShell (http://www.beanshell.org/)
• JavaScript (http://www.mozilla.org/rhino/)
• Java (http://www.java.com)
• OpenOffice.org Basic OpenOffice.org Basic and Dialogs

The framework is designed so that developers can add support for new languages.

Template:Documentation/Note

Structure of this Chapter

This chapter is organized into the following sections:

• Section Using the Scripting Framework describes the user interface features of the Scripting Framework
  • Describes how to run a macro using the Run Macro dialog.
  • Describes how to use the Organizer dialogs to create, edit and manage macros.
• Section Writing Macros provides a guide on how to get started with writing Scripting Framework macros
  • Describes how to write a simple HelloWorld macro.
  • Describes how Scripting Framework macros interact with OpenOffice.org and the OpenOffice.org API.
  • Describes how to create a dialog from a Scripting Framework macro.
  • Describes how to compile and deploy a Java macro.
• Section How the Scripting Framework Works describes how the plug-able architecture of the Scripting Framework allows support for new scripting languages to be added easily.
• Section Writing a LanguageScriptProvider UNO Component using the Java Helper Classes describes how to use the Scripting Framework Java helper classes to add support for a new scripting language
  • Describes how to use the ScriptProvider abstract base class.
  • Describes how to add editor and management support.
  • Describes how to build and register a ScriptProvider.
• Section Writing a LanguageScriptProvider UNO Component From Scratch describes how to write a LanguageScriptProvider UNO component.

Who Should Read this Chapter

If you are interested in automating OpenOffice.org using BeanShell, JavaScript, Java or OpenOffice.org Basic then you should read sections Using the Scripting Framework and Writing Macros.

If you are interested in adding support to run and write macros in a language with a Java based interpreter then you should read section Writing a LanguageScriptProvider UNO Component using the Java Helper Classes.

If you are interested in adding support for a scripting language from scratch then you should read section Writing a LanguageScriptProvider UNO Component From Scratch.