Saltar al contenido

Editar el Archivo de Configuración del Agente (jitterbit.conf)

Introducción

Si está utilizando un agente privado, puede cambiar ciertas configuraciones para su agente dentro del archivo de configuración de Jitterbit (jitterbit.conf). En esta página se describe cómo realizar dichos cambios, así como las configuraciones disponibles.

Realizar Cambios de Configuración

Puedes realizar cambios en jitterbit.conf de forma remota a través de la Management Console, o manualmente en el directorio donde está instalado el agente privado.

La edición remota es el método preferido y, al usar este método, es más fácil garantizar la sincronización entre varios agentes dentro de un grupo de agentes y ver los cambios en el archivo de configuración. Si no desea almacenar el contenido de su jitterbit.conf archivo en la nube a través de la Management Console, pero aún así me gustaría realizar cambios en el archivo de configuración, puede hacerlo manualmente.

En cualquier caso, después de haber editado el archivo de configuración, se deben reiniciar todos los servicios de Jitterbit para que se realice el cambio de configuración.

Edite de Forma Remota a Través de la Management Console

La configuración del agente remoto está disponible para los agentes privados versión 8.14 y más alto. Además, debe tener habilitada la configuración del agente remoto para poder realizar cambios en el archivo de configuración de forma remota. Para habilitar la configuración del agente remoto:

  1. Inicie sesión en el portal Harmony y elija Management Console.
  2. Haga clic en el menú del portal Harmony en la parte superior izquierda y seleccione Organizaciones.
  3. Dentro de la tabla, seleccione la organización para la que desea habilitar la configuración del agente remoto.
  4. En el extremo derecho de la fila seleccionada, use el menú desplegable Acciones para seleccionar Editar políticas de la organización. Debe tener permiso de Administrador para la organización para poder ver esta opción.
  5. En la ventana emergente, marque la casilla de verificación junto a Habilitar configuración del Agente remoto y luego haga clic en Guardar.

Después de habilitar la configuración del agente remoto, edite el archivo de configuración.

Consejo

Referencia Agentes para todas las opciones disponibles al editar el archivo de configuración de Jitterbit de forma remota.

Advertencia

Cuando habilita la configuración del agente remoto, la configuración actual del agente (excluyendo la información de la base de datos de caché de PostgreSQL local y las variables globales predefinidas locales) se leerá y almacenará en la nube para que pueda verla y editarla de forma remota. Una vez que habilite la configuración del agente remoto, cualquier cambio que realice manualmente en el agente local jitterbit.conf el archivo ubicado en el agente no tendrá efecto.

Para deshabilitar la configuración del agente remoto y poder volver a editar el archivo local jitterbit.conf archivo manualmente, abra Organizaciones, seleccione una organización, seleccione la pestaña Administración de Agente y luego deshabilite Configuración remota del agente. Sin embargo, tenga en cuenta que perderá la configuración actual del agente remoto que estaba almacenada en la nube. Después de reiniciar los servicios del agente, su agente leerá desde el local jitterbit.conf archivo.

Editar Manualmente

Aunque es posible editar manualmente el archivo de configuración local de cada agente, este no es el método preferido para realizar cambios de configuración. Consulte Editar de forma remota a través de la Management Console arriba para el método preferido.

El archivo de configuración local se encuentra en el directorio de instalación de la máquina donde está instalado el agente privado. Suele ser en uno de estos lugares:

  • Windows (Harmony): C:\Program Files (x86)\Jitterbit Agent\jitterbit.conf

  • Windows (v5.x): C:\Program Files (x86)\Jitterbit Integration Server\jitterbit.conf

  • Linux: /opt/jitterbit/jitterbit.conf

Para realizar cambios, abra jitterbit.conf En un editor de texto, edítelo y luego guarde el archivo. Debe tener permisos de administrador del sistema para poder editarlo jitterbit.conf.

El formato del archivo de configuración es el siguiente:

  • Las secciones se definen mediante líneas individuales que contienen el nombre de la sección entre corchetes. Ejemplo:

    [Section]
    
  • Las claves y los valores se definen mediante un nombre de clave, seguido de un solo signo igual y, a continuación, del valor.

    No debe haber espacios entre la clave, el signo igual y el valor. Ejemplo:

    mykey=myvalue
    
  • Algunos valores pueden requerir comillas simples o dobles. Ejemplo:

    mykey="my value"
    
  • Las claves deben estar en la sección correcta como se documenta aquí para que se puedan encontrar y surtan efecto.

  • Los nombres de las secciones y de las claves no distinguen entre mayúsculas y minúsculas.

  • El orden de los elementos dentro de una sección no importa.

  • Los comentarios se pueden indicar con un solo símbolo hash (#) carácter. Cualquier cosa en la línea que sigue al # se ignorará.

  • No tiene ninguna línea que contenga un solo hash (#) carácter. Esto hará que se ignore la siguiente línea.

  • Todos los nombres de archivo son relativos a la carpeta del directorio de instalación de inicio a menos que se indique lo contrario.

    Importante

    Utilice barras diagonales para rutas de archivos/directorios incluso en Windows (como C:/Windows/Temp).

Reiniciar los Servicios de Jitterbit

Todos los servicios de Jitterbit deben reiniciarse para que la nueva configuración surta efecto.

En la máquina donde está instalado cada agente privado, primero detenga los servicios y luego reinícielos.

Windows Linux
Desde el menú Inicio:

Detener Jitterbit Services
Iniciar Jitterbit Services

Desde el directorio de instalación del Jitterbit Agente:

> StopServices.bat
> StartServices.bat

De un mensaje:

$ sudo jitterbit stop
$ sudo jitterbit start

Utilice un Archivo de Configuración Alternativo

Para utilizar un archivo de configuración alternativo, puede (en Windows) iniciar el agente privado desde una línea de comando:

> jitterbit.exe -f c:\config\alt-jitterbit.conf

Actualizar un Agente Privado

El archivo de configuración se conserva al actualizar un agente privado. Es decir, el archivo de configuración existente jitterbit.conf el archivo no se sobrescribe al instalar sobre una instalación de agente existente.

Es posible que, de vez en cuando, se realicen adiciones o cambios en jitterbit.conf como se anunció a través de las notas de lanzamiento de Harmony. Para aprovechar las mejoras o realizar ajustes, puede agregar manualmente nuevas configuraciones y valores a su archivo de configuración existente después de la actualización.

Otra opción es desinstalar y reinstalar el agente para obtener la última copia de jitterbit.conf, teniendo en cuenta que deberá volver a aplicar las personalizaciones aplicadas anteriormente. Para fines de respaldo, recomendamos hacer una copia de seguridad de su archivo de configuración de agente privado existente antes de reinstalar.

Configuración y Valores Predeterminados

Estas secciones describen cada configuración disponible dentro del jitterbit.conf archivo y los valores predeterminados para cada configuración.

Nota

En la siguiente tabla, un valor de 0 es intercambiable con un valor de false y un valor de 1 es intercambiable con un valor de true.

Dentro de la jitterbit.conf archivo, líneas que comienzan con # significa que estas líneas son comentarios que se ignoran en la configuración actual. Varios parámetros opcionales se comentan de esta manera; para utilizar estos parámetros, debe eliminar el comienzo # para que el parámetro se lea como parte del archivo de configuración.

Advertencia

Al editar el archivo de configuración, tenga en cuenta que el resto de una línea que esté comentada con # no debe dejarse en blanco, o la siguiente línea se leerá como un comentario incluso si no comienza con #.

[Settings]

Clave
Valor predeterminado Descripción
TempDir

De forma predeterminada, el TempDir la configuración se deja en blanco y se utilizará el directorio temporal proporcionado por el sistema operativo, y los archivos temporales de Jitterbit se ubicarán en %temp%\jitterbit o /tmp/jitterbit.

En Windows con el directorio temporal predeterminado del sistema operativo, este sería C:\Windows\Temp\jitterbit.

En Linux con un directorio temporal predeterminado del sistema operativo de /tmp, esto sería /tmp/jitterbit.

Para utilizar un directorio temporal diferente, configure TempDir igual a su trayectoria absoluta. Utilice barras diagonales, incluso en Windows. El directorio debe existir y el agente privado de Jitterbit debe poder leerlo y escribirlo.

CurlDebugDir

De forma predeterminada, el CurlDebugDir el parámetro se deja en blanco y no se crean registros de depuración detallados.

Para obtener registros de depuración detallados de solicitudes FTP y HTTP, puede cambiar el valor de este parámetro a cualquier ruta de directorio válida donde desee guardar los registros de depuración. Cada solicitud creará un nuevo archivo en este directorio.

Consulte también Registros de depurar de rizos.

EnableLocalFileLocation false

De forma predeterminada, EnableLocalFileLocation se establece en false. Esto significa que el uso de archivos locales como fuentes o destinos está deshabilitado.

Para usar archivos locales en su agente privado, puede habilitar los archivos locales cambiando el valor de este parámetro a true Para obtener más información, consulte Habilitar la ubicación de archivos locales.

JavaScriptMaxIterations 50000

El número máximo de iteraciones de bucle permitidas en Harmony es 50.000. El número máximo de iteraciones de bucle en JavaScript es por secuencia de comandos, no por bucle.

Por ejemplo, un secuencia de comandos de JavaScript que contenga tres bucles, donde cada bucle ejecuta 25 000 iteraciones, sería un total de 75 000 iteraciones ejecutándose dentro del un secuencia de comandos.

Para aumentar el número máximo de iteraciones permitidas en cualquier secuencia de comandos JavaScript, agregue manualmente JavaScriptMaxIterations=X dónde X es mayor que 50000.

RecoverableStatusCode 500,502,503,504

De forma predeterminada, RecoverableStatusCode se establece en la lista de códigos de error de 500,502,503,504 para la versión 10.34 y posteriores del agente privado.

Para los agentes privados 10.30 a 10.33, RecoverableStatusCode configuración y la lista de códigos de error deben agregarse manualmente:

RecoverableStatusCode=500,502,503,504

Cuando RecoverableStatusCode está configurado y la opción Reintentar está seleccionada en una conexión HTTP, la actividad se recupera de los códigos de error enumerados y vuelve a intentar la actividad.

EnableAPITimeout false

De forma predeterminada, EnableAPITimeout no está presente en el jitterbit.conf archivo y debe agregarse manualmente.

Si EnableAPITimeout se establece en true, las operaciones activadas por las APIs de API Manager utilizarán la configuración de tiempo de espera de operación establecida en Cloud Studio o Design Studio.

[DBInfo]

Clave
Valor predeterminado
Descripción
User jitterbit

De forma predeterminada, cuando se instala un agente privado de Jitterbit, se instala una base de datos PostgreSQL local. Esta sección proporciona el nombre de usuario del agente privado para esa base de datos PostgreSQL local.

No recomendamos cambiar la base de datos PostgreSQL local predeterminada. Sin embargo, para utilizar una base de datos PostgreSQL diferente, aquí es donde deberá especificar su información y credenciales.

Nota

El instalador del agente silencioso de Windows versión 10.48 o posterior config64.ps1 el secuencia de comandos permite especificar un nombre de usuario de agente alternativo en su Postgres_agent_username campo, que actualizará el User valor aquí.

DisableOdataCount false Desactiva la $count y $inlinecount configuración en consultas OData entrantes. Ajustado a true si experimenta problemas de rendimiento en la base de datos en segundo plano como resultado de la función de recuento. Esto solo está disponible con un agente privado 9.6 o posterior.
Password generado durante la instalación
Driver 'PostgreSQL ODBC Driver(UNICODE)' Windows de 32 bits
'PostgreSQL Unicode(x64)' Windows de 64 bits
'PostgreSQL-jitterbit' Linux
SystemDbName 'postgres'
Server 127.0.0.1
Port 6432 Para la versión 10.60 o anterior del agente privado, el puerto predeterminado es 6543.

[APIInfo]

Clave
Valor predeterminado Descripción
DebugJDML false Establecer en true para agregar registros adicionales de llamadas OData en los registros API, incluido el SQL real enviado a la base de datos. Esto solo está disponible con un agente privado 9.6 o posterior.

[ProcessEngine]

Clave
Valor predeterminado Descripción
MaxNumberOfWorkerThreads auto

De forma predeterminada, cuando MaxNumberOfWorkerThreads se establece en auto, la cantidad de subprocesos de trabajo será el doble de la cantidad de núcleos.

Puede cambiar este valor a cualquier número desde un mínimo de 1 hasta un máximo de 200.

RunOperationsInSeparateProcess true

De forma predeterminada, cuando RunOperationsInSeparateProcess se establece en true las operaciones se ejecutarán en procesos separados. Cuando esta opción está activada true, el valor predeterminado es tiempo de ejecución ilimitado durante cuánto tiempo se permite ejecutar una operación.

Para establecer un límite sobre cuánto tiempo se permite ejecutar cada operación, puede configurar MaxOperationRuntimeSeconds al número de segundos permitidos. Opcionalmente, puede especificar un MaxOperationRuntimeMessage que se registrará en los casos en que se alcance el tiempo de ejecución máximo.

No se recomienda desactivar RunOperationsInSeparateProcess Puedes hacerlo configurando RunOperationsInSeparateProcess como false. En ese caso, MaxOperationRuntimeSeconds y MaxOperationRuntimeMessage no se aplicará.

MaxOperationRuntimeSeconds
MaxOperationRuntimeMessage
EnableDebugDump false

De forma predeterminada, EnableDebugDump es false y el volcado de depurar no está habilitado. Para habilitarlo, configúrelo en true.

Si está habilitado, puede configurar DebugDumpDir a la ruta a un directorio para el volcado de depurar. Si no se especifica, DebugDumpDir se establecerá de forma predeterminada en TempDir Ajuste bajo [Settings].

Para especificar un directorio, configure DebugDumpDir igual a su trayectoria absoluta. Utilice barras diagonales, incluso en Windows. El directorio debe existir y el agente privado de Jitterbit debe poder leerlo y escribirlo.

DebugDumpDir

[PredefinedGlobalVariables]

Esta sección proporciona los valores predeterminados de las variables globales predefinidas, que también se conocen como variables Jitterbit. Estos se pueden sobrescribir caso por caso estableciendo la variable correspondiente en un secuencia de comandos.

Para obtener documentación completa sobre todas las variables que se pueden configurar en esta sección, consulte Cloud Studio variables de Jitterbit o Design Studio variables Jitterbit.

Clave
Valor predeterminado Descripción
jitterbit.source.db.preserve_char_whitespace false De manera predeterminada, los espacios en blanco iniciales y finales de una base de datos de origen no se conservan. Para conservar los espacios en blanco iniciales y finales, cambie el valor a true.
jitterbit.target.db.include_null_in_sql_statement false De manera predeterminada, no se incluye un valor nulo en una sentencia SQL de una base de datos de destino. Para incluir un valor nulo, cambie el valor a true.
jitterbit.scripting.nesting.max 10 De forma predeterminada, se permiten hasta 10 secuencias de comandos anidados. Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.while.max_iterations 50000 De forma predeterminada, cada bucle while está limitado a 50.000 iteraciones en un secuencia de comandos escrito en lenguaje Jitterbit Script. Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.db.auto_commit true De forma predeterminada, los secuencias de comandos de la base de datos se confirmarán automáticamente. Para utilizar transacciones de base de datos, puede cambiar este valor a false.
jitterbit.scripting.db.max_rows 10000 De forma predeterminada, el número máximo de filas de la base de datos afectadas por un secuencia de comandos es 10.000. Este número limita la cantidad de filas que se devolverán para el DBExecute, DBLookup, y DBLookupAll funciones (ver Cloud Studio Funciones de base de datos o Design Studio Funciones de base de datos). Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.ldap.scope 1 De forma predeterminada, los secuencias de comandos permiten el uso de LDAP. Para desactivar esta opción, configúrela en 0.
jitterbit.scripting.ldap.include_dn_in_results false De forma predeterminada, los secuencias de comandos no incluyen el nombre completo (DN) en Active Directory. Para incluir el DN, cambie esta opción a true.
jitterbit.scripting.ldap.use_paged_search false De forma predeterminada, la búsqueda paginada de LDAP está desactivada en las secuencias de comandos. De forma predeterminada, Active Directory permite que sus consultas extraigan solo una cierta cantidad de registros a la vez. Si esta opción está configurada en false y ejecuta una consultar que excede este límite, su consultar fallará. Si configura esto en true, Jitterbit recuperará los datos en páginas para que no se exceda el límite de Active Directory.
jitterbit.scripting.ldap.max_search_results 1 De forma predeterminada, el máximo de resultados de búsqueda devueltos por una búsqueda LDAP es 1 Para obtener más resultados, aumente este número.
jitterbit.scripting.ldap.return_null_if_no_results false Si se establece en true, entonces una consultar LDAP sin registros que coincidan con la consultar devolverá un único NULL valor.
jitterbit.source.text.csv_nullable false De forma predeterminada, si se utiliza un archivo CSV de texto como archivo de origen, no se permiten valores nulos. Cambie este valor a true para permitir valores nulos.TABLEROWEND
jitterbit.target.http.remove_trailing_linebreaks true Si se establece en true Los saltos de línea finales se eliminarán antes de que se publiquen los datos de destino.
jitterbit.target.xml.num_for_bool false De forma predeterminada, los valores de destino booleanos XML se representan con valores de cadena: "falso" y "verdadero". Si se configura en true Los valores de destino booleanos XML se representarán con "0" o "1" para false y true valores respectivamente.
jitterbit.source.ftp.transfer_timeout 3600 De forma predeterminada, el tiempo de espera de transferencia para fuentes FTP es de 3600 segundos. Para aumentar o disminuir, cambie el valor a otro número.
jitterbit.target.ftp.transfer_timeout 3600 De forma predeterminada, el tiempo de espera de transferencia para destinos FTP es de 3600 segundos. Para aumentar o disminuir, cambie el valor a otro número.
jitterbit.http.enable_cookies false De forma predeterminada, las cookies no están habilitadas para conexiones HTTP. Para habilitar las cookies, cambie este valor a true.

[TransformationEngine]

Clave
Valor predeterminado Descripción
WriteLog 0

De forma predeterminada, WriteLog se establece en 0, lo que significa que el registro detallado de transformaciones está desactivado.

Para activar el registro detallado de transformaciones con fines de depuración, puede cambiar este valor a 1.

No se recomienda mantener el registro habilitado, ya que esta opción puede generar muchos archivos. Además, tenga en cuenta que el registro detallado también se puede activar en el nivel de operación, lo cual es preferible.

Cuándo WriteLog está habilitado y WriteLogDir se deja en blanco de forma predeterminada, los registros de depurar se escribirán en JITTERBIT_HOME/DataInterchange/Temp/Debug Si desea cambiar el directorio donde se guardan los registros, puede especificar el valor de WriteLogDir como la ubicación del directorio deseada.

Para obtener más información, consulte Registro de depurar de operaciones.

WriteLogDir
ValidateXML 1

De forma predeterminada, ValidateXML se establece en 1, lo que significa que la validación XML está activada.

Para desactivar toda la validación XML a escala global, configure en 0. Como sea, esto no es recomendable. Se recomienda establecer esto en el nivel de transformación.

LdapEnableAutoUpdateMode false

De forma predeterminada, el modo de actualización automática para LDAP no está habilitado.

Si se cambia a true el modo de actualización automática le permite buscar cada entrada para determinar si la entrada debe agregarse o actualizarse.

TimingOn 0

De forma predeterminada, TimingOn se establece en 0, lo que significa que la creación de perfiles de archivos no está activada.

Para activar la creación de perfiles globalmente, cambie este valor a 1 Cuando está habilitado, los archivos de creación de perfiles se escriben en JITTERBIT_HOME/DataInterchange/Temp/LOG de forma predeterminada. No se puede cambiar el directorio de registro para este parámetro.

AutoStreaming 1

De forma predeterminada, AutoStreaming se establece en 1, lo que significa que la transmisión automática está activada.

Para deshabilitar la transmisión, configure este parámetro igual a 0. Como sea, esto no es recomendable. Se recomienda hacer esto en transformaciones individuales.

Consulte también Cloud Studio Procesamiento de Transformación o Design Studio transformaciones por secuencias y lote.

UseOldRuleForLoopOneOfXmlNode 0

De forma predeterminada, este parámetro está configurado en 0, lo que significa que esta regla no está habilitada.

La única instancia en la que este parámetro debe establecerse en 1 es para garantizar la compatibilidad con versiones anteriores. Cuando se configura en 1, se utilizará una regla que estaba presente en versiones anteriores para crear uno de los nodos de destino XML.

AutoXsiNil 0

De forma predeterminada, este parámetro está configurado en 0.

Si este valor se establece en 1, entonces la transformación creará automáticamente un xsi:nil="true" atributo para un elemento que es obligatorio y no está asignado.

DefaultEntityResolution true De manera predeterminada, el análisis de tipos de IDoc está habilitado. Para deshabilitar este análisis adicional en un agente privado, añadir manualmente DefaultEntityResolution=false en el [TransformationEngine] sección en jitterbit.conf.

[OperationEngine]

Clave
Valor predeterminado Descripción
Debug false

De forma predeterminada, Debug se establece en false y el modo de depurar no está habilitado.

Para habilitar el modo de depurar, establezca el valor en true Esto hará que se escriban mensajes de proceso adicionales en el archivo de registro. Es posible que desee habilitar esta opción si tiene datos temporales que no se deben eliminar.

Nota

Ambos Debug valor y el WriteLog el valor debe establecerse en 1(verdadero) para que se generen los registros.

Consulte Registro de depurar de operaciones para obtener información adicional.

AlwaysRunSuccessOperation false

De forma predeterminada, este parámetro está configurado en false.

Si se establece en true, las operaciones se configurarán para que siempre se ejecuten correctamente incluso si no hay datos. Esta opción puede resultar útil cuando no hay archivos fuente disponibles para una fuente basada en archivos, pero desea que la operación se ejecute como si hubiera sido exitosa.

TemporaryStorageRootDirectory

De manera predeterminada, cuando no se especifica, el directorio raíz de almacenamiento temporal será TemporaryStorage y bajo el directorio temporal del sistema operativo, o bajo el directorio temporal especificado por el TempDir Ajuste bajo [Settings].

En Windows con el directorio temporal predeterminado del sistema operativo, este sería

C:\Windows\Temp\jitterbit\TemporaryStorage

En Linux con un directorio temporal predeterminado del sistema operativo de /tmp, esto sería

/tmp/jitterbit/TemporaryStorage

Para especificar un directorio de almacenamiento temporal diferente, establezca TemporaryStorageRootDirectory igual a su ruta absoluta. Utilice barras diagonales, incluso en Windows. El directorio debe existir y el agente privado de Jitterbit debe poder leerlo y escribirlo; de lo contrario, la configuración se ignora.

Consulte Ubicaciones de los archivos de registro para obtener información adicional.

MaxNumberOfOperationThreads

De forma predeterminada, cuando no se especifica este parámetro, el número de subprocesos de operación es ilimitado.

Para establecer un número máximo de subprocesos, puede utilizar un número como valor aquí.

MaxOperationStackDepth 50

De forma predeterminada, el número máximo de llamadas a operación síncronas anidadas permitidas es 50.

Para aumentar o disminuir este máximo, configúrelo en el número deseado. Para que este parámetro sea ilimitado, establezca el valor en 0 o un número negativo. Sin embargo, tenga en cuenta que no se recomienda configurar este parámetro como ilimitado, ya que puede causar inestabilidad en el sistema.

MaxAsyncOperationChainLength 50

De forma predeterminada, el número máximo de operaciones asincrónicas permitidas en una sola cadena es 50.

Esto es para proteger contra bucles de operación infinitos. Para aumentar o disminuir este máximo, configúrelo en el número deseado. Para que este parámetro sea ilimitado, establezca el valor en 0 o un número negativo.

MaxAsyncOperationChainLengthOverrideAllowed true

De forma predeterminada, este parámetro está configurado en true, lo que significa que es posible anular la longitud máxima de la cadena de operación asincrónicas. Cuando esta opción está habilitada, puede anular la longitud máxima de la cadena configurando la variable global $jitterbit.operation.max_async_chain_length (consulte Cloud Studio variables de operación Jitterbit o Design Studio variables de operación Jitterbit).

Si esta opción se cambia a false, no será posible anular la longitud de la cadena utilizando la variable global.

AlwaysDeleteTempDir false

De forma predeterminada, este parámetro está configurado en false, lo que significa que los archivos de operación temporales se conservan hasta que se limpien de forma asincrónica.

Para eliminar siempre los archivos de operación temporales, incluso en caso de errores, configúrelo en true.

WriteLog 0

De forma predeterminada, WriteLog está configurado en 0(falso).

Para habilitar WriteLog modo, establezca el valor en 1 (verdadero). Esto hará que se escriban mensajes de proceso adicionales tanto para la API como para las operaciones programadas en el archivo de registro. Quizás quieras habilitar esto si tienes datos temporales que no deben eliminarse.

[APIOperation]

Clave
Valor predeterminado Descripción
EnableErrorLogging true

De forma predeterminada, EnableErrorLogging es true, es decir, solo operaciones API (configuradas para APIs personalizadas o servicios OData) con errores se registran en los registros de operación.

Si esta opción está configurada en false, registro de errores en los registros de operación está deshabilitado.

EnableLogging false

De forma predeterminada, EnableLogging es false, es decir, todas las operaciones API (configuradas para APIs personalizadas o servicios OData) no están registrados en los registros de operación. Tenga en cuenta que aún puede ver los registros de procesamiento de API en el API Manager Registros de API página.

Si EnableLogging se establece en true, todas las operaciones de API se registran en los registros de operación. Tenga en cuenta que cuando EnableLogging se establece en true, el escenario para EnableErrorLogging se ignora (ya que se registrarían todos los registros de operación de API).

EnableOperationIdLogging false

De forma predeterminada, EnableOperationIdLogging es false, lo que significa que no se registrará el ID de una operación que provocó un bloqueo.

Si esta opción se configuró en true, luego se registra el ID de la operación que causó el bloqueo y se puede utilizar para determinar la causa raíz.

APIOperationLogging false

De forma predeterminada, APIOperationLogging no está presente en el jitterbit.conf archivo y debe agregarse manualmente.

Si APIOperationLogging se establece en true, un registro registrará el inicio de una llamada API y el tiempo transcurrido.

Precaución

Activar esta configuración generará al menos cuatro líneas adicionales para cada operación API, lo que puede generar archivos de registro muy grandes.

[HttpEndPoints]

Importante

[HttpEndPoints] la configuración se aplica solo a Design Studio extremos HTTP alojados.

Clave
Valor predeterminado Descripción
EnableErrorLogging true

De forma predeterminada, EnableErrorLogging es true, es decir, solo extremo alojado HTTP las llamadas con errores se registran en el registro de actividades.

Si esta opción estuviera configurada en false, el registro de errores en el registro de actividad se desactivará.

EnableLogging true

De forma predeterminada, EnableLogging se establece en verdadero para extremos alojados HTTP, lo que significa que todas las llamadas a extremo alojados en HTTP se registran en el registro de actividad. Para deshabilitar el registro de operación para extremos alojados HTTP, puede cambiar este valor a false Es posible que desees desactivar el registro para lograr una mayor eficiencia y rendimiento bajo carga.

Ten en cuenta que cuando EnableLogging se establece en true, entonces el ajuste para EnableErrorLogging se ignora (ya que se registrarían todas las llamadas HTTP).

Si ambos EnableLogging y EnableErrorLogging Se establecieron para false, entonces no se habilitará ningún registro.

[AutoScaling]

Clave
Valor predeterminado Descripción
DeregisterAgentOnJVMShutdown true

Si DeregisterAgentOnJVMShutdown se establece en true (o no está presente), entonces la cancelación del registro del agente debería ocurrir, incluso cuando se detiene el agente (a menos que se detenga usando el comando "Drain Stop" desde la Management Console).

Si DeregisterAgentOnJVMShutdown se establece en false entonces la cancelación del registro del agente no se produce al detener el agente (a menos que no se detenga usando el comando "Drain Stop" desde la Management Console).

[ResultFiles]

Clave
Valor predeterminado Descripción
DisableSuccess false

De forma predeterminada, DisableSuccess es false, lo que significa que la creación de archivos de éxito está habilitada.

Es posible que desee activar esta opción configurando true si no desea que se creen archivos de éxito, lo que puede ahorrar espacio en disco.

TABLEROWEND
DisableFailure false

De forma predeterminada, DisableFailure es false, lo que significa que la creación de archivos de error está habilitada.

Es posible que desee activar esta opción configurando true si no desea que se creen archivos de error, lo que puede ahorrar espacio en disco.

[PredefinedServerGlobalDataElement]

Clave
Valor predeterminado
Descripción
definido por el usuario definido por el usuario

Esta sección se utiliza para crear variables globales predefinidas personalizadas que se inicializan para cualquier operación que se inicie en el agente. Si especifica bubble='gum', esto agregará una variable global predefinida llamada bubble con el valor inicial de "gum" que puede ser referenciado en secuencias de comandos como $bubble o mediante el uso Get("bubble").

Ver Cloud Studio variables de Jitterbit o Design Studio variables globales.

[Scheduler]

Clave
Valor predeterminado Descripción
AutoStart 1 De forma predeterminada, este parámetro se establece igual a 1, significado AutoStart está habilitado.
SleepTimeInSeconds 5

De forma predeterminada, el tiempo de suspensión se establece en 5 segundos.

Este valor se puede aumentar o disminuir según sus necesidades.

WriteLog 0

De forma predeterminada, este parámetro está configurado en 0 y el registro de depurar del programador está desactivado. Esta es la configuración recomendada, ya que activar el registro de depurar del programador podría generar un gran volumen de registros y potencialmente causar una degradación del rendimiento.

Para activar el registro de depurar del programador, cambie este valor a 1 el registro se escribe en el directorio temporal y se llama scheduler_debug.log.

[FileCleanup]

Clave
Valor predeterminado Descripción
AutoStart 1

De forma predeterminada, este parámetro se establece igual a 1, significado AutoStart está habilitado.

Si cambia esta opción a 0, entonces la limpieza de archivos no se ejecutará automáticamente, lo que deshabilitará efectivamente la limpieza de archivos.

SleepTimeInSeconds 5

De forma predeterminada, el tiempo de suspensión se establece en 5 segundos.

Este valor se puede aumentar o disminuir según sus necesidades.

FrequencyInHours 24.0

De forma predeterminada, la limpieza de archivos se ejecutará una vez cada 24 horas.

Este valor se puede aumentar o disminuir según sus necesidades.

[SMTPClient]

Clave
Valor predeterminado Descripción
DefaultSMTPServers

Especifica los servidores SMTP predeterminados que se usarán cuando se va a enviar un mensaje de correo y el usuario no especificó ningún servidor SMTP.

Agregue los servidores SMTP en una lista separada por comas.

DefaultFromEmail Especifica una dirección de correo predeterminada para usar en el campo "De" si el usuario no especificó ninguna.
DefaultAccount
DefaultAccountPassword
UseSSL
Si sus servidores SMTP necesitan autenticación, especifique la cuenta y la contraseña aquí. UseSSL a true si el servidor SMTP requiere SSL/TLS.

[SSH]

¡Asegúrese de que estos archivos puedan ser leídos por la aplicación Jitterbit y por nadie más!

Clave
Valor predeterminado Descripción
PublicKeyFile

No hay ningún valor predeterminado PublicKeyFile. Puede especificar la ruta absoluta a su clave pública aquí si corresponde. Por ejemplo:

PublicKeyFileMe='/usr/local/ssh/id_dsa.pub'

PrivateKeyFile

No hay ningún valor predeterminado PrivateKeyFile Aquí puede especificar la ruta absoluta a su clave privada. Por ejemplo:

PrivateKeyFile='/usr/local/ssh/id_dsa'

PrivateKeyPassphrase No hay ningún valor predeterminado PrivateKeyPassphrase Puede especificar aquí la contraseña de su clave privada si es necesario.TABLEROWEND
Configurado por el usuario para múltiples conjuntos

Se pueden configurar múltiples conjuntos de claves mediante la configuración, por ejemplo:

$jitterbit.source.sftp.ssh_key_id="Me"

o

$jitterbit.target.sftp.ssh_key_id="Me"

Con una entrada como:

PublicKeyFileMe='/usr/local/ssh/id_dsa.pub'
PrivateKeyFileMe='/usr/local/ssh/id_dsa'
PrivateKeyPassphraseMe=

[SSL]

¡Asegúrese de que Jitterbit pueda leer estos archivos, pero nadie más! Solo se admiten certificados y claves con formato PEM.

Clave
Valor predeterminado Descripción
CertificateFile

No hay ningún valor predeterminado CertificateFile Aquí puede especificar la ruta absoluta al archivo de certificado de cliente SSL. Por ejemplo:

CertificateFile='C:/Certs/default.crt'

PrivateKeyFile

No hay ningún valor predeterminado PrivateKeyFile Aquí puede especificar la ruta absoluta a su clave privada. Por ejemplo:

PrivateKeyFile='C:/Certs/default.key'

PrivateKeyPassphrase No hay ningún valor predeterminado PrivateKeyPassphrase Puede especificar la contraseña de su clave privada aquí si es necesario.TABLEROWEND
Configurado por el usuario para múltiples conjuntos

Se pueden configurar múltiples conjuntos de certificados y claves mediante la siguiente configuración, por ejemplo:

$jitterbit.target.http.ssl_cert_id = "Me";

o

$jitterbit.source.http.ssl_cert_id = "Me";

o

$jitterbit.web_service_call.ssl_cert_id = "Me";

Con una entrada como:

CertificateFileMe='C:/Usuarios/Mi Nombre/Certs/me.crt'
PrivateKeyFileMe='C:/Usuarios/Mi Nombre/Certs/me.key'
PrivateKeyPassphraseMe=mysecret

[Settings/XMLSchemas]

Estas configuraciones definen los esquemas XML disponibles.

Clave Valor predeterminado
Schema_2001 DataInterchange/xml_dtd/Schemas/XMLSchema_2001.xsd
Schema_1999 DataInterchange/xml_dtd/Schemas/XMLSchema_1999.xsd
SoapEncoding DataInterchange/xml_dtd/Schemas/SOAP_Encoding.xsd
WSDL DataInterchange/xml_dtd/Schemas/WSDL.xsd
SoapEncoding_v11 DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v11.xsd
SoapEncoding_v12 DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v12.xsd

[DbDrivers]

Ciertos controladores de bases de datos requieren caracteres especiales para delimitar los nombres de tablas/columnas. Si su aplicación requiere configuraciones diferentes, puede modificar estas entradas.

Muchos controladores ODBC requieren que los nombres de tablas y campos estén entre comillas si distinguen entre mayúsculas y minúsculas o contienen caracteres especiales. Configure los caracteres de cotización para su controlador en esta sección si aún no están incluidos. Los caracteres especiales que se admiten como delimitadores incluyen / . * = ? | ( ) [ ] { y } Estos delimitadores se definen especificando el Quote Begin y Quote End en esta sección.

PostgreSQL

'PostgreSQL Quote Begin'='\"'
'PostgreSQL Quote End'='\"'

'PostgreSQL-psql Quote Begin'='\"'
'PostgreSQL-psql Quote End'='\"'

'PostgreSQL ANSI Quote Begin'='\"'
'PostgreSQL ANSI Quote End'='\"'

'PostgreSQL Unicode Quote Begin'='\"'
'PostgreSQL Unicode Quote End'='\"'

SQL Server

Para SQL Server, Quote Begin y Quote End son necesarios solo para tablas o columnas que contienen caracteres especiales.

'SQL Server Quote Begin'='['
'SQL Server Quote End'=']'

MySQL

Para MySQL, Quote Begin y Quote End son necesarios para las tablas con espacios.

'MySQL Quote Begin'='`'
'MySQL Quote End'='`'

Controlador MySQL 3.51

'MySQL ODBC 3.51 Driver Quote Begin'='`'
'MySQL ODBC 3.51 Driver Quote End'='`'

Controlador MySQL 5.1

'MySQL ODBC 5.1 Driver Quote Begin'='`'
'MySQL ODBC 5.1 Driver Quote End'='`'

Oracle

'Oracle Quote Begin'='\"'
'Oracle Quote End'='\"'

Oracle XE

'Oracle in XE Quote Begin'='\"'
'Oracle in XE Quote End'='\"'

Microsoft ODBC para Oracle

'Microsoft ODBC for Oracle Quote Begin'='\"'
'Microsoft ODBC for Oracle Quote End'='\"'

Controlador ODBC de Oracle

'Oracle ODBC Driver Quote Begin'='\"'
'Oracle ODBC Driver Quote End'='\"'

Oracle en OraClient10g_home2

'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'

Acceso

'Microsoft Quote Begin'='['
'Microsoft Quote End'=']'

MS Access

'Microsoft Access Driver (*.mdb) Quote Begin'='['
'Microsoft Access Driver (*.mdb) Quote End'=']'

Excel

'Excel Quote Begin'='['
'Excel Quote End'=']'

Excel

'Microsoft Excel Driver (*.xls) Quote Begin'='['
'Microsoft Excel Driver (*.xls) Quote End'=']'

MS Excel : Nombre Alternativo

'Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin'='['
'Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End'=']'

FileMaker Pro

'DataDirect 32-BIT SequeLink 5.4 Quote Begin'='\"'
'DataDirect 32-BIT SequeLink 5.4 Quote End'='\"'

DB2

'IBM DB2 (AS400) Quote Begin'='\"'
'IBM DB2 (AS400) Quote End'='\"'

[HttpConnectionPool]

Esta sección se utiliza con configuraciones de proxy para llamar a recursos externos.

Clave
Valor predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales que se mantendrán en el grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 20).
MaxConnectionsPerRoute 5 Número máximo de conexiones por enrutar. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 2).
TimeoutInSeconds 60 Tiempo de espera, en segundos, para esperar una conexión del grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente no hay tiempo de espera, lo que significa que el tiempo de espera será indefinido mientras se espera que haya una conexión disponible).
HttpSocketTimeoutInSeconds 180 Tiempo de espera, en segundos, después de establecer la conexión, que el socket del cliente espera para recibir una respuesta después de enviar la solicitud. Este es el tiempo transcurrido desde que el cliente envió la solicitud al servidor antes de que el servidor responda. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tiempo de espera, en segundos, para esperar la conexión con el alojar remoto.

[HttpConnectionPoolLocal]

Esta sección se utiliza con recursos locales (servicios SOAP, API).

Clave
Valor predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales que se mantendrán en el grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 20). Este valor se puede establecer en 100. Consulte la nota.
MaxConnectionsPerRoute 50 Número máximo de conexiones por enrutar. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 2). Este valor se puede establecer en 100. Consulte la nota.
TimeoutInSeconds 60 Tiempo de espera, en segundos, para esperar una conexión del grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente no hay tiempo de espera, lo que significa que el tiempo de espera será indefinido mientras se espera que haya una conexión disponible).
HttpSocketTimeoutInSeconds 180 Tiempo de espera, en segundos, después de establecer la conexión, que el socket del cliente espera para recibir una respuesta después de enviar la solicitud. Este es el tiempo transcurrido desde que el cliente envió la solicitud al servidor antes de que el servidor responda. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tiempo de espera, en segundos, para esperar la conexión con el alojar remoto.

Nota

Estos solo se aplican a [HttpConnectionPoolLocal] ajustes.

Si configura MaxConnections y MaxConnectionsPerRoute hasta 100, realice estos cambios adicionales:

  1. Edite el jitterbit-agent-config.properties archivo y conjunto:

    max.concurrent.requests=100
    

    No establecer max.concurrent.requests superior a 100. Esto revertirá el valor predeterminado de 16.

  2. Edite el httpd.conf archivo y conjunto:

    ThreadsPerChild 101
    

[Debug]

Clave
Valor predeterminado Descripción
WebServiceDebugFile ''

De forma predeterminada, la escritura en un archivo de depurar de un servicio web está deshabilitada.

Cuando está habilitado, los servicios web backend escribirán información de depurar en este archivo mientras están en modo de depurar.

[ErrorHandling]

Esta sección proporciona opciones de configuración para manejar posibles situaciones de error en el backend. Los valores posibles son:

  • Ok: La situación se considera normal; continúe como siempre.
  • Warning: Registrar una advertencia y continuar.
  • Error: La situación se considera fatal.
Clave
Valor predeterminado Descripción
NoRowsAffectedOnDbUpdates Ok Una declaración de actualización en un objetivo de base de datos que no afecta ninguna fila es Ok según la definición anterior.
NoTargetDataGenerated Ok No se generaron datos de destino Ok según la definición anterior.
NoWebServiceRequestData Warning No hay datos disponibles para generar una solicitud de servicio web válida genera una Warning según la definición anterior.
EmptyDatabaseSource Warning Una fuente de base de datos plana está vacía y genera una Warning según la definición anterior.

[JavaBackend]

Clave
Valor predeterminado Descripción
DebugLogLevel No hay ningún valor predeterminado DebugLogLevel Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JavaUiBackend]

Clave
Valor predeterminado Descripción
LogLevel OFF El valor predeterminado para LogLevel es OFF, lo que indica que el registro está desactivado. Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JDBCEngine]

Clave
Valor predeterminado Descripción
SessionTimeout 60 El valor predeterminado para SessionTimeout es 60, que es el número de minutos de inactividad después de los cuales se agotará el tiempo de espera de una sesión JDBC abierta. Esto se utiliza como medida de seguridad, ya que normalmente el servidor cerrará las sesiones después de su uso. Puede cambiar el tiempo de espera de la sesión ajustando el número.
ClientSessionTimeout 180 El valor predeterminado para ClientSessionTimeout es 180, que es el número máximo de minutos que puede durar una operación JDBC. Después de esto la operación fallará. Si cree que una operación JDBC (como un proceso de escritura de destino JDBC) tardará más que esto, debe aumentar este número.
LogLevel INFO El valor predeterminado para LogLevel es INFO, lo que indica que se están registrando mensajes informativos. Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[LDAP]

El [LDAP] la sección de un archivo de configuración de agente privado se puede utilizar para agregar compatibilidad con UTF-8 para Microsoft Windows y Active Directory con agentes privados de Windows que sean versión 9.5 o superior.

Clave Valor Descripción
CharacterEncoding ISO-8859-1 Admite codificación UTF-8.

Esto puede estar justificado si utiliza el LDAPReplace() función para reemplazar un valor en Active Directory como se ve a continuación, y descubre que el texto se convierte en un resultado diferente al de la entrada, como por ejemplo François siendo reemplazado por FrançOis:

LdapReplace("givenName", "François");

Para evitar problemas con caracteres especiales, agregue el [LDAP] sección de la siguiente manera y luego reinicie el agente:

  1. Actualice el jitterbit.conf archivo con las siguientes líneas:

    [LDAP]
    CharacterEncoding=ISO-8859-1
    
  2. Reinicie el agente.

Para obtener más información, consulte Funciones LDAP de Cloud Studio o funciones LDAP de Design Studio.

[ConnectorsInfo]

Clave
Valor predeterminado
Descripción
MSAXUrl http://127.0.0.1:8002/AX/ Esto lo utiliza Microsoft Dynamics AX Connector (Design Studio o Cloud Studio) y no debe modificarse a menos que lo indique el soporte de Jitterbit.
MSCrmUrl http://127.0.0.1:8000/CRM/ Esto lo utiliza Microsoft Dynamics CRM Connector (Design Studio o Cloud Studio) y no debe modificarse a menos que lo indique el soporte de Jitterbit.
jitterbit.connectorcall.timeout 300 Valor de tiempo de espera en segundos. Esto lo utilizan ciertos conectores y no se debe cambiar a menos que lo indique el soporte de Jitterbit.

[VerboseLogging]

Esta sección está presente en los agentes privados 10.48 y posteriores y se utiliza para la generación de datos de entrada y salida de componentes cuando registro de depurar de operación está habilitado en una operación individual de Cloud Studio que se ejecuta en un agente privado 10.48 o posterior.

Al actualizar una versión anterior del agente privado a 10.48 o posterior, la generación de datos de entrada y salida se habilita automáticamente de forma predeterminada, incluso si el [VerboseLogging] la sección y sus claves no están presentes en el archivo de configuración.

La generación de datos de entrada y salida de componentes no se ve afectada por la configuración del grupo de agentes Habilitar registro en la nube. Los datos de entrada y salida de los componentes se registrarán en la nube de Harmony incluso si el registro en la nube está deshabilitado, a menos que verbose.logging.enable está configurado explícitamente para false. Esto anula la generación de datos de entrada y salida de componentes cuando Habilitar modo de depuración hasta está configurado en una operación individual de Cloud Studio, pero no impide que se generen archivos de registro de depurar de operación. Ambos tipos de registros de depurar de operación se tratan en Registro de depurar de operaciones.

Clave
Valor predeterminado
Descripción
verbose.logging.enable true

Cuando true o cuando esta configuración no está presente en el archivo de configuración, los datos de entrada y salida del componente se escriben en el registro de operación de Cloud Studio cuando registro de depurar de operación está habilitado en una operación individual de Cloud Studio que se ejecuta en un agente privado 10.48 o posterior. Ajustado a false para evitar que los datos de entrada y salida de los componentes se registren en la nube de Harmony.

Precaución

Cuando esta configuración no está presente en el archivo de configuración de un agente privado 10.48 o posterior, la configuración se trata como si estuviera presente y se establece en true Es decir, la generación de datos de entrada y salida de componentes está habilitada de manera predeterminada en todos los agentes 10.48 y posteriores, a menos que esta configuración se establezca explícitamente en false.

verbose.logging.commpress.folder.path De manera predeterminada, esta configuración está comentada y no se utiliza. No se debe cambiar a menos que lo indique el soporte de Jitterbit.
verbose.logging.log.folder.path De manera predeterminada, esta configuración está comentada y no se utiliza. No se debe cambiar a menos que lo indique el soporte de Jitterbit.
verbose.logging.log.file.extension .verbose Esto se utiliza para registro de depurar de operación y no se debe cambiar a menos que lo indique el soporte de Jitterbit. No es necesario que esta configuración esté presente en el archivo de configuración para que se generen los datos de entrada y salida del componente.
verbose.logging.use.dynamic.host.for.collector.url true Esto se utiliza para registro de depurar de operación y no se debe cambiar a menos que lo indique el soporte de Jitterbit. No es necesario que esta configuración esté presente en el archivo de configuración para que se generen los datos de entrada y salida del componente.