Conexión HTTP¶

Introducción¶

Una conexión HTTP se configura mediante el conector HTTP, estableciendo acceso a un servicio web HTTP o HTTPS (incluidos los servicios web RESTful). Una vez que se establece una conexión, puede configurar una o más actividades HTTP asociadas con esa conexión para usarlas como fuente para proporcionar datos a una operación o secuencia de comandos, o como destino para consumir datos en una operación o secuencia de comandos.

Crear o Editar una Conexión HTTP¶

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

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

Se puede editar una conexión HTTP existente desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes 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).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Configurar una Conexión HTTP¶

La configuración de una conexión HTTP incluye estos campos:

• Nombre del Extremo: Introduzca un nombre que se utilizará para identificar la conexión HTTP. El nombre debe ser único para cada conexión HTTP y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo HTTP, que hace referencia tanto a una conexión específica como a sus actividades.

• URL base: Introduzca una URL base válida para la conexión. Para utilizar el cifrado SSL, simplemente utilice https:// en la URL. No incluya ningún parámetro de consultar o ruta a menos que se utilicen para todas las actividades asociadas (podrá especificar rutas y parámetros únicos durante la configuración de la actividad). La URL final se concatenará a partir de la URL base proporcionada aquí junto con las rutas especificadas durante la configuración de la actividad.

• Nombre de usuario y Contraseña: Si corresponde, ingrese un nombre de usuario y contraseña que le permitirán acceder al servidor HTTP. Puede dejar estos campos en blanco para la autenticación anónima si no se requiere ningún nombre de usuario ni contraseña.

• Certificado: Utilice el menú desplegable para seleccionar un certificado disponible para autenticarse con el servidor HTTP. Puede administrar certificados SSL del lado del cliente desde la Management Console en Personalizaciones > Certificados de cliente.

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

  Esta configuración entra en vigor cuando se usa con Agentes Privados versión 10.22 o posterior.

  Nota

  Para Agentes Privados versión 10.30 a 10.33, el RecoverableStatusCode La configuración y la lista de códigos de error deben agregarse manualmente al archivo de configuración del Agente Privado.

  Seleccione la casilla Reintentar para expandir opciones de configuración adicionales:

  

  • Intervalo de reintento (segundos): Ingrese la cantidad de segundos (máximo de 5 segundos) que se deben esperar entre el reenvío de una solicitud al extremo HTTP.

  • Reintentos máximos: Ingrese el número máximo de reintentos (se recomienda no más de 5 reintentos) que una solicitud se reenviará al extremo HTTP. Si la solicitud aún falla después del número máximo de reintentos, se devolverá una excepción con un mensaje de error 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 registro en el registro de operación. Cualquier acciones de operación configurados para ejecutar operaciones abajo en la cadena se activan según el estado final de la operación después de reintentar hasta el número máximo de reintentos.

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  

  • Opción de seguridad: Si corresponde, seleccione Usar autenticación HTTP básica para autenticarse con el alojar mediante autenticación HTTP básica sin cifrado SSL. Tenga en cuenta que si se utiliza esta opción, la contraseña proporcionada se envía en texto sin cifrar. (A menos que sea necesario, esto no se recomienda).

    Si no se utiliza esta opción, de forma predeterminada Harmony negocia con el extremo para determinar qué métodos de autenticación son compatibles y utiliza las credenciales proporcionadas contra uno de los protocolos. Además de HTTP Básico, Harmony admite estas opciones de autenticación HTTP:

    • Resumen HTTP

    • HTTP Digest con autenticación con sabor a IE

  • Ignorar líneas: Si hay encabezados y/o pies de página en los datos de origen que desea ignorar, ingrese el número de líneas a ignorar en el Primero y el Último campos.

  • Configuración de proxy: Si desea especificar un proxy personalizado, use el menú desplegable para seleccionar una de estas opciones:

    • 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, entonces la configuración Predeterminada tiene el mismo resultado que la configuración Desactivar.

    • Desactivar: La configuración de proxy está desactivada para esta conexión específica, sin pasar por la configuración de proxy del Agente Privado si existe.

    • Personalizado: La configuración de proxy está habilitada para esta conexión específica utilizando la información personalizada proporcionada aquí. Esta opción omite la configuración del proxy del Agente Privado si existe uno y, en su lugar, utiliza información de proxy personalizada. Cuando se selecciona Personalizado, hay campos adicionales disponibles para que los configure. Para obtener detalles sobre estos campos, consulte Habilitar proxy para Agentes Privados.

      Nota

      Campos adicionales con un icono de variable admite variables con agentes 10.66 y posteriores.

  • 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. Si el método que se utiliza no acepta datos estructurados, o si la API no requiere que se especifique el tipo de contenido, puede dejar este campo en blanco. Ejemplos de tipos de contenido incluyen text/plain, application/json, application/x-www-form-urlencoded, etc.

    • Habilitar codificación de contenido: Si se selecciona, el encabezado Accept-Encoding se envía con la codificación admitida por Harmony. Actualmente se admite Gzip.

    • Habilitar codificación de transferencia fragmentada: Si se selecciona, se envía el encabezado Transfer-Encoding: fragmentado. Utilice esta opción si está transfiriendo grandes conjuntos de datos.

    • Enviar Esperar 100-continuar: Si se selecciona, se envía el encabezado Esperar: 100-continuar. Con esta opción, no se envían datos hasta que el servidor HTTP haya validado los encabezados. Utilice esta opción si envía grandes cantidades de datos pero no desea utilizar codificación de transferencia fragmentada.

    • Permitir cifrados débiles: Seleccione esta casilla de verificación para comunicarse con servidores HTTP que utilizan cifrados débiles (DES/3DES y RC4).

    • HTTP Aceptar codificación Gzip: Seleccionada de forma predeterminada, esta opción le indica al servidor HTTP que Harmony puede aceptar un archivo comprimido con Gzip. respuesta. A cambio, Harmony sigue el estándar RFC 1952 y descomprime automáticamente las respuestas HTTP de Gzip. Si el servidor no utiliza Gzip, Harmony ve que la respuesta no está comprimida y la maneja como de costumbre.

      Nota

      Esta configuración no está relacionada con el conector Gzip.

    • Solo aplicable cuando se usa HTTPS: Utilice el menú desplegable para seleccionar una versión SSL específica si el servidor HTTP lo requiere. El valor predeterminado es Negociar.

    • Solicitar encabezados (una línea por encabezado): Cualquier texto ingresado en este cuadro se envía como un encabezado HTTP. Especifique cada encabezado en una línea a menos que el encabezado esté ajustado según el estándar HTTP. Este campo también admite el uso de variables globales, variables del proyecto, y variables de Jitterbit reemplazando las variables entre corchetes [ ] con sus valores.

• Prueba: Haga clic para verificar la conexión enviando una solicitud HTTP GET sin autorización.

• 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 de componentes, eliminación y eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos Pasos¶

Una vez creada una conexión HTTP, se puede acceder a las acciones del menú para esa conexión desde la pestaña Componentes del panel del proyecto. Consulte Menú de acciones de conexión para detalles.

Una vez que configura una conexión HTTP, puede configurar una o más actividades HTTP asociadas con esa conexión para usarlas como fuente (para proporcionar datos dentro de una operación) o como destino (para consumir datos dentro de una operación), o para usar. en un secuencia de comandos.

Utilice el menú desplegable Mostrar para filtrar por Extremos y luego haga clic en el bloque de conexión HTTP para mostrar las actividades que están disponibles para usarse con una conexión HTTP:

Para obtener más información, consulte Actividades HTTP, que cubre actividades OBTENER, PUT, PUBLICAR, ELIMINAR y Personalizar.