Wikiadmin: Created page with "== Introduction == This howto explains how to add a masked text field and column to the Openbravo system. A [http://smartclient.com/#maskedTextItem masked] text can be used t..."

2018-10-14T14:06:04Z

Created page with "== Introduction == This howto explains how to add a masked text field and column to the Openbravo system. A [http://smartclient.com/#maskedTextItem masked] text can be used t..."

New page

== Introduction ==

This howto explains how to add a masked text field and column to the Openbravo system. A [http://smartclient.com/#maskedTextItem masked] text can be used to force the user in entering text/string values in the correct format.

The steps to get a masked text field in your window consists of 2 steps: 1) create a reference defining the mask, 2) add a column to a table using the reference, and 3) add a field to a tab.

The last 2 steps are defined in detail in the following howtos:
* [[How_to_add_Columns_to_a_Table|Add a new column to a table in the system]]
* [[How_to_add_a_field_to_a_Window_Tab|Define and add a new field to a tab]]

This howto will only focus on the specific parts of a masked text field.

{{(!)|Masked text fields are available in MP20 and later MPs.}}

== Example Module ==

This howto is supported by an example module which shows example of the code shown and discussed in this howto.

The example module adds a mask text field to the sales order header window. Please use an example module version of a release/implementation date of 23rd of January or later.

The code of the example module can be downloaded from this mercurial repository: https://code.openbravo.com/erp/mods/org.openbravo.client.application.examples/

{{(!)|The example module also contains implementations of other howtos.}}

== Defining the Mask Reference ==

The first step is to create a specific reference for the mask and then set the mask in the mask reference child tab.

The mask reference must have the 'Masked String' as the parent reference and can not be a base reference. Then create a record in the 'Mask Reference' child tab defining the mask.

[[Image:howto-mask-text-reference.png|center|600px]]

For information on how to define a mask see the description in the 'Masked String' parent reference.

[[Image:howto-mask-text-parent-reference.png|center|600px]]

== Adding a column - selecting the correct reference ==

To get a mask text field, the first thing to do is to select the correct reference and reference search key when [[How_to_add_Columns_to_a_Table|adding a column]]:

[[Image:howto-mask-text-column-reference.png|center|600px]]

== Create a field ==

Then [[How_to_add_a_field_to_a_Window_Tab|create a field]] within the tab/window:

[[Image:howto-rich-text-field.png|center|600px]]

== The result ==

The result is visualized as a masked text editor in form view:

[[Image:howto-mask-text-result.png|center]]

[[Category:HowTo]]

How to add a masked text field - Revision history

Wikiadmin: Created page with "== Introduction == This howto explains how to add a masked text field and column to the Openbravo system. A [http://smartclient.com/#maskedTextItem masked] text can be used t..."