Saltar al contenido

Archivo de configuración del agente privado de Jitterbit jitterbit.conf

Introducción

Esta página describe el archivo de configuración principal para agentes privados, jitterbit.conf. Se encuentra en el directorio de instalación (JITTERBIT_HOME), por defecto C:\Program Files\Jitterbit Agent\ en Microsoft Windows, /opt/jitterbit/ en Linux y Docker.

El archivo utiliza el formato INI file, en el que los nombres de sección están entre corchetes, y cada sección es una lista de pares clave-valor. Las secciones pueden estar en cualquier orden dentro del archivo. (Esta página ordena las secciones alfabéticamente, pero no es así en el archivo predeterminado). Si hay secciones o claves que no se encuentran en tu archivo, debes añadirlas; algunas no se proporcionan en el archivo predeterminado. Para claves que no están presentes o comentadas (con un # al inicio), se aplica el valor predeterminado. Los valores booleanos se pueden proporcionar como 0/1 o false/true. Las rutas utilizan barras diagonales hacia adelante, incluso cuando se especifican ubicaciones de Windows.

Importante

Los cambios realizados en el archivo no se aplican hasta que se reinicia el agente, y no se sobrescriben al actualizar.

[AgentCapability]

Estos parámetros se aplican tanto a las características de observabilidad de agentes privados nativos como de terceros.

Las métricas de uso de memoria se recopilan solo en agentes Windows. En agentes Linux, el uso de memoria no se utiliza en el cálculo de capacidad, y los parámetros de memoria en esta sección no tienen efecto.

Apache solo sirve solicitudes de API, por lo que los parámetros de subprocesos de Apache en esta sección son relevantes solo en un agente que maneja APIs.

Cuando se habilitan las métricas de uso de CPU o memoria, anulan las otras entradas de capacidad: si alguna cruza su umbral, el agente se reporta como incapaz independientemente de la disponibilidad de subprocesos de Apache o de subprocesos de trabajo del motor de procesos.

Importante

No cambies ningún valor en esta sección a menos que el soporte de Jitterbit te lo indique.

Clave Predeterminado Descripción
ApacheThreadBuffer 10 Buffer de límite de subprocesos de Apache.
ApacheThreadCapabilityDebugOutput false Si es true, genera registros de solución de problemas adicionales de Apache.
ApacheThreadCapabilityEnabled false Si es true, habilita la métrica de uso de subprocesos de Apache para determinar el estado de capacidad del agente.
ApacheThreadCapabilityReportInterval 2 Con qué frecuencia se verifica el uso de subprocesos de Apache (segundos).
CapabilityDebugOutput false Si es true, genera registros de solución de problemas de capacidad adicionales.
CapabilityRefreshCooldown 1 Después de que un agente entra en estado incapaz, el período de enfriamiento (segundos) antes de actualizar el estado de capacidad. El valor predeterminado cambió de 2 a 1 en la versión 12.7 del agente.
CpuConsecutiveFailureThreshold 3 Número de violaciones consecutivas del umbral de CPU requeridas antes de que el agente cambie de capaz a incapaz. Se aplica solo cuando CpuUsageCapabilityEnabled es true. El valor predeterminado cambió de 1 a 3 en la versión 12.7 del agente.
CpuUsageCapabilityDebugOutput false Si es true, habilita registros de depuración de capacidad de CPU en el archivo de registro del motor de procesos. Si es false, solo registra cambios en el estado de capacidad de CPU.
CpuUsageCapabilityEnabled false Si es true, habilita la métrica IncapableCpuUsage para determinar el estado de capacidad del agente.
CpuUsageCapabilityReportInterval 1 Con qué frecuencia se verifica el porcentaje de CPU (segundos).
EnhancedCapabilityMetricsEnabled false Si es true, habilita la lógica de métrica de capacidad del agente.
EnhancedCapabilityMetricsJMXEnabled true Si es true, habilita la métrica JMX para capacidad.
EnhancedCapabilityMetricsSubmissionEnabled false Si es true, establece EnhancedCapabilityMetricsEnabled en true y envía métricas de capacidad a Harmony.
IncapableCpuUsage 95 Porcentaje de CPU en el que el agente se vuelve incapaz. Se ignora a menos que CpuUsageCapabilityEnabled sea true.
IncapableMemoryUsage 95 Porcentaje de memoria en el que el agente se vuelve incapaz. Se ignora a menos que MemoryUsageCapabilityEnabled sea true.
MemoryUsageCapabilityDebugOutput false Si es true, genera registros de solución de problemas de memoria adicionales.
MemoryUsageCapabilityEnabled false Si es true, habilita la métrica IncapableMemoryUsage para determinar el estado de capacidad del agente.
MemoryUsageCapabilityReportInterval 1 Con qué frecuencia se verifica el porcentaje de memoria (segundos).

[AgentMetrics]

Estos parámetros se aplican solo a la función de observabilidad nativa.

Clave Predeterminado Descripción
Enabled false Si es true, permite el uso de otras claves en esta sección. Si es false, se ignoran los valores de otras claves en esta sección.
JitterbitMetricsServiceEnabled false Si es true, inicia el servicio de recopilación de métricas.
UserIntentFileWatcherEnabled true Si es true, y tanto Enabled como JitterbitMetricsServiceEnabled son true, inicia un servicio de vigilancia de archivos que captura la última acción del usuario.
OperationStatusLogToFileEnabled false Si es true, registra el estado de las operaciones en un archivo. (Movido y renombrado desde EnableAgentMetricLogging en [MetricLogging].)
OperationStatusLogToFileAsyncEnabled true Si es true, y OperationStatusLogToFileEnabled es true, registra de forma asincrónica usando subprocesos separados. (Movido y renombrado desde EnableAgentMetricLogging en [MetricLogging]) No cambies a menos que el soporte de Jitterbit te lo indique.
AgentEnvSyncProgressToFileEnabled false Si es true, registra el proceso de sincronización del agente en un archivo. (Movido y renombrado desde EnableAgentSyncMetricLogging en [MetricLogging].)
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del planificador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, usa esta cantidad de subprocesos del grupo de subprocesos.

[APIInfo]

Este parámetro se aplica a las operaciones activadas por una API OData del Administrador de API.

Clave Predeterminado Descripción
DebugJDML false Si es true, permite un registro adicional de llamadas de API OData en el Administrador de API, incluido el SQL enviado a la base de datos.

[APIOperation]

Estas configuraciones se aplican a operaciones activadas por un API personalizada o API OData del Administrador de API.

Clave Predeterminado Descripción
EnableErrorLogging true Registra solo errores de operaciones de API en los registros de operaciones. Se ignora si EnableLogging es true.
EnableLogging false Registra todas las operaciones activadas por API (exitosas e infructuosas) en los registros de operaciones. Esto proporciona control a nivel de agente similar a habilitar registro de depuración de operaciones en operaciones individuales. Si es true, tiene prioridad sobre EnableErrorLogging. Para más detalles sobre el registro de operaciones de API, consulta Datos de solicitud y respuesta de API.
EnableOperationIdLogging false Registra el ID de una operación que causa un bloqueo.
APIOperationLogging false Registra la hora de inicio y el tiempo transcurrido de una llamada de API.

Caution

Turning on this setting generates at least four additional lines for each API operation, which can result in very large log files.

[AutoScaling]

Clave Predeterminado Descripción
DeregisterAgentOnDrainstop false Anula el registro cuando el agente se detiene. Equivalente a deregisterAgentOnDrainstop en register.json.
DeregisterAgentOnJVMShutdown true Desactiva la anulación de registro al apagar la JVM si la anulación de registro está habilitada mediante registro automático o DeregisterAgentOnDrainstop.

[ConnectorsInfo]

Clave Predeterminado Descripción
MSAXUrl http://127.0.0.1:8002/AX/ Utilizado por el conector Microsoft Dynamics AX Connector. No cambies a menos que el soporte de Jitterbit te lo indique.
MSCrmUrl http://127.0.0.1:8000/CRM/ Utilizado por el conector Microsoft Dynamics CRM Connector. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connectorcall.timeout 300 Tiempo de espera de llamada de conector (segundos) para ciertos conectores. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.disable.file.watcher false Si es true, desactiva el monitor de archivos del conector. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.max.recent.connector.lookup 15 Número máximo de sumas de verificación md5 de conectores a mantener. (Si la suma de verificación de un nuevo conector coincide con una existente, se omite la descarga.)
jitterbit.connector.max.temp.file.write.attempts 30 Número máximo de intentos para mover un archivo temporal de conector.

[DbDrivers]

Esta sección especifica los caracteres especiales predeterminados utilizados para delimitar nombres en algunos controladores utilizados por el conector de Base de datos. Los delimitadores admitidos incluyen: / . \* = ? | ( ) [ ] { }.

Las claves y los valores se citan entre comillas simples, y los caracteres especiales se escapan con \.

Clave Predeterminado
DataDirect 32-BIT SequeLink 5.4 Quote Begin \"
DataDirect 32-BIT SequeLink 5.4 Quote End \"
Excel Quote Begin [
Excel Quote End ]
IBM DB2 (AS400) Quote Begin \"
IBM DB2 (AS400) Quote End \"
Microsoft Access Driver (*.mdb) Quote End ]
Microsoft Excel Driver (*.xls) Quote Begin [
Microsoft Excel Driver (*.xls) Quote End ]
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin [
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End ]
Microsoft ODBC for Oracle Quote Begin \"
Microsoft ODBC for Oracle Quote End \"
Microsoft Quote Begin [
MySQL ODBC 3.51 Driver Quote Begin `
MySQL ODBC 3.51 Driver Quote End `
MySQL ODBC 5.1 Driver Quote Begin `
MySQL ODBC 5.1 Driver Quote End `
MySQL Quote Begin `
MySQL Quote End `
Oracle ODBC Driver Quote Begin \"
Oracle ODBC Driver Quote End \"
Oracle Quote Begin \"
Oracle Quote End \"
Oracle in OraClient10g_home2 Quote Begin \"
Oracle in OraClient10g_home2 Quote End \"
Oracle in XE Quote Begin \"
Oracle in XE Quote End \"
PostgreSQL ANSI Quote Begin \"
PostgreSQL ANSI Quote End \"
PostgreSQL Quote Begin \"
PostgreSQL Quote End \"
PostgreSQL Unicode Quote Begin \"
PostgreSQL Unicode Quote End \"
PostgreSQL-psql Quote Begin \"
PostgreSQL-psql Quote End \"
SQL Server Quote Begin [
SQL Server Quote End ]

[DbInfo]

Key Default Descripción
User jitterbit Nombre de usuario para la base de datos PostgreSQL local.
DisableOdataCount false Desactiva la configuración $count e $inlinecount en consultas OData entrantes. Establece en true si la funcionalidad de conteo de la base de datos causa problemas de rendimiento.
Password None Contraseña para la base de datos PostgreSQL local. Cada instalación genera una contraseña nueva, incluso en el mismo host. La contraseña en la imagen de Docker Hub cambia entre versiones y es la misma para todos los contenedores basados en una imagen.
Driver 'PostgreSQL Unicode(x64)' Valor predeterminado de Windows.
'PostgreSQL-jitterbit' Valor predeterminado de Linux.
SystemDbName 'postgres' Nombre de la base de datos del sistema PostgreSQL.
Server 127.0.0.1 Nombre de host o dirección IP del servidor PostgreSQL.
Port 6432 Puerto predeterminado del servidor PostgreSQL. (6543 en agentes privados versión 10.60 o anterior.)
UseInternalPooling true Si es true, activa la agrupación de conexiones de base de datos interna para optimizar el rendimiento del agente.
  • Windows, instalación nueva (agente 12.5 y posterior): El instalador escribe esta clave con un valor de true.
  • Windows, actualización (a agente 12.5 y posterior): Si la clave no está ya definida en el archivo, el instalador pregunta si deseas activarla.
  • Linux (agente 12.9 y posterior): Si la clave no está en el archivo, el valor predeterminado es true.
  • Todos los demás casos: Si la clave no está presente, se aplica false.

[Debug]

Key Default Descripción
WebServiceDebugFile '' Ruta absoluta al archivo de depuración de servicios web backend. Si es una cadena vacía, el registro se desactiva. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ErrorHandling]

Esta sección configura cómo manejar posibles situaciones de error en el backend. Los valores posibles son:

  • Ok: La situación es normal; continúa como de costumbre.
  • Warning: Registra una advertencia y continúa.
  • Error: La situación es fatal.
Clave Predeterminado Descripción
NoRowsAffectedOnDbUpdates Ok Una sentencia de actualización en un destino de base de datos que no afecta ninguna fila es Ok según la definición anterior.
NoTargetDataGenerated Ok No se generó datos de destino es 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 Un origen de base de datos plano vacío genera una Warning según la definición anterior.

[FileCleanup]

Clave Predeterminado Descripción
AutoStart true Inicia las rutinas de limpieza de archivos.
SleepTimeInSeconds 5 Tiempo de espera de limpieza de archivos (segundos).
FrequencyInHours 24.0 Intervalo de limpieza de archivos (horas).

[HttpConnectionPool]

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

Clave Predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales a mantener en el grupo. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 5 Número máximo de conexiones por ruta. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos), el tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

[HttpConnectionPoolLocal]

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

Clave Predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales a mantener en el grupo. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 50 Número máximo de conexiones por ruta. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos) (tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

Consejo

Si estableces MaxConnections y MaxConnectionsPerRoute en 100, realiza estos cambios adicionales:

  1. Edita el archivo jitterbit-agent-config.properties y establece:

    max.concurrent.requests=100

  2. Edita el archivo httpd.conf y establece:

    ThreadsPerChild 101

[HttpEndPoints]

Clave Predeterminado Descripción
EnableErrorLogging true Registra errores de llamadas de punto de conexión HTTP alojado en el registro de operaciones. Se ignora cuando EnableLogging es true.
EnableLogging true Registra todas las llamadas de punto de conexión HTTP alojado en el registro de actividades.

[JavaBackend]

Clave Predeterminado Descripción
DebugLogLevel (Ninguno) Nivel de registro de depuración de Tomcat (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JavaUiBackend]

Clave Predeterminado Descripción
LogLevel OFF Nivel de registro de Java (Tomcat) UI (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JDBCEngine]

Clave Predeterminado Descripción
SessionTimeout 60 Tiempo de espera de sesión JDBC abierta (minutos).
ClientSessionTimeout 180 Tiempo máximo de operación JDBC (minutos).
LogLevel INFO Nivel de registro del motor JDBC (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JdbcSecurity]

Esta sección se agregó en la versión 12.10 del agente. Restringe las cadenas de conexión JDBC y las conexiones del conector de base de datos, por seguridad.

Clave Predeterminado Descripción
block.localhost.connections true Bloquea una conexión de base de datos a localhost o 127.0.0.1 cuando es true. Establece en false para permitir una conexión de base de datos a una base de datos que se ejecuta en el mismo host que el agente.
mysql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que siempre se rechazan.
mysql.forced.false.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que se rechazan si se establecen en true en la cadena de conexión.
postgresql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de PostgreSQL que siempre se rechazan.
oracle.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de Oracle que siempre se rechazan.
sqlserver.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de SQL Server que siempre se rechazan.

Lo siguiente muestra la sección completa con sus valores predeterminados. Para permitir una conexión o parámetro específico mientras se mantiene el resto restringido, cópialo y elimina ese parámetro del valor de la clave correspondiente:

[JdbcSecurity]
block.localhost.connections=true
mysql.blocked.params=queryinterceptors,statementinterceptors,propertiestransform,socketfactory,socksproxyhost
mysql.forced.false.params=allowLoadLocalInfile,allowLocalInfile,allowUrlInLocalInfile,autoDeserialize,allowMultiQueries
postgresql.blocked.params=socketfactory,socketfactoryarg,sslfactory,sslfactoryarg,sslhostnameverifier,sslpasswordcallback,authenticationpluginclassname,loggerfile,loggerlevel
oracle.blocked.params=oracle.net.tns_admin,oracle.net.wallet_location
sqlserver.blocked.params=socketfactoryclass

Para permitir todos los parámetros de una clave, establécela en un valor vacío (por ejemplo, mysql.blocked.params=).

Advertencia

Comentar una de las cinco claves *.blocked.params o *.forced.false.params (con un # al inicio) no restaura su restricción predeterminada. Tiene el mismo efecto que establecer la clave en un valor vacío: todos los parámetros de esa clave se permiten. Para restaurar la restricción predeterminada después de agregar esta sección, elimina completamente la línea de la clave o comenta la línea [JdbcSecurity], lo que restaura todas las claves de la sección a sus valores predeterminados.

[JsonParser]

Esta sección se agregó en la versión 12.5 del agente.

Clave Predeterminado Descripción
MaxStringLength 20000000 Número máximo de caracteres permitidos en un valor de cadena JSON individual. Las operaciones que procesan cadenas JSON que exceden este límite fallan con un error StreamConstraintsException. Aumenta este valor si necesitas procesar cargas JSON más grandes (por ejemplo, establécelo en 50000000 para un límite de 50 MB).

[LDAP]

Usa esta sección para agregar compatibilidad con UTF-8 para Microsoft Windows y Active Directory con agentes privados de Windows.

Clave Predeterminado Descripción
CharacterEncoding ISO-8859-1 Codificación de caracteres LDAP.

Consejo

Si utilizas la función LDAPReplace() para reemplazar un valor en Active Directory como se muestra a continuación, es posible que encuentres que el texto se convierte a un resultado diferente al de la entrada, como que François se reemplace con FrançOis:

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

En casos como este, agrega esta sección y reinicia el agente.

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

[Masking]

Esta sección se agregó en la versión 11.59 / 12.3 del agente. Estas configuraciones se pueden usar para enmascarar encabezados de solicitud personalizados en actividades HTTP de Studio y fuentes HTTP de Design Studio y destinos. Cuando se enmascara un encabezado de solicitud, los valores enmascarados aparecen como ***REDACTED*** en los registros de tiempo de ejecución.

Clave Predeterminado Descripción
HttpRequestHeaders true Si es false, los encabezados de solicitud proporcionados en RequestHeaders no se enmascaran.
RequestHeaders Lista separada por comas de encabezados de solicitud personalizados a enmascarar (por ejemplo, security_key,test_header,test_header2).

Ten en cuenta que los siguientes encabezados de solicitud ya están enmascarados de forma predeterminada en los registros de tiempo de ejecución y no requieren usar estas configuraciones:

Categoría Nombre del encabezado
Autenticación y tokens authorization
proxy-authorization
x-api-key
x-auth-token
x-access-token
x-refresh-token
x-session-token
x-id-token
x-client-secret
Cookies y CSRF cookie
x-csrf-token
x-xsrf-token
PII (GDPR / CCPA) x-user-id
x-user-email
x-user-name
x-user-phone
x-user-address
x-customer-id
x-employee-id
x-national-id
x-date-of-birth
x-ip-address
x-forwarded-for
x-real-ip
x-originating-ip
Pago (PCI-DSS) x-card-number
x-card-cvv
x-card-expiry
x-bank-account
x-payment-token
Salud (HIPAA) x-patient-id
x-medical-record
x-health-plan-id
x-diagnosis-code
Enrutamiento interno y rastreo x-internal-ip
x-backend-server
x-cluster-node
x-request-id
x-correlation-id

[MetricLogging]

Importante

Esta sección está deprecada a partir de la versión 11.41 del agente privado y se eliminará en una versión posterior. Las claves se han movido a la sección [AgentMetrics], con algunos nombres de claves cambiados. Consulta esa sección para más detalles.

Clave Predeterminado Descripción
EnableAgentMetricLogging false Si es true, se habilita el registro de métricas del agente.
EnableAgentMetricAsyncLogging true Si es true, el registro se realiza de forma asincrónica. No cambies a menos que el soporte de Jitterbit te lo indique.
EnableAgentSyncMetricLogging Si es true, se habilita el registro de métricas de sincronización.
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del programador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, utiliza esta cantidad de subprocesos del grupo de subprocesos.

[OperationEngine]

Clave Predeterminado Descripción
Debug false Habilita el modo de depuración. Tanto el valor Debug como WriteLog deben establecerse en 1 para que se generen registros.
AlwaysRunSuccessOperation false Siempre ejecuta operaciones correctamente incluso si no hay datos.
TemporaryStorageRootDirectory (Ninguno) Ruta absoluta al directorio raíz de almacenamiento temporal. Si no se especifica, utiliza TemporaryStorage anexado al valor de TempDir (C:\Windows\Temp\jitterbit\TemporaryStorage para Windows, /tmp/jitterbit/TemporaryStorage para Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
MaxNumberOfOperationThreads (Ninguno) Número máximo de subprocesos de operación. Si no se especifica, el número de subprocesos de operación es ilimitado.
MaxOperationStackDepth 50 Número máximo de llamadas de operación sincrónica anidadas. Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLength 50 Número máximo de operaciones asincrónicas permitidas en una sola cadena (para evitar bucles de operación infinitos). Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLengthOverrideAllowed true Anula la longitud máxima de la cadena de operaciones asincrónica estableciendo la variable Jitterbit jitterbit.operation.max_async_chain_length.
AlwaysDeleteTempDir false Elimina archivos temporales, incluso en caso de error.

Precaución

Cuando se habilita el registro de depuración de operaciones, establecer este valor en true hará que los datos de entrada y salida de componentes no se generen, ya que los archivos temporales de operaciones se eliminarán antes de que el servicio Verbose Log Shipper pueda capturarlos.
WriteLog 0 Habilita (1) o deshabilita (0) mensajes de proceso adicionales tanto para operaciones de API como programadas para escribirse en el archivo de registro.

[PredefinedGlobalVariables]

Cualquier variable de Jitterbit se puede configurar en esta sección para aplicarse en todo el grupo de agentes de forma predeterminada. Para configurar una variable de Jitterbit a nivel de operación, consulta Establecer variables de Jitterbit en scripts o transformaciones.

La tabla siguiente enumera ejemplos de variables de Jitterbit que se pueden configurar en esta sección. Esta lista no es exhaustiva; consulta la documentación de variables de Jitterbit para cada variable individual y obtener la descripción de cada una.

Clave Predeterminado Descripción
jitterbit.http.enable_cookies false Habilita cookies para conexiones HTTP.
jitterbit.scripting.db.auto_commit true Confirma automáticamente scripts de base de datos. Si es false, utiliza transacciones de base de datos.
jitterbit.scripting.db.max_rows 10000 Número máximo de filas de base de datos afectadas. Se aplica a DBExecute, DBLookup y DBLookupAll funciones de base de datos de Studio o funciones de base de datos de Design Studio.
jitterbit.scripting.ldap.include_dn_in_results false Si es true, incluye el nombre distinguido (DN) en Active Directory.
jitterbit.scripting.ldap.max_search_results 1 Número máximo de resultados de búsqueda LDAP devueltos.
jitterbit.scripting.ldap.return_null_if_no_results false Si es true, las consultas LDAP sin registros coincidentes devuelven un único valor NULL.
jitterbit.scripting.ldap.scope 1 Habilita (1) o deshabilita (0) LDAP.
jitterbit.scripting.ldap.use_paged_search false Habilita búsqueda LDAP paginada en scripts. Si es true, Jitterbit recupera datos en páginas y evita exceder los límites de Active Directory.
jitterbit.scripting.nesting.max 10 Número máximo de scripts anidados.
jitterbit.scripting.while.max_iterations 50000 Límite de iteración de scripts de Jitterbit.
jitterbit.source.db.preserve_char_whitespace false Preserva los espacios en blanco de caracteres iniciales y finales de la base de datos de origen.
jitterbit.source.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de origen (segundos).
jitterbit.source.text.csv_nullable false Permite valores nulos en archivos de texto CSV.
jitterbit.target.db.include_null_in_sql_statement false Incluye valores nulos en las sentencias SQL de la base de datos de destino.
jitterbit.target.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de destino (segundos).
jitterbit.target.http.remove_trailing_linebreaks true Elimina saltos de línea finales antes de publicar datos de destino.
jitterbit.target.xml.num_for_bool false Si es true, representa valores booleanos XML como 0 y 1. Si es false, utiliza false y true.

[PredefinedServerGlobalDataElement]

Clave Predeterminado Descripción
(Definido por el usuario) (Definido por el usuario) Variables globales predefinidas personalizadas que se inicializan para cualquier operación que se inicia en el agente.

[ProcessEngine]

Clave Predeterminado Descripción
MaxNumberOfWorkerThreads auto Número de subprocesos de trabajo (1 a 200). Cuando es auto, el número es el doble del número de núcleos del procesador.
RunOperationsInSeparateProcess true Si es true, el tiempo de ejecución de la operación es ilimitado. Usa MaxOperationRuntimeSeconds para establecer un límite de tiempo de ejecución.
MaxOperationRuntimeSeconds (Ninguno) Tiempo máximo de ejecución de la operación (segundos). Se ignora si RunOperationsInSeparateProcess es false.
MaxOperationRuntimeMessage (Ninguno) Mensaje que se muestra cuando se alcanza el límite de tiempo de ejecución. Se ignora si RunOperationsInSeparateProcess es false.
EnableDebugDump false Si no se especifica, DebugDumpDir usará de forma predeterminada la configuración TempDir en [Settings].
DebugDumpDir (Ninguno) Ruta absoluta al directorio de volcado de depuración. Si no se establece, se usa el valor de TempDir. Se ignora a menos que EnableDebugDump sea true. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ResultFiles]

Clave Predeterminado Descripción
DisableSuccess false Crear archivos de éxito.
DisableFailure false Crear archivos de error.

[Scheduler]

Clave Predeterminado Descripción
AutoStart 1 Habilitar (1) o deshabilitar (0) el inicio automático del programador.
SleepTimeInSeconds 5 Tiempo de espera (segundos).
WriteLog 0 Habilitar (1) o deshabilitar (0) el registro de depuración del programador. El archivo de registro está en scheduler_debug.log en el directorio especificado por el valor de TempDir.

[Settings]

Clave Predeterminado Descripción
TempDir (Ninguno) Ruta absoluta a un directorio temporal. Si está en blanco, los archivos temporales usan el directorio temporal del sistema operativo (%temp%\jitterbit en Windows, /tmp/jitterbit en Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDebugDir (Ninguno) Ruta absoluta al archivo de registro de curl para solicitudes FTP, SFTP, HTTP y HTTPS. Se crea un archivo por solicitud. Los nombres de archivo de registro son GUID con extensión .txt. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDefaultSSLVersionMax true Si es true, usa la opción --tls-max (se aplica a curl 7.54.0 y superior).
EnableLocalFileLocation false Permitir la creación de archivos locales. Necesario para el conector de Almacenamiento local, archivos de activación o carpetas de éxito/error configuradas en otros conectores.
JavaScriptMaxIterations 50000 Número máximo de iteraciones de bucle permitidas por script.
RecoverableStatusCode 500, 502, 503, 504 Cuando se establece y se selecciona la opción Reintentar en una conexión HTTP, la actividad se recupera de los códigos de error listados y reintenta la actividad.
EnableAPITimeout false Si es true, las operaciones activadas por API Manager usarán la configuración de tiempo de espera de operación.
TargetHttpRemoveTrailingLinebreaks false Si es true, elimina el CR/LF al final de las líneas en transformaciones posteriores del conector HTTP.
AllowUnsafeLegacyRenegotiation false Si es true, permite la renegociación TLS heredada no segura durante el protocolo de enlace de conexión con el servidor. Necesario para evitar el error error:0A000152:SSL routines::unsafe legacy renegotiation disabled. Compatible con agentes versión 11.39 y posterior.

[Settings/XMLSchemas]

Estas configuraciones definen las ubicaciones de los esquemas XML disponibles.

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

[SMTPClient]

Clave Predeterminado Descripción
DefaultSMTPServers (Ninguno) Lista separada por comas de servidores SMTP a usar cuando se envía un mensaje de correo electrónico y el usuario no especifica servidores SMTP.
DefaultFromEmail (Ninguno) Dirección de correo electrónico a usar en el campo De si el usuario no especifica ninguna.
DefaultAccount (Ninguno) Nombre de inicio de sesión para servidores SMTP que requieren autenticación.
DefaultAccountPassword (Ninguno) Contraseña para servidores SMTP que requieren autenticación.
UseSSL (Ninguno) Si es true, el servidor SMTP requiere SSL/TLS.

Nota

Los extremos creados mediante la función SendSystemEmail con DefaultSMTPServers se incluyen en reportes de uso de extremos y cuentan hacia tu licencia.

[SSH]

Clave Predeterminado Descripción
PublicKeyFile (Ninguno) Ruta absoluta a tu clave pública. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de clave privada. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo XXX) a estas claves (para crear PublicKeyFileXXX, PrivateKeyFileXXX, PrivateKeyPassphraseXXX), luego haz referencia a ellas en variables de script de Jitterbit con $jitterbit.source.sftp.ssh_key_id="XXX" o $jitterbit.target.sftp.ssh_key_id="XXX".

[SSL]

Clave Predeterminado Descripción
CertificateFile (Ninguno) Ruta absoluta a tu archivo de certificado de cliente SSL. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo YYY) a estas claves (para crear CertificateFileYYY, PrivateKeyFileYYY, PrivateKeyPassphraseYYY), luego haz referencia a ellas en variables de script de Jitterbit con $jitterbit.target.http.ssl_cert_id = "YYY";, $jitterbit.source.http.ssl_cert_id = "YYY";, o $jitterbit.web_service_call.ssl_cert_id = "YYY";.

[TraceLogging]

Key Default Description
tracelog.shipper.enabled false Si es true, habilita el registro de seguimiento del motor de operaciones en el agente.

[TransformationEngine]

Key Default Description
WriteLog false Registro de depuración de transformación detallado. Si es true, se establece Debug en [OperationEngine] en true.
WriteLogDir (None) Ruta absoluta al directorio de registro. Si no se especifica, los registros se escriben en JITTERBIT_HOME/DataInterchange/Temp/Debug. Se ignora a menos que WriteLog sea 1. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
ValidateXML true Validación de XML.
LdapEnableAutoUpdateMode false Habilita el modo de actualización automática de LDAP.
TimingOn false Habilita (1) o deshabilita (0) globalmente la generación de perfiles de archivo. Los archivos se escriben en JITTERBIT_HOME/DataInterchange/Temp/LOG.
AutoStreaming true Transmisión automática de transformación.
UseOldRuleForLoopOneOfXmlNode false (Se utiliza para compatibilidad con versiones anteriores.)
AutoXsiNil false Establece el atributo xsi:nil="true" para elementos que son obligatorios y no están asignados en transformaciones.
DefaultEntityResolution true Habilita el análisis de tipos de IDoc.

[VerboseLogging]

Esta sección se utiliza para la generación de datos de entrada y salida de componentes cuando se habilita el registro de depuración de operaciones en una operación individual de Studio.

Los datos de entrada y salida de componentes se registran en la nube de Harmony, a menos que verbose.logging.enable esté establecido en false. La configuración para el registro en la nube no tiene efecto en este tipo de registro.

Esto anula la generación de datos de entrada y salida de componentes cuando se configura Enable Debug Logging Until en una operación individual de Studio, pero no impide que se generen archivos de registro de depuración de operaciones.

Key Default Description
verbose.logging.enable true Cuando se habilita el registro de depuración de operaciones en una operación individual de Studio, escribe datos de entrada y salida de componentes en el registro de operaciones de Studio.
verbose.logging.commpress.folder.path (None) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique. commpress (dos 'm') es una falta de ortografía conocida de esta propiedad.
verbose.logging.log.folder.path (None) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.log.file.extension .verbose Se utiliza para el registro de depuración de operaciones. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.use.dynamic.host.for.collector.url true Se utiliza para el registro de depuración de operaciones. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.collector.url (None) URL del servicio de recopilador de registros.