Skip to main content

App Builder User Interface

Note

App Builder is a new and evolving product available with the Alteryx Analytics Cloud Platform. Functionality is subject to change without notice as we continue to refine and enhance your experience. We appreciate your understanding and welcome your feedback on Alteryx Community as we continue to improve App Builder!

The App Builder user interface consists of the Orchestrate and Design canvases, where you can access tools and components to build and design your app.

App Builder Canvas

The App Builder canvas is the area where you build your app. An app consists of a data flow, or a series of tools and variables, and both static and interactive components that are combined to create an interactive web application. App Builder is broken out into 2 separate canvases: Orchestrate and Design.

  • Orchestrate: Integrate your data and add tools and variables, which then become available to add to your app.

  • Design: Edit and design the app itself. Add tools and variables from your orchestration, add visual components like headings and images, and change the colors of the elements in the app.

App Builder Interactive Results Grid

View your data in App Builder in the Interactive Results Grid, located below the canvas. To view data, select a tool or anchor in the data flow. The data from the tool or anchor is displayed in the Results Grid.

Tool Messages

To view messages about your data flow tools:

  1. Select a tool on the canvas.

  2. In the Results Grid, select Messages to access the message view.

  3. Select a message type.

Each message displays the name of a tool and the tool ID in parentheses. Each tool in the data flow, including tools that have been removed, is numbered. Tool ID indicates the tool number in the data flow. Select the link to the tool name in a message to select the tool in the data flow.

Message Types

The Results Grid displays 2 message types:

  1. Warning: Warnings do not cause data flow failure, but you should review them.

  2. Error: A tool was not configured correctly.

Keyboard Shortcuts in App Builder

Use the keyboard to navigate and make changes to apps in App Builder.

PC Shortcuts

Action

Shortcut

Save

Alt + S

Undo

Ctrl + Z

Redo

Ctrl + Y

Mac Shortcuts

Action

Shortcut

Save

Ctrl + S

Undo

⌘ + Z

Redo

⌘ + Y

Rename App

To rename your app, select the textbox with your app's current name, then enter a new name. Select the Enter key to save your new name.

Change Device View

To see how your app looks on different devices, select the screen icon, then select a device. The canvas size will change to match your selected device. To edit the device settings, select Canvas Settings from the Edit menu.

Preview App

To see a preview of what your app looks like to customers, select the eye icon preview-icon.png. Your app will open in a new browser tab.

Share App

To share your app with someone in your workspace, select the share icon share-icon.png. If this app has been published, select which version of your app to share. You can either share your app as an embeddable iframe HTML tag or as a link. Select the copy icon next to your selected sharing method to copy the tag or link. Interacting with shared apps requires access to all related assets using the Library.

Application Publishing

App Creators can now publish an app to indicate it is ready for others to use. Changes to the app can be made, tested, and reviewed with others before publishing or republishing the app.

Publish an App from Sandbox

A Creator in App Builder is able to develop Sandbox apps and promote a completed app to a published state. Saved changes made in Sandbox apps do not appear in the published app until they are published.

  1. To publish an app for the first time, select Publish to open the publishing dialog.

  2. Optionally, enter a Customized Path for your app. The custom path updates both the sharing link and the iFrame URL link. Changes made to the custom path are saved within your app.

    Note

    The Customized Path can only be changed by unpublishing and republishing an app.

  3. Select Publish to publish your app.

Republish an App

Republishing an app overrides the current version of the app in production. To republish an app, select Publish to open the publishing dialog. The last date and time your app was saved is shown for reference. Note that you can't change the Customized Path unless you unpublish your app. Select Publish to republish your app.

Unpublish an App

To unpublish an app, select Unpublish from the File menu. Select Unpublish from the dialog to confirm you want to unpublish the app.