Creating an embedded view or embedded folder

About this task

When you embed a view or folder on a form, subform, page, or document, you can control the size and appearance of a view or folder display, especially on the Web. Embedding a view or folder pane lets you combine views and folders with other form elements (such as styled text) and graphics.

Before you begin, if there is any chance the view or folder you are embedding could be renamed, assign an alias before you embed it to avoid breaking the application if an embedded object is renamed.

Procedure

  1. Open a form, subform, or page in Domino® Designer, or open a document in Edit mode.
  2. Place the cursor where you want the embedded view or folder to display.
  3. Choose one of the following:
    • Create - Embedded Element - View
    • Create - Embedded Element - Folder Pane
  4. Views only: set a display option for the embedded view. You can display the view using HTML, as a Java™ applet, or using the display properties set for the view.
  5. Optional: (Optional, for views) You can assign a name to the embedded view. This name allows you to specify an embedded view as a target from another embedded view. This technique is used in the Notes mail template to show discussion threads in the Inbox view of the workplace.
  6. Optional: (Optional, for views) If you don't want to display the same view in all circumstances, click "Choose a View based on a formula." When you click OK to close the dialog box, write a formula in the Programmer's pane to display the appropriate view.
  7. Optional: (Optional, for views) You can specify a target frame on the Info tab of the Embedded View Properties box. The target frame specifies where the document is displayed when a user selects a document in an embedded view with a single click or with the arrow keys, or with a double click. You can specify a target frame for a single click (next to "for single click") and a target frame for a double-click (next to "for double click").

Results

For more information on target frames, see the Framesets topic, "Specifying a target frame." Close and save the form, subform, page, or document.

  1. (Optional, for views) If the embedded view is in the current database, you can select "Show only current thread" to display documents for one "thread" -- that is, one main topic and all the associated response documents.
  2. (Optional, for views) Check "Use views selection margin property" to maintain the margin settings you set for the view.

Tips

About this task

  • To delete an embedded view or folder pane, click the embedded view or folder pane in the Work pane and choose Edit - Delete.
  • Domino prevents the view opening if there are create or read access lists on a form in which views are embedded.
  • For compatibility with previous releases, the reserved fields $$ViewBody and $$ViewList still work on forms.
  • When you embed a calendar view, the embedded view property "Disable scrollbars" has no effect. Scrollbars for calendars always display -- the horizontal scrollbar is used to change dates, and the vertical arrows appear if there are too many entries to fit the vertical space.
  • If you are embedding a calendar view, make sure the embedded view has enough height to display as much of the calendar as you want displayed. The user will not have a vertical scroll bar in the view. Also, if the embedded view is too short, the footer indicating which week/month of the year is being shown will not display.
  • After embedding a view, you can change the view by clicking the Formula button in the Programmer's pane, then clicking the View button. You will see a list of views from the database where the original embedded view came from. For example, if you embed the Inbox view from your mail database, then you want to change the view, your choices are limited to the other views in the mail database. To embed a view from a different database, you must first delete the embedded view and embed the view you want.
  • You can display a discussion thread in an embedded view from another embedded view (see the Notes mail template for an example). Then, when a user opens the page or document, both views launch, displaying the current document and the associated thread.

    To do this, create an embedded view with threads on a page or form and assign it a name in the Embedded View. Check the "Show only current threads" option on the Embedded View Properties box. Then, create another embedded view on the page, form, or document, and in the "Single Click" target field on the Embedded View Properties box for the second view, enter the name of the first embedded view.