pageName - Page Name (property)

Opens a selected document using a specified page.

Category

basics

Syntax

pageName="name"
Where name is the name of an XPage, for example, /page1.xsp.

Usage

In Design mode, click the top tab under Properties and look for At runtime, open selected document using, or click All Properties and look for pageName under data.
Omitting this property in Source mode is the same as selecting XPage associated with the document's form in Design mode. At runtime, the priorities for opening a page are as follows:
  • If you select an XPage, that XPage opens
  • Else if the application contains a form whose name or alias matches the Form item in the document:
    • If that form specifies that an XPage should be displayed (Form properties, Defaults, "Display XPage instead"), that XPage opens.
    • Else if an XPage exists with the same name as the form or alias name, that XPage opens.
    • Else an error occurs.
  • Else if the application has a default form (Form properties, Form Info, "Default database form"):
    • If that form specifies that an XPage should be displayed (Form properties, Defaults, "Display XPage instead"), that XPage opens.
    • Else if an XPage exists with the same name as the form or alias name, that XPage opens.
    • Else an error occurs.

Examples

This View Panel control opens a selected document using /xpage1.xsp.
<xp:viewPanel rows="30" id="viewPanel1" pageName="/xpage1.xsp">
	<xp:this.facets>
		<xp:pager partialRefresh="true" layout="Previous Group Next"
			xp:key="headerPager" id="pager1">
		</xp:pager>
	</xp:this.facets>
	<xp:this.data>
		<xp:dominoView var="view2" viewName="main"></xp:dominoView>
	</xp:this.data>
	<xp:viewColumn columnName="subject" id="viewColumn1" displayAs="link">
		<xp:viewColumnHeader value="subject" id="viewColumnHeader1"></xp:viewColumnHeader>
	</xp:viewColumn>
	<xp:viewColumn columnName="fruit" id="viewColumn2">
		<xp:viewColumnHeader value="fruit" id="viewColumnHeader2"></xp:viewColumnHeader>
	</xp:viewColumn>
</xp:viewPanel>