Cree un extremo HTTP alojado en Jitterbit Design Studio

Descripción general

Un Extremo HTTP alojado representa una URL con una o más operaciones asociadas a ella. Cuando se accede a la URL, las operaciones configuradas se activan con los datos de la solicitud como entrada (si corresponde). El extremo se puede configurar para devolver un archivo de destino o el contenido de un elemento de datos como respuesta.

Crear un extremo HTTP alojado

Siga estos pasos para crear un Extremo HTTP alojado:

1. Si aún no lo ha hecho, inicie sesión en Jitterbit Studio.
2. Asegúrese de haber abierto el proyecto apropiado en el que desea crear el nuevo Extremo HTTP alojado.
3. Cree y pruebe las operaciones que desea activar con el Extremo HTTP alojado.

4. Haga clic con el botón derecho en el nodo Hosted HTTP Extremos (Puntos finales HTTP alojados) en el árbol de proyectos y elija New Hosted HTTP Extremo (Nuevo punto final HTTP alojado) o seleccione New (Nuevo) en el menú File (Archivo) y elija New Hosted HTTP Extremo (Nuevo punto final HTTP alojado) en el submenú. Aparecerá una nueva pestaña titulada "New Hosted HTTP Extremo" (Nuevo punto final HTTP alojado) en el panel derecho:

   

5. Complete las propiedades del Extremo HTTP:

   1. El Nombre de su extremo debe ser único dentro de su proyecto.

   2. URL del Extremo es la URL en la que desea que este extremo escuche. Por ejemplo, si ingresa "company/po_import", el extremo se activará cuando la URL "http://[server name]:[server port]/company/po_import" se solicita.

      1. El nombre del servidor es el servidor en el que está instalado el agente privado. Si tiene un balanceador de carga o un firewall frente a su agente privado, entonces esta es la dirección IP o el nombre de host que está configurado para comunicarse con el agente privado.

      2. El puerto del servidor para HTTP es 46908.

      3. Si está creando una URL HTTPS (en lugar de HTTP), deberá configurar SSL en Jitterbit Apache en el agente privado de Jitterbit. Consulte estos enlaces para obtener información adicional:

         • Usando el archivo de configuración HTTPD
         • Configuración de Jitterbit con SSL

      4. El puerto del servidor para HTTPS es 46909.

   3. Operaciones para activar es una lista de las operaciones que desea activar con este extremo. Se debe especificar al menos una operación. Para agregar una operación, haga clic en el botón Agregar operación. Se presentará una lista de operaciones disponibles. Seleccione una o más operaciones y haga clic en Aceptar. Si selecciona una operación existente y hace clic en Editar operación, la operación seleccionada aparecerá en una nueva ventana o pestaña. Para eliminar una o varias operaciones de la lista de operaciones para activar, seleccione la(s) operación(es) y haga clic en Eliminar operaciones.

   4. Cada operación se puede activar de forma sincrónica o asincrónica. Para cada operación, seleccione el modo apropiado en el menú desplegable. Si desea utilizar el resultado de una operación como respuesta, debe ejecutarse de forma sincrónica. Las operaciones asincrónicas simplemente se agregan a la cola de operación para su procesamiento futuro.

   5. Si desea que el objetivo final de una operación se devuelva como respuesta, marque la casilla Objetivo final como respuesta para la operación que desea utilizar. Solo una operación puede tener esta opción marcada.

   6. En Configuración de solicitud, puede elegir opcionalmente que los datos de la solicitud se escriban en una variable global. Si no es obligatorio, deje este campo vacío. Por ejemplo, si ingresa la cadena request En este campo, los datos de la solicitud serán accesibles en secuencias de comandos y asignaciones como $request o Get("request") En Configuración de respuesta, se configura el comportamiento de la respuesta. El valor predeterminado es Sin respuesta. Si necesita devolver datos como parte de la respuesta, puede utilizar el destino final de una operación o datos escritos en un elemento de datos global como respuesta. Marque el botón de opción correspondiente y seleccione una operación o ingrese el nombre de un elemento de datos global.

6. De forma predeterminada, un Extremo HTTP alojado requiere un usuario autenticado. El usuario se autentica mediante la autenticación HTTP y todas las operaciones activadas deben tener el indicador de permiso de ejecución configurado para el usuario autenticado. Si desea que cualquier persona pueda activar el extremo o si está implementando la autenticación usted mismo, el usuario anónimo debe tener permiso de ejecución en la operación. Las operaciones siempre se ejecutan como propietario de la operación.

7. Implemente su proyecto. Una vez implementado el Extremo HTTP alojado, escuchará las solicitudes entrantes en la URL configurada.

Elementos de datos globales

Estos elementos de datos globales se completan cuando se accede a un Extremo HTTP alojado:

1. jitterbit.networking.http.request.header.HeaderName

   Contiene los encabezados HTTP incluidos en la solicitud. Por ejemplo, el encabezado Content-Type se escribe en el elemento de datos global $jitterbit.networking.http.request.header.content_typeNOTA: Utilice cualquiera de los dos $jitterbit.networking.http.request.header.content_type o Get("jitterbit.networking.http.request.header.content-type") para recuperar el valor.

2. jitterbit.networking.http.query.ParameterName

   Contiene los parámetros de consultar de URL, si los hay. Si la URL a la que se accede es http://server:port/company/po_import?po_id=dlsho394&uid=arcade, entonces $jitterbit.networking.http.query.po_id tendrá el valor "dlsho394" y $jitterbit.networking.http.query.uid tendrá el valor "arcade".

3. jitterbit.networking.peer.ip

   Contiene la dirección IP de la máquina que llama.

Estos elementos de datos globales se pueden configurar para modificar el comportamiento de un Extremo HTTP alojado:

1. jitterbit.networking.http.response.content_type

   Anula el encabezado de respuesta Content-Type predeterminado. El encabezado Content-Type predeterminado se establece siguiendo estas reglas: si un destino de operación es la respuesta, el encabezado Content-Type se establece en "text" para un destino de texto y "text/xml" para un destino XML. Si el extremo devuelve el contenido de un elemento de datos como respuesta, el encabezado Content-Type se establece en "text/html". Si el extremo no está configurado para devolver datos de respuesta, el encabezado Content-Type no se establece. Establezca este elemento de datos global para anular estos valores predeterminados.