Product Specs
This page provides a description as to how the Tulip product functional works and is designed. It is organized into the sections as described below.
System Overview - These describe how Tulip can be configured at the account level, and provide necessary domain information for understanding Tulip concepts.
Routes - Describe the specific views that present a user interface that is served by the admin console that let users CRUD (create, read, update and delete) specific types of data models, and relationships between models, given the appropriate access rights. The documentation of the routes effectively describes how one can use Tulip to created, edit and deploy Tulip solutions.
Models - Describe the digital objects that make up a Tulip solution. Models and attributes that are wholly contained within another model, or are only important in the context of that model, are documented in a nested format with respect to that model.
Beta: Use of Beta Features offered by Tulip is optional and is at your sole risk. Due to the unproven nature of Beta versions, they are provided “as is,” “as available,” and without warranty. This means that any warranties, indemnities and other obligations of Tulip under any terms of service or MSA do not apply to Beta Versions. Once this feature comes off Beta for full release, a new release note will communicate this and the Beta tag will be removed from the relevant Product Specification.
System Overview
| ID | Name | Description |
|---|---|---|
| S_WORKSPACE | Workspace | An organizational unit in Tulip used to segregate users, settings and resources. |
| S_PLAYER | Tulip Player | The downloadable application used to run Tulip apps |
| S_EDGE_DEVICE | Edge Device | A description of Tulip's Hardware products |
| S_DESCR | The Tulip Platform | High level description of Tulip |
| S_DATA | Data Management | Overview of the systems & technologies Tulip uses |
| S_AUTH | Enterprise Authentication | Specification of enterprise authentication configurations |
| S_AUDIT | Application Audit Trail | A description of how Tulip creates an audit trail. |
Routes
| ID | Name | Description |
|---|---|---|
| R_WUSPR | Workspace User Profile | An interface for managing a user from the account settings when `workspaces` is enabled |
| R_WIDGET_EDITOR | Widget Editor | An interface for editing a Custom Widget |
| R_USRM | Profile | An interface for managing one's own user profile |
| R_USPR | User Profile | An interface for editing a user's profile and access rights |
| R_TBLS | Tables | An interface for managing Tulip Tables |
| R_TBLQ | Table Query Editor | An interface for editing all parts of a Table Query |
| R_TBLE | Table Editor | An interface for editing the schema and content of a single Tulip Table. |
| R_SWRK | Settings - Working Days | A configuration that determines the active working days for the account |
| R_SWORKSPACE | Settings - Workspace | An interface for managing workspace settings |
| R_SUSR | Settings - Users | An interface for managing users |
| R_STAT | Station | An interface for managing a station |
| R_SWRK | Settings - Working Days | A configuration that determines the active working days for the account |
| R_SROL | Settings - Roles | An interface for managing roles |
| R_SPLS | Settings - Player | An interface for managing all player settings in the account |
| R_SEDU | Settings - Edge Devices | An interface for managing the Edge Device update settings for the account |
| R_SDAT | Settings - Date and Time | An interface for managing the date and time settings |
| R_SCONN | Settings - Connectors | An interface for managing Developer Mode settings and impact of connector configuration changes on published apps |
| R_SCOL | Settings - Color Palette | An interface for managing the color palette for the account |
| R_SAPT | Settings - Approval Types | An interface for managing the account types available in the account |
| R_SAML | Settings - SAML Setup | An interface for managing the integration between the Tulip account and the user's SAML directory |
| R_SACC | Settings - Account | An interface for managing account settings |
| R_PLAYER_MENU | Tulip Player Menu | An interface for viewing and editing app permissions |
| R_NTWK | Settings - Network Access | An interface for managing the IP addresses and CIDR blocks that are allowed to use this account |
| R_MTYPS | Machine Types | View a list of all machine types |
| R_MTYP_DET | Machine Type Details | View and configure a machine type |
| R_MSTS | Machine States | The page for viewing a list of machine states |
| R_MLIB | Machine Library | View a list of all machines |
| R_MFLD | Machine Activity Fields | The page for viewing a list of machine activity fields |
| R_MENU | Menu Bar | A universal navigation bar across all routes in Tulip |
| R_MDTS | Machine Data Sources | An interface for managing machine data sources. |
| R_MDTR | Machine Downtime Reasons | View a list of all downtime reasons |
| R_MDET | Machine Details | View and configure a machine |
| R_MATT | Machine Attributes | The page for viewing a list of machine attributes |
| R_HIST | Activity History | The page for viewing a timeline of activity records |
| R_EDGE_DEVICES_PAGE | Edge Devices Page | An interface for managing Tulip Edge Devices |
| R_EDGE_DEVICE_PORTAL | Edge Device Portal | The web based interface for configuring an Tulip Edge Device |
| R_DISPDEV | Display Devices | An interface for managing Display Devices, including registration via shareable links. |
| R_DEVM | Developer Mode | The testing experience for using the Developer Version of any app |
| R_DETECTORS | Detectors | The page for viewing a list of Detectors |
| R_DETECTOR | Detector | The page for editing a vision detector |
| R_DASH | Dashboard | An interface for viewing and editing the Dashboard model |
| R_CONNS | Connectors | The page for managing connectors |
| R_CONN | Connector | The page for managing a single connector |
| R_CONN_FUNC | Connector Function Editor | The page for editing a connector function |
| R_CAM_CONFIGS | Camera Configurations | The page for viewing a list of camera configurations |
| R_CAM_CONFIG | Camera Configuration | The page for editing a camera configuration |
| R_AUTOMATIONS | Automations Page | (Beta) A view of available automations |
| R_AUTOMATIONS_VERSIONS | Automations Versions Page | (Beta) A view of a specifc automation's versions |
| R_AUTOMATIONS_RUNS | Automations Run History Page | (Beta) A view of an automation's runs |
| R_AUTOMATIONS_EDITOR | Automations Editor Page | (Beta) A view of an automation's development version |
| R_AUSG | Account Usage Page | An interface for tracking usage of the Tulip Product |
| R_APPV | App Versions | An interface for viewing and managing the versions for an app |
| R_APPP | App Permissions | An interface for viewing and editing app permissions |
| R_APPO | App Overview | A view of app structure and metadata app |
| R_APPG | App Group | An interface for managing an app group |
| R_APPE | App Editor | An interface for editing the layout and logic of an app |
| R_APPD | App Dashboard | A page for seeing the dashboard of all analyses for an app |
| R_APPCM | App Creation Modal | An interface for creating a new application |
| R_APPC | App Completions | An interface for viewing and exporing the completion data for anapp |
| R_APPA | App Approvals | An interface for managing approval assignment for an app |
| R_APIT | Settings - API Tokens | An interface for managing the credentials that are allowed to access the Tulip API on this account |
| R_ANYS | Analysis | A full page view of an analysis |
| R_ANYE | Analytics Editor | An interface for creating and editing analyses |
Models
| ID | Name | Description |
|---|---|---|
| M_WORKSPACE | Workspace | An organizational unit used to manage and control content within a Tulip Account. |
| M_USER | User | A digital record for a person granted some level of access to the Tulip System |
| M_USER_STATUS | User Status | The current state of a user with respect to the system |
| M_USER_ROLE | User Role | A named collection of specific access rights that can be assigned to a user |
| M_USER_FIELD | User Field | A custom attribute applied to the user model |
| M_TRIG | Triggers | User defined actions performed in response to events in the Tulip system. |
| M_TABLE | Table | A user defined database that easily integrates with Tulip apps. |
| M_TABLE_RECORD | Table Record | A row in a Tulip Table |
| M_TABLE_RECORD_FIELD | Table Record Field | A property for each object in the table. Sometimes called a column. |
| M_TABLE_QUERY | Table Query | A collection of Table Records that can be changed based on values in an app |
| M_TABLE_AGGREGATION | Table Aggregation | A summary value that can exist on top of a single field of a Table Query. |
| M_STAT | Station | A configuration that connects a specific Tulip player to machines and devices |
| M_STAG | Station Group | A group of stations |
| M_PLAYER_DEVICE_MAP | Player Device Mapping | The technical details of a device that can be used in the Tulip Player |
| M_NODERED_NODES | Node-RED Tulip Nodes | A custom Node RED node for Tulip hardware |
| M_MULTILINGUAL_APPS | Multilingual Apps | Manually translate text within Tulip apps into multiple languages |
| M_MTYP | Machine Type | A rule set used to define the behavior of a Machine |
| M_MTRIG | Machine Triggers | If/Then logic for defining the state of a machine and other machine fields. |
| M_MSTS | Machine State | A category for the current status of a Machine |
| M_MFLD | Machine Activity Field | A field or column in a machine activity table. |
| M_MDTS | Machine Data Source | A connection to data generated by a physical machine |
| M_MDTR | Machine Downtime Reason | A data type used to classify downtime events for Machines |
| M_MATT | Machine Attribute | A unit of data for mapping between raw data and a Machine |
| M_MACH | Machine | A digital twin of equipment that generates data. |
| M_MACH_MACT | Machine Activity | A running history of state details for a machine |
| M_EXPRESSION | Expressions | A configured code snippet that returns a calculated value based on certain inputs |
| M_DISPLAY_DEVICE | Display Device | The physical Display Device running the Tulip Player. |
| M_DETECTOR | Vision Detector | The definition of how objects are detected by Camera Configurations. |
| M_DASH | Dashboard | A column based layout for seeing a collection of analyses |
| M_CUSTWIDGET | Custom Widget | A user created widget that can have custom behavior and interactions. |
| M_CREATE_APP_MODAL | Create App Modal | Interface to create a new app. |
| M_CONTENT_LIBRARY | Content Library | A feature set for allowing app creation from centrally-managed template apps within an organization. |
| M_CONN | Connector | A configuration that specifies how Tulip connects to an external data source |
| M_CONN_HOST | Connector Host | A runtime service that facilitates the communication of a connector |
| M_CONN_FUNC | Connector Function | A configured code snippet that allows apps to make requests to a connector data source |
| M_CONN_ENV | Connector Environment | A configuration for how a connector accesses a data source given the app status. |
| M_CLRS | Color Palette | Allows for defining a universal color palette that can be accessed in all apps. |
| M_CAM_CONFIG | Camera Configuration | A configuration for Tulip Vision that can be applied to one or more Stations. |
| M_AUTOMATIONS | Automation | (Beta) The set of all versions of an an automation. |
| M_APPROVALTYPE | Approval Type | A specific approval that must be accepted for an app to be published |
| M_APPGROUP | App Group | Named groupings of Apps, similar to folders in a file system. |
| M_APP | App (Application) | The set of all versions of an a app. |
| M_APP_VER | App Versions | A specific version of an app |
| M_APP_VER_VAR | Variable | Dynamic value used in apps for real time control logic |
| M_APP_VER_STEPGROUP | Step Group | A collection of steps and step groups app |
| M_APP_VER_STEP | Step | A named view in an app that can be routed to based on trigger logic and human actions |
| M_APP_VER_STEP_SIGN | Signature Step | A form step that includes an e-sig widget |
| M_APP_VER_STEP_REG | Regular Step | A step that renders a custom arrangement of widgets |
| M_APP_VER_STEP_REG_WIDGET | Widget | A UI component that can be custom configured to be on an a step |
| M_APP_VER_STEP_HIST_WIDGET | Record History Widget | A UI component that can be used to view the history of a table record |
| M_APP_VER_STEP_FORM | Form Step | A step that renders input widgets in a form |
| M_APP_VER_STEP_FORM_INPUT | Form Input | An input element for user data entry on a form step |
| M_APP_VER_RECD | Record Placeholder | A dynamic reference in an app to a table record |
| M_APP_VER_QRY | Table Query Placeholder | An instance of a Table Query that is bound to an app |
| M_APP_VER_COMP | App Version Completion | A persistent log of App execution metrics and state. |
| M_APP_VER_AGG | Table Aggregation Instance | An instance of a Table Aggregation that is bound to an app |
| M_APP_PERM | App Permission | A named role for assigning a user certain access rights to an app |
| M_APP_EXPORT_IMPORT | App Export/Import | An interface to serialize an App and related resources into a file. |
| M_APP_EDITOR_NAVIGATION_OPTIONS | App Editor Navigation Options | A collection of options allowing for easier viewing of the App Editor canvas. |
| M_APP_APPR | App Approval | An approval type assigned to an app, and the eligible approvers, required for a new version of an app to be published. |
| M_APIT | API Tokens | A set of credentials for using the Tulip API |
| M_API_TOKENS | API Tokens | A set of credentials for using the Tulip API |
| M_ANALYSIS | Analysis | A configuration specifying a way to retrive and represent data on a dashboard or in an app |
| M_ALLOWLIST | IP Allowlist | A set of permitted IP addresses and CIDR blocks for accessing Tulip. |
| M_ACTIVITY | Activity Record | An immutable record containing information about a change to master data |