Actividad de HTTP v2 BULK

Introducción

Una actividad HTTP v2 BULK, que utiliza 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

Se crea una instancia de una actividad HTTP v2 BULK a partir de una conexión HTTP v2 utilizando su tipo de actividad BULK.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad HTTP v2 BULK existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad HTTP v2 BULK

Siga estos pasos para configurar una actividad HTTP v2 BULK:

• 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: Revise 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 las configuraciones adicionales. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad HTTP v2 BULK y no debe contener barras diagonales / o dos puntos :.

• Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

  • Método: Especifique el método HTTP que se utilizará, uno de los siguientes: POST, PUT, GET, DELETE, HEAD, PATCH u OPTIONS.

  • 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 se puede utilizar.

    • URL: Muestra la URL completa que se utilizará en tiempo de ejecución.

  • Parámetros de solicitud: Haga clic en el ícono de agregar para agregar una fila a la tabla que aparece a continuación 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 ícono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, pase el cursor sobre la columna más a 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 de agregar para agregar una fila a la tabla a continuación e ingresar un Nombre y Valor para cada encabezado de solicitud.

    Como alternativa, los encabezados se pueden definir en otros campos de configuración de la interfaz de usuario o se pueden proporcionar 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:

    1. Un encabezado proporcionado en la transformación de la solicitud anula todos los campos siguientes.
    2. Un encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 BULK (este campo) anula el campo restante a continuación.
    3. Un encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si está habilitado Enviar encabezados de solicitud en la ejecución de la actividad, tiene la menor prioridad.

    Para guardar la fila, haga clic en el ícono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, pase el cursor sobre la columna más a la derecha y use el ícono de edición o eliminar icono .

    Para eliminar todas las filas, haga clic en Borrar todo.

  • Configuración adicional: Haga clic en el ícono de agregar para agregar una fila a la tabla a continuación e ingresar un Nombre y un Valor para cada configuración adicional.

    Se admiten estas configuraciones adicionales:

    Clave	Valor predeterminado	Tipo de datos	Descripción
    connection-timeout	30000	Entero	El tiempo de espera de transferencia en milisegundos. Si no se especifica esta configuración, el tiempo de espera de transferencia predeterminado es 30000 milisegundos (30 segundos). Establecido en 0 por un tiempo de espera ilimitado.TABLEROWEND
    content-type	—	Cadena	El tipo de contenido de la estructura de solicitud que espera la API en 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. Establecer en 0 o un número negativo para evitar seguir cualquier redirección.
    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 en false, los datos no se modifican.

    Como alternativa, se pueden proporcionar configuraciones adicionales en la transformación de 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 para content-type, 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 se especifica el tipo de contenido en varios lugares, se sigue este orden de precedencia:

    1. Un Content-Type El encabezado proporcionado en la tabla Configuración adicional de una actividad HTTP v2 BULK (esta tabla) anula todos los campos siguientes.
    2. El bodyContentType El campo especificado en una transformación de solicitud anula los campos restantes a continuación.
    3. Un Content-Type encabezado proporcionado en la transformación de la solicitud headers El nodo anula los campos restantes a continuación.
    4. A Content-Type El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 BULK anula el campo restante a continuación.
    5. Un Content-Type El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si está habilitado Enviar encabezados de solicitud en ejecución de actividad, tiene la menor precedencia.

    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 indicado anteriormente. 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 ícono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, pase el cursor sobre la columna más a la derecha y use el ícono de edición o eliminar icono .

    Para eliminar todas las filas, haga clic en Borrar todo.

  • Ignorar error de operación en caso de código de estado de error: Seleccione esta opción para que las operaciones informen un estado de error incluso si la API a la que llama el conector devuelve un código de estado de error. El valor predeterminado no está seleccionado.

  • Seleccione el código de estado HTTP que se considerará exitoso en el tiempo de ejecución de la operación: Seleccione Agrupado por clase o Granular (entrada manual) para considerar los códigos de estado especificados como exitosos en registros de operación.

    • Agrupado por clase: Cuando se selecciona, se muestra un menú desplegable con clases de códigos de estado no exitosos que se tratarán como exitosos. Las opciones del menú desplegable incluyen Redirección 3xx, Error de cliente 4xx y Error de servidor 5xx. El valor predeterminado del menú desplegable no está seleccionado.

    • Granular (entrada manual): Cuando se selecciona, se muestra un campo para ingresar manualmente una lista delimitada por comas de códigos de estado no exitosos que se tratarán como exitosos. Esta lista puede incluir diferentes clases de códigos de estado al mismo tiempo. El valor predeterminado del campo está en blanco.

      

  • Multipart: Seleccione para admitir multipart/form-data solicitudes cuando se utilizan esquemas predeterminados. Esto es necesario para las solicitudes que incluyen RFC 1867 cargas de formularios.

  • Continuar en caso de error: Seleccione esta opción para continuar con la ejecución de la actividad si se encuentra un error en 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 de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta. A continuación se describe cada elemento de la interfaz de usuario de este paso.

• Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados 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:

    Nodo/Campo del Esquema de Solicitud	Notas
    json	Formato del esquema de solicitud
    solicitudes	Nodo de solicitudes
    ítem	Nodo de artículos
    solicitud	Nodo de una solicitud específica
    root	Nodo de una solicitud raíz
    identificador	Identificador de la solicitud
    ruta	Ruta de la solicitud, sin incluir la URL base del punto final
    encabezados	Nodo de encabezados
    elemento	Nodo de un encabezado específico
    clave	Clave del encabezado
    valor	Valor del encabezado
    método	Método de la solicitud
    requestParameters	Nodo de parámetros de solicitud
    item	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
    ítems	Nodo de artículos
    respuesta	Nodo de una respuesta específica
    responseItem	Nodo de un elemento de respuesta
    identificador	Identificador de la respuesta
    encabezados	Nodo de encabezados
    elemento	Nodo de un encabezado específico
    clave	Clave del encabezado
    valor	Valor del encabezado
    error	Nodo de error
    statusCode	Código de estado HTTP de la respuesta
    statusMessage	Mensaje de estado de la respuesta
    detalles	Detalles de la respuesta
    propiedades	Propiedades de la respuesta
    responseContent	Contenido de la respuesta
    estado	Un valor booleano que indica si se devolvió una respuesta

• Actualizar: Haga clic en el ícono 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 en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad HTTP v2 BULK, 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 la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades HTTP v2 BULK 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 que se utilizan como objetivo 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 utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.