Utilice el tipo de solicitud de datos codificados en URL de formulario para agregar varios parámetros al cuerpo de su solicitud.

Acciones

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

Agregar
Para agregar parámetros al cuerpo de la solicitud.
Haga clic en Agregar parámetro o en el icono 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 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 valor del parámetro duplicado en el modal de Copiar.
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.

Elemento de tabla Descripción
Clave Muestra la clave del parámetro. El usuario del paquete no puede ver la clave en el editor de Editor de bots o Tarea API. La clave se envía como parte del encabezado.
Valor Muestra el valor del parámetro. El usuario del paquete puede ver y actualizar este valor en el editor de Editor de bots o Tarea API.
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 Editor de bots o Tarea API.
  • No: Si el valor está preprogramado. El usuario del paquete no puede ver este valor en el editor de Editor de bots o Tarea API. 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 Editor de bots o Tarea API.
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 Editor de bots o Tarea API.

Agregar parámetros del cuerpo de la solicitud

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

  1. Haga clic en la pestaña Cuerpo de la solicitud dentro del panel de Configuración.
  2. En la lista desplegable Tipo, seleccione Datos codificados en URL del formulario.
  3. Haga clic en Agregar parámetro cuando no exista ningún 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 Editor de bots o Tarea API. Este nombre se envía como parte del encabezado.
    2. 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 Editor de bots o Tarea API. 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 Editor de bots o Tarea API.
      4. Etiqueta: Ingrese una etiqueta para el parámetro. El usuario del paquete puede ver la etiqueta del parámetro en el editor de Editor de bots o Tarea API.
      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 Editor de bots o Tarea API. 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.