Angular Template

AngularTemplateImg01

Template node has the following properties:

Category Property  
General Properties Include Automatic Conditions In Data Selector AngularTemplatePropertiesImg01
Validation Message Display
Default Instance Tab for parallel transactions
Generate View
Generate Selection
Consider Show In Default Form
Max Grid Attributes
Max Filters
Max View Tabs
Navigation Return Procedure
Auditing Enable Auditing
Auditing Condition
Auditing Levels
Update Instances Update Instances
Merge with previous Table Merge with previous Table Theme
Prompt Generate Prompt
Prompt Image
Filter Prompt FKs of PK
Filter Multiple Prompt Image
Default Prompt Parameter Type
Prompt Encrypt URL Parameters
FK Selector Default Auto FK selector
Auto FK selector type
Exclude auto FK selector Description Attributes
Auto FK selector description
Multirow Actions Check Selected Lines
Select All Pages
View Tab Options SDT
Grid Tab Count
Extended Controls Excessive Tabs Behavior
Action Group Type
Grid Action Group Type
Fields Help Text Help Text Theme Class
Help Text Info Icon
Info Icon Tooltip Position
Editable Grid Force not Smooth
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
Infinite scrolling page
Multiple Selection Display Type
DVelop Combo Styles
Popover Font Icon Class
Font Icon
Position
Master Page Search  Master Page Search Style
Include in Master Page search
Mask Mask Options
Dynamic Allow Dynamic Sections
Allow Dynamic Validation
List Use Read Replica
Master Panel Master Panel

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.

 

 

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:

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).

 

 

 

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:

TemplateImg08

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

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.

 

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 three possibilities:

  • Prompt
  • DVelop Combos
  • Extended Suggests

 

Exclude auto 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:

ExcludeDescAttSettings

Person transaction has CompanyId as an FK of Company:

ExcludeDescAtt2

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:

ExcludeDescAtt3

 

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:

AutoDVelopComboDescription1

  • 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':

AutoDVelopComboDescription2

 

 

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.

TemplateImg09

TemplateImg10

 

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:

TemplateImg11

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

CountGridTabs

Example 2

CountGridTabs2

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):

CountGridTabs3

 

 

Properties Of Category Extended Controls:

Excessive Tabs Behavior

Behavior when tabs exceed the width of the page.

Two possible values:

  • Rows
  • Slider

 

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 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

TemplateImg21

TemplateImg22

 

Help Text Info Icon:

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

 

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 Editable Grid:

Force not Smooth

If true, the Grid Objects with 'Web User Experience = Use model property' that contains the StandardAction Insert, Update or Delete with InLine='True' will be forced to not use Smooth Web user experience.

 

 

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'.

Infinite scrolling page

Indicates the number of records that are loaded at once when scrolling.

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.

ExtendedComboTags

Extended Combo/Suggest Styles

Specify the different ways to display the values within the Extended 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.

DVelopComboStylesImg001

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

DVelopComboStyleImg02

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

DVelopComboStyleImg03

 

 

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.

Font Icon

Specifies the icon that will trigger the popover to be displayed.

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.

 

 

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**

MaskOptionsImg01

** 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

maskphonenumberimg01


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

 

 

Dynamic

Allow Dynamic Sections

Defines wheather the transactions will allow having dynamic sections by default.

Allow Dynamic Validations

Defines wheather the transactions will allow having dynamic validations by default.

 

 

List

Use Read Replica

Property to be considered in List, Prompts and Grid Tab objects to set the 'Use Read Replica' of the generated Data Selectors. This property will only be considered if the property 'Generate Data Selector For Conditions' is True in the WorkWithPlus node of the object.

 

 

Master Panel

Master Panel

Defines what the Master Panel is, similar to the Master Page in Web environments.