Tersus: Demo Stage 5 – Status: Adding item statuses

Demo Stage 5 – Status: Adding item statusesDate: May 31, 2023Adding a FieldIt can be helpful to assign a status to each item in the list. This way, when you walk in the supermarket, you can mark the items you have already bought.Adding a field is easy, using the 'Table Wizard':

In '<Desktop View>', right click on 'Items' and select Apply Table Wizard.

Add a field 'Status' (Text)

Press 'Finish'

The wizard will update your model with the additional field in all relevant places. If you now save your model and restart the appliaction, you will be able to update the status of any item you choose.Adding a 'Got It' ButtonUpdating an item's status requires the selection of its row in the table, pressing the 'Update' button, entering the new status, and pressing 'Save'.Walking in the supermarket with your iPhone, you may prefer a one-click method to mark an item you buy. To support this, we can add a 'Got It' button to mark an item as bought:Modeling the button in the top rowThe straightforward way is to create the 'Got It' button in the 'Action Header Group' of the row above the item table (the group with the existing buttons 'New', 'Update' and 'Delete'):

Drag a 'Button' from the 'Display' section of the palette. Name it 'Got It'.

Model 'Got It' similar to the way the 'Save' button is modeled inside the footer of the 'Update' dialog (see comments below the screenshot):

Items: Right click, select Add Ancestor Reference, and select the

'Items' element.
Convert Row to Record: Drag from the model repository from the package 'ShoppingList/Desktop/Items/Wizard/Transformations'.
Create Parameters, Save Update, Refresh Page: Copy from the 'Save' button inside the footer of the 'Update' dialog (go to 'Save', select the 3 elements and the flows between them, and press Copy; then return to 'Got It' and press Paste (Reuse)).
√: Create a text constant with the value "√".

If you now restart the application, you will only need to select a row and press 'Got It', and its status will be changed to √.Download Model: Stage 5, Interim Model (version 2.1.9)Reusing the button in each item rowWe would like to make 'Got It' a one-click-button (save the need to select a row before pressing the button).This can be achieved by putting a 'Got It' button in each row – clicking the button will change the status of its row.Modeling is trivial:

In the editor, select the 'Got It' button, right-click and select Copy.

Inside

'Items', zoom into 'Table Row', right-click and select Paste (Reuse):

Note that 'Got It' works both ways – either selecting a row and then pressing the 'Got It' that appears above the table, or pressing a 'Got It' in one of the rows. This is possible because of the way 'Got It' is modeled (referring to the selected table row).Making the button invisible if an item is already boughtOnce an item is marked as bought (√), we no longer need the 'Got It' button in its row.Actually, if we only display the buttons for the other items, we will make it easier to see which items we still need to look for on the shelves.We can model this by displaying the 'Got It' button only if the item's status is different from '√':

Open the model of 'Got It' and add a 'Boolean' element '<Visible>'.

Open the 'Convert Record to Row' model (from the package 'ShoppingList/Desktop/Items/Wizard/Transformations').

Add to 'Convert Record to Row' an action 'Show or Hide Row Button' that sets the value of the '<Visible>' element of the 'Got It' button based on the item's status:

Here is a possible way to model 'Show or Hide Row Button' (note its trigger 'Status' is optional, because 'Status' may be missing, and reuse the '√' constant from the 'Got It' model):

If you now restart the application you will notice that when you press 'Got It', the item's status changes to '√', and the 'Got It' button disappears.Download Model: Stage 5, Full Model (version 2.1.9)A More Compact DisplayTo save some space on the screen, we can embed the 'Got It' button in the 'Status' field of each row:

In '<Desktop View>', zoom into

'Items' (Table Wizard), zoom into

'Items [Table]', and zoom into 'Table Row'.

Select both 'Status' and 'Got It', right click, and select Encapsulate.

You get a pane named 'Pane'. Rename it to 'Status'.

This is what you get if you now restart the application:

Download Model: Stage 5, Final Model (version 2.1.9) Next: Adding an optional comments fieldSee Also:

To use the full functionality of this web site, JavaScript needs to be turned on.

For best results, use the Firefox browser..

Loading ...