Configurar una tarea API en un formulario

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

Antes de empezar

  • Debe tener una licencia Bot Creator.
  • Primero debe crear una Tarea API para invocarlo en el formulario.
En este tema, se describe cómo invocar una Tarea API en un formulario. En este ejemplo, creará un formulario de código postal que invoque una Tarea API 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 Tarea API. Para obtener más información, consulte Crear un formulario.
    Póngale el nombre Tarea API - Formulario de código postal a 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 Tarea API.
    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 mediante las condicionessiyentoncesy 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 Tarea API. Durante la ejecución, la Tarea API 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 Tarea API .
    3. Introduzca una condición Si para validar si se presionó el botón.Invocar una tarea API en el 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 Tarea API a un formulario mediante la opción Agregar asignación de variables.
      Nota: Si edita una variable de Tarea API publicada y agrega variables adicionales después de haber ingresado la tarea, las variables no se mostrarán en el formulario. Debe ingresar la Tarea API después de agregar las variables.
    6. Haga clic en Explorar para seleccionar un Tarea API específico a fin de realizar una operación especificada. En este ejemplo, se selecciona Tarea API (Tarea API - Código postal) para recuperar el Lugar y el Estado de cualquier Código postal.