Cree y configure un formulario para invocar API Task y asigne las variables de API Task a los campos necesarios del formulario.

Antes de empezar

  • Debe tener una licencia Bot Creator.
  • Primero debe crear una API Task para invocarlo en el formulario.
En este tema, se describe cómo invocar una API Task en un formulario. En este ejemplo, creará un formulario de código postal que invoque una API Task para recuperar los detalles del place y el state en función de la entrada de código postal proporcionada. El formulario creado se ejecuta mediante un proceso. Puede crear un formulario con los campos específicos de su caso de uso.

Procedimiento

  1. Navegue hasta un formulario o cree uno en el que quiera invocar un API Task. Para obtener más información, consulte Crear un formulario.
    Ingrese el nombre API Task: Formulario de código postal para este formulario.
  2. Diseñar un formulario: Utilice los elementos de formulario para crear un formulario interactivo basado en su caso de uso. En este ejemplo, el formulario está diseñado para asignar las variables de código postal de la API Task.
    1. Desde la columna Elementos, arrastre el elemento Área de texto y suéltelo en su diseñador de formularios.
      Aparecerá la pestaña Propiedades con los campos correspondientes en la parte derecha de la pantalla.
    2. Introduzca una Etiqueta de elemento. Por ejemplo: Código postal.
    3. Arrastre el elemento Botón y suéltelo en el diseñador debajo del cuadro de texto Código postal. Ingrese un nombre para este botón en el campo Texto-botón (obligatorio) como Enviar.
    4. Además, arrastre otros dos elementos Área de texto y nómbrelos Lugar y Estado.
  3. Agregue las Reglas del formulario. Las reglas de formulario proporcionan las condiciones necesarias para cada elemento del formulario. Puede establecer reglas de formulario utilizando las condiciones if y then, y especificar las acciones que se ejecutarán cuando se cumplan las condiciones. En este ejemplo, las reglas del formulario están configuradas de modo tal que cuando se ingresa un código postal y se presiona el botón Enviar, el cuadro del elemento de lugar y estado recuperará los valores de las variables de API Task. Durante la ejecución, la API Task no funcionará como se esperaba si no se cumplen las condiciones de la regla de formulario.
    1. Haga clic en la pestaña Reglas del formulario.
    2. Si lo desea, introduzca un nombre para la regla. Por ejemplo, Invocar API Task .
    3. Introduzca una condición Si para validar si se presionó el botón.Invocar una API Task en un formulario
    4. Para definir la cláusula Entonces, seleccione Acciones del formulario y, a continuación, en el menú desplegable, seleccione Obtener valor de la llamada API.
    5. Puede asignar variables asociadas a la API Task a un formulario mediante la opción Agregar asignación de variables.
      Nota: Si edita una variable de API Task publicada y agrega variables adicionales después de haber ingresado la tarea, las variables no se mostrarán en el formulario. Debe ingresar la API Task después de agregar las variables.
    6. Haga clic en Explorar para seleccionar un API Task específico a fin de realizar una operación especificada. En este ejemplo, se selecciona un API Task ( API Task: Código postal) para recuperar el Lugar y el Estado de cualquier Código postal.