May 1, 2012, 3:08 PM
64 Posts

Notes Form Hands over JavaApplet to Xpages

  • Category: Other Domino Designer Tooling
  • Platform: Windows
  • Release: 8.5.2
  • Role: Developer
  • Tags: Java Applet,JavaAgent,Xpages
  • Replies: 0
Knowledge Sharing:

Java Applet/Xpages

Build Applet to Notes Form

And Xpages iFrame

Form Applet

System Requirements:

Download Domino Designer 8.5.2 Environment (DDE)



Load Java Applet as a Lotus Notes JavaAgent or Script Library, attach the Applet to a Notes form then write an iFrame tag into Xpages form to load Applet through.



Information contained in the following is presented as is. This tutorial assumes you have basic programming knowledge. All tutorials are based on an Eclipse/Eclipse-based software. Should you need to familiarize yourself with a certain Eclipse environment, prior to continuing this tutorial, please stop now and see a tutorial from this site...


Write JavaAgent Applet, load to Form/Xpages

Full code added below, jump ahead if necessary, areas of interest have been highlighted for your convenience. Below JavaAgent is pretty basic, please use instructions as guide to fully understand how this Applet loads.



 * Created from Copy: 2012.

 * Applet Test to include in Notes Form

 * then sucked into Xpages via iFrame



import lotus.domino.*;

import java.awt.*;

import java.awt.event.*;



 * @author kcherizard

 * @version 2012.



public class awt extends AppletBase implements ActionListener {

      private static final long serialVersionUID = 1L;

      private Button b;

      private String text = "Oh My! Get a load of this!";

      Graphics g;

      public java.awt.TextArea ta;

      public Session s;


      public void notesAppletInit() {

            g = getGraphics();

            b = new Button("Get Döcu User");


            ta = new java.awt.TextArea(15, 30);





      public void paint(Graphics g) {

            b.setLocation(0, 0);

            ta.setLocation(200, 0);



      public void notesAppletStart() {

            try {

                  s = this.getSession();


            } catch (NotesException e) {

                  text = + " " + e.text;

            } catch (Exception e) {





      public void actionPerformed(ActionEvent e) {

            text = "What? I didn’t see anythingJ";


            ta.append(text + "\n");



      public void getTheName() {

            try {

                  if (isNotesLocal()) {



                  text = "User " + s.getCommonUserName();

            } catch (NotesException e) {

                  text = + " " + e.text;

            } catch (Exception e) {


            } finally {

                  if (isNotesLocal()) {








Build Xpages form with an iFrame

Full code added below, jump ahead if necessary, areas of interest have been highlighted for your convenience.


<?xml version="1.0" encoding="UTF-8"?>

<xp:view xmlns:xp="">

      <xp:span style="font-weight:bold">Applet from Notes form Embedded as an


      <xp:br style="font-weight:bold"></xp:br><xp:br></xp:br>



      <iframe src="http://localhost/docu.nsf/AppletForm?OpenForm"

            width="300" height="300"></iframe>





The Steps:



1.       Grab above code, plug it into a JavaAgent

2.       Give the is Agent full permissions

3.       Using code pane, right-click, run the code as Java Applet

4.       Provide your Applet loaded, save and keep code Open


Java Applet

5.       Go to Resources in DDE’s Application Navigator

6.       Add New Applet Resources to your project

7.       Navigate through Domino Directory, find workspace (../Data/workspace)

8.       Double-click the Bin folder to pick up the .class @ left

9.       Select class, choose Add/Replace File(s)

10.   File is now added to Current Libraries pane @ right



Notes Form

11.   Create a new form, enter some text in design pane

12.   Go to DDE’s menu bar, find Create option

13.   Choosing Java Applet loads a ‘Create Java Applet’ pop up

14.   From here you want to Locate the Applet

15.   Select class, choose Add/Replace File(s)

16.   Got to Libraries pane Dropdown to select the class

17.   You have added your Applet to the Form, now What?

18.   Well, right-click on this bad boy to see its properties

19.   Select ‘Applet uses Notes CORBA classes


Cheat Sheet: Java Applet Steps: Notes Client/Xpages Applet Tut



You can now build Applets to your Notes Client and Xpages forms.  If trying sample code above on an actual Server (http://myservername/...) other than http://localhost/, you will get an IBM certification notice pop up, just say yes in this case.


TIP: You should leave your JavaAgent open to locate all .class files




Questions, comments, please post a brief message. Thank you for coming...