Template

The WorkWithPlus Pattern Settings editor is open on the Web settings > Template tab, with the Settings object tree showing nodes for Template, Objects, Theme, Labels, Grid, MasterPages, Global Attribute based rules, Global Events & Subs (with 'Commit updates' subroutines), Global automatic conditions, Global variables, and Notifications, the latter expanded to show Predefined Transaction Notifications including Discussion, Mention, InsertRecord, UpdateRecord, and DeleteRecord.

Template node has the following properties:

Category Property  
General Properties Include Automatic Conditions In Data Selector A full-height Template property grid lists WorkWithPlus template settings organized into sections: Default Instance, Navigation, Auditing, Update Instances, MergeWithPreviousTable, Association Selection Object, Prompt, FK Selector, Multirow Actions, View, Extended Controls, Fields Help Text, Wizard, Simple Wizard, Extended Combo/Suggest, Popover, Master Page Search, Mask, Dynamic, and List. Notable values include User Controls Base Library 'Bootstrap', Icon Fonts 'Latest Free Font Awesome', Auditing Levels 'First And Second Levels', Excessive Tabs Behavior 'Slider', and Mask Options 'IP Address:099.099.099.099,Thousand separat...'.
Validation Message Display
User Controls Compatibility
Icon Fonts
Optimization Number
Default Instance Tab for parallel transactions
Generate View
Generate Selection
Consider Show In Default Form
Max Grid Attributes
Max Filters
Max View Tabs
Navigation Use Transaction Context
After Insert
After Update
After Delete
Return Procedure
Auditing Enable Auditing
Auditing Condition
Auditing Levels
Update Instances Update Instances
Merge with previous Table Merge with previous Table Theme
Merge with previous Table Cell Spacing
Merge with previous Table Cell Padding

Domains with Special Semantics

(deprecated, properties hidden from version 15 Upgrade #4.2)

Address
Geolocation
URL
Email
Association Selection Object Return On Confirm
Prompt Generate Prompt
Prompt Image
Filter Prompt FKs of PK
Filter Multiple Prompt Image
Default Prompt Parameter Type
Prompt Encrypt URL Parameters
FK Selector Auto FK Selector type
Default FK Selector
Exclude FK Selector Description Attributes
Auto FK Selector Description
Multirow Actions Check Selected Lines
Mantain selected rows when page changes
Select All Pages
View Tab Options SDT
Grid Tab Count
Extended Controls Tab Panel Type
Excessive Tabs Behavior
Panel Type
Panel Show Collapse Icon
Panel Collapse Icon Position
Action Group Type
Grid Action Group Type
Fields Help Text Help Text Display
Help Text Theme Class
Help Text Info Icon
Description Tooltip Position
Value Tooltip Position
Info Icon Tooltip Position
Wizard Share BCs Across Steps
Save Interval Seconds
Simple Wizard Allow Step Title Click
Arrow Selected-Unselected Image
Arrow Unselected-Selected Image
Extended Combo/Suggest Search operator
Include Only Selected Option
Dynamic Load Max Items
Multiple Selection Display Type
DVelop Combo/Suggest Styles
Popover Font Icon Class
Position
Trigger
Master Page Search  Master Page Search Style
Include in Master Page search
Mask Mask Options

General Properties:

Startup Wizard Imported Configurations:

Specifies the "Design System Wizard" configuration xml file.

Include Automatic Conditions in Data Selector:

Specifies the default value for the property 'Include in Data Selector' on the 'Automatic Conditions' nodes. The property 'Include in Data Selector' specifies whether to include that  Automatic Conditions   in the DataSelectors generated with the conditions of the filters or not. These applies only for the GridObjects which its property ' Generate Data Selector For Conditions ' is True. In the link provided there is an example of both properties.


Validation Message Display:

Specifies the way that the validation messages will be displayed when a Web Panel contains required variables (variables with the property 'Is required' true). The options are:

  • One at a time: it will display only one error message at a time, in the error viewer (or error messages User Control if you have it on the Master Page).
  • One at a time (on the field): it will display only one error message at a time, next to the field.
  • All at once: it will display all the error messages thrown, in the error viewer (or error messages User Control if you have it on the Master Page).
  • All at once (on the field): it will display all the error messages thrown, but each one in the field that is related to.


User Controls Compatibility:

Specifies which controls will WorkWithPlus add in the WebForms when that instance contains one of the following nodes: Panel, Tabs, Action Group of type DVelop Bootstrap, etc. The possible values are Responsive and Previous versions compatibility. The Responsive ones are the same controls with the difference that they don't import the bootstrap.js and bootstrap.css as GeneXus does it when generating a Web Responsive application.

Responsive (Based on containter type) it uses a new type of control that it doesn't needs to generate HTML tables. This only works in GeneXus 16 or higher

Icon Fonts:

Specifies the version of the icon fonts of Fontawesome that you will be able to add in your application. The options are 'Fontawesome 4' and 'Fontawesome 5'.

Optimization Number:

Specifies which code optimizations will be made by WorkWithPlus. In each superior number, all the optimizations from the previous numbers will also be made.

The optimization numbers are:

  • 0: No optimizations will be made (this is the value for all the KBs which started to use WorKWithPlus prior to version 10.1)
  • 1:  Sets the name of the tables of the FreeStyleGrids with Header as <GridName>_HeaderTable and <GridName>_DescriptionsTable instead of UnnamedTableFSWithHeaderHeader and UnnamedTableFreeStyleGridDescriptions
  • 2: Improvement in Dynamic Filters: when the first item of the dynamic filters has operators it adds the options related to the first item directly in the web form (for the variable).
  • 3:  Improvement was included in the user control used for Columns Filters. This improvement lets GeneXus reference the necessary procedures (exposed as REST web services) and properly deploy them when you build the application.
    Optimization in the code generated when you have dynamic filters with a search action.
  • 4: Improvement in the definition of the Select All variable of the Multi Row selection.
  • 5: The following improvements are included:
    • For property 'Description Width' of an attribute or variable, it will set the property 'Label Width' with the selected value, instead of creating a Table with 2 columns, a Textblock at the left and the attribute with 'Label Position' none at the right (this is what is done in previous versions of WorkWithPlus (or with 'Optimization Number' 4 or less).
    • For property 'Description Position' of an attribute or variable with value 'Top', it will set the property 'Label Width" with value 100% for all sizes. In previous versions of WorkWithPlus (or with 'Optimization Number' 4 or less), it creates a Table with 2 rows, a TextBlock for the label and the attribute with 'Label Position' none.
  • 6: Improvement in the "PrepareTransaction" sub for Tabular Tab in Views to use variables that are never assigned.
  • 7: The following improvements are included:
    • Allows to use the 'Contextual actions visibility'. More information about this in the following link: 'Contextual actions visibility'
    • When the environment/Web Panel is 'Smooth', the hidden variables are no longer included on screen. This makes the Web Forms much lighter, and this impacts in the generation time, compilation time and runtime performance.
    • Improvement in the DropDownOptions User Control, creating lite User Controls with less properties in order to have lighter Web Forms.
  • 8: The following optimizations are included:

                      Before setting 'Optimization Number' as 8, you need to import the XML named 'Optimization8File.xml' located in <GeneXus_Installation>\Packages\Patterns\WorkWithPlus\Resource.

  • 9: The following optimizations are included:
    • The Dynamic Filters are displayed as responsive
    • The possibility to reorder, resize and fix columns of a grid is included (enabling it with the correspondent properties)
  • 10: The following optimization is included:
  • 11: The optimization is related to including the Transaction Level in the 'For each' commands added automatically by WorkWithPlus for Web associated with a grid object with base table.

    • For Each Person
      ...
      EndFor
  • 12: Optimization Number 12 is related to improvements made in Title Filter associated with numeric inputs:
    • Support inserting numbers with decimals in the Title Filters which its column supports decimal values.
    • Avoid the error when inserting more digits than the maximum amount of digits supported by the attribute/variable of the Title Filter.

      Optimization Number 12 is available as of WorkWithPlus for Web 14 Upgrade #3.
  • 13: Optimization Number 13 the following improvements are added: 
    • In a FreeStyleGrid that does not have infinite scrolling, the classic pagination actions (PageFirst, PageNext, PagePreviousm PageLast buttons) are only added when you have the DescriptionsAsHeader option set to true.
    • In a form with 'Web User Experience' as 'Smooth' and that includes the pagination bar, a refresh command is not added after navigating to the first page and/or performing 'Clear Filters'.
  • 14: Optimization Number 14 adds the Optimization in code generated in List to save the filters in the session.
  • 15: Optimization Number 15 has the following improvements:
    • Title Filter of a date field with range search and four digits in its year will display four digits in the range.
    • Improvement of the visible rule that is added when a Table in a transaction has items with visible conditions, and some items share the same condition. In this optimization, the rule will be defined once per different condition.

 

Properties Of Category Default Instance:

Tabs for parallel transactions:

Specifies whether to insert additional tabs in the View object for parallel transactions or not.


Generate View:

Specifies whether to generate View object when creating the instance by default or not. If you set this property on No but you have already created some View objects to some instances, the pattern will not delete those objects when executing Update Instances. Also, if you want to generate the View object for some specific transaction, you can make 'Add View' and the View will be generated based on the correspondant template.


Generate Selection:

Specifies whether to generate Selection object when creating the instance by default or not. If you set this property on No but you have already created some Selection objects to some instances, the pattern will not delete those objects when executing Update Instances. Also, if you want to generate the Selection object for some specific transaction, you can make 'Add Selection' and the Selection will be generated based on the correspondant template.


Consider Show in Default Form:

Specifies whether to take into account the property 'Show in default form' of attributes.


Max Grid Attributes:

Specifies the maximum amount of attributes that will be added by default in the grids asociated to a transaction instance. For example, if this property has the value 25 and you have a transaction with 100 attributes and you go to apply Pattern for the first time, the grid of Selection and Prompt objects will have the first 25 attributes in the grid. The value 0 means that will include all the attributes with no limitations on the amount of them.


Max Filters:

Specifies the maximum amount of filters to be added by default in grid objects. It´s analogous to the previous property but with filters. By default, WorkWithPlus will add one filter for the description attribute and one filter for each foreign key attribute (when the property 'Add related tables filters' that is in node Filters within the Transaction Templates has the value True). So, if this property has the value 10, and you have a transaction with 20 FK attributes, WorkWithPlus will add up to 10 filters by default.

Max View Tabs:

Specifies the maximum amount of Tabs within the View object that WorkWithPlus will add by default when applying WorkWithPlus to a transaction. WorkWithPlus by default adds one Tabular tab for the transaction plain information, one GridTab for each level and one GridTab for each related transaction. So, if this property has the value 10, and the sum of the tabs of the transaction (plain information, parallel transactions, levels and 1-N relations) are more than 10, it will add the first 10 tabs.

If you want for some transaction to add the tabs, or to add one tab which is not included in those by default, you can follow these steps:

  1. Change this property to 0 and save the settings
  2. Depending on your case make one of these actions:
    2.1 When you did not applied the pattern yet -> Go to apply pattern to the transaction the first time
    2.2 When you have customized other objects within the instance and do not want to overwrite those changes -> Delete View object and make Add -> View
    2.3 When you have customized the View object or some tabs within the instance and want to add some other Tabs by default ->  Make right clic over the Tabs node of the View Tab of the instance -> Add from default -> Grid/Tabular Tab
          and select the ones that you want.
     
  3. After saving the changes, open the WorkWithPlus Settings and set the property with the same value as prior to the 0.

 

 

Properties Of category Navigation:

Use transaction context:

Specifies whether the context will be used for inserting parameters in the insertion of records to transactions or not.

If this property is True, and we are visualizing one Person's Project, the following behaviour will occur:

A generated Work With Web Panel for 'Person :: Jackson Bob' shows General, Email, Project, and My Web Component tabs, with Project selected displaying a grid of Id, Description, Start Date, Estimated Finish Date, Status, Comments, Created/Updated Date and User, Real Cost, and Price columns for three projects. A red annotation box with an arrow points to the Insert button, labeled 'We go to add a new Project associated to Bob'.

The generated Project transaction form, opened via transaction context, shows a General Information panel with Id=0, an empty Description field, Start Date and Estimated Finish Date pickers, and a Status dropdown. A red annotation box highlights the read-only Person Id (2) and Full Name (Jackson Bob) fields, with text explaining 'The Project will be added to Bob, it is using transaction Context'.

On the other hand, if we set the property as False and we are visualizing one Person's Credit Cards, the following behaviour will occur when we go to add a new Credit Card to that person: 

The same generated Project transaction form as the previous example, but a red annotation box now reads 'Transaction context is disabled so it won't remember to which Person we wanted to add the new Project', with an arrow pointing to the Person Id field now editable and defaulted to 0, with an empty Full Name and a search/lookup icon next to Person Id.

After Insert:

Specifies the default value for this property on instance's main node. This property specifies the program that will be invoked after Insert action is executed. The options are 'Return to caller', 'Go to View', 'Go to Selection', 'Stay in Transaction' and 'Nothing'. 


After Update:

Specifies the default value for this property on instance's main node. This property specifies the program that will be invoked after Update action is executed. The options are 'Return to caller', 'Go to View', 'Go to Selection', 'Stay in Transaction' and 'Nothing'. 


After Delete:  

Specifies the default value for this property on instance's main node. This property specifies the program that will be invoked after Delete action is executed. The options are 'Return to caller', 'Go to Selection' and 'Nothing'.


Navigation options:

  • Return to Caller : returns to the object that invoked the transaction (by inserting a 'Return' in the AfterTrn event). If the property 'Return Procedure' has some value, it will invoke the procedure specified in that property.
  • Go to Selection: calls the Selection object associated to the transaction.
  • Go to View: calls the View object associated to the transaction and the record that was being inserted or updated.
  • Stay in transaction: stays in the correspondent transaction, in update mode with the record that was being inserted or updated.
  • Nothing: does not enter any code for navigation, and gives developer the flexibility to do whatever he wants by adding user code in AfterTrn event.

Return Procedure:

Specifies a procedure that will be invoked instead of making a 'Return' call. This allows user to handle by itself the call stack.

 

 

Properties Of Category Auditing:

Enable auditing:

Specifies the default value for this property on instance's main node. This property enables auditing to the transaction. In consequence, the procedure LoadAudit<transaction> will be created, which will be invoked each time an action of this transaction is executed (at runtime). This procedure loads an SDT (AuditingObject) with the transaction name, the action executed and the old and the new values of each attribute (in case it is an upate). Then, the After Trn Event invokes AuditTransaction procedure which executes some operation defined by GeneXus developer. 


Auditing Condition:

Specifies the default value for this property on instance's main node. This property specifies a condition that will have to be accomplished in order to audit the action (INS, UPD, DLT) of the correspondent transaction. This could be an udp to a procedure, the value of some attribute or variable, etc. For example &Context.RoleId <> 'Administrator'. 


Auditing Levels:

Specifies the levels of the audited transactions that will be considered in the auditing. This can be just the firs level of them 'Only First Level' or first and second levels 'First and Second Levels'.
 

If you want to read more information about Auditing, follow this link: Auditing

 

 

Properties Of Category Update Instances:

Update Instances:

Specifies the default value for this property on instance's main node. This property specifies whether the UpdateInstances functionality will update all nodes with its properties, will only merge node's properties all will not update any node neither its properties.

 

 

Properties Of Category Merge with previous table:

:

Theme to be assigned to the tables created when some node is merged to another node (its property mergeWithPreviousCell is true).


:

Cell spacing to be assigned to the tables created when some node is merged to another node (its property mergeWithPreviousCell is true).


:

Cell padding to be assigned to the tables created when some node is merged to another node (its property mergeWithPreviousCell is true).

In the GeneXus IDE, the Person transaction object has the Work With Plus pattern applied, showing the Transaction template tree (TableMain, Person, Error viewer, TableContent with Basic Information/More Information/Auditing tabs and attributes like PersonId, PersonFirstName, PersonLastName) alongside a live preview of the Person form. The Properties panel on the right shows the selected PersonLastName control's properties, with 'Merge With Previous Cell' set to True, connected by a red arrow from the control to that property.
 

The GeneXus Web Form designer for the Person object shows a nested TableMergedPersonFirstName table (highlighted with a red box and arrow) containing the First Name (PersonFirstName) and Last Name (PersonLastName) controls side by side inside the Basic Information tab. The Properties panel on the right highlights this table's Cell Padding and Cell Spacing (both 0) and its Class set to 'TableMerged'.

 

 

Properties Of Category Domains with Special Semantics:

Deprecated, these properties are hidden from version 15 Upgrade #4.2.

Address:

Specifies the domain that represents an address, and when user creates attributes based on this domain, will show in google maps the location of it when the attribute is in display mode (read only).


Geolocation:

Specifies the domain that represents a geolocation. When user creates attributes based on this domain,  will show in google maps the location of it when the attribute is in display mode (read only) and in insert mode will enable user to select a location from google maps.


URL:  

Specifies the domain that represents an URL. When user creates attributes based on this domain,  will create a link to the url inserted it when the attribute is in display mode (read only).


Email:  

Specifies the domain that represents an email. When user creates attributes based on this domain,  will create a 'mailto' link to send an email to it from the configured email when the attribute is in display mode (read only).
 

For more information about this domains, and some images about it, follow this link: Domain with specific semantic

 

 

Properties Of Category Association Selection Object:

Return on Confirm:

Specifies whether to make a 'Return' call after clicking on confirm button or not.

 

 

Properties Of Category Prompt:

Generate Prompt:

Specifies whether to generate prompt objects for each level of the instances by default, or not. If you set this property on No but you have already created some Prompt objects to some instances, the pattern will not delete those objects when executing Update Instances.


Prompt Image:

Specifies the image to assign next to filters when they have a prompt node as its children. 

Filter Prompt FKs of PK:

Specifies if the filter prompt will filter the foreing key attributes contained in the primary key.


Filter Multiple Prompt Image:

Specifies the image to assign next to the Filter Attribute Multiple with type Prompt.
 

In this kind of filter it will specify the image:

A search filter row shows a 'Search in' dropdown set to Company, and a 'value' field displaying an upward-arrow icon labeled 'Image' (called out in a red box with an arrow) next to selected filter tags DVelop, Disco, and 3M, each with an 'x' to remove them.

Default Prompt Parameter Type:

Specifies the type of the parameters added by default to the Prompt objects. The values are 'Out' or 'InOut'.

Prompt Encrypt URL Parameters

You can encrypt the parameters sent to a Prompt.
The following options are available:

  • No
  • Session Key
  • Site Key
  • <Use Environment property>
  • <Do not update>

Properties Of Category FK Selector

Auto FK Selector type:

Specifies the type to use when having the property 'Auto Prompt / DVelop Combo' enabled, whether it is a prompt or a DVelop Combo.

There are two possibilities:

  • Prompt
  • DVelop Combos

Default Auto FK Selector:

Specifies the default value for this property on the attributes. The property 'Auto Prompt' specifies whether to generate the prompt rule or add a DVelop Combo control, in case the attribute belongs to some foreign key of the transaction. So, only applies to attributes that are foreign keys to some other transaction.

 

Exclude FK Selector Description Attributes

This property specifies whether to exclude or not (from the transaction form) the Description Attribute of a Foreign Key when the property 'Default Auto Prompt / DVelop Combo' is true and the property 'Auto Prompt/DVelop Combo type' is 'DVelop Combo'. This applies to the transaction and view (general tab) instance forms.

For example, having the properties like the following image:

WorkWithPlus Pattern Settings editor with the Template node selected in the tree and its Properties panel showing global options (Include Automatic Conditions In Data Selector: True, Validation Message Display: All at Once, User Controls Compatibility: Responsive, Icon Fonts: Font Awesome 5); a red arrow points to the highlighted "Prompt / DVelop Combo" section where Auto Prompt/DVelop Combo type is set to DVelop Combos, Default Auto DVelop Combo is True, and Exclude DVelop Combo Description Attributes is True.

Person transaction has CompanyId as an FK of Company:

GeneXus Structure editor for transaction "Person", showing the attribute tree: PersonId (key), PersonFirstName, PersonLastName, PersonFullName (formula), PersonNickName, PersonCellNumber, PersonHomeTelNumber, PersonBirthDate, PersonHobby, CompanyId, CompanyName, PersonHasFavoriteMusicBand, PersonFavoriteMusicBand, PersonGender, and a nested Email level with EmailDir (key) and EmailDescription.

So, when the instance is created by WorkWithPlus for Web the attribute CompanyName (which is the Description Attribute of Company transaction) will be automatically excluded:

GeneXus Patterns tab for transaction "Person" with a Transaction pattern instance tree showing TableContent's View Detail panel attributes; a red arrow and callout labeled "CompanyName is excluded automatically" points to the CompanyId attribute, explaining that CompanyName (the related description attribute) is auto-excluded from the view since CompanyId already implies it.

 

Auto FK Selector Description

This property specifies the description to assign to the FK attribute when the property 'Default Auto Prompt / DVelop Combo' is true and the property 'Auto Prompt/DVelop Combo type' is 'DVelop Combo'. The options are:

  • Related transaction description: it will assign the description of the related transaction. For example, in the Person transaction that has an FK to Company, for CompanyId it will display the description of Company transaction:

The GeneXus IDE shows the Person transaction's Patterns tab with the CompanyId attribute selected in the structure tree; its Properties panel lists Attribute, Description (Company), Right Text, Auto Prompt/DVelop Combo, and Link/Form/Control Info sections. A red arrow points from the Company transaction's CompanyId attribute (with properties Name, Description, Module/Folder Root Module, Business Component False) up to the Person transaction, illustrating how the Company attribute is linked/referenced.

  • Attribute description: it will assign the description of the FK attribute. For example, in the Person transaction that as an FK to Company, for CompanyId will assign '=Attribute.Title':

The GeneXus IDE shows the Person transaction's Patterns tab with the CompanyId attribute selected; its Properties panel shows Description set to the formula "=Attribute.Title" and expanded Control Info and Advanced Security sections (Show/Hide Security Function, Edit/ReadOnly Security Function). A red arrow points from the CompanyId node in the structure tree up toward the General Information web layout preview showing Id, First Name, Last Name, Full Name, and Value fields.

Properties Of Category Multirow Actions:

Check Selected Lines:

Specifies whether the actions that have Multi Row Selection enabled will or will not check if user selected at least one record of grid before clicking it, and display an error message if no record is selected.

The WorkWithPlus Pattern Settings editor shows the WWP Configuration tree (Template, Objects, Theme, Labels, Grid, MasterPages, Context, GXtest Cases Generation) with Template selected, and a red arrow points from it to the 'Multirow Actions' section in the Properties panel on the right, where Check Selected Lines is True and Mantain selected rows when page changes is Yes.

The generated Person Work With grid displays rows with checkboxes, Id, First Name, Last Name, Full Name, Nickname, Birth Date, Hobby, Gender, Company and other columns, plus Insert, Excel, PDF, Select columns, and Delete Selected toolbar buttons. A red annotation points from 'Delete Selected' explaining it is an action with Multi Row Selection = True, and a second red box under the checkbox column reads 'At least one line must be selected'.

Mantain selected rows when page changes:

Specifies the default value for this property on User Actions within Transaction instances. This property specifies whether to mantain the records that were selected when navigating to another page of the grid or not. This property only applies for multi row selection in grid objects associated to a transaction instance.

Select All Pages

Specifies whether the 'Select all' option in the grid will select all the records of the visible page, or will select the records of all the pages that are being filtered.

 

Properties Of Category View:

Tab Options SDT:

Specifies the SDT to be used in the View objects for displaying the tabs of the view. The SDT that comes with WorkWithPlus, and will be set by default is WWPTabOptions:

The GeneXus Data Type / SDT structure editor shows the WWPTabOptions structure, marked as a collection, containing a TabOptionsItem group with fields Code (TabCode), Description (VarChar 255), Link (Url, GeneXus), WebComponent (Url, GeneXus), IncludeInPanel (Numeric 1.0), CollapsedByDefault (Boolean), and Collapsable (Boolean).

Grid Tab Count

In order to achieve this, each 'Grid Tab' node has a property named 'Caption record count'. The possible values are True, False or <default>. The value '<default>' is taken from WorkWithPlus for Web Settings > Template > 'Grid Tab Count'. 

When this property is True, the View object will calculate the count of each Grid Tab data, displaying the information in the caption, like follows:

Example 1

Person View detail page for "Herrerax Felipe" showing tabs General, Email (5), and Project (16), a "Go to Person" link, and General tab fields Id 2, First Name Felipe, Last Name Herrerax, Full Name "Herrerax Felipe", Nick Name Filipo, with Cell Number partially visible below.

Example 2

"Herrerax Felipe" detail page with a top search bar and Account menu, showing a General Information card with fields Id 2, First Name Felipe, Last Name Herrerax, Nick Name Filipo, Birth Date 04/10/19, Hobby "Play cards", Favorite Music Band "The Beatles", and Gender Male, plus Update and Delete buttons, followed by a "Person Split" tab section repeating similar fields alongside Email (5) and Project (16) tabs.

If you want to change the way that the count is displayed, you change it directly in the language resource (the key is WWP_TabWithCountCaption):

GeneXus IDE Translations editor for the "English" language object, Filter field showing "_TabWithCountCaption", with checkboxes "Show only user messages", "Show only untranslated messages", and "Show only referenced messages", and a messages table listing Code "WWP_TabWithCountCaption" with Localized text "%1 (%2)".

 

Properties Of Category Extended Controls:

Tab Panel Type:

Specifies the TabPanel control that will be displayed on the forms when adding a Tabs node in the instances. The options are: DVelop Bootstrap or GXUI.

A WorkWithPlus pattern instance object tree shows the Tabs (TabsGeneral) node expanded into Basic Information (Tab1) containing a Table with attributes PersonId, PersonFirstName, PersonLastName, PersonFullName, PersonHobby, PersonNickname, PersonBirthDate, PersonGender, CompanyId, and CompanyName, alongside collapsed More Information (Tab2) and Auditing (Tab3) tabs each with their own Table node.

DVelop Bootstrap: the TabPanel DVelop Bootstrap control is a control developed by DVelop for using with WorkWithPlus. Uses the Bootstrap 3.0 library that Twitter created in order to have applications with the new tendencies of web applications.

The generated Person transaction form (Bootstrap/DVelop theme) shows tabs Basic Information, More Information, and Auditing, with the Basic Information tab active displaying Id=0, First Name, Last Name, Full Name, Hobby, Nickname, Birth Date, Gender (Male), and Company fields with a lookup icon.

GXUI: is the TabPanel control dveloped by GXUI library.

The same generated Person transaction form rendered with a different, non-Bootstrap classic theme: tabs Basic Information, More Information, and Auditing appear in a blue tab-strip style, with the same Id, First Name, Last Name, Full Name, Hobby, Nickname, Birth Date, Gender, and Company fields laid out below.

Excessive Tabs Behavior

Behavior when tabs exceed the width of the page.

Two possible values:

  • Rows
  • Slider

Panel Type:

Specifies the Panel control that will be displayed on the forms when adding a Panel node in the instances. The options are: DVelop Bootstrap or GXUI.

A WorkWithPlus pattern instance object tree shows a Panel: Email node containing a 'Subor level (Grid)' with attributes EmailDir, EmailDescription, and EmailComments, representing a subordinate-level editable grid for email records.

DVelop Bootstrap: the Panel DVelop Bootstrap control is a control developed by DVelop for using with WorkWithPlus. Uses the Bootstrap 3.0 library that Twitter created in order to have applications with the new tendencies of web applications.

The generated Email panel renders as an editable grid with Email, Description, and Comments column headers, five empty input rows, and a '<a href='[New row'>[New row</a>]' link at the bottom to add additional rows.

GXUI: is the Panel control dveloped by GXUI library.

The Email panel rendered with the classic (non-Bootstrap) theme, showing a blue title bar 'Email' and a grid with Email, Description, and Comments columns, five empty input rows, and a '<a href='[New row'>[New row</a>]' link at the bottom.

Panel Show Collapse Icon:

Specifies whether to show or not the Collapse Icon in Panel control. Applies only when the Panel Type is DVelop Bootstrap. 
 

If this property has the value False, in order to expand/collapse the Panel you have to click in the Title:

An Auditing panel shows Created Date (09/25/13 02:13 PM), Created User (administrator), Update Date (empty), and Updated User (empty) fields. A red callout box with an arrow pointing at the 'Auditing' title reads 'Click in the title in order to collapse/expand'.

If this property has the value True, it will display an icon in order to collapse/expand the panel:

The Auditing panel is shown in its collapsed-toggle icon variant, with a minus sign next to the 'Auditing' title, and Created/Update Date/Updated User fields visible below. A red callout with an arrow pointing at the minus/plus icon reads 'Click in -/+ in order to collapse/expand the panel'.

Panel Collapse Icon Position:

Specifies the position of the collapse/expand icon. Applies only when the Panel Type is DVelop Bootstrap and when the property 'Panel Show Collapse Icon' is True. The values are Left and Right.

Action Group Type:

Specifies the default value for this property on Action Group nodes. This property specifies whether the Action group will be displayed as a Combo Box, GX Action Group or as a DVelop Bootstrap Drop Down Options. There is an example of these options on the following link: Action Group Node

Grid Action Group Type:

Specifies the default value for this property on 'Grid Action Group' nodes inside grids. This property specifies whether the Action Group inside grids will be displayed as a combo box or as a DVelop Bootstrap Drop Down Options.

 

 

Properties Of Category Fields Help Text:

Help Text Display:

Specifies the position where the help description will be diplayed. The options are:

  • Tooltip on description: will display the tooltip when positioning the mouse in the description of the attribute:
    The Person data entry form shows fields Id, First Name, Last Name (focused), Nick Name, Age, Email, and Home Address, with Confirm and Cancel buttons below. A red arrow points to the Last Name field with a tooltip reading 'Father's Last Name only'.
     
  • Tooltip on value: will display the tooltip when positioning the cursor or the mouse in the field value:
    The Person data entry form's Informacion General section shows Id, First Name (focused), Last Name, Age, and Email fields, with a red arrow pointing down at a tooltip reading 'Father's last name only' near the Last Name label.
     
  • Tooltip on both: will display the tooltip when positioning the mouse in the description or positioning the mouse or cursos in the field value.
     
  • Information Icon: will display the tooltip when positioning the mouse in the icon:
    The Person data entry form's Informacion General section shows Id, First Name (focused), Last Name, Age, and Email fields, with a help icon (question mark) next to the Last Name field and a red arrow pointing to a tooltip reading 'Father's last name only'.

Help Text Theme Class:

This property must coincide with the property 'Class Selector' of the control DVelopBootstrapTooltip that is included in the MasterPage that you are using for the application. 

If you leave the property 'Class Selector' of the control empty, you should set it empty in this property also, and it means that all the tooltips of all the applications will be displayed using the DVelopBootstrapTooltip control.

By default this property in the User Control is 'BootstrapTooltip' so the property 'Help Text Theme Class' must be the same

In the GeneXus Web Form designer for WWPBootstrapResponsiveMasterPage, a UTToolbtip control named DVelop_GXBootstrap_Tooltip1 is selected in a 'Tooltip example' row showing a 'Tooltip' button preview. The Properties panel on the right, connected by a red arrow, highlights the Class Selector set to 'BootstrapTooltip', Default Position 'bottom', and Delay settings (Labels/Buttons/Inputs Show Delay 300, Images Show Delay 0, Hide Delay 0).

The WorkWithPlus Pattern Settings editor shows the WWP Configuration tree with Template selected, and a red arrow connects it to the 'Help Text Theme Class' property (highlighted, value BootstrapTooltip) inside the Fields Help Text section of the Properties panel, alongside other Template settings like Association Selection Object, Prompt, Multirow Actions, View, and Extended Controls.

Help Text Info Icon:

Specifies the icon that will be assigned next to the attribute/variable when the property 'Help Text Display' is Icon.

Description Tooltip Position:

Specifies the position of the tooltip that will be displayed when positioning the mouse in the Description textblock. The options are left, right, top, bottom. This property only applies when the property 'Help Text Display' is 'Tooltip on Description' or 'Tooltip on Both'

Value Tooltip Position:

Specifies the position of the tooltip that will be displayed when positioning the mouse or cursor in the value (attribute/variable). The options are left, right, top, bottom. This property only applies when the property 'Help Text Display' is 'Tooltip on Value' or 'Tooltip on Both'

Info Icon Tooltip Position:

Specifies the position of the tooltip that will be displayed when positioning the mouse in the help icon. The options are left, right, top, bottom. This property only applies when the property 'Help Text Display' is 'Tooltip on icon'.

 

 

Properties of Category Wizard:

Share BCs Across Steps:

If this property is True, the data of each of the wizard will be saved in the same Business Component. 

Save Interval Seconds

Interval in seconds to Save the Wizard data when Resume property is 'Ask User' or 'Always'.

 

Properties of Category Simple Wizard:

The properties of 'Simple Wizard' category applies when you create a Wizard that won´t have components (the ones that are in the template category 'Create, update and display data'

Allow Step Title Click

Specifies whether the wizard will allow to click in some specific step to go directly to that step.

Arrow Selected-UnSelected Image

Specifies the image that will be used when creating a simple wizard of type 'Arrow', for separating the selected step with an unselected step right next to it.

Arrow Unselected-Selected Image

Specifies the image that will be used when creating a simple wizard of type 'Arrow', for separating an unselected step with the selected step right next to it.

 

 

Properties of Category Extended Combo/Suggest:

Search operator

Two possible values:

- Contains
- Starts with

Include Only Selected Option

When having a variable that its 'Control type' is 'DVelop Combo' and has multiple selection (property 'Allow Multiple Selection' as true), you can configure with this property if you want to have an option to display only the ones that are selected.

Dynamic Load Max Items

Specifies the maximum amount of items to load when the property 'Load Data Dynamically' is true on an attribute/variable that its control type is 'DVelop Combo'.

Multiple Selection Display Type

When having multiple selection of an Extended Combo (attribute/variable that its control type is 'DVelop Combo'), with this property you will be able to select whether you want to display them as descriptions separated by commas, or visualize it like tags.

An animated GIF shows a General Information form with a Companies label above an empty DVelop Combo dropdown field, and Confirm and Cancel buttons below, illustrating interaction with the combo control before a value is selected.

DVelop Combo/Suggest Styles

Specify the different ways to display the values within the DVelop Combo. You can include up to 3 attributes within the combo. It includes a title, description and even an image. With this we achieve a better description of the displayed value.

An empty "Country" input field is shown with its label above it and a hand cursor hovering near the right edge of the box, depicting the collapsed initial state of a combo control before it is opened.

This property is where you define the properties that will be displayed in the DVelop Combo style when defining it in a Web Panel or Transaction.

WorkWithPlus Settings editor with the Template node selected in the tree and the Properties panel showing View, Extended Controls, Fields Help Text, Editable Grid, Wizard, and DVelop Combo sections. A "DVelop Combo Styles" editor dialog is open below, listing style rows Title and subtitle, Title, subtitle and image, and Title and image with their theme classes and attribute counts, plus Add, Remove, Move up/down, OK and Cancel buttons; red arrows connect the Template node and the DVelop Combo Styles property to this dialog.

It will look like the image below when creating your DVelop Combo.

WebPanel object Pattern tab with the Variable node selected under TableContent; the Properties panel shows Control Type "Custom" and Control Info "DVelop Combo". The Style dropdown is expanded, listing Regular, Title and subtitle, Title, subtitle and image (selected, highlighted), and Title and image, with a red arrow pointing from the Style property to this list.

Properties of Popover:

Font Icon Class

Specifies the Font Awesome icon that will be displayed before the text. It can be formatted with another class defined in the Section node of the Theme to specify the color and size of the icon.

Position

Specifies the position of the Popover that will be displayed when hovering the button or clicking on it. The options are left, right, top, bottom.

Trigger

Specifies what action must be taken to display the Popover. The options are Click and Hover.

 

Master Page Search:

Master Page Search Style

Search result style.

Include in Master Page search

Include or not the search field in Master Page.

Mask

Mask Options

Masks defined to use on attributes/variables.

Possible values:

  • IP Address
  • Thousand separator
  • CPF**
  • CNPJ**
  • CPF or CNPJ**

'Editor' dialog for mask values listing Description/Value pairs: IP Address (099.099.099.099), Thousand separator (#<THS>##0;reverse), CPF (000.000.000-00), CNPJ (00.000.000/0000-00), and CPF or CNPJ (combined pattern), with Add, Remove, Edit, Move up, Move down, OK, and Cancel buttons.

** If the Knowledge Base's language is set to "Portuguese", the CPF, CNPJ  and CPF or CNPJ options will be available by default.

You can define your own Masks which you can use in any instance of WorkWithPlus for Web.

  • Description: Thousand separator decimal
  • Value: #<THS>##0<DEC>00;reverse

Once a new mask is created within WorkWithPlus for Web Settings, you will be able to use it in any instance of your KB.

The following table shows the wildcards characters that can be entered for the property:

0 Only Number
9 Optional Number
S Only letter
A Letter or Number
<THS> Thousands separator
<DEC> Decimal separator

 

An example of completing and formatting a field for a phone number would be the following

Animated demo frame showing a plain 'Phone number' text label on a blank background, part of a sequence illustrating an input mask being applied to a phone field.


To achieve this, we have two formats, one for 10 digits, and if a digit 11 is placed, it is placed where the number 9 is, taking the second format and adding it in the position of the optional number.

(00) 0000-0000;(00) 00009-0000