Sites

Sites allow users to focus on a limited set of activities. Each site contains up to five pages, each of which is either an action, a report (Tempo or task report), or a record type, allowing users to do their work efficiently.

Sites as User Start Pages

For users who primarily or exclusively use a site to do their work, you can set the site or any page within the site as their start page when they first log in to Appian. To learn more about how to do this, see User Start Pages.

Designing Sites

Sites can be created in the Appian Designer and further configured in the site designer.

Create a New Site

  1. In Appian Designer, open the application that you want the site to be in.
  2. From the New menu, click Site. This will display the Create Site form. image:CreateSiteModal.png

    • Name - The name is displayed to users in the browser title bar. The name is a required parameter.
    • Description - An optional description that is displayed to designers only.
    • Web Address Identifier - The section of the site's URL that identifies it. It appears in the URL and in log files for network devices and servers. The web address identifier must be unique across sites in your system.
  3. Click Create & Edit to create the site and to open the site designer to continue configuring it.
    • The site designer allows you to edit a site's properties, configure the contents of the site, and add custom branding for the site.

image:SiteDesignerWithBranding.png

Edit Site Properties

Under the Properties section of the site designer, you can edit the name, description, and web address identifier that were defined during the site creation process. In addition, you can edit the following properties:

  • Show site name on navigation bar - Option to show the site name on the navigation bar.
  • Show Tempo link in navigation menu - Option to show or hide the Tempo link in the navigation menu. Designers can select to always show it, never show it, or show it for one or more selected groups.

Configure a Site Page

Designers can configure up to 5 pages per site. Each page within a site can be configured with an action, a report (task report or Tempo report), or a record type.

To add and configure a new site page:

  1. Click Add Page below the Pages grid.
  2. Fill in the Add Page dialog:
    image:SiteAddPageModal.png

    • Title - The page title is displayed to users in the navigation bar. The title is a required parameter. You can configure the value as a static string or as an expression.
    • Web Address Identifier - The section of the URL that identifies the page. The web address identifier appears in the URL and in log files for network devices and servers. The value must be unique across pages within the same site.
    • Width - Determines the width of the content area for the page. The default is standard.
    • Icon - The icon is displayed to users in the navigation bar. The icon is a required parameter.
    • Page Type - Indicate whether the page will contain an action, report (Tempo or task report), or record type.
    • Page Content - Enter the name of the design object for the page content.
      • The list of available objects to select from is based on the page type selected
      • Actions must have a start form to be used in a site page. See the Process Start Form section of Process Models for more information.
      • Related actions based on quick tasks are not supported in site records.
    • Visibility Determines whether the page is visible to basic users (system administrators are unaffected by this setting).
      • Select Always show to make the page visible to any user that has access to the site.
      • Select Only show when... to set the visibility with an expression. When the expression evaluates to true, the page will be visible.
  3. Click OK.
    • The newly configured page appears in the Pages grid.
  4. Use the grid controls on the right side of the Pages grid to reorder or delete the new page.
    • The order of the pages in this grid is the order they will appear in the site.

Configure Site Branding

Use the Branding section of the site designer to modify the site logo, favicon, and colors.

image:SiteAddPageModal.png

  • Logo - The logo appears on the top right corner of the site and is automatically resized for use in the site.

    • The logo file should be a JPG, PNG, BMP, JPEG or GIF file with a transparent background and must be less than 100KB.
    • The default logo is the Appian logo.
    • Use the document radio button to use an image within an Appian Document folder or Knowledge Center.
    • Use the web address radio button to point to a static image hosted on a separate web server. Use this option when your company web assets, such as logos, are hosted on a content delivery network.
    • Use the expression radio button to dynamically display different logos based on a expression rule.
      • Expressions that resolve to a document will use that document.
      • Expressions that resolve to a integer will use the document that has the integer as the id.
      • Expressions that resolve to a text value will use the text value as the web address.
      • The default logo will be shown if the expression does not resolve to a valid document, integer with corresponding document, or web address.
  • Favicon - The favicon (short for "favorite icon") is the small icon that appears in the browser tab or URL bar.

    • Provide an ICO file with sizes 16x16 and 32x32 that is less than 100KB.
    • The default favicon is the Appian "A" icon.
    • Use the document radio button to use an icon image within an Appian Document folder or Knowledge Center.
    • Use the web address radio button to point to a static icon image hosted on a separate web server. Use this option when your company web assets, such as icon images, are hosted on a content delivery network.
    • Use the expression radio button to dynamically display different icon images based on a expression rule.
      • Expressions that resolve to a document will use that document.
      • Expressions that resolve to a integer will use the document that has the integer as the id.
      • Expressions that resolve to a text value will use the text value as the web address.
      • The default favicon will be shown if the expression does not resolve to a valid document, integer with corresponding document, or web address.
  • Navigation Bar Background Color - The background color of the navigation bar of the site in web, app header, tab bar and status bar in iOS, and app header bar and navigation bar in Android.

    • The default value is #46708c.
    • Use the hex code radio button to provide a valid 3 or 6 digit hex code or use the color picker by clicking on the color preview bar.
    • Use the expression radio button to dynamically display different colors based on the expression rule.
      • The default accent color will be displayed if the expression does not resolve to a valid hex code.
  • Selected Tab Background Color - The background color of the selected tab in web and iOS.

    • The default value is #083d5c.
    • Use the hex code radio button to provide a valid 3 or 6 digit hex code or use the color picker by clicking on the color preview bar.
    • Use the expression radio button to dynamically display different colors based on the expression rule.
      • The default accent color will be displayed if the expression does not resolve to a valid hex code.
  • Accent Color - Affects the color of many elements in all interfaces, including buttons, links, active field border colors, milestone bars, section titles, etc.

    • Avoid grayscale colors (black, white, and gray) that are similar to colors used for interface elements and avoid green/red colors that are used to indicate positive/negative values.
    • The default value is #1d659c.
    • Use the hex code radio button to provide a valid 3 or 6 digit hex code or use the color picker by clicking on the color preview bar.
    • Use the expression radio button to dynamically display different colors based on the expression rule.
      • The default accent color will be displayed if the expression does not resolve to a valid hex code.

Click Save in the header bar to save any changes that you have made to the site configuration. To test the site, you can navigate directly to it by clicking on the URL in the Web Address field.

image:SiteEndUserBranding.png


To test your site on a mobile device, add an account to the Appian for Mobile Devices application with the full site URL as the server address.

image:iOSSiteServerAddress.png

Once you have added your account successfully, you will see the site.

image:iOSSiteRecordView.png

Security

Each site has a rolemap that specifies its viewers, auditors, editors, and administrators. Users must also have at least viewer rights to the task report configured for the site in order to use the site. By default, only the site creator and system administrators have access to the site.

To access the site's configuration and rolemap, users must also be in the designer role.

Users in each role are allowed to perform the following actions on the site:

Actions / Roles Administrator Editor Auditor Viewer
View site Yes Yes Yes Yes
View the configuration Yes Yes Yes Yes
View the security Yes Yes Yes No
Update the configuration Yes Yes No No
Update the security Yes No No No
Delete Yes No No No

Notes

The default security for a site is that users and groups that are not system administrators or explicitly in the rolemap do not have access to the site. However, you can change the default security for a site such that users have Viewer privileges by default.

Design Considerations

Actions in sites can be designed to be available to iOS users while they are offline. Learn more about designing for offline mobile.

When a user clicks a process task link to a SAIL task or a record link in a site, the respective task or record view opens within the site. However, if there is news entry link in a site, clicking it opens a new tab with the news entry in Tempo. In order to keep users within a site and not navigate them to Tempo, avoid the use of news entry links in sites.

Users can navigate between site pages by clicking on the site page or using the keyboard navigation. To refresh the current site page they are on, users can re-click or select the site page again.

Using the site navigation menu, users can easily access other interfaces they have access to. This menu may contain links to other sites, Tempo, Admin Console, Appian Designer, and Runtime Data. If the designer has configured the Tempo link to appear on the site navigation menu, it will alway display at the top of the available sites. If the user only has access to the current site they are on, the site navigation menu will not be shown.

image:SiteEndUserBranding.png


Task Notifications

Email notifications that are sent to users when they are assigned a new task contain a link to the task in Tempo. If you don't want to navigate your site users to Tempo, you can disable these notifications for your environment. However, users can override the system setting by enabling these notifications in their personal settings.

See also: Configuring Notifications

Logging

The usage of sites is logged in <APPIAN_HOME>/logs/audit/sites_usage.csv. See Sites Usage Audit for details.

Sites metrics are logged in <APPIAN_HOME>/logs/data-metrics/sites.csv. See Sites Metrics Log for details.

17.2

On This Page

FEEDBACK