Actividad HTTP V2 BULK (Beta)¶
Introducción¶
Una actividad HTTP v2 BULK (Beta), utilizando su conexión HTTP v2, envía múltiples solicitudes a un servicio accesible a través del protocolo HTTP o HTTPS, y puede usarse como fuente (para proporcionar datos en una operación) o como destino (para consumir datos en una operación).
Crear una Actividad HTTP V2 BULK (Beta)¶
Se crea una instancia de una actividad HTTP v2 BULK (Beta) a partir de una conexión HTTP v2 utilizando su tipo de actividad BULK (Beta).
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.
Una actividad HTTP v2 BULK (Beta) existente se puede editar desde estas ubicaciones:
- El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
- La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).
Configurar una Actividad HTTP V2 BULK (Beta)¶
Siga estos pasos para configurar una actividad HTTP v2 BULK (Beta):
-
Paso 1: Ingrese un nombre y especifique la configuración
Proporcione un nombre para la actividad y especifique el método, la ruta, los parámetros de solicitud, los encabezados de solicitud y las configuraciones adicionales. -
Paso 2: revisar los esquemas de datos
Se muestran todos los esquemas de solicitud o respuesta.
Paso 1: Ingrese un Nombre y Especifique la Configuración¶
En este paso, proporcione un nombre para la actividad y especifique el método, la ruta, los parámetros de solicitud, los encabezados de solicitud y configuraciones adicionales. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
-
Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad HTTP v2 BULK (Beta) y no debe contener barras diagonales.
/
o dos puntos:
. -
Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:
-
Método: Especifique el método HTTP que se utilizará, uno de POST, PUT, GET, DELETE, HEAD, PARCHE o OPCIONES.
-
Ruta: Ingrese una URL para usar en la actividad:
- Si se deja en blanco, la URL base configurada en la conexión HTTP v2 se utilizará en tiempo de ejecución.
- Si se especifica una ruta parcial, se agregará a la URL base configurada en la conexión HTTP v2.
- Si se especifica una URL completa, anulará la URL base configurada en la conexión HTTP v2.
Los parámetros de solicitud se pueden incluir encerrándolos entre llaves
{
}
. Parámetros de consulta (como/queryrecord?id=10
) también puede ser usado.- URL: Muestra la URL completa que se utilizará en tiempo de ejecución.
-
Parámetros de solicitud: Haga clic en el ícono Agregar
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada parámetro de solicitud. Los parámetros de solicitud proporcionados se codificarán automáticamente en URL.
Alternativamente, los parámetros de solicitud se pueden proporcionar en la transformación de solicitud. Los parámetros de solicitud que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen. Si se especifica la misma clave de parámetro tanto en este campo como en la transformación de solicitud, la especificada en la transformación tiene prioridad.
Para guardar la fila, haga clic en el icono de enviar
en la columna de la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna de la derecha y use el ícono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
-
Encabezados de solicitud: Haga clic en el ícono Agregar
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada encabezado de solicitud.
Alternativamente, los encabezados se pueden definir en otros campos de configuración de la interfaz de usuario o proporcionarse en la transformación de la solicitud. Los encabezados que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen.
Si se especifica la misma clave de encabezado en varios lugares, se sigue este orden de precedencia:
- Un encabezado proporcionado en la transformación de la solicitud anula todos los campos siguientes.
- Un encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 BULK (Beta) (este campo) anula el campo restante a continuación.
- Un encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor prioridad.
Para guardar la fila, haga clic en el icono de enviar
en la columna de la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna de la derecha y use el ícono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
-
Configuraciones adicionales: Haga clic en el ícono Agregar
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada configuración adicional.
Se admiten estas configuraciones adicionales:
Llave Valor predeterminado Tipo de datos Descripción connection-timeout
30000
Entero El tiempo de espera de la transferencia en milisegundos. Si no se especifica esta configuración, el tiempo de espera de transferencia predeterminado es 30000
milisegundos (30 segundos). Ajustado a0
por un tiempo de espera ilimitado.content-type
— Cadena El tipo de contenido de la estructura de solicitud que espera la API particular. Por ejemplo, text/plain
,application/json
,application/x-www-form-urlencoded
, etc. Si no se especifica esta configuración, no hay ningún valor predeterminado.max-redirect
50
Entero El número máximo de redirecciones a seguir. Si no se especifica esta configuración, el valor predeterminado es seguir 50
redirecciones. Ajustado a0
o un número negativo para evitar seguir redirecciones.trailing-linebreaks
false
Cadena Elimina los espacios en blanco iniciales y finales y los saltos de línea cuando se establece en true
. Si esta configuración no se especifica o se establece enfalse
, los datos no se modifican.Alternativamente, se pueden proporcionar configuraciones adicionales en la transformación de la solicitud. Las configuraciones adicionales que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen. Para todas las configuraciones excepto el tipo de contenido, si se especifica la misma clave de configuración tanto en este campo como en la transformación de solicitud, la especificada en la transformación tiene prioridad.
Para
content-type
, un valor especificado aquí tiene prioridad sobre todos los demás lugares de la interfaz de usuario donde se puede especificar el tipo de contenido. Si el tipo de contenido se especifica en varios lugares, se sigue este orden de prioridad:- Un
Content-Type
El encabezado proporcionado en la tabla Configuraciones adicionales de una actividad HTTP v2 BULK (Beta) (esta tabla) anula todos los campos siguientes. - El
bodyContentType
El campo especificado en una transformación de solicitud anula los campos restantes a continuación. - Un
Content-Type
encabezado proporcionado en la transformación de la solicitudheaders
El nodo anula los campos restantes a continuación. - Un
Content-Type
El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 BULK (Beta) anula el campo restante a continuación. - Un
Content-Type
El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor prioridad.
Nota
Si un encabezado se define en varias ubicaciones, cada instancia del encabezado se agregará a la solicitud de una actividad siguiendo el orden de precedencia anterior. Este orden se basa en cómo los servicios suelen manejar los encabezados duplicados en una solicitud.
Para guardar la fila, haga clic en el icono de enviar
en la columna de la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna de la derecha y use el ícono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
- Un
-
Multiparte: Seleccione para admitir
multipart/form-data
solicitudes cuando se utilizan esquemas predeterminados. Esto es necesario para solicitudes que incluyen RFC 1867 cargas de formularios. -
Continuar en caso de error: Seleccione esta opción para continuar la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud lote. Si se encuentra algún error, se escribe en el registro de operación.
-
-
Guardar y salir: Si está habilitado, haga clic para guardar la configuración para este paso y cerrar la configuración de la actividad.
-
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.
-
Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Paso 2: Revisar los Esquemas de Datos¶
Se muestran todos los esquemas de solicitud o respuesta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
-
Esquemas de datos: Estos esquemas de datos se heredan mediante transformaciones adyacentes y se muestran nuevamente durante asignación de transformación.
Importante
A diferencia de otras actividades HTTP v2, la actividad HTTP v2 BULK (Beta) no admite esquemas editables. Los datos proporcionados en una transformación tienen prioridad sobre la configuración de la actividad.
Los esquemas de solicitud y respuesta predeterminados constan de estos nodos y campos:
-
Solicitud:
Solicitar nodo/campo de esquema Notas json Formato del esquema de solicitud solicitudes Nodo de solicitudes artículo Nodo de artículos solicitud Nodo de una solicitud específica raíz Nodo de una raíz de solicitud identificador Identificador de la solicitud camino Ruta de la solicitud, sin incluir la URL base del punto final encabezados Nodo de encabezados artículo Nodo de una encabezado específica clave Clave del encabezado valor Valor del encabezado método Modalidad de la solicitud parámetros de solicitud Nodo de parámetros de solicitud artículo Nodo de un parámetro de solicitud específico clave Clave del parámetro de solicitud valor Valor del parámetro de solicitud cuerpo Cuerpo de la solicitud -
Respuesta:
Nodo/campo del esquema de respuesta Notas json Formato del esquema de respuesta respuestas Nodo de respuestas artículos Nodo de artículos respuesta Nodo de una respuesta específica artículo de respuesta Nodo de un elemento de respuesta identificador Identificador de la respuesta encabezados Nodo de encabezados artículo Nodo de una encabezado específica clave Clave del encabezado valor Valor del encabezado error Nodo de error código de estado Código de estado HTTP de la respuesta detalles Detalles de la respuesta propiedades Propiedades de la respuesta respuestaContenido Contenido de la respuesta estado Un booleano que indica si se devolvió una respuesta
-
-
Actualizar: Haga clic en el icono de actualización
o la palabra Actualizar para regenerar esquemas desde el extremo HTTP v2. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Próximos Pasos¶
Después de configurar una actividad HTTP v2 BULK (Beta), complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en diferentes.
Se puede acceder a las acciones del menú para una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte Menú de acciones de actividad en Conceptos básicos del conector.
Las actividades HTTP v2 BULK (Beta) que se utilizan como fuente se pueden utilizar con estos patrones de operación:
- Patrón de transformación
- Patrón de archivo de dos objetivos (solo como primera fuente)
- Patrón de archivo HTTP de dos destinos (solo como primera fuente)
- Patrón de dos transformaciones (como primera o segunda fuente)
Las actividades HTTP v2 BULK (Beta) que se utilizan como destino se pueden utilizar con estos patrones de operación:
- Patrón de transformación
- Patrón de dos transformaciones (como primer o segundo objetivo)
Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de secuencias de comandos.
Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.