Submit

Материал из VXML
Перейти к: навигация, поиск


<submit> — элемент, используемый для передачи информации в другой документ. В отличие от <goto> данный элемент позволяет разработчику передать список переменных, разделенных пробелом, с помощью HTTP GET или POST методов.

Синтаксис

<submit enctype="CDATA"
       expr="CDATA"
       fetchaudio="CDATA"
       fetchhint="(prefetch|safe)"
       fetchtimeout="CDATA"
       method="(GET|POST)"
       namelist="NMTOKEN"
       next="CDATA">

Атрибуты

  • next — URI ссылки, куда происходит передача
    (Необходимость указания: обязательно, если не указан expr)
  • expr — как и атрибут next определяет URI файла, однако адрес определяется с помощью ECMAScript, что дает возможность разработчику динамически изменять URI.
    (Необходимость указания: обязательно, если не указан next)
  • namelist — список переменных, необходимых для представления. По умолчанию предоставляется весь список переменных. Переменные должны быть объявлены. В противном случае выдается ошибка error.semantic.
    (Необходимость указания: необязательно)
    По умолчанию: все переменные
  • method — указывает HTTP метод, который используется, когда отправляется запрос.
    (возможны значения 'GET' и 'POST')
    (Необходимость указания: необязательно)
    По умолчанию: GET
  • enctype — определяет MIME тип грамматики. Возможные значения атрибута:
    'application/grammar-xml' и 'text/gsl'
    (Необходимость указания: необязательно)
    По умолчанию: application/grammar-xml
  • fetchaudio — URI на аудио-файл, который проигрывается, пока получение не будет выполнено.Если адрес не указан и используется данный атрибут или атрибут не указан, никакое аудио проигрываться не будет.
    (Необходимость указания: необязательно)
  • fetchtimeout — время ожидания содержимого сценария, которое должно быть возвращено, до тех пор пока не произойдет ошибка error.badfetch event. Если не указано, то используется значение по умолчанию
    (Необходимость указания: необязательно)
    По умолчанию: 5s
  • fetchhint — используется, чтобы определить, когда данные должны быть получены во время выполнения работы приложения.Возможные значения и их описания:
  1. prefetch — данные получаются при первом выполнении документа
  2. safe — данные получаются, только когда они специально запрашиваются в приложении
    (Необходимость указания: необязательно)
    По умолчанию: safe
  • maxage — указывает максимально допустимое время выполнения сценария. Время указывается в секундах.
    (Необходимость указания: необязательно)

Родители

<block> <catch> <error> <filled> <help> <if>

Потомки

none

Пример

Пример демонстрирует передачу значения переменной number в файл new.xml.

<?xml version="1.0" encoding="UTF-8"?>
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="ru-RU">
  <var name="number" expr="'0'"/>
  <form id="form">
    <block>
      <prompt>Переменной "number" присваиваем значение "5".</prompt>
      <assign name="number" expr="'5'"/>
      <prompt>
        Переменной "number" присвоено значение <value expr="number"/>.
        Переходим в файл "new.xml" и передаем переменную "number".
      </prompt>
      <submit next="new.xml" namelist="number"/>
    </block>
  </form>
</vxml>

Файл new.xml.

<?xml version="1.0" encoding="UTF-8"?>
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="ru-RU" application="test.xml">
  <form id="Form">
    <block>
      <prompt>
        Переход успешный. Переменной "number" присвоено значение <value expr="number"/>. 
        Тестирование завершено.
      </prompt>
    </block>
  </form>
</vxml>



Добавить новый комментарий
Если не хотите писать от анонимного пользователя, зарегистрируйтесь или представьтесь системе.

Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Статьи
Грамматики
Элементы VXML
Элементы SSML
Инструменты