specs/models/M_APP_VER_VAR
Variable
Widgets and triggers utilize variables of specific types to determine user interaction and application flow. There are three categories of variables in apps:
- Primitive - a single value such as integer, text, or user
- Custom object - a variable with named attributes, each of which is a primitive
- Array - an ordered list in which every item is of the same type. The type can be either a primitive or a custom object.
The primitive variable types in apps:
| Variable Type | Description |
|---|---|
| Boolean | a true or false value |
| Color | a value that encodes the standard RGBA standard used in web apps |
| Number | a numeric value that can have a decimal value. Max value: 9007199254740991 |
| Image URL | Link to an image in Tulip, which is stored by cloud provider. Max file size: 20MB. Max URL length: 2048 characters. |
| Integer | A numeric value that cannot have decimal values. Max value: 9007199254740991 |
| Interval | A duration in time saved in milliseconds. Max value: 7730941132799 seconds |
| Text | Sequence of characters. Max size: 2.5kB in Tulip Tables; 50kB in other case. Truncated to 600 characters for analytics. |
| User | A user in the Tulip system. The user model includes custom fields (see 09 People Management) |
| Datetime | A specific date, time and timezone. |
| Station | A station where an app is used, as determined by the "Stations" page |
| Machine | A Machine that was outputting data as defined on the Machine Details page. |
| Object | A general purpose, complex object with properties defined by the user. |
| File | Link to a file, which can be stored on our cloud provider. Max file size: 200MB for mp4 videos, 50MB for all other file types Max URL length: 2048 characters. |
Furthermore, each variable type can also be saved as an array of that type, for example 'Boolean array' or 'Color array'.
Fields
| Name | Description |
|---|---|
| Name | User defined name of the Variable |
| Type | Data Type, chosen from the supported list of types. |
| Default Value | The value that will be assigned to a variable when an App first starts. |
| Where Used | The Widgets, Triggers and/or Steps where a Variable is used within the App. |
| Save for Analysis | Save this Variable with each Completion for later use in Analytics. Value will not be saved when disabled or after "Complete and Go To Splash Screen" action. |
| Clear on Completions | Reset Variable to default value after each Completion. The Variable will not be reset after a Completion when this option is disabled. |
Tests
| ID | Name |
|---|---|
| QA-T56 | Variable Widget : 01 - Simple variables in canvas can be changed to compound variables |
| QA-T57 | Variable Widget : 02 - Record View: Compound variables can be used with triggers |
| QA-T157 | Input Widgets : 01 - Boolean widget |
| QA-T458 | Variable modal : 01 - Create and modify a variable |
| QA-T459 | Variable modal : 02 - Variables need to have unique names |
| QA-T460 | Variable modal : 03 - Managing variables created within the app |
| QA-T461 | Variable modal : 04 - Variable's parameters |
| QA-T462 | Variable modal : 05 - Managing variables on the modal |
| QA-T463 | Variable modal : 06 - Deleting variables |
| QA-T477 | Input Widgets : 02 - Text widget |
| QA-T478 | Input Widgets : 03 - Number widget |
| QA-T479 | Input Widgets : 04 - Single Select widget |
| QA-T480 | Input Widgets : 05 - Multiselect widget |
| QA-T481 | Input Widgets : 06 - Date picker widget |
| QA-T482 | Input Widgets : 07 - Image widget |
| QA-T513 | Timer Widget : 02 - Target Time Configuration |
| QA-T568 | Dev Mode - Variables and Table Records |
| QA-T707 | Variable modal : 07 - Save for Analysis in Development Mode |
| QA-T763 | Signature Widget : 01 - Signature widget configuration |
| QA-T827 | Signature Widget : 02 - Signee options and variables |
| QA-T828 | Signature Widget : 02 / Signee options and mandatory features |
| QA-T829 | Signature Widget : 03 - Signing in LDAP, SAML |
| QA-T830 | Signature Widget : 03 / Denied signing in LDAP, SAML |
| QA-T839 | Input Widgets : 09 - Input Widget Labels |
| QA-T938 | App Export/Import : 02 - Widgets are Imported and Function |
Requirements
No requirements