Reference Site and Portal Pages

What site and portal page references are

You can directly reference site and portal pages in certain functions using the site! and portal! domains. These domain prefixes are direct object references that remove the need to create a constant to reference a page.

Site and portal page references allow you to reference pages configured in a site or portal for use in the page link component, a!urlForSite(), and a!urlForPortal().

For more information on linking to site and portal pages, see Use URL Parameters for Site and Portal Navigation.

Reference a site or portal page

It's easy to construct a page reference since the site! and portal! domains leverage typeahead to suggest a selection of existing sites or portals. If you already know the name of your site or portal, you can even skip entering the domain and simply type the name for the domain and object reference to appear.

The site or portal object reference combined with . dot notation allows you to directly access pages, which are identified in the object reference by their web address identifier.

To reference a site or portal page:

1. Enter the site! or portal! domain and select the site or portal.
2. Enter . after the object name to autosuggest the pages.
3. Select pages to access the menu of pages configured in the site or portal object.
4. Select a page's web address identifier from the dropdown to append to the pages property.

For example, the reference below refers to the My Projects page on the DOT Site.

When you highlight a page from the dropdown, Appian automatically provides additional information about the page, including:

• Site or portal name.
• Page title.
• Page web address identifier.
• Type of page (sites only).
• Interface used as the page content.
• Whether or not the page is configured to use encrypted URL parameters.
• Whether to update the URL when rule input values change.
• URL parameter names that are enabled for the page.
• Visibility setting (sites only).

You can also access this information in the expression documentation pane by clicking the page reference. Notice how the URL parameter names display under Enabled URL Parameter(s).

When using a page reference, Appian automatically shortens the reference to improve the readability of your expressions. To display the full reference, simply hover over it.

Feedback