specs/routes/R_APPE

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

Edit

  • You can add assets to the asset library by uploading new images. Click the “assets” button in the Widget Bar, and then press “Upload”

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 nRegular 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 create a new Regular Step by clicking 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 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.

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 “Trash’ icon on the right side of the screen

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 clicking the “Add Placeholder” button.

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 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 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…

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

IDName
QA-T56Variable Widget : 01 - Simple variables in canvas can be changed to compound variables
QA-T57Variable Widget : 02 - Record View: Compound variables can be used with triggers
QA-T58Variable Widget : 03 - Simple variables can have their size, color, and style options modified.
QA-T59Variable widget : 04 - Compound variables can reorder, delete and restore feilds
QA-T60Variable widget : 05 - Compound variables can have their size, color, and style options modified.
QA-T61Variable widget : 06 - Magic variables can have their size, color, and style options modified.
QA-T62Variable widget : 07 - Testing variables and compound variables in app
QA-T98Record Placeholders : 00 - Load Table Records Trigger, and Table Record Widget
QA-T99Create and Load Table Record Trigger
QA-T100Record Placeholders : 00 - Table Data Tab
QA-T102Record Placeholders : 00 - Add a record placeholder to an app
QA-T103Record Placeholders : 00 - Edit a record placeholder in an app
QA-T104Record Placeholders : 00 - View the table for a record placeholder
QA-T106Signature Step : 01 - A signature form can be created
QA-T107Signature Step : 02 - Signature widgets cannot be deleted from a signature form step and additional ones cannot be created
QA-T108Signature Step : 03 - Signature form should allow any user to submit it when configured so
QA-T109Signature Step : 04 - Signature form should allow only the current user to submit it when configured so
QA-T110Signature Step : 05 - Signature forms should only be submittable a single time per process run
QA-T116Machine Monitoring : 06 - Machine Outputs
QA-T134Record Placeholders : 00 - Delete Record Placeholder
QA-T153Widgets - Photo Form Input Widget
QA-T157Widgets - Boolean Input Widget
QA-T160App Editor Misc - Verify Keyboard Shortcuts Work
QA-T183Triggers - Print Using System Dialog Trigger
QA-T208Analytics Widget
QA-T234Variable Widget : 08 - Table Records Can be Styled
QA-T241Embedded Tables : 00 - Embed a Tulip Table in an app
QA-T242Embedded Tables : 00 - Sort an embedded table
QA-T243Embedded Tables : 00 - Connect an embedded Tulip Table to a Table record
QA-T244Embedded Tables : 00 - Filter an embedded table
QA-T245Embedded Tables : 00 - Handle deleted fields in embedded tables
QA-T246Embedded Tables : 00 - Handle a Tulip Table change in an embedded table
QA-T257Machine Monitoring : 07 - Machine Widgets
QA-T258Machine Monitoring : 08 - App Triggers For Machines
QA-T267User Roles : 08 - Viewers should be unable to modify data in Tulip
QA-T280Filter an embedded app analysis
QA-T281Filter an embedded machine analysis
QA-T338Widgets - Shapes Widget (and aesthetic changes)
QA-T339Widgets - Text Widget
QA-T340Widgets - Button Widget
QA-T341Widgets - Image Widget
QA-T342Widgets - Video Widget
QA-T343Widgets - Document Widget
QA-T344Widgets - Webpage Widget
QA-T345Widgets - Timer Widget
QA-T346Form Step - Create Form Step
QA-T347Form Step - Running the Form Step
QA-T348Master Layout - Master Layout
QA-T350App Editor Misc - Comments
QA-T351App Editor Misc - Step Overload
QA-T396Widgets - Digital History Record Widget
QA-T399Table Links : 03 - Linking Records via App Triggers
QA-T411App Editor Misc - Apps can be worked on in Parallel