WorkWithPlus for Native Mobile on Transactions

WorkWithPlus for Native Mobile can be applied to any Transaction, allowing the user to generate the full "work with" experience, including the creation of the list, view, data entry and prompts, and all the interactions between them.

The only requirement Transactions have to fulfill, is that they must be enabled as a Business Component

To enable WorkWithPlus for Native Mobile over a Transaction, you must start by creating the Base Panel, which will be the main entry for the "work with". Usually, this will be the "List" panel.

GeneXus "New Object" dialog with "User Interface" selected under Select a Category and "Panel" selected under Select a Type, described as "Defines a UI screen (mobile, web, TV, etc.)". The Name field is set to "PersonWW", Description to "Person WW", and Module/Folder to "Root Module". Create and Cancel buttons appear at the bottom right.

Once the base panel is created, go to the "Patterns/WorkWithPlus" tab, and choose to select a template (if not prompted automatically).

On the template selector, choose one of the "List" templates and continue.

WorkWithPlus "Template selector" dialog with categories (All, Empty, List, Specialized list, Data, Home, Other, Prompt, Chart) listed on the left; the "List" category is selected and an arrow highlights it. The template thumbnails panel in the middle shows list layouts such as "Cards with background image", "Cards with multiple layouts", "Horizontal columns", and "Image and amounts", the last one highlighted by an arrow. The right pane previews the selected "Image and amounts" template on a phone mockup, listing items (Beer, Tannat Wine, Lollipop, Green Apple, Delicious cherries, Steak) each with a price of $384.00 and a status label. "Cancel" and "Apply" buttons appear at the bottom right, with an arrow pointing to "Apply".

On the template initialization dialog, select "Based on a Transaction"

"Template initialization" dialog offering four radio-button options for how to base the template: "Based on a Transaction" (selected), "Based on an SDT or External Object", "Variables based on Attributes or Domains", and "Using custom variables", with OK and Cancel buttons.

You will then be prompted with the classic "Template Editor" dialog, but this time, a new section will be displayed, where you will be able to select the template you want to apply on each of the "work with" sections:

  • Data entry template: Choose the template used for the data entry (insert, update, delete)
  • Data display template: Choose the template used for the "view", this includes the data display and all related tabs, like sublevels and foreign keys.
  • Prompt template: Choose the template for the prompt associated with this transaction.

"Template Editor: Image and amounts" dialog. The highlighted top-left section has checkboxes to generate a 'Data entry' Panel (template "Data edit"), a 'Data display' Panel (template "Profile display"), and a Prompt Panel (template "Prompt with image"). Below are settings for horizontal lines between rows, and Image/Title/Amount/Subtitle fields bound to attributes (PersonPhoto, PersonFullName, PersonFirstName, PersonLastName) with an "Include arrow" checkbox. The right side shows a live phone preview titled "Person WW" listing rows with a circular image, "Value" title/subtitle, and "$384.00" amount. Cancel and Apply buttons are at the bottom.

Once you confirm your choices and customizations, the WorkWithPlus instance will be created, containing all the generated sections:

GeneXus IDE Transaction editor for PersonWW with the Patterns tab active, showing the WorkWithPlus pattern applied and three generated templates highlighted: "Image and amounts", "Prompt with image", and "Profile display" (all Transaction: Person). The pattern node tree on the left shows Selection, Application bar, MainTable with a Free style grid, TableListImage (PersonPhoto), TableListData (PersonFullName, PersonFirstName, PersonLastName), Arrow, and hidden PersonId. The right pane shows a phone preview titled "Person WW" listing rows of "Value"/"Value" text with placeholder images and "Value" amounts.

Once saved, WorkWithPlus will generate all the associated Panels, which will lay below the Panel you selected as the Base Panel (in this example, Panel 'PersonWW'):

GeneXus Knowledge Base Explorer tree showing the PersonWW folder expanded under the WorkWithPlusPersonWW pattern instance, listing generated objects: PersonWWData, PersonWWEmailPersonSplitTabsWC, PersonWWEmailPersonSplitWC, PersonWWEmailWC, PersonWWGeneral, PersonWWPersonSplit, PersonWWPersonSplitTabs, PersonWWProjectWC, PersonWWPrompt, and PersonWWView.