The following document contains examples of forms where various Actions have been programmed.

1 Report Action

Form with a 'Report' action showing a list-type report using a field filled in on the form.

1.1 Example

User wants to check the stock of an item in various warehouses.

  • The form contains a field called item_code, and the form action is to generate a report with the SQL statement.

1.2 Step-by-Step Process

1.2.1 Create the Form Head

  • Choose the action Report
  • Indicate the SQL statement which will be executed at each iteration
  • The WHERE statement includes the item_code variable entered by the user at each iteration in the form.
  • In this example, the list report's output consists of the warehouse, the location, and the current stock.

1.2.2 Create a Group

Create the group before creating its fields.

In this example, we only need one group to include the item field.

1.2.3 Create Form Fields

Add one field to the form. Its parameters are:

  • Field of 'group 1' at head group.
  • Code 'item_code' related in the SQL statement of the form head.
  • Label Item. Simply used to indicate that the input field belongs to an item code.
  • Mnemonic item_code. Show tag in zone scroll.
  • Mode 'Input'. Field is visible and editable.
  • Type 'char'. This is because the related column 'item_code' is a char.
  • Required 'Yes'. In this case, entering an item code is mandatory.
  • Hide 'No'. Makes the field an input field and lets the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

1.2.4 Add the Form to a Menu

1.3 Web Terminal Execution

Web Terminal Execution
Execution of the form, with Item field as input. Input item code and hit Enter. Form execution generates a list-type report.

2 Insert Action

Form with an 'Insert' action which inserts new data into a database table using form fields.

2.1 Example

The user wants to add new data into the stock table. This action will add a new item to the warehouse, making it available for stock transactions.

  • The form must include all fields necessary for the transaction.
  • The name of the form's fields must match the names of the table columns. The transaction will skip form fields whose names do not match.
  • In this example, the Insert transaction is performed on the table term_wms_stock.

The table structure is:

2.2 Step-by-Step Process

2.2.1 Create the Form Head

  • Choose the Insert action
  • Indicate the name of the table where the insert statement will be executed at each iteration.

In this example, the table is term_wms_stock.


2.2.2 Create a Group

Create the group before creating its fields.

In this example, we only need one group to include fields.

2.2.3 Create Form Fields

In this case, we need four fields to perform the insertion that matches the table columns.

  • warehouse_code (char)
  • item_location (char)
  • item_code (char)
  • stock (decimal)

Parameters of the warehouse_code Field

  • Field of 'group 1' at head group.
  • Code 'warehouse_code' related to table column.
  • Label Warehouse. Simply used to indicate that the input field belongs to a warehouse code.
  • Mnemonic warehouse_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'char'. This is because the related column 'warehouse_code' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter a warehouse code.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.
  • Validation parameters are set to ensure that a specific set of values is entered. In this case, the user, rather than enter a value as Warehouse, selects from a list of values from the table term_wms_warehouse. Performing validation will fill out the Help box.

Parameters of the item_location Field

  • Field of 'group 1' at head group.
  • Code 'item_location' related to table column.
  • Label Location. Simply used to indicate that the input field belongs to a location code.
  • Mnemonic location_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'char'. This is because the related column 'item_location' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter a location code.
  • Default '0'. Adds this default value to the saved input.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

Parameters of the item_code Field

  • Field of 'group 1' at head group.
  • Code 'item_code' related to the table column.
  • Label Item. Simply used to indicate that the input field belongs to an item code.
  • Mnemonic item_code. Show tag in zone scroll.
  • Mode Input. Field visible and editable.
  • Type 'char'. This is because the related column 'item_code' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter an item code.
  • Validation parameters are set to ensure that a specific set of values is entered. In this case, the user, rather than enter a value as Item, selects from a list of values from the table term_wms_item. Performing validation will fill out the Help box.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

Parameters of the 'stock' Field

  • Field of 'group 1' at head group.
  • Code 'stock' related to the table column.
  • Label Stock. Simply used to indicate that the input field belongs to a stock number.
  • Mnemomic stock_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'decimal'. Because the related column 'stock' is a decimal.
  • Required 'Yes'. In this case, it is mandatory to enter a value.
  • Default '1'. Adds this default value to the saved input.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

2.2.4 Add the Form to a Menu

2.3 Web Terminal Execution

Web Terminal Execution
First 'warehouse' field soft referenced to 'warehouse' table List of available warehouses Second field location is 0 by default
Item validation Number of items entered

2.4 Stock

The last three rows consist of the new data inserted.

Copy
SELECT * FROM term_wms_stock
                
    +--------------+-------------+----------------+----------------+
    |warehouse_code|item_location|item_code       |stock           |
    +--------------+-------------+----------------+----------------+
    |WMS_CENTRAL   |0            |I00001          |         100,000|
    |WMS_CENTRAL   |0            |I00002          |          75,000|
    |WMS_CENTRAL   |0            |I00003          |          30,000|
    |WMS_CENTRAL   |0            |I00004          |          20,000|
    |WMS_CENTRAL   |0            |I00005          |          15,000|
    |WMS_CENTRAL   |0            |I00006          |          80,000|
    |WMS_CENTRAL   |0            |I00007          |          40,000|
    |WMS_CENTRAL   |0            |I00008          |          60,000|
    |WMS_CENTRAL   |0            |I00009          |          10,000|
    |WMS_CENTRAL   |0            |I00010          |          33,000|
    |WMS_NORTH     |0            |I00001          |          50,000|
    |WMS_NORTH     |0            |I00002          |          35,000|
    |WMS_NORTH     |0            |I00003          |          40,000|
    |WMS_NORTH     |0            |I00004          |          50,000|
    |WMS_NORTH     |0            |I00005          |           5,000|
    |WMS_LAND      |0            |I00006          |          20,000|
    |WMS_LAND      |0            |I00007          |          10,000|
    |WMS_LAND      |0            |I00008          |          25,000|
    |WMS_LAND      |0            |I00009          |          40,000|
    |WMS_LAND      |0            |I00010          |          76,000|
    |WMS_NORTH     |0            |I00006          |           1,000|
    |WMS_NORTH     |0            |I00008          |           5,000|
    |WMS_LAND      |0            |I00002          |           2,000|
    +--------------+-------------+----------------+----------------+

3 Update Action

Forms with an 'Update' action update table data and can use the form's data fields in the 'where' clause.

3.1 Example

User wants to adjust the stock value of an item for a specific warehouse location.

  • The form must include all fields necessary for the transaction.
  • The name of the form fields must match the names of the table columns, as the process will skip the form fields of the form that don't match.
  • In this example, the update transaction is performed on the table term_wms_stock.

The table structure is:

3.2 Step-by-Step Process

3.2.1 Create the Form Head

  • Choose the Update action.
  • Indicate the name of the table where the update statement will be executed at each iteration.
  • In this example, the table is term_wms_stock.
  • Also indicate the WHERE condition using '?'. At each iteration, the program will replace it with the same combined field.
  • In this example, the condition is: warehouse_code = ? AND item_location = ? AND item_code = ?
  • The program will update all the matching form fields with the columns of the table.

In this example, the statement appears as follows:

Copy
UPDATE TABLE term_wms_stock 
       SET warehouse_code = '@warehouse_code', 
           item_location  ='@item_location', 
           item_code      ='@item_code', 
           stock          = @stock 
     WHERE warehouse_code = '@warehouse_code' 
       AND item_location  ='@item_location' 
       AND item_code      ='@item_code'

the @ fields are the values entered by the user at each iteration.

3.2.2 Create a Group

Create the group before creating its fields.

In this example, we only need one group to include the fields.

3.2.3 Create Form Fields

In this case, we need four fields to perform the update matching the table columns.

  • warehouse_code (char)
  • item_location (char)
  • item_code (char)
  • stock (decimal)

Parameters of the warehouse_code Field

  • Field of 'group 1' at head group.
  • Code 'warehouse_code' related to table column.
  • Label Warehouse. Simply used to indicate that the input field belongs to a warehouse code.
  • Mnemonic warehouse_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'char'. This is because the related column 'warehouse_code' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter a warehouse code.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.
  • Validation parameters are set to ensure that a specific set of values is entered. In this case, the user, rather than enter a value as Warehouse, selects from a list of values from the table term_wms_warehouse. Performing validation will fill out the Help box.

Parameters of the item_location Field

  • Field of 'group 1' at head group.
  • Code 'item_location' related to table column.
  • Label Location. Simply used to indicate that the input field belongs to a location code.
  • Mnemonic location_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'char'. This is because the related column 'item_location' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter a location code.
  • Default '0'. Adds this default value to the saved input.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

Parameters of the item_code Field

  • Field of 'group 1' at head group.
  • Code 'item_code' related to the table column.
  • Label Item. Simply used to indicate that the input field belongs to an item code.
  • Mnemonic item_code. Show tag in zone scroll.
  • Mode Input. Field visible and editable.
  • Type 'char'. This is because the related column 'item_code' is a char.
  • Required 'Yes'. In this case, it is mandatory to enter an item code.
  • Validation parameters are set to ensure that a specific set of values is entered. In this case, the user, rather than enter a value as Item, selects from a list of values from the table term_wms_item. Performing validation will fill out the Help box.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

Parameters of field stock

  • Field of 'group 1' at head group.
  • Code 'stock' related to the table column.
  • Label Stock. Simply used to indicate that the input field belongs to a stock number.
  • Mnemonic stock_code. Show tag in zone scroll.
  • Mode 'Input'. Field visible and editable.
  • Type 'decimal'. This is because the related column 'stock' is a decimal.
  • Required 'Yes'. In this case, it is mandatory to enter a value.
  • Default 'Current stock'. indicates the current stock value to user.
    The default value supports the SQL statement, in this case:

    SELECT stock FROM term_wms_stock WHERE warehouse_code = '@warehouse_code' AND item_location = '@item_location' AND item_code = '@item_code'

    the @ fields are the previously-entered values.
  • Hide 'No'. Simply used to make the field type Input and let the user enter a value.
  • Spoken 'No'. Text-to-speech not enabled.

3.2.4 Add the Form to a Menu

3.3 Web Terminal Execution

Web Terminal Execution
First 'warehouse' field soft referenced to 'warehouse' table List of available warehouses Second field location is 0 by default
Item validation Number of items entered Form execution and restart

4 Delete Action

Forms with a 'Delete' action delete table data and can use form data fields in the 'where' clause.

4.1 Example

User wants to remove item stock from a warehouse location.

  • The form must include all the necessary fields for the transaction.
  • The name of the form fields must match the names of the table columns, skipping the form fields which do not match.
  • In this example, the delete transaction is in the term_wms_stock table.
  • The table structure is:
Copy
+-----------------------+--------------------+--------------------+----------+
    |warehouse_code         |item_location       |item_code           |stock     |
    |char 12                |char 12             |char 16             |decimal   |
    +-----------------------+--------------------+--------------------+----------+

4.2 Step-by-Step Process

4.2.1 Create the Form Head

  • Choose the Delete action
  • Indicate the name of the table where the delete statement will be executed at each iteration.
  • In this example, the table is term_wms_stock.
  • Also indicate the WHERE condition using '?'. At each iteration, the program will replace it with the same combined field.
  • In this example, the condition is: warehouse_code = ? AND item_location = ? AND item_code = ?
  • The program will update all form fields matching the table columns.

In this example, the statement will appear as follows:

Copy
DELETE FROM term_wms_stock 
           WHERE warehouse_code = '@warehouse_code' 
             AND item_location  ='@item_location' 
             AND item_code      ='@item_code'

the @ fields are the values entered by the user at each iteration.

4.2.2 Create a Group

Create the group before the fields.

In this example we only need one group to include the fields.

4.2.3 Create Form Fields

In this case we need 3 fields to perform the update that match with the columns of the table.

  • warehouse_code (char)
  • item_location (char)
  • item_code (char)

Parameters of field warehouse_code

  • Field of 'group 1' at head group.
  • Code 'warehouse_code' related with the column of the table.
  • Label Warehouse. Just to indicate the user that the input field belongs to an warehouse code.
  • Mnemonic 'warehouse_code' Show tag in zone scroll.
  • Mode 'Input' Field not hidden and editable.
  • Type 'char'. Because the related column 'warehouse_code' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as warehouse , select from a list of values from the table term_wms_warehouse . To perform validation fill the box ' help'
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No' Not talk.

Parameters of field item_location

  • Field of 'group 1' at head group.
  • Code 'item_location' related with the column of the table.
  • Label 'Location'. Just to indicate the user that the input field belongs to an location code.
  • Mnemonic 'location_code'. Show tag in zone scroll.
  • Mode 'Input'. Field not hidden and editable.
  • Type 'char'. Because the related column 'item_location' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Default '0'. Just to add this default value in the filed input.
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No'. Not talk.

Parameters of field item_code

  • Field of 'group 1' at head group.
  • Code 'item_code' related with the column of the table.
  • Label Item. Just to indicate the user that the input field belongs to an item code.
  • Mnemonic 'item_code' Show tag in zone scroll.
  • Mode 'Input' Field not hidden and editable.
  • Type 'char'. Because the related column 'item_code' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as item , select from a list of values from the table term_wms_item . To perform validation fill the box ' help'
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No' Not talk.

4.2.4 Add the form to a menu

4.3 Web Terminal Execution

Web Terminal Execution
First field warehouse with soft-ref to warehouse table List of available warehouses
validation of item. Number of items and intro

5 Action procedure

Form with an action 'Procedure' call XSQL-Script, for more complex actions where the action of the end of the form needs to perform a process

5.1 Example

User wants to create, adjust or remove stock from an item in a specific warehouse.

  • The form must have all the necessary fields for the possible transactions.
  • Sentence accept XSQL-Script or Native procedure
  • Prepare the XSQL-Script or Native procedure


Copy
<!-- ============================================================================== -->
    <!--                                                                                -->
    <!--    XSQL: term_wms_form_procedure                                               -->
    <!--                                                                                -->
    <!--    Receives the values indicateed at form and proceed to                         -->
    <!--    create, adjust or delete stock of an item in a warehouse,                   -->
    <!--    using the option sleceted by the user at first field of form.               -->
    <!--                                                                                -->
    <!-- ============================================================================== -->
    <xsql-script name='term_wms_form_procedure'>
       <args>
           <arg name='p_option'         type='string' />
           <arg name='p_warehouse_code' type='string' />
           <arg name='p_item_location'  type='string' />
           <arg name='p_item_code'      type='string' />
           <arg name='p_stock'          type='decimal' />
       </args>
       <body>
       	
       <switch name='p_option'>
            <case value='ADD'>
                <!-- create new entry at table -->
                <insert table='term_wms_stock'>
                	<column name='warehouse_code'><p_warehouse_code /></column>
                	<column name='item_location'><p_item_location /></column>
                	<column name='item_code'><p_item_code /></column>
                	<column name='stock'><p_stock /></column>
                </insert>
                		
            </case>
            <case value='ADJ'>
            	<!-- Modify the stock of the table -->
            	<update table='term_wms_stock'>
            		<column name='stock'><p_stock/></column>
            		<where>
            		    warehouse_code = <p_warehouse_code /> AND
            		    item_location  = <p_item_location />  AND
            		    item_code      = <p_item_code/>	
            		</where>	
            	</update>	
            	
            </case>
            <case value='DEL'>
                <!-- Remove an entry of the table -->
                <delete table='term_wms_stock'>
                	<where>
                	    warehouse_code = <p_warehouse_code /> AND
            		    item_location  = <p_item_location />  AND
            		    item_code      = <p_item_code/>	
                	</where>	
                </delete>		
            </case>		
       </switch>	 	
       	
       	
       </body>
    </xsql-script>


Copy
<!-- ================================================================================ -->
    <!--                                                                                  -->
    <!--    XUDP : term_wms_form_procedure                                                -->
    <!--                                                                                  -->
    <!--                                                                                  -->
    <!-- ================================================================================ -->
    <procedure name='term_wms_form_procedure'>
        <args>
            <arg name='p_option'            type='char' mode='in' />
            <arg name='p_warehouse_code'    type='char' mode='in' />
            <arg name='p_item_location'     type='char' mode='in' />
            <arg name='p_item_code'         type='char' mode='in' />
            <arg name='p_stock'             type='decimal' mode='in' />
        </args>
    
        <body>
    
            <if>
                <expr>p_option = 'ADD'</expr>
                <then>
                    <insert table='term_wms_stock'>
                        <column name='warehouse_code'>p_warehouse_code</column>
                        <column name='item_location'>p_item_location</column>
                        <column name='item_code'>p_item_code</column>
                        <column name='stock'>p_stock</column>
                    </insert>
                </then>
    
                <else-if>
                    <expr>p_option = 'ADJ'</expr>
                    <then>
                        <update table='term_wms_stock'>
                            <column name='stock'>p_stock</column>
                            <where>
                                warehouse_code = p_warehouse_code AND
                                item_location  = p_item_location  AND
                                item_code      = p_item_code
                            </where>
                        </update>
                    </then>
                    <else>
                        <delete table='term_wms_stock'>
                            <where>
                                warehouse_code = p_warehouse_code AND
                                item_location  = p_item_location  AND
                                item_code      = p_item_code
                            </where>
                        </delete>
                    </else>
                </else-if>
    
            </if>
        </body>
    </procedure>

Copy
-- **************************************************************************
    -- term_wms_form_procedure
    -- DEISTER Axional Studio XSQL-UDFUNC  -  Engine: ids
    -- **************************************************************************
    CREATE PROCEDURE term_wms_form_procedure(
        p_option char,
        p_warehouse_code char,
        p_item_location char,
        p_item_code char,
        p_stock decimal
    )
    
    
        -- =========================================================
        -- Debug
        -- To activate debug mesages, call sdm_set_debug(1) or level
        -- =========================================================
        DEFINE GLOBAL gl_debug   SMALLINT DEFAULT 0;    -- DEBUG FLAG
        IF gl_debug > 1 THEN
            TRACE ON;
        END IF
    
        -- =================================
        -- Function body
        -- =================================
        IF p_option = 'ADD' THEN
          INSERT INTO term_wms_stock (warehouse_code, item_location, item_code, stock)
            VALUES (p_warehouse_code, p_item_location, p_item_code, p_stock);
         ELIF p_option = 'ADJ' THEN
           UPDATE term_wms_stock
              SET stock=p_stock
            WHERE 
                                warehouse_code = p_warehouse_code AND
                                item_location  = p_item_location  AND
                                item_code      = p_item_code
                            ;
        END IF;
    
    END PROCEDURE;

The structure of the table is:

5.2 Step by step

5.2.1 Create the form head

  • Choose action Procedure
  • Indicate the sentence statement.

In this example the code is a XSQL-Script call

Copy
<call name='term_wms_form_procedure'>
        <args>
            <arg>@v_option</arg>
            <arg>@warehouse_code</arg>
            <arg>@item_location</arg>
            <arg>@item_code</arg>
            <arg>@stock</arg>
        </args>
    </call>

Or Native proceudre

Copy
EXECUTE PROCEDURE term_wms_form_procedure('@v_option','@warehouse_code','@item_location','@item_code', '@stock')

The script or procedure recives the fields of the form using @ + field_code to reference the value filled at the form.


5.2.2 Create a Group

Create the group before the fields.

In this example we only need one group to include the fields.

5.2.3 Create Form Fields

In this case we need 5 fields to perform the XSQL-script that match with the input values of the script.

Also add 2 extra display fields just to indicate the option and item descriptions.

  • v_option (char)
  • v_option_name (char)
  • warehouse_code (char)
  • item_location (char)
  • item_code (char)
  • item_name (char)
  • stock (decimal)

The form action runs a program that will create, update, and delete records in the table of stock.

Parameters of field v_option

  • Field of 'group 1' at head group.
  • Code 'v_option'
  • Label 'Option'. Just to indicate the user that the input field belongs to an option code.
  • Mnemonic 'v_option'. Show tag in zone scroll.
  • Mode 'Input'. Field not hidden and editable.
  • Type 'char'.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as warehouse_option , select from a list of values from the table term_wms_warehouse_options . To perform validation fill the box ' help'
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No'. Not talk.

Parameters of field v_option_name

  • Field of 'group 1' at head group.
  • Code 'v_option_name'
  • Label 'Description'.
  • Mnemonic 'v_option_name'.
  • Mode 'Display'.
  • Type 'char'.
  • Required 'No'. Because it's a display field.
  • Default 'SQL sentence'. Filtering using @ + field_code
Copy
SELECT option_name FROM term_wms_warehouse_option WHERE option_code = '@v_option'
  • Hide 'No' Just to make the field display (no-input).
  • Spoken 'No'. Not talk.

Parameters of field warehouse_code

  • Field of 'group 1' at head group.
  • Code 'warehouse_code' related with the column of the table.
  • Label Warehouse. Just to indicate the user that the input field belongs to an warehouse code.
  • Mnemonic warehouse_code. Show tag in zone scroll.
  • Mode Input. Field not hidden and editable.
  • Type 'char'. Because the related column 'warehouse_code' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No'. Not talk.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as warehouse , select from a list of values from the table term_wms_warehouse . To perform validation will fill the box ' help'

Parameters of field item_location

  • Field of 'group 1' at head group.
  • Code 'item_location' related with the column of the table.
  • Label Location. Just to indicate the user that the input field belongs to an location code.
  • Mnemonic 'location_code' Show tag in zone scroll.
  • Mode 'Input' Field not hidden and editable.
  • Type 'char'. Because the related column 'item_location' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Default '0'. Just to add this default value in the filed input.
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No' Not talk.

Parameters of field item_code

  • Field of 'group 1' at head group.
  • Code 'item_code' related with the column of the table.
  • Label 'Item'. Just to indicate the user that the input field belongs to an item code.
  • Mnemonic 'item_code'. Show tag in zone scroll.
  • Mode 'Input'. Field not hidden and editable.
  • Type 'char'. Because the related column 'item_code' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as item , select from a list of values from the table term_wms_item . To perform validation fill the box ' help'
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No'. Not talk.

Parameters of field v_item_name

  • Field of 'group 1' at head group.
  • Code 'v_item_name'
  • Label Description. Just to indicate the user the name of the selected previous item.
  • Mnemonic 'v_item_name'.
  • Mode 'Display'. Just to make the field display (no-input).
  • Type 'char'.
  • Required 'No'. Because it's display field.
  • Default 'SQL sentence'. Filtering using @ + field_code
Copy
SELECT item_name FROM term_wms_item WHERE item_code = '@item_code'
  • Hide 'No' Just to make the field input and let the user enter a value.
  • Spoken 'No'. Not talk.

Parameters of field stock

  • Field of 'group 1' at head group.
  • Code 'stock' related with the column of the table.
  • Label Stock. Just to indicate the user that the input field belongs to an stock number.
  • Mnemonic 'stock_code' Show tag in zone scroll.
  • Mode 'Input' Field not hidden and editable.
  • Type 'decimal'. Because the related column 'stock' is a decimal.
  • Required 'Yes'. Because it's mandatory to enter an value in this case.
  • Default '0'. Just to add this default value in the filed input.
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No' Not talk.

5.2.4 Add the form to a menu

5.3 Web Terminal Execution

choose option [Adjust item-stock]

Web Terminal Execution
Field option List of possible options
Warehouse code Location
Code of item Stock filled and form restart
Copy
SELECT * FROM term_wms_stock WHERE warehouse_code = 'WMS_LAND'
                
    +--------------+-------------+----------------+----------------+
    |warehouse_code|item_location|item_code       |stock           |
    +--------------+-------------+----------------+----------------+
    |WMS_LAND      |0            |I00006          |          20,000|
    |WMS_LAND      |0            |I00007          |          10,000|
    |WMS_LAND      |0            |I00008          |          25,000|
    |WMS_LAND      |0            |I00009          |          40,000|
    |WMS_LAND      |0            |I00010          |          76,000|
    |WMS_LAND      |0            |I00002          |          60,000|
    +--------------+-------------+----------------+----------------+

6 Action Settings

Form with an action 'Settings' allow to store the values entered in the form, keeping them during the session and to use them in other forms without having to fill values making the forms process faster.

If an operator has to work in a warehouse. If reported in a form with the action settings the warehouse code, other forms can retrieve the value.

For this, the code fields must match and be the same.

6.1 Example

User init the warehouse where has to work only once and other form receives the value filled at previous form

In this example we prepare 2 forms.

  1. Form with action settings with one field 'warehouse_code'
  2. Form with action report that don't ask for field warehouse_code because will filled automatically from the first form.

6.2 Step by step

6.2.1 Create the form head

  • Choose action Settings

6.2.2 Create a Group

Create the group before the fields.

In this example we only need one group to include the fields.

6.2.3 Create Form Fields

In this case we need 1 field. Because we want to store one value 'the waherouse code'

  • warehouse_code (char)

Parameters of field warehouse_code

  • Field of 'group 1' at head group.
  • Code 'warehouse_code' related with the column of the table.
  • Label Warehouse. Just to indicate the user that the input field belongs to an warehouse code.
  • Mnemonic 'warehouse_code' Show tag in zone scroll.
  • Mode 'Input' Field not hidden and editable.
  • Type 'char'. Because the related column 'warehouse_code' is a char.
  • Required 'Yes'. Because it's mandatory to enter an item code in this case.
  • Hide 'No'. Just to make the field input and let the user enter a value.
  • Spoken 'No' Not talk.
  • Introducing validation parameters to ensure the introduction of a specific set of values that in this case the user instead of entering a value as warehouse , select from a list of values from the table term_wms_warehouse . To perform validation will fill the box ' help'

6.2.4 Add the form to a menu



Web Execution
Field input warehouse Help field, select a warehouse Value warehouse_code are stored in session