App Editor

Overview

The App Editor allows you to create, view, and edit app versions. These app versions can be created in real-time by multiple Tulip users.

An app version is a series of steps, or screens of content, that can be used by an operator running the Tulip Player on a desktop, tablet or mobile phone.

After an app version is published, it is immediately available to all devices that are allowed to run the “latest published version” of an app.

Model/Page Connections

Color Palette

View

• When a user attempts to edit a Color variable or any widget with color options, they will see all colors from the Color Palette

App Version

Edit

• The App Editor’s primary purpose is editing an app’s “development” version. Almost every button on the screen will allow you to change the app version by modifying the Models within that app version.

View

• You can view the entire app version by clicking each step on the left side of the screen

Create

• A new version of the app can be “published”, or created, by pressing the “Publish” button in the top right corner of the screen.

Analysis

View

• A user can view the live version of an Analysis by looking at an Analysis that is embedded in a Step
• A user can view all Analyses across all apps from the Embedded Analysis Widget

Step Group

Create

• A user can create a new Step Group by clicking the “Add” button in the top left of the screen and choosing Step Group

Edit

• A user can edit a step group by dragging new steps underneath it in the list on the left side of the screen
• A user can edit the name of the step group by double clicking the name on the left side of the screen

View

• A user can view all step groups within the app version by scrolling through the list of steps and step groups on the left side of the screen

Delete

• A step group can be deleted by selecting the Step Group on the left side of the screen, then pressing the “Trash’ icon on the right side of the screen

Asset Library

The asset library is a library of static shapes that can be added to an app as an aid to the operator.

View

• You can view the Asset Library by clicking the “Assets” button at the top of the screen in the Widget Bar.

Regular Step

Create

• A user can create a new Regular Step by clicking the “Add” button in the top right of the screen and choosing Step
• A user can create a new Regular Step by clicking the Step in the list on the left side of the screen and then pressing “Enter”.
• A user can copy a Regular Step by clicking Step in the list on the left side of the screen and then pressing the “gear” icon on the right side of the screen within the Context Pane and then choosing "Copy Step"

Edit

• A step contains a series of Widgets. A user can edit the widgets on the step by selecting the Step from the list on the left side of the screen.
• A user can edit the details of the step in the panel on the right side of the screen after selecting the step. It can also change its relationship to the content on the "Master Layout" template within the app.

View

• A user can view all Regular Steps within the app version by scrolling through the list of steps and step groups on the left side of the screen

Delete

• A Regular Step can be deleted by selecting the step on the left side of the screen, then pressing the “gear’ icon on the right side of the screen and choosing "Delete Step"

Form Step

Create

• A user can create a new Form Step by clicking the “Add” button in the top right of the screen and choosing Form Step
• A user can create a new Form Step by clicking the Form Step in the list on the left side of the screen and then pressing the “Duplicate” icon on the right side of the screen

Edit

• A step contains a series of Widgets. A user can edit the widgets on the step after selecting the Step from the list on the left side of the screen.
• A user can edit the details of the step in the panel on the right side of the screen after selecting the step.

View

• A user can view all Form Steps within the app version by scrolling through the list of steps and step groups on the left side of the screen

Delete

• A Form Step can be deleted by selecting the step on the left side of the screen, then pressing the “Trash’ icon on the right side of the screen

Approval Step

Create

• Approval Steps are only available on “Enterprise” plans
• A user can create a new Approval Step by clicking the “Add” button in the top right of the screen and choosing Signature Form
• A user can create a new Approval Step by clicking the Signature Form in the list on the left side of the screen and then pressing the “Duplicate” icon on the right side of the screen

Edit

• A step contains a series of Widgets. A user can edit the widgets on the step after selecting the Step from the list on the left side of the screen.
• A user can edit the details of the step in the panel on the right side of the screen after selecting the step.

View

• A user can view all Approval Steps within the app version by scrolling through the list of steps and step groups on the left side of the screen

Delete

• An Approval Step can be deleted by selecting the step on the left side of the screen, then pressing the “Trash’ icon on the right side of the screen

Widget

Create

• A widget can be created by selecting any icon from the “Widget Bar” at the top of the screen, and then clicking a widget from the menu that appears. This will automatically add the widget to the step.

Edit

• After adding a widget to a step, a user can click the widget. A series of customization options will appear on the right side of the screen.
• A widget can be resized by dragging any of the corners after it is embedded on the step.

View

• When a user is viewing a specific step, all widgets on that step will be displayed.

Delete

• A widget can be deleted by clicking the widget and then pressing “Delete” on the keyboard.
• A widget can be deleted by clicking the widget and then pressing the “Trash” icon that appears on the right side of the screen.

Variable

Create

• A variable can be created via the “Variable” dropdown on the right side of the screen, which appears in a variety of widgets
• A variable can be created by clicking the “App” menu on the right side of the screen, then choosing the “Variables” option from the resulting options. After that, a variable can be created using the text field at the top of the menu that appears.

Edit

• A variable can be edited by clicking the “App” menu on the right side of the screen, then choosing the “Variables” option from the resulting options. After that, a list of variables in the app version will be shown. A user can click any name of a variable to edit the name.
• A user can edit the “default value” using the “Default Value” column in the screen above.

View

• A list of all variables in the app version can be viewed by clicking the “App” menu on the right side of the screen, then choosing the “Variables” option from the resulting options.

Delete

• A variable can be deleted when it is not included in any triggers. A user can press the “Trash icon next to the variable on the right side of the Variables screen to delete it.

Record Placeholder

Create

• A user can create a Record Placeholder by selecting the “Records” tab on the left side of the screen and then choosing a specific table. Then, they can click the "+" button next to the “Record Placeholder” title.

Edit

• After a Record Placeholder has been created, a user can edit the name by clicking the name of the Record Placeholder from the list of Record Placeholders in the “Records” tab on the left side of the screen.

View

• A user can view all Record Placeholders under the “Records” tab on the left side of the screen.

Delete

• A Record Placeholder can be deleted after it is not referenced in any triggers. To delete the Record Placeholder, click its name and then choose the “Delete” button from the resulting menu.

Table Query Placeholder

Create

• A user can create a Table Query Placeholder by selecting the “Records” tab on the left side of the screen and then choosing a specific table. Then, they can click the "+" button next to the “Query” title.

Edit

• After a Table Query Placeholder has been created, a user can edit the name by clicking the name of the Query Placeholder from the list of Query Placeholders in the “Records” tab on the left side of the screen.

View

• A user can view all Query Placeholders under the “Records” tab on the left side of the screen.

Delete

• A Query Placeholder can be deleted after it is not referenced in any triggers. To delete the Query Placeholder, click its name and then choose the “Delete” button from the resulting menu.

Table Aggregation Instance

Create

• A user can create a Table Aggregation Instance by selecting the “Records” tab on the left side of the screen and then choosing a specific table. Then, they must add a preexisting Table Query as a Table Query Placeholder. Then, they can click the "+Add Aggregation" button to add an aggregation to that Query Placeholder.

Edit

• After a Table Aggregation Instance has been created, a user can edit the name by clicking the name of the Aggregation Instance in the “Records” tab on the left side of the screen.

View

• A user can view all Aggregation Instances related to each Table Query Placeholder under the “Records” tab on the left side of the screen.

Delete

• An Aggregation Instance can be deleted after it is not referenced in any triggers. To delete the Aggregation Instance, click its name and then choose the “Delete” button from the resulting menu.

Table Record

View

• A Table Record can be viewed by selecting the “Embedded Table” widget under the “Embed” option in the “Widget Bar”. Then, after choosing a Table and the relevant Table Fields from the menu on the right side of the screen, a user can see all records from the Table.

Table Fields

View

• Table Fields can be viewed by selecting the “Embedded Tulip Table” widget under the “Embed” option in the “Widget Bar”. Then, after choosing a Table, a user can see all Table Fields for that Table in the dropdown under the “Columns” label.

Triggers

Create

• A trigger can be created by clicking on a Button Widget that is already available on a step, and then pressing the “+” button next to the “Triggers” label on the right side of the screen.
• A trigger can be created by clicking on the “Step” tab on the left side of the screen, and then clicking “Add” next to any of the trigger types listed.
• A trigger can be “copied” by pressing the “duplicate” icon next to the trigger name. This will copy the trigger from the step or widget and add it to your computer’s clipboard.

Edit

• A trigger can be edited by clicking on an existing trigger listed in either the “Widget” or “Step” tab on the right side of the screen.
• A trigger can be “cut’ by pressing the “scissors” icon next to the trigger name. This will remove the trigger from the step or widget and add it to your computer’s clipboard.

View

• Triggers are attached to either steps or individual widgets. You can see a list of all attached triggers by clicking the step or button, and then viewing the list of triggers that appears on the right side of the screen.

Pages

The following Pages are related to managing apps:

• App overview
• App dashboard
• App versions
• App completions
• App permissions
• App approvals

The following pages can be accessed at the top of the page for the purpose of testing apps:

• Tulip Player
• Developer Mode

User Permissions

App editing permissions may be restricted by the app creator, the user who originally created the app. The rules around restricting app editing are described in App Permissions.

Tests

Requirements