Conexión HTTP v2 (Beta)¶

Introducción¶

Una conexión HTTP v2 (Beta), creada con el conector HTTP v2 (Beta), establece el acceso a un servidor HTTP a través de un servicio web RESTful (REST API). Una vez que se configura una conexión, puede crear instancias de actividades HTTP v2 (Beta) asociadas con esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o Editar una Conexión HTTP v2 (Beta)¶

Se crea una nueva conexión HTTP v2 (Beta) utilizando el conector HTTP v2 (Beta) desde una de estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (vea Paleta de Componentes de Diseño).
• La página Conexiones globales (vea Crear una conexión global en Conexiones globales).

Una conexión HTTP v2 (Beta) existente se puede editar desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (vea Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Configurar una Conexión HTTP v2 (Beta)¶

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión HTTP v2 (Beta) se describe a continuación.

• Nombre de conexión: Ingrese un nombre para usar para identificar la conexión. El nombre debe ser único para cada conexión HTTP v2 (Beta) y no debe contener barras inclinadas / o dos puntos :. Este nombre también se usa para identificar el extremo HTTP v2 (Beta), que se refiere tanto a una conexión específica como a sus actividades.

• URL base: Ingrese la URL base. La URL base se utiliza para probar la conexión. El uso de este campo en el tiempo de ejecución depende de si se completa el campo URL de actividad HTTP de una actividad HTTP v2 (Beta):

  • Si se proporciona una URL parcial o no se proporciona ninguna URL en el campo URL de actividad HTTP, la URL utilizada en el tiempo de ejecución se concatena desde la URL base y la URL de actividad HTTP.

  • Si se proporciona una URL completa en el campo URL de actividad HTTP, entonces la URL base no se usa en tiempo de ejecución.

• Autorización: Use el menú para seleccionar el tipo de autorización, resumido a continuación. La configuración de cada tipo de autorización se describe en Tipos de autorización de conexión HTTP v2 (Beta).

  • Clave API: Especifique un par clave-valor de API para enviar encabezados o parámetros de consultar.

  • Firma de AWS: Especifique un ID de clave de acceso de AWS, clave de acceso secreta, región, servicio y token de sesión para enviar utilizando Amazon Web Services (AWS) Signature Version 2 en encabezados o parámetros de consultar.

  • Autorización básica: Especifique un nombre de usuario y contraseña para enviar encabezados.

  • Ficha de portador: Especifique un token de portador para enviar en los encabezados.

  • Autorización resumida: Especifique un nombre de usuario, contraseña, dominio, nonce, algoritmo, QOP, conteo de nonce, nonce de cliente y opaco para enviar en los encabezados.

  • Autenticación de halcón: Especifique un ID de autenticación de Hawk, una clave de autenticación, información específica de la aplicación, un ID de aplicación y DLG para enviar en los encabezados.

  • Sin autorización: Seleccione para acceder al servidor HTTP de forma anónima sin autorización.

  • OAuth 2.0: Especifique el tipo de concesión y proporcione el extremo del token de OAuth, el ID del cliente, el secreto del cliente, el alcance y el tipo de token para enviar en los encabezados o en el cuerpo de la solicitud.

• Reintentar: Funciona solo cuando se usa un ambiente asociado con un Grupo de Agentes Privados, se usa esta configuración para volver a intentar una solicitud cuando un extremo HTTP v2 (Beta) devuelve uno de estos códigos de estado: 500, 502, 503, o 504.

  Esta configuración surte efecto cuando se usa con Agentes Privados versión 10.34 o posterior.

  Seleccione la casilla de verificación Reintentar para ampliar las opciones de configuración adicionales:

  

  • Intervalo de reintento (segundos): Ingrese la cantidad de segundos (máximo de 5 segundos) para esperar entre reenviar un solicitud al extremo HTTP v2 (Beta).

  • Número máximo de reintentos: Ingrese el número máximo de reintentos (máximo de 5 reintentos) que se reenviará una solicitud al extremo HTTP v2 (Beta). Si la solicitud aún falla después de la cantidad máxima de reintentos, una excepción con un error se devolverá el mensaje en el registro de operación. Además, el Agente Privado registrará cada reintento en el jitterbit.log archivo de registro.

    Cada reintento se trata como parte de la misma ejecución de operación, donde solo aparece un único registro en la operación registro. Cualquier acción de operación configurada para ejecutar operaciones abajo en la cadena se desencadena en función del estado final del operación después de reintentar hasta el número máximo de reintentos.

• Configuración opcional: Haga clic para expandir la configuración opcional adicional:

  

  • Configuración de proxy: Use el menú para seleccionar la configuración de proxy, una de estas opciones:

    • Personalizado: La configuración del proxy se habilita usando las entradas especificadas en los campos adicionales que están disponibles cuando se selecciona esta opción. Esta opción omite la Configuración del proxy del Agente Privado si existe.

      

      • Host: Ingrese el nombre de alojar del servidor proxy HTTP.
      • Puerto: Ingrese el puerto del servidor proxy HTTP.
      • Usuario: Ingrese el nombre de usuario para la autenticación del servidor proxy HTTP.
      • Contraseña: Ingrese la contraseña para la autenticación del servidor proxy HTTP.
      • Dominio NTLM: Ingrese el dominio NTLM para la autenticación del servidor proxy HTTP.
      • Permitir certificados no verificados usados por proxy: Seleccione para permitir que el servidor proxy HTTP use certificados no verificados.

    • Predeterminado: La configuración del proxy está habilitada mediante la Configuración del proxy del Agente Privado si existe. Si la configuración del proxy no se especifica en la configuración del agente, la configuración Predeterminada tiene el mismo resultado que la configuración Deshabilitar.

    • Deshabilitar: La configuración del proxy está deshabilitada, omitiendo la Configuración del proxy del Agente Privado si existe.

  • Propiedades HTTP avanzadas: Si corresponde, configure estas opciones avanzadas:

    • Tipo de contenido: Ingrese 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 el método que se utiliza no acepta datos estructurados, o si la API no requiere que se especifique el tipo de contenido, deje este campo en blanco.

      Como alternativa, el tipo de contenido se puede especificar en otros campos de configuración de la interfaz de usuario o se puede proporcionar en la transformación de solicitud. Si el tipo de contenido se especifica en varios lugares, se sigue este orden de prioridad:

      1. A Content-Type El encabezado proporcionado en la tabla Configuración adicional de una actividad HTTP v2 (Beta) anula todos los campos a continuación.
      2. El bodyContentType El campo especificado en una transformación de solicitud anula los campos restantes a continuación.
      3. A Content-Type encabezado proporcionado en la transformación de solicitud headers node 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 (Beta) anula los campos restantes a continuación.
      5. A Content-Type El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) anula el campo restante a continuación.
      6. A Content-Type el encabezado provisto en el campo Content-Type de una conexión HTTP v2 (Beta) (este campo) tiene la menor prioridad.

    • Habilitar codificación de contenido: Seleccione para enviar el Accept-Encoding encabezado con codificación Gzip.

      Como alternativa, este encabezado se puede definir en otros campos de configuración de la interfaz de usuario o se puede proporcionar en la transformación de solicitud. Si este encabezado se especifica en varios lugares, se sigue este orden de prioridad:

      1. Un Accept-Encoding encabezado proporcionado en la transformación de solicitud headers node anula todos los campos a continuación.
      2. Un Accept-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 (Beta) anula los campos restantes a continuación.
      3. Un Accept-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) anula el campo restante a continuación.
      4. Un Accept-Encoding encabezado habilitado por el campo Habilitar codificación de contenido de una conexión HTTP v2 (Beta) (este campo) tiene la menor prioridad.

    • Habilitar codificación de transferencia fragmentada: Seleccione para enviar el Transfer-Encoding: chunked encabezado Utilice esta opción si está transfiriendo grandes conjuntos de datos.

      Como alternativa, este encabezado se puede definir en otros campos de configuración de la interfaz de usuario o se puede proporcionar en la transformación de solicitud. Si este encabezado se especifica en varios lugares, se sigue este orden de prioridad:

      1. A Transfer-Encoding encabezado proporcionado en la transformación de solicitud headers node anula todos los campos a continuación.
      2. A Transfer-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 (Beta) anula los campos restantes a continuación.
      3. A Transfer-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) anula el campo restante a continuación.
      4. A Transfer-Encoding: chunked encabezado habilitado en el campo Habilitar codificación de contenido de una conexión HTTP v2 (Beta) (este campo) tiene la menor prioridad.

    • Permitir cifrados débiles: Esta opción no funciona actualmente.

    • Keep Alive: Seleccione para permitir que una sola conexión TCP permanezca abierta para múltiples solicitudes y respuestas HTTP.

    • Solo aplicable cuando se usa HTTPS: Use el menú para cambiar la selección de Negociar (predeterminado) a una versión TLS específica si el servidor HTTP lo requiere, seleccionando TLS 1.0, TLS 1.1, TLS 1.2 o TLS 1.3.

    • Encabezados de solicitud: Defina encabezados HTTP para la conexión. Haga clic en el ícono de agregar para agregar un encabezado a la siguiente tabla e ingresar un par clave-valor para cada parámetro de solicitud.

      Para guardar la fila, haga clic en el icono de enviar en la columna más a la derecha.

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

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

      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 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 provisto en la transformación de solicitud headers node anula todos los campos a continuación.
      2. Un encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 (Beta) anula el campo restante a continuación.
      3. Un encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) (este campo) tiene la menor prioridad.

      Importante

      Los campos de la tabla Encabezados de solicitud muestran el icono de variable solo en el modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

• Prueba: Haga clic para verificar la conexión enviando una solicitud HTTP GET utilizando la autorización configurada. Una prueba se considera exitosa si se devuelve cualquier código de estado HTTP 2xx. A 405 Method Not Allowed la respuesta también se trata como satisfactoria.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias, eliminación y eliminación de componentes). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos Pasos¶

Después de crear una conexión HTTP v2 (Beta), coloca un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

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

Estos tipos de actividad están disponibles:

• PARCHE: Aplica modificaciones parciales a un recurso existente en un servidor HTTP y puede usarse como origen o destino en una operación.

• CABEZA: Recupera la línea de estado y la sección de encabezado de un recurso en un servidor HTTP y puede usarse como origen o destino en una operación.

• CORREO: Crea un nuevo recurso en un servidor HTTP y puede usarse como origen o destino en una operación.

• CONSEGUIR: Recupera información sobre un recurso en un servidor HTTP y puede usarse como origen o destino en una operación.

• OPCIONES: Recupera información sobre las opciones de comunicación de un recurso en un servidor HTTP y puede usarse como origen o destino en una operación.

• BORRAR: Elimina un recurso en un servidor HTTP y puede usarse como origen o destino en una operación.

• PONER: Reemplaza un recurso existente en un servidor HTTP y puede usarse como origen o destino en una operación.