To automatically launch a composite application when you open an NSF file in the IBM Lotus Notes Standard client, you must store the composite application in the Notes database. There are two ways to do this:
- If creating a new composite application, you can create the NSF file using the supplied Blank Composite Application template.
- If the composite application already exists in an XML file, open the Notes database in IBM Lotus Domino Designer. Navigate to Composite Applications-Applications and use the Import XML button to bring the file into Notes as a Composite Application design element. You can also create a default Composite Application here using the New Blank CA button and then customize it using the Composite Application Editor.
The Composite Application design element behaves just like other design elements in terms of replication, template inheritance, and so on. You may have more than one of them in a single Notes database, though this is unusual.
In addition to storing the Composite Application XML in the Notes database, you must also change certain settings to tell the Notes client to launch the Composite Application when the user opens the Notes database. (This has already been done for you if you created the Notes database from the Composite Application template.)
The easiest way to set the database to launch a Composite Application, is through the Database Properties Launch
If you do not select a page, the default page of the application will be used.
Using the Launch
property works in most cases. However, there are circumstances where it may be better to do it another way:
- If the application must be compatible with earlier Notes client versions.
- If not all your users will use the Premium client.
- If you want to create outline entries that open the application using different Composite Applications, or different pages within the same Composite Application. For instance, Mail and Calendar are the same database, but you would open them to different Composite Application pages depending which outline entry the user clicks to open them.
In such cases, you would not use the "Launch as Composite Application" option in the Database
Infobox. Instead, do the following:
- Create a frameset, and set the frameset to open the composite application and page you want.
- In the Launch tab of the Database Infobox, select that frameset.
- When the database is opened in the Standard Notes client using Ctrl+O or an outline entry that points to the database, it will ignore the regular contents of the frameset, and instead open the composite application specified in the frameset properties. The Notes Basic client, or an earlier version of Notes, will ignore the Composite Application setting of the frameset, and you will see the frameset in the client.
- Of course, a Notes database can contain multiple framesets, so if you want to have your application open to different pages of the composite application depending how it's launched, you can define several framesets that open to different composite application pages. Then, create outline entries that link to those framesets.
To edit a composite application stored in a Notes database, you must first launch that composite application in the Standard Notes client and then use the Edit Application
menu item. If you have not opened the Notes application as a composite application, the Composite Application Editor does not know where to find the composite application XML to edit.
Deployment and testing options for composite applications hosted on Notes Domino servers
Debugging in the property broker
Reference documentation for composite applications