Home
IBM Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
Designing composite applications
You can create composite applications from XPages.
Working with components in XPages
Components based on XPages can be developed with Domino® Designer.
Publishing and receiving events (JavaScript™)
You can use Publish and Receive events to communicate among components in an application.
Publishing an event on the XPage with JavaScript
On the XPage, you can use a client-side script to publish a defined component event.

IBM Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
- Product overview
  IBM® Domino® Designer supports applications development for the IBM Domino platform using XPages, forms, views, and other elements such as controls.
- Tutorials
  This section contains tutorials and information about tutorials.
- Administering applications
  IBM® Domino® Designer provides features for administering and managing your work and related files while developing your application projects.
- Designing XPages applications
  IBM® Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
- Designing composite applications
  You can create composite applications from XPages.
  - Working with components in XPages
    Components based on XPages can be developed with Domino® Designer.
    - Creating a component (JavaScript™)
      Creating a component requires work in both the component and XPage interfaces.
    - Publishing and receiving events (JavaScript™)
      You can use Publish and Receive events to communicate among components in an application.
      - Specifying an event on the component
        On the Events tab in the component, click the Add button to create an event.
      - Publishing an event on the XPage with JavaScript
        On the XPage, you can use a client-side script to publish a defined component event.
      - Publishing an event on the XPage with a simple action
        On the XPage, you can use a client simple action to publish a defined component event.
      - Receiving an event on the XPage
        On the XPage, create an event to receive information from another component.
    - Using parameters
      Parameters require work in both the component and XPage interfaces.
  - Running an XPage as a component in a composite application
    You can run an XPage as a component in a composite application.
- Programming
  XPages uses JavaScript™ for programming while the forms-based design elements use the formula language, LotusScript®, Java™, and JavaScript.

Publishing an event on the XPage with JavaScript

On the XPage, you can use a client-side script to publish a defined component event.

Procedure

Implement a mechanism to trigger the script. For example, create a button and put the script in a client onclick event.
Call the following method where name is the event name as defined on the Event tab and type is its type as defined on the Event tab. The value is a string but must match the type in format.
```
XSP.publishEvent(name, value, type)
```

Example

Here are several examples:

XSP.publishEvent("publishString", "hello", "string");
XSP.publishEvent("publishNumber", "12", "number");
XSP.publishEvent("publishBoolean", "true", "boolean");
XSP.publishEvent("publishJson", {"userId": "jsmith"}, "JSON");

You can embed server JavaScript™ as the second parameter to publish values computed on the server. For example:

XSP.publishEvent("publishString", "#{javascript:document.myfield}", "string");