Home
JavaScript and XPages reference
This reference describes the JavaScript™ language elements, Application Programming Interfaces (APIs), and other artifacts that you need to create scripts, plus the XPages simple actions.
Simple actions (JavaScript)
A simple action performs a pre-programmed activity that can be modified by arguments.
Execute Script (Simple actions)
Executes a script or EL expression.

JavaScript and XPages reference
This reference describes the JavaScript™ language elements, Application Programming Interfaces (APIs), and other artifacts that you need to create scripts, plus the XPages simple actions.
- JavaScript™ language elements (JavaScript)
  The JavaScript™ language elements are based on the ECMAScript Language Specification Standard ECMA-262 (see http://www.ecma-international.org/publications/standards/Ecma-262.htm). The JavaScript described here applies to the server-side interpreter. Client-side scripts are interpreted by the browser.
- Simple actions (JavaScript)
  A simple action performs a pre-programmed activity that can be modified by arguments.
  - Change Document Mode (Simple actions)
    Changes the access mode for the current page.
  - Confirm Action (Simple actions)
    Confirms an action.
  - Create Response Document (Simple actions)
    Creates a response document and opens it as a new document.
  - Delete Document (Simple actions)
    Deletes the current document and opens a new page.
  - Delete Selected Documents (Simple actions)
    Deletes documents selected in a view.
  - Execute Client Script (Simple actions)
    Executes a client-side script.
  - Execute Script (Simple actions)
    Executes a script or EL expression.
  - In Place Form Action (Simple actions)
    Shows or hides In Place Form controls that are commonly used for the in place editing of an individual document - directly within a Repeat control that lists multiple documents.
  - Modify Field (Simple actions)
    Modifies a field in the current document.
  - Open Page (Simple actions)
    Replaces the current page.
  - Publish Component Property (Simple actions)
    Publishes a component event.
  - Publish View Column (Simple actions)
    Publishes the value of a view column as a component event.
  - Save Data Sources (Simple actions)
    Saves all the data sources on the current page and opens a new page.
  - Save Document (Simple actions)
    Saves the current document.
  - Send Mail (Simple actions)
    Sends a mail message.
  - Set Component Mode Action (Simple actions)
    Changes the mode of a component.
  - Set Value (Simple actions)
    Sets the value of a computed expression.
- Global objects and functions (JavaScript™)
  Global objects provide entry points to server-side scripts. Entering the name of a global object instantiates it.
- DOM (JavaScript)
  Represents a document in XML Document Object Model format.
- Domino®
  This library provides access to the IBM® Domino® back-end.
- Runtime (JavaScript)
  The Runtime library contains classes that provide useful methods for globalization.
- Standard (JavaScript)
  The Standard library contains classes for manipulating data of different types and performing common operations.
- XSP (JavaScript™)
  The XSP library contains classes that access the browser context.

Execute Script (Simple actions)

Executes a script or EL expression.

Defined in

Type

Basic (Server)

Syntax

Note: This is the XSP source code. The UI presents the simple action as a dialog with a box for each argument.

executeScript script=#{javascript:<JavaScript>}

executeScript script=#{<EL_expression>}


Arguments	Description	UI presentation
`script`	One of the following: `javascript` `xpath` null (for EL)	A combo box with the options JavaScript (Server Side), Expression Language (EL), or Custom.
`JavaScript`	Valid JavaScript code.	An area to type the script plus an Open Script Editor button.
`EL_expression`	Valid EL expression.	An area to type the expression plus an Open Script Editor button.

Usage

See Introduction to the JavaScript and XPages reference for writing JavaScript. Search the Web for documentation EL expressions.

If you specify Custom in the UI, enter XSP source code starting with # (the pound sign) and ending with } (the closing brace).

Examples

Note: These examples present XSP source code which can be inserted under the Source tab taking care to keep the XML well formed. To use the UI, select or enter the arguments in the simple action dialog.

This button uses JavaScript to create a new document.

<xp:button value="Save" id="button1" style="width:148.0px">
<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
<xp:this.action>
	<xp:executeScript><xp:this.script>
		<![CDATA[#{javascript:var doc = database.createDocument(); doc.appendItemValue("Subject", "my subject"); return doc.save()}]]>
	</xp:this.script></xp:executeScript>
</xp:this.action></xp:eventHandler></xp:button>