To work with data from a Domino® source, you need to connect to
a Domino server
and create a service data object that you can add to a Faces JSP. These service
data objects in Domino are
either views and notes.
Note: A page code file is required if you want to add a Domino View
or Domino Note
to a Faces JSP. If you have page code suppression turned on when adding a Domino View
or Domino Note,
you are prompted to allow a page code file to be generated.
To create a new Domino Note or Domino View in a Faces JSP file:
- Open the Data drawer on the palette click on either Domino
View or Domino Note and drag it to the
Faces JSP file. The Domino View or Domino Note wizard opens.
Note: An alternate
way to create a Domino Note
or Domino View
is to right-click within the Page Data view and select or .
- In the Name field, type a name for the Domino Note or Domino View, for example myBirthDate.
- (Optional) If you are reusing information from a previously created
object, select Reuse existing metadata definition,
then enter the input file location or click Browse to
find the file. To reuse information, the existing metadata file must be imported
into the workspace before you can select it using the wizard.
- (Optional) If you want to automatically add data controls, select Add
input/output controls to display the view on the page. For Domino notes,
you have the option of creating controls for displaying or updating an existing
note or creating a new note.
- Click Next. The Connection page displays.
- Type the host name or IP address of the Domino server you want to access
- In the Server field, type the host name or IP address. Do not enter
the Domino server
name.
- In the Development section, type your Domino user name and password. The password
is the HTTP password as defined in the your person document in the Domino Directory.
- (Optional) In the Runtime section, type your runtime Domino user
name and password if it is different from development.
- Click Connect to server. Your connection
status displays, for example, currently connected to DomServer1 as
MyUserName.
- Click Next. The Domino Database page displays.
- Select a database, then click Next.
Note: For views, the View page displays with a list of all the defined
views and their associated columns from the Domino database. For notes, the Form
page displays with a list of defined forms and their associated fields.
- Complete one of the following steps:
- For Domino views, select a view and any of its columns,
then click Finish. Optionally, you can click Next to
make changes to the way the columns display.
- For Domino notes, select a form and any of its fields,
then click Next. The Filter page displays where you
enter a condition for filtering query results, then click Finish.
From the Page Data view, you can see the Domino views and notes that were added
to the page, for example, View1 (Service Data
Object) and Note1 (Service Data
Object). The note fields can contain multiple values which are
marked as multi-value.
Available actions for Domino data access
When targeting
a single Domino document
or note, you can:
- Create
- Retrieve
- Update
- Delete
When targeting Domino views, you can only retrieve information.
Editing
your Domino SDO
To
make changes to the metadata in the Domino SDO object you just created, follow
these steps:
- In the Page Data view, right-click on your Domino view or Domino note node and select Configure.
The Domino View
or Domino Note
wizard opens.
- Make any changes, then click Finish to complete.
Limitations for accessing Domino
- Rich Text field support is limited to straight text. If a Rich
Text field on an existing document is updated, all Rich Text (text formatting,
paragraph formatting, etc.) and Rich Text Objects (bitmaps, attachments, embedded
objects, etc.) will be lost.
- Computed for Display fields can be created and updated, even though
Computed for Display fields are not typically saved to documents.