The Notes View and Notes PIM containers let you quickly add and configure a Notes view or a Notes personal information manager component such as e-mail, calendar, or contacts, to your composite application. Working with containers, rather than with standard components, is like working with a template for a particular type of application component. A container gives you the ability to easily publish properties on selection events within these views and components to integrate them into an application.
These particular containers only support publishing properties and only support the selection event.
Before you begin
To enable a preview of this feature in Notes 8.5, you must first download the Notes PIM and Notes View containers. For installation instructions, see Generic Containers and Utilities.
When you add a Notes View container, you browse for the particular view you want to add and then configure the view component for your application. The Notes View container supports standard LotusScript® formulas to access data.
Adding a container component for a Notes personal information manager (PIM) component simplifies the configuration for this type of component. You can select what types of information components to add and edit the component properties in the component property editor, or from the component toolbar, without needing to interact with the WSDL property editor. You can accept the default configuration for each component or customize the configuration to suit your application requirements. After selecting what properties to expose, you can wire the components to other components in your application.
Note: The Notes PIM container supports both standard LotusScript formulas and column formulas to access data. Evaluating formulas requires opening the Notes document, while executing a column formula does not. If you are using a local replica as your data source, either is acceptable, but if you are using a server-based data source, column formulas will have better performance. The Notes view container does not support column formulas.
Configuring the containers using the Composite Application Editor
Use the composite application editor (CAE) to add the Notes view and PIM containers to a composite application. The container interface lets you easily specify landmark events and associate them with actions.
1. Add a Notes PIM or Notes View container component to your application from the component palette. The components are grouped in the Containers section of the component palette. When you add the container to the workspace, a toolbar, that is visible only while you are in the Composite Application Editor, displays at the top of the component. You can use the toolbar instead of the property editor to manipulate the actions for the component.
2. To edit the container using the Property Editor, right-click the container component name in the navigator and select Edit Component Properties.
3. Click the Component Settings tab. The container name, such as Notes View Container , displays as the component name and description.
If you are configuring a Notes View container, use the Browse button to select a Notes view.
If you are configuring a Notes PIM container, in the Component Types field, choose which type of component: Email Inbox, Calendar, Contacts, Todo, or Recent Collaborations – to configure. Selecting a component type makes the properties for that type available for further configuration.
5. Notes PIM Container only: Click the Selection Output tab to view the available properties. The Notes PIM container is configured to allow either formula or column formulas for accessing data. You can change the formula type, or you can edit the formula for a property from this page. You can also add or delete properties from this page.
6. Click the Advanced tab if you want to edit property values. Some properties support multiple selections, which are delimited by “\0\0” by default. If you are deploying the application to the Web, you might want to change the delimiter to the tag.
7. When you have completed your configuration changes, click OK to close the component properties editor.
Using the component toolbar to add actions for the component
Use the toolbar at the top of the container component to create or modify properties, or to specify actions for the component.
1. In the Properties field, select a property that you want to associate with an action. You can also define a new property from this field.
2. If you are working with a Notes PIM container, use the Field Type field to specify whether you want to use standard LotusScript formulas and column formulas to access data. Evaluating formulas requires opening the Notes document, while executing a column formula does not. If you are using a local replica as your data source, either is acceptable, but if you are using a server-based data source, column formulas will have better performance. The Notes view container does not support column formulas, so this field is not available on the Notes View toolbar.
3. Use the Field Expression field to select an available field to associate with the action. You can also define a new field here.
4. Click the Add Action button. This will add a new publish action to the selection event. The field type and field expression are converted into the internal syntax used by the container configuration.
5. Repeat steps 1-4 until you have specified all of the actions you want for the container. When you are done, click the Save and Refresh button.
What to do next
When you have completed configuring the container, use the wiring tool to wire this component to other components in your application. Note that a Notes PIM container can only be a wiring source.