A record placeholder is the representation of a Tulip Table entry inside of the trigger editor. When an entry
is loaded into a record, all fields in the record are set as the values in the Tulip Table entry as
they were at the time the record was loaded. The record interface allows users to insert, update,
or delete entries in a Tulip Table. A record has an associated Tulip Table, and the record can not
modify values in other Tulip Tables other than its associated Table.
Name | Description |
---|
Table | The Tulip Table from which the record can load values and into which the Tulip Table can store values. |
Placeholder | The name of the record as it will appear inside the trigger editor. |
Places Used | The widgets and triggers that reference this Table Record Placeholder. These references must be deleted before the Table Record Placeholder can be deleted. |
Save for Analysis? | A boolean value that indicates whether the loaded table records will be saved in the app completion record. "On" by default. |
The following are possible actions a user can perform with a record.
Name | Description |
---|
Clear All Record Placeholders | Clears all placeholders in an app, does not affect the related Tables or Fields. Resets all placeholders, similar to completing and app. |
Clear Record Fields | Given a record name (placeholder) a user may clear the record, making all fields blank. |
Clear Record Placeholder | Remove the connection between a record placeholder and a record. The placeholder will now be empty. |
Create Record | Given a record, a user may save that data into the corresponding Tulip Table, therefore creating a new entry in the Tulip Table or updating an existing one. |
Create or Load Record | If an ID does not exist in the table yet, create it and create a new row, otherwise, load the existing row with that ID. |
Delete Record | Given a text identifier, a user may delete a record, removing the entry that corresponds to the record in the associated Tulip Table. It can still be viewed later in the History Widget. |
Link Record | Choose a Linked Record field within a specific record placeholder, and then choose the record ID to link to that field. |
Load Record | Given a record name (placeholder) and a text identifier, a user may load the values that correspond to the text identifier from a Tulip Table into a record. |
Unlink Record | Choose a Linked Record field within a specific record placeholder, and then choose the record ID to unlink from that field. |