Publish

When working with Nintex Apps applications, making an app avaliable to end users happens to two separate processes:

  • Publishing an application to end users in a specific environment, making the Nintex Apps pages within it available at specific URLs to specific permission sets
  • Deploying an application's resources from one Nintex Apps environment to another—for example from a sandbox environment to a production environment

How end users navigate to apps and app pages

When an end user visits your Nintex Apps environment's site URL, they will be taken to their default app —which is configured in their site permission set.

This default app can be set by navigating to Settings > People > Site Permission Sets, selecting the site permission set to configure, then enabling the Default app toggle by the appropriate app.

Note:  If a user has no default app associated with their permission set, then Nintex Apps will attempt to navigate users to any of the apps they have access to.

End users can also manually enter the URL for the app they wish to access, assuming they have access through their site permission set or an app permission set. As a builder you can facilitate end users navigating between apps by using the Go to Nintex Apps Page action with the Navigation component.

Note:  Nintex Apps admins can navigate to different apps within the Nintex Apps admin UI by clicking their name in the top right corner of the screen and hovering over My apps. However this is primarily intended for quick navigation for admins and developers—not end users.

Publishing an app to end users in an environment

An app and its pages are published to end users by configuring page URLs and user permissions. Page URLs determine where a user must go to access an app, while their permissions determine whether or not they can access the app—as well as the resources within it.

  • Page URLs can be configured from the Pages tab of the app detail screen. Click dots-vertical More Options > Configure URLs beside the page you wish to publish. For more information on page URLs, see the Setting page URLs section of the Apps topic.
  • App permission sets can be configured from the Permissions tab of the app detail screen. For more information on granting app access through permission sets, see the Permissions topic.

A high-level workflow for developing and publishing an app to end users would look similar to this:

  1. Creating and adding all necessary resources for an app—connections, files, and Nintex Apps pages.
  2. Adding any necessary app navigation within those Nintex Apps pages, for example a Navigation component that links to other pages within the app—or other apps themselves
  3. Creating app permission sets that grant access to all necessary permissions to the necessary connections of an app
  4. Assigning those permission sets to all necessary users
  5. Adding page URLs to each Nintex Apps page within the app that will be pulblished.

Once the proper permissions have been assigned, and the page URLs created, users can access their apps.

Deploying an app to another environment

Apps, and all of their associated resources, can be retrieved and deployed to other environments individually by using the deployment user interface or the command line interface (CLI).

For most deployments, we recommend utilizing the deployment user interface. For more information, see the Deployment topic.

If you are a more advanced user, the CLI provides the ability to retrieve and deploy apps with the --app flag. For more information, see the --app flag section of the CLI topic.

App Access and Profile Permissions

Once an app is created, it must then be assigned to profiles through the App Access tab. An app, and its routes/pages, cannot be accessed by any non-admin profiles until this has been done.

  1. Navigate to Settings > People > Profiles.
  2. Click Configure from the kebab menu beside the appropriate profile.
  3. Click the App Access tab
  4. Toggle the Allowed button beside the appropriate apps.

Note:  Page permissions are determined by the apps containing them, not the pages themselves. Any pages not assigned a route within an app will not be viewable by any end user without an Admin profile.

This is particularly important when working with Page Includes, as each Nintex Apps page used in the app must have an associated URL Slug even if the pages are never shown independently, i.e. outside of a Page Include component. These permission errors may manifest as empty pages or "session expired" messages.

See the user and permission management topic for more information about profiles.

Connecting Nintex Apps Pages

While app and page URLs serve as the skeleton for a Nintex Apps site's URL framework, bundling pages into an app does not mean they speak to each other. A critical concept is that a page URL is not an A->B path to a page, nor can it be used for navigation in any way. A page URL points to a specific Nintex Apps page, an "address" for that page.

App and page URLs do not provide built-in navigation nor do they send data between their Nintex Apps pages. This becomes possible, however, by creating an app navigation bar and using URL parameters.

Check out Create an App Navigation Bar, where we build the navigation bar for the app described above.