4.0

Limitations of the Mozilla Rhino Implementation in Orchestrator
Orchestrator implements the Mozilla Rhino 1.6 JavaScripting engine. However, the implementation of Rhino
in Orchestrator presents some limitations.
When writing scripts for workflows, you must consider the following limitations of the Mozilla Rhino
implementation in Orchestrator.
n
When a workflow runs, the objects that pass from one workflow element to another are not Javascript
objects. What is passed from one element to the next is the serialization of a Java object that has a Javascript
image. As a consequence, you cannot use the whole Javascript language, but only those classes that are
present in the API Explorer. You cannot pass function objects from one workflow element to another.
n
Orchestrator runs the code in scriptable task elements in a context that is not the Rhino root context.
Orchestrator transparently wraps scriptable task elements and actions into Javascript functions, which it
then runs. A scriptable task element that contains System.log(this); does not display the global object
this in the same way as a standard Rhino implementation.
n
You can only call actions that return nonserializable objects from scripting, and not from workflows. To
call an action that returns a nonserializable object, you must write a scriptable task element that calls the
action by using the System.getModule ModuleName .action() method.
n
Workflow validation does not check whether a workflow attribute type is different to an input type of an
action or subworkflow. If you change the type of a workflow input parameter, for example from
VIM3:VirtualMachine to VC:VirtualMachine, but you do not update any scriptable tasks or actions that use
the original input type, the workflow validates but does not run.
Using the Orchestrator API
The Orchestrator API exposes as JavaScript objects and methods all of the objects and functions of the
technologies that Orchestrator accesses through its plug-ins.
For example, you can access JavaScript implementations of the vCenter Server API through the Orchestrator
API, to include vCenter operations in scripted elements that you create. You can also access JavaScript
implementations of objects from all of the other plug-ins you install in the Orchestrator server. If you create a
custom plug-in to a third-party application, you map the objects from its API to JavaScript objects that the
Orchestrator API then exposes.
Procedure
1 Access the Scripting Engine from the Workflow Editor on page 117
The Orchestrator scripting engine uses the Mozilla Rhino 1.6 JavaScript engine to help you write scripts
for scripted elements in workflows. You access the scripting engine for scripted workflow elements from
the Scripting tab in the workflow editor.
2 Access the Scripting Engine from the Action or Policy Editor on page 117
The Orchestrator scripting engine uses the Mozilla Rhino JavaScript engine to help you write scripts for
actions or policies. You access the scripting engine for actions and policies from the Scripting tabs in the
action and policy editors.
3 Access the Orchestrator API Explorer on page 118
Orchestrator provides an API Explorer to allow you to search the Orchestrator API and see the
documentation of JavaScript objects that you can use in scripted elements.
4 Use the Orchestrator API Explorer to Find Objects on page 118
The Orchestrator API exposes the API of all plugged-in technologies, including the entire vCenter Server
API. The Orchestrator API Explorer helps you find the objects you need to add to scripts.
vCenter Orchestrator Developer's Guide
116 VMware, Inc.