Crear un destino HTTP en Jitterbit Design Studio

Introducción

Los destinos HTTP normalmente se utilizan como punto final de una operación de transformación.

Cuando se utiliza HTTP como destino, el agente Jitterbit envía una acción HTTP (una de GET, POST, PUT, DELETE o CUSTOM) y pasa datos a la URL especificada en la configuración del destino.

Puede configurar un destino HTTP con información de encabezado para una acción POST en la definición. Cuando se utiliza en una operación, se forma un mensaje de texto ASCII utilizando esta información de encabezado, una línea en blanco y la información transformada de una fuente.

Por ejemplo, considere una transformación de una consultar de base de datos de origen en un documento XML. Los datos se recuperan de la fuente y luego se transforman al formato de documento XML según lo definido en la transformación. A continuación, la información del encabezado de destino (definida por la definición de destino) se agrega al comienzo del documento XML, junto con una línea en blanco y luego el contenido XML. Luego, el documento final se pasa a la URL de destino mediante un comando HTTP POST.

Similar a una fuente HTTP, se devuelve una respuesta de la solicitud HTTP y luego se analiza. Si el mensaje indica que se realizó correctamente, no se hace nada más. Cuando se recibe un mensaje de error, se utiliza como parte del proceso de registro de errores para la operación.

Crear un destino HTTP

Puede optar por crear un nuevo destino HTTP por sí solo o dentro de una operación existente. Para obtener más información sobre cómo funcionan los destinos dentro de las operaciones, consulte Creación de una operación.

Crear un nuevo objetivo HTTP como objetivo independiente

Dentro de su proyecto en Jitterbit Design Studio, puede crear un nuevo destino HTTP mediante cualquiera de los siguientes métodos:

• Vaya a Archivo > Nuevo > Nuevo objetivo; o

• En el árbol de la izquierda, haga clic derecho en Objetivos y seleccione Nuevo objetivo; o

• En la barra de herramientas superior, haga clic en el ícono de objetivo azul .

En la ventana emergente, seleccione HTTP como tipo:

Su nuevo objetivo aparece en su propia pestaña Nuevo objetivo en el panel derecho de la ventana.

Crear un nuevo destino HTTP en una operación existente

Por lo general, se crea un objetivo de forma predeterminada cuando se crea una nueva operación. (La excepción es una operación que consta únicamente de un secuencia de comandos). Con una operación existente, puede especificar el tipo de su objetivo mediante:

• Haga doble clic en el icono del objetivo; en la ventana emergente, seleccione Crear nuevo objetivo; o

• Hacer clic derecho en el ícono del objetivo y seleccionar Crear nuevo objetivo.

En la pantalla de configuración que aparece, utilice el menú desplegable Tipo para seleccionar HTTP, como se muestra arriba.

Utilizar un destino HTTP existente en una operación existente

Para utilizar un objetivo HTTP existente en una operación existente con un objetivo, puede configurarlo mediante cualquiera de las siguientes opciones:

• Dentro de la operación, haciendo doble clic en el icono de destino y, en la ventana emergente resultante, seleccionando el destino HTTP deseado de la lista; o

• Dentro de la operación, haga clic derecho en el ícono del destino, elija Seleccionar destino existente y, en la ventana emergente resultante, seleccione el destino HTTP deseado de la lista; o

• Arrastrar el objetivo HTTP deseado desde el árbol de la izquierda y soltarlo sobre el icono de objetivo existente de la operación.

Configurar un destino HTTP

Una vez que haya creado un destino HTTP, se abrirá la pantalla de configuración en la vista principal de Design Studio. Puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el icono del destino en la operación o haciendo doble clic en el destino en el árbol de la izquierda.

Configuración básica {: #basic-configuration }La pantalla de configuración será similar a la de este ejemplo:

• Nombre: Ingrese un nombre apropiado y único para la fuente.

• Tipo: Utilice el menú desplegable para seleccionar HTTP, si aún no está especificado.

• Parámetros de conexión: Especifique los detalles de su conexión HTTP:

  • URL: Ingrese una URL válida para el destino. Un destino HTTP se define por la URL del recurso, como http://www.example.com/ups.app/xml/ShipConfirm.

    • Para utilizar el cifrado SSL, utilice https:// en lugar de http:// en la URL, como por ejemplo https://www.example.com/ups.app/xml/ShipConfirm.

    • Si se especifican parámetros de consultar, proporciónelos como estarían en un navegador web, como https://www.example.com/queryrecord?id=10.

  • Inicio de sesión: Si corresponde, ingrese el nombre de usuario y la contraseña que permiten acceder a la URL. Deje estos campos en blanco si no se requiere nombre de usuario ni contraseña.

  • Contraseña: Ingrese una contraseña para usar con el Inicio de sesión para acceder a la URL referenciada en el campo URL, si es necesario.

  • Habilitar opción Reintentar: Disponible solo en las versiones 10.22 y superiores de Design Studio 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, 501, 502, 503, o 504.

    Para que esta configuración surta efecto, los agentes privados deben tener la versión 10.22 o superior. Con versiones anteriores de agentes, la configuración de esta opción se ignorará sin ningún error.

    Seleccione la casilla de verificación para habilitar opciones de configuración adicionales:

    • Máximo de reintentos: Ingrese la cantidad máxima de reintentos (se recomienda no más de 5 reintentos) que se reenviará una solicitud a NetSuite. Si la solicitud sigue fallando después de la cantidad máxima de reintentos, se devolverá una excepción con un mensaje de error en el registro de operación. Además, el archivo de registro del agente privado jitterbit.log Registrará cada reintento.

      Cada reintento se trata como parte de la misma ejecución de la operación, donde solo aparece un único registro en el registro de operación. Cualquier evento En caso de éxito o En caso de error configurado para ejecutar operaciones abajo en la cadena se activa según el estado final de la operación después de volver a intentarlo hasta el número máximo de reintentos.

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

  • Verbo HTTP: Use el menú desplegable para seleccionar GET, POST, PUT, DELETE o CUSTOM, según los requisitos del extremo. Para un POST, se publica una solicitud vacía en la URL y la respuesta se usa como fuente.

• Probar conexión: Al hacer clic en el botón el botón probará el destino HTTP; Jitterbit realizará una solicitud HEAD HTTP y devolverá un error si no tiene éxito. Tenga en cuenta que es posible que el servidor HTTP al que hace referencia la URL no permita HEAD, incluso si se permiten GET o POST.

• Haga clic en el botón Guardar en la barra de herramientas principal o en la barra de herramientas de destino para guardar la configuración.

Opciones

Se pueden especificar parámetros de conexión adicionales haciendo clic en Opciones en la parte inferior de la sección Parámetros de conexión:

• Content-Type: El tipo de contenido predeterminado está vacío, lo que se debe utilizar si el método que se utiliza no acepta datos estructurados o si la API no requiere que se especifique el tipo de contenido. Esto se puede cambiar desmarcando Use default Content-Type y especificando un tipo de contenido adecuado. Algunos ejemplos de tipos de contenido incluyen text/plain, application/json, application/x-www-form-urlencoded, etc.

• Opciones de seguridad: Para que el agente utilice un certificado para autenticarse con el alojar, especifique un certificado apropiado en el menú desplegable. (El botón verde a la derecha del menú desplegable actualizará la lista de certificados disponibles de Harmony).

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

  Consejo

  Puede administrar los certificados SSL del lado del cliente desde la Management Console en Personalizaciones > Certificados de cliente.

• Escribir respuesta en (opcional): Para guardar la respuesta del servidor HTTP, especifique que se escriba en un destino independiente mediante el menú desplegable. Si se especifica, el botón Editar se habilita para permitir la edición de ese destino.

• Configuración de proxy: Utilice el menú desplegable para seleccionar una de estas opciones para un proxy personalizado para el alojar HTTP:

  • Deshabilitar: Las configuraciones de proxy están deshabilitadas para esta fuente específica, omitiendo la configuración de proxy del agente si existe.

  • Predeterminado: La configuración del proxy está habilitada, utilizando la configuración del proxy del agente si existe. Si no se especifican configuraciones de proxy en la configuración del agente, la configuración Predeterminada tiene el mismo resultado que la configuración Deshabilitar.

  • Personalizado: Las configuraciones de proxy se habilitan para este objetivo específico utilizando la información personalizada proporcionada aquí. Esta opción omite la configuración de proxy del agente si existe. Cuando se selecciona Personalizado, estos campos están disponibles:

    

    Vea Habilitación de proxy para agentes privados para obtener más detalles sobre estos campos.

    Nota

    Los campos Host, Usuario, Contraseña y Dominio NTLM admiten variables ingresadas entre corchetes con agentes de la versión 10.66 y posteriores.

Propiedades avanzadas

Se pueden especificar parámetros avanzados adicionales haciendo clic en Propiedades avanzadas en la parte inferior de la sección Opciones. Estos parámetros se refieren a los encabezados HTTP enviados con la solicitud y a los parámetros relacionados con SSL:

• Habilitar codificación de contenido: Si se marca, el encabezado "Accept-Encoding" se enviará con la codificación compatible con Jitterbit. Actualmente, se admite Gzip. Esta opción está desactivada de forma predeterminada.

• Habilitar codificación de transferencia fragmentada: Si se marca, se enviará el encabezado "Transfer-Encoding: chunked". Utilice esta opción si está transfiriendo grandes conjuntos de datos. Esta opción está desactivada de forma predeterminada.

• Enviar Expect: 100-continue: Si se marca, se enviará el encabezado "Expect: 100-continue". Con esta opción, no se enviarán datos hasta que el servidor HTTP haya validado los encabezados. Utilice esta opción si va a enviar grandes cantidades de datos pero no desea utilizar la codificación de transferencia fragmentada. Esta opción está desactivada de forma predeterminada.

• Permitir cifrados débiles: Si se marca esta opción, se permitirá la comunicación con extremos HTTP que utilicen cifrados débiles (DES/3DES y RC4). Esta opción está desactivada de forma predeterminada.

• Establecer Accept-Encoding en GZip: Marcada de forma predeterminada, esta opción le indica al servidor HTTP que Jitterbit puede aceptar una respuesta comprimida con Gzip. A cambio, Jitterbit seguirá el estándar RFC 1952 y descomprimirá automáticamente las respuestas HTTP con Gzip. Si el servidor no utiliza Gzip, Jitterbit verá que la respuesta no está comprimida y la manejará como de costumbre. Esta característica se agregó a partir de la versión 8.20 de Jitterbit y ahora está marcada de forma predeterminada para todas las fuentes HTTP nuevas y existentes.

• Encabezados de solicitud (una línea por encabezado): Cualquier texto ingresado en este cuadro se enviará como un encabezado HTTP. Especifique un encabezado por línea a menos que el encabezado esté encapsulado de acuerdo con el estándar HTTP. Los elementos de datos globales entre corchetes se reemplazarán con sus valores.

• Versión SSL: Solo aplicable cuando se utiliza HTTPS, permite especificar una versión SSL específica si el servidor HTTP lo requiere. El valor predeterminado es "Negociar". Las opciones disponibles son:

  

Variables globales de destino predefinidas que afectan a un destino HTTP

Estas variables globales de destino predefinidas afectan a los destinos HTTP:

• jitterbit.target.http.form_data- jitterbit.target.http.form_data.ContentType- jitterbit.target.http.form_data.filename- jitterbit.target.http.form_data.name- jitterbit.target.http.max_redirs- jitterbit.target.http.remove_trailing_linebreaks- jitterbit.target.http.request.header._HeaderName_(mostrado en el editor de secuencia de comandos como jitterbit.target.http.response.header.*)
• jitterbit.target.http.ssl_cert_id- jitterbit.target.http.status_code- jitterbit.target.http.transfer_timeout

Consulte Variables de Jitterbit de destino para más detalles.