<filled>

Action to perform after a form input item is filled.

Syntax

<filled
    mode = "{all | any}"
    namelist = "list of identifiers"
/>

Attributes

Attribute

Data Type

Required?

Default

Description

mode

identifier

no

all

Determines when the <filled> element is executed. Valid values:

  • all = <filled> element is executed when all of the fields are filled.

  • any = <filled> element is executed when any of the fields are filled.

If the <filled> element is specified at the form-item level, the mode attribute cannot be specified in the <filled> element.

namelist

list of identifiers

no

NA

Space-separated list of input item variables. Control items are not permitted in this list. When omitted, the namelist defaults to the names of all of the form's input items. If the <filled> tag is specified at the form-item level, the namelist attribute cannot be specified in the <filled> tag.

Details

The <filled> element can be a child of:

Parents

<field>, <form>, <object>, <record>, <subdialog>, <transfer>

Children

<assign>, <audio>, <clear>, <data>, <disconnect>, <enumerate>, <exit>, <foreach>, <goto>, <if>, <log>, <prompt>, <reprompt>, <return>, <script>, <submit>, <throw>, <value>, <var>

Example

<?xml version="1.0"?>
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml">
    <form>
        <field name="userID" type="digits?length=8">
            <prompt>What is your user ID?</prompt>
                <noinput>
                    Please say or key in your eight digit user ID
                    <reprompt/>
                </noinput>
        </field>
        <field name="pin" type="digits?length=4">
            <prompt>What is your pin number?</prompt>
                <noinput>
                    Please say or key in your four digit pin number
                    <reprompt/>
                </noinput>
        <!-- 
            A field level <filled> - does not specify mode or namelist.
        -->
                <filled>
                    <if cond="pin == 9999">
                        Entry denied - please retry
                        <clear namelist="pin"/>
                    <elseif cond="pin == 0000"/>
                        Invalid pin - please re try
                        <clear namelist="pin"/>
                    <else/>
                        You entered <value expr="pin"/>
                    </if>
                </filled>
        </field>
    <!--
        A form level <filled> - executes when both fields are filled: 
    -->
        <filled namelist="userID pin" mode="all">
            <submit next="validate.jsp"/>
        </filled>
    </form>
</vxml>

See Also

<field>, <form>, <object>, <record>, <subdialog>, <transfer>