Utilice el tipo de solicitud de datos de formulario para agregar varios parámetros al cuerpo de la solicitud.

Acciones

Las siguientes acciones de parámetros están habilitadas:

Agregar
Para agregar parámetros al cuerpo de la solicitud.
Haga clic en el ícono Agregar para agregar un parámetro. El conteo de parámetros mostrado en el título de la tabla Parámetros se actualiza de forma automática.
Editar
Para editar los parámetros existentes que están disponibles en el cuerpo de la solicitud.
En la tabla Parámetros, pase el cursor sobre el ícono de puntos suspensivos verticales del parámetro que desea editar y luego haga clic en el ícono Editar. Puede editar la clave, el tipo de clave y los valores de los parámetros en la ventana modal Editar parámetro.
Habilitar/inhabilitar
Para habilitar o deshabilitar los parámetros que están disponibles en el cuerpo de la solicitud. Puede desactivar un parámetro en los siguientes escenarios:
  • Cuando la solicitud de API utiliza valores predeterminados.
  • Al introducir una nueva capacidad en un despliegue controlado de paquetes de conectores.
  • Al probar e iterar nuevas capacidades en un paquete de conectores.
  • Al solucionar problemas de un paquete de conectores que contiene parámetros con errores.
En la tabla Parámetros, pase el cursor sobre el ícono de puntos suspensivos verticales del parámetro que desea habilitar o deshabilitar y luego haga clic en el botón de cambio Habilitar/Deshabilitar. El estado del parámetro se actualiza en consecuencia en la tabla Parámetros. Los parámetros deshabilitados no se incluyen en el paquete de conectores publicado.
Copiar
Para replicar los parámetros existentes que están disponibles en el cuerpo de la solicitud.
En la tabla Parámetros, pase el cursor sobre el icono de puntos suspensivos verticales del parámetro correspondiente y haga clic en el icono Copiar para duplicar el parámetro seleccionado. Asegúrese de ingresar una nueva clave en el modal de Copiar. Todos los demás atributos del parámetro original se copian al nuevo parámetro. Una vez copiado, el nuevo parámetro se habilita de forma predeterminada. Use el interruptor Habilitar/deshabilitar para deshabilitar el parámetro manualmente. El conteo de parámetros en el título de la tabla Parámetros se actualiza automáticamente cuando se crea un nuevo parámetro utilizando la opción Copiar.
Puede cambiar el Tipo de clave y Tipo de valor del parámetro duplicado en el modal de Copia.
Eliminar
Para eliminar los parámetros que están disponibles en el cuerpo de la solicitud.
Realice una de las siguientes acciones para eliminar parámetros:
  • Haga clic en la casilla de verificación Seleccionar todo en el encabezado de la tabla y luego haga clic en el icono Eliminar que está disponible encima de la tabla para eliminar múltiples parámetros.
  • Pase el cursor sobre el menú de puntos suspensivos verticales de cada parámetro y luego haga clic en el icono Eliminar para eliminar el parámetro individualmente.

Tabla de parámetros

La tabla de Parámetros muestra el número total de parámetros de solicitud en una acción. Este número incluye tanto los parámetros habilitados como los deshabilitados.

Vea los siguientes detalles de parámetros en la tabla.

Columna Descripción
Clave Muestra la clave del parámetro. El usuario del paquete no puede ver la clave en el editor de Bot editor o API Task. La clave se envía como parte del encabezado.
Tipo de clave Muestra los tipos de datos del formulario. Determina cómo se interpretan y manejan los datos.
  • Texto: Si el tipo de clave es una entrada de texto simple. El contenido se trata como texto sin formato (text/plain). Este tipo de clave es adecuado para datos como nombres, direcciones o descripciones.
  • Archivo: Si el tipo de clave es una carga de archivo binario. El contenido son los datos sin procesar del propio archivo cargado. Este tipo de clave se utiliza para cargar documentos, imágenes u otros datos binarios.
    Nota: El campo de tipo de archivo siempre es definido por el usuario, y los usuarios pueden cargar archivos a través del Bot editor.
Valor Muestra el valor del parámetro. El usuario del paquete puede ver y actualizar este valor en el editor de Bot editor o API Task.
Valor proporcionado por el usuario Muestra el estado del valor.
  • Sí: Si el valor lo proporciona el usuario. El usuario del paquete debe proporcionar un valor apropiado al configurar este parámetro en el editor de Bot editor o API Task.
  • No: Si el valor está preprogramado. El usuario del paquete no puede ver este valor en el editor de Bot editor o API Task. Este valor se envía como parte del encabezado.
Estado Muestra el estado del parámetro.
  • Habilitado: Si el parámetro está habilitado.
  • Deshabilitado: Si el parámetro está deshabilitado.
Etiqueta Muestra la etiqueta para los valores proporcionados por el usuario. El usuario del paquete puede ver la etiqueta del parámetro en el editor de Bot editor o API Task.
Descripción Muestra la descripción del parámetro. El usuario del paquete puede ver la descripción del parámetro en el editor de Bot editor o API Task.

Agregar parámetros del cuerpo de la solicitud

Siga estos pasos para agregar un parámetro al cuerpo de la solicitud de datos del formulario:

  1. Haga clic en la pestaña Cuerpo de la solicitud dentro del panel de Configuración.
  2. Seleccione Datos del formulario desde la lista desplegable Tipo.
  3. Haga clic en Agregar parámetro o en el ícono más (+) en la parte superior de la tabla para agregar un parámetro.
  4. Realice lo siguiente en la ventana modal Agregar parámetro.
    1. Tecla: Introduzca un nombre de clave adecuado. El nombre de la clave no se muestra al usuario del paquete en el editor de Bot editor o API Task. Este nombre se envía como parte del encabezado.
    2. Tipo de clave: Seleccione el tipo de clave adecuado en la lista desplegable.
    3. Seleccione una de las siguientes opciones en la sección El valor será:
      Tipo Descripción
      Preprogramado Introduzca un valor preprogramado para el parámetro. El usuario del paquete no puede ver este valor en el editor de Bot editor o API Task. Este valor se envía como parte del encabezado.
      Proporcionado por el usuario
      1. Tipo de entrada de valor: Habilite esta casilla de verificación si desea proteger el tipo de entrada de valor. Si selecciona que esté protegido, puede introducir el parámetro a través de una credencial, una variable o una string insegura.
      2. ¿Este campo es obligatorio? Seleccione No o Sí según los requisitos del parámetro.
      3. Valor (opcional): Introduzca un valor. El usuario del paquete puede ver y actualizar este valor en el editor de Bot editor o API Task.
      4. Etiqueta: Ingrese una etiqueta para el parámetro. El usuario del paquete puede ver la etiqueta del parámetro en el editor de Bot editor o API Task.
      5. Descripción (opcional): Escriba una descripción para el parámetro. El usuario del paquete puede ver la descripción del parámetro en el editor de Bot editor o API Task. La descripción aparece como texto de ayuda en el editor.
  5. Haga clic en Agregar para agregar el parámetro al cuerpo de la solicitud.

    El nuevo parámetro se mostrará en la tabla Parámetros.

Repita los pasos para agregar más parámetros al cuerpo de la solicitud.