App Designer
Use the App Designer to configure your app, design its pages, and manage its assets in a single, unified workspace.
The Elements panel provides quick access to all app assets, including pages, connections, tables, workflows, documents, files, permissions, user access, and app settings. The Configuration panel allows you to configure each asset directly within the designer.
Access the App Designer
-
In the navigation bar, click Apps.
-
Select an app from the apps list.
Navigate the App Designer
Elements panel
The Elements panel is on the left side of the App Designer. It displays all app assets, which you can select to configure and manage your app.
-
Pages: Create and manage the pages in your app. For more information, see Pages page.
-
Connections: Set up and manage connections to pass data between pages in your tenant and connectors. For more information, see Connections page.
-
Tables: Create and manage tables used as data sources for apps and process-related data. For more information, see Tables page.
-
Workflows: Create and manage workflows for your app. For more information, see Workflows page.
-
Documents: Create and manage documents for your app. For more information, see Documents page.
-
Files: Add and manage files for your app. For more information, see Files page.
-
Permissions: Create and manage permission sets that determine user access for the app and its data. For more information, see Permissions page.
-
User access: View the users and groups that can access the app. For more information, see User access page.
-
App settings: Manage app settings, including the app name, URL, and Design system. For more information, see App settings page.
Configuration panel
The Configuration panel is on the right side of the App Designer. It displays all items related to the asset selected in the Elements panel. You can view, edit, or configure each item's properties.
Pages page
The Pages page displays the list of pages that reside in an app. On this page, you can:
-
Use the search field.
-
Select the page you want to edit in the list.
This opens the page in the Page Designer. To return to the Pages page, click the app name in the top-left.
-
Click
next to the page you want to manage or right-click the page.-
Open: Click to open the page in the Page Designer.
-
Settings: Click to open the Page settings.
-
View XML: Click to view the XML version of the page.
-
Preview: Click to preview the page at runtime.
-
Clone: Click to create a duplicate of the current page.
-
Delete: Click to delete the page.
Note:In Nintex Apps, dependency mechanisms ensure that included pages cannot be deleted until all references to them within container pages are removed. For more information, see Page Include.
When a page is included in other pages using the Page Include component, the Pages page in the App Designer and the All Pages tab display a visual indicator that shows how many pages include it. To view the container pages, click the visual indicator link.
-
-
Click Create a page. For more information, see Create and customize pages.
This option is available only for legacy sites that have pages not associated with an app.
-
Click Add a page.
-
In the Add pages to the app dialog, select the pages you want to add.
-
Click Add.
Page settings
-
Page name: The name of the page.
-
Page title: The title that appears on the browser tab.
-
Page URL: The web address end users visit to access a Nintex Apps page. It is a combination of the app's URL and one or more URL path elements.
To access more page URL options, click
:-
Edit: Click to edit the page URL.
-
Go to URL: Click to open the page URL in your browser.
-
Disable: Click to disable the URL.
-
Delete: Click to delete the URL.
Note:Page URLs are automatically enabled when they are added.
For more information, see Set page URLs.
-
-
Add URL: Click to add a URL.
-
API version: Displays the API version that the page is built on. For more information, see API Versioning in Nintex Apps.
-
Design system: The name of the design system that determines the styling applied to the page. For more information, see Design system.
-
Max unnamed revisions: Limits the number of unnamed revisions that are created each time a Nintex Apps page is saved. Once the limit is reached, the oldest unnamed revisions are deleted first. For more information, see Page revisions.
-
Personalization mode: Determines where user personalizations, such as selected tabs and filter values, are stored.
-
Client-side: Use for non-authenticated users, such as visitors to a public-facing website, community, or portal.
Note: Even if server-side is chosen for the page, non-authenticated users are defaulted to client-side storage for personalizations.
-
Server-side: (Default) Allows user personalizations to sync across multiple devices.
-
-
Unsaved changes warning: To display a warning when a user attempts to close the page with unsaved changes, turn on the toggle.
-
Available as principal page: To set the page as the principal page, turn on the toggle. For more information, see Principal and dependent pages.
-
Make this the home page: Click to the set the page as the home page.
Connections page
The Connections page displays the list of connections used in an app. On this page, you can:
-
Use the search field.
-
Select the connection you want to edit in the list. For more information, see Connections.
- Click
next to the connection you want to manage or right-click the connection:- Go to connection: Click to edit the connection.
- Remove: Click to remove the connection. This does not delete the connection; it only removes it from the app.
-
Click Create a connection. For more information, see Connections.
-
Click Add a connection.
-
In the Add connections to app dialog, select the connections you want to add.
-
Click Add.
Tables page
The Tables page displays the list of tables used in an app. On this page, you can:
-
Use the search field.
-
Select the table you want to edit in the list. For more information, see Tables.
- Click
next to the table you want to manage or right-click the table:- Go to table: Click to edit the table.
- Remove: Click to remove the table. This does not delete the table; it only removes it from the app.
-
Click Create a table. For more information, see Tables.
-
Click Add a table.
-
In the Add tables to app dialog, select the tables you want to add.
-
Click Add.
Workflows page
The Workflows page displays the list of workflows used in an app. On this page, you can:
-
Use the search field.
-
Select the workflow you want to edit in the list. For more information, see Workflows.
- Click
next to the workflow you want to manage or right-click the workflow:- Go to workflow: Click to edit the workflow.
- Remove: Click to remove the workflow. This does not delete the workflow; it only removes it from the app.
-
Click Create a workflow. For more information, see Workflows.
-
Click Add a workflow.
-
In the Add workflows to app dialog, select the workflows you want to add.
-
Click Add.
Documents page
The Documents page displays the list of documents used in an app. On this page, you can:
-
Use the search field.
-
Select the document you want to edit in the list. For more information, see Documents.
- Click
next to the document you want to manage or right-click the document:- Open: Click to edit the document.
- Remove: Click to remove the document. This does not delete the document; it only removes it from the app.
-
Click Create a document. For more information, see Documents.
-
Click Add a document.
-
In the Add documents to app dialog, select the documents you want to add.
-
Click Add.
Files page
The Files page displays the list of files used in an app. On this page, you can:
-
Use the search field.
-
Select the file you want to edit in the list. On the file detail page, you can configure the following:
-
File name: Displays the file name.
-
Description: Displays the file description.
-
Visibility: Select one of the following options:
-
Public: Allows access to the file for non-authenticated users.
-
Private: Restricts access to the file to authenticated users only.
-
-
-
Click
next to the file you want to manage or right-click the file:-
Configure: Click to configure the file properties.
-
Download: Click to download.
-
Remove: Click to remove the file. This does not delete the file; it only removes it from the app.
-
Preview: Click to view the file in a new browser tab.
-
- Click Upload a file.
- In the file selection dialog, select the file you want to add.
- Click Open.
- Click Add a file.
- In the Add files to app dialog, select the files you want to add.
- Click Add.
Permissions page
The Permissions page displays the list of permissions sets created for the app. On this page, you can:
-
Use the search field.
-
Select the permission set you want to edit in the list. For more information, see Permissions in Nintex Apps.
-
Click
next to the permission set you want to delete. -
Click Delete.
You cannot delete a permission set until it has been unassigned from all users.
-
Click Create a permission set.
-
In the Name field, type a unique name for the permission set.
-
In the Description field, type a description that ensures quick and easy permission identification and assignment.
-
Click Done.
-
Under the Connection access tab, for each connection you want the permission set to have access to, turn on the toggle.
Note:If a connection does not appear in the list, ensure it has been added as an app resource. For more information, see Connections page.
To configure app-level Create, Read, Update, and Delete (CRUD) permissions for objects such as SQL and Nintex Data, click Edit. For more information, see Configure app-level CRUD permissions for objects.
-
Click Save.
These steps apply only to connections that support object-level permissions, such as SQL and Nintex Data.
-
Select the permission set you want to configure or click
next to it and click Configure. -
Under the Connection access tab, next to the connection for which you want to configure the CRUD permissions for objects, click Edit.
-
In the Objects panel on the left, select an object.
-
Select one of the following permission types:
-
Basic: All fields in the object inherit the same permissions.
-
Advanced: Field permissions are set individually. Select this option if you need granular control over specific fields.
-
-
Select the object permissions you want to apply:
-
Allow all: Allows create, read, update, and delete.
-
Create: Allows create only.
-
Read: Allows read only.
-
Update: Allows update only.
-
Delete: Allows delete only.
-
-
Set field permissions:
Note:This option is available only for the Advanced permission type. When Advanced is selected, field-level permissions only show Create, Read, and Update. Delete does not appear at the field level.
-
Select the fields you want to configure individually.
-
Click Update selected rows.
-
Confirm your selection and click Apply.
-
-
Next to each connection object condition you want to enable for the permission set, turn on the Always on toggle.
For example, you can create a condition on a Created by field using a Nintex Apps user attribute and enforce it on Query to ensure each user only sees records created by that user. For more information, see Conditions.
Note:This option appears only when you have configured at least one connection object condition. For more information, see Connections.
-
Click Done.
-
Select the permission set you want to assign to users or groups, or click
next to it and click Configure. -
Click the User access tab.
-
To assign:
-
Groups:
-
Click Assign groups.
-
In the Assign groups to permission set dialog, select the groups you want to assign the permission to.
-
Click Assign.
-
-
Users:
-
Click Assign users.
-
In the Assign users to permission set dialog, select the users you want to assign the permission to.
-
Click Assign.
-
-
-
Select the permission set you want to unassign users or groups from, or click
next to it and click Configure. -
Click the User access tab.
-
Click
next to the users or groups you want to unassign. -
Click Save.
To add or delete a group, go to the User Management tab in Nintex Workflow. For more information, see User Management.
You can configure public (unauthenticated) user permissions by enabling the standard public access permission set on any app. This setup allows public users to access the app at runtime without logging in.
You cannot add public users to custom app permission sets. Manage all public access using the public access permission set.
-
Click Configure public access.
-
Click Enable public access.
-
Next to each connection you want public users to access, turn on the toggle.
-
Click Save.
The public access permission set is added to the Permissions page.
Disabling the public access permission set prevents unauthenticated users from accessing the app at runtime.
You can disable the public access permission set using the following options:
-
Click Configure public access > Disable public access > Disable.
-
Click
next to the public access permission set and click Configure > Disable public access > Disable.
User access page
The User access page displays separate lists of users and groups that have access to the app. On this page, you can:
-
Use the search field.
-
Click
next to the user you want to manage or right-click the user:- Manage user access: Click to view the user's permission sets.
In the user details page, click
next to the permission set you want to view. For more information, see Permissions in Nintex Apps.To view the user profile, click Go to user. For more information, see User Management.
-
Go to user: Click to view the user profile.
- Manage user access: Click to view the user's permission sets.
App settings page
In the App settings page, you can view and edit the following:
-
Name: Displays the app name.
-
App URL: Displays the app URL. You can edit the URL if needed. For more information, see Apps.
-
Design system: Displays the app's design system.
To update, select the design system you want from the drop-down. For more information, see Design system.