Ir para o conteúdo

Edite o arquivo de configuração do agente privado Jitterbit (jitterbit.conf)

Introdução

Se você estiver usando um agente privado, você pode alterar certas configurações para seu agente dentro do arquivo de configuração Jitterbit (jitterbit.conf). Esta página descreve como fazer essas alterações, bem como quais configurações estão disponíveis.

Fazer alterações de configuração

Você pode fazer alterações em jitterbit.conf remotamente através do Management Console, ou manualmente no diretório onde o agente privado está instalado.

Editar remotamente é o método preferido e, usando esse método, é mais fácil garantir a sincronização entre vários agentes dentro de um grupo de agentes e ver as alterações no arquivo de configuração. Se você não quiser armazenar o conteúdo do seu jitterbit.conf arquivo na nuvem por meio do Management Console, mas ainda gostaria de fazer alterações no arquivo de configuração, você pode fazer isso manualmente.

Em ambos os casos, depois de editar o arquivo de configuração, todos os serviços Jitterbit devem ser reiniciados para que a alteração de configuração ocorra.

Editar remotamente via Management Console

A configuração do agente remoto está disponível para agentes privados versão 8.14 e superior. Além disso, você deve ter a configuração do agente remoto habilitada para fazer alterações no arquivo de configuração remotamente. Para habilitar a configuração do agente remoto:

  1. Faça login no portal Harmony e escolha Management Console.
  2. Clique no menu do portal Harmony no canto superior esquerdo e selecione Organizações.
  3. Na tabela, selecione a organização para a qual você deseja habilitar a configuração do agente remoto.
  4. Na extrema direita da linha selecionada, use o menu suspenso Ações para selecionar Editar Políticas da Organização. Você deve ter permissão Admin para a organização para ver esta opção.
  5. No pop-up, marque a caixa de seleção ao lado de Ativar configuração do Agente remoto e clique em Salvar.

Após a configuração do agente remoto ser habilitada, edite o arquivo de configuração.

Dica

Referência Agentes para todas as opções disponíveis ao editar o arquivo de configuração Jitterbit remotamente.

Aviso

Quando você habilita a configuração do agente remoto, a configuração atual do agente (excluindo as informações do banco de dados de cache do PostgreSQL local e as variáveis globais predefinidas locais) será lida e armazenada na nuvem para que você possa visualizá-la e editá-la remotamente. Depois de habilitar a configuração do agente remoto, quaisquer alterações feitas manualmente no local jitterbit.conf arquivo localizado no agente não terá efeito.

Para desabilitar a configuração do agente remoto e novamente poder editar o local jitterbit.conf arquivo manualmente, abra o Organizações, selecione uma organização, selecione a aba Gerenciamento de Agente e desabilite Configuração de agente remoto. No entanto, observe que você perderá a configuração atual do agente remoto que estava armazenada na nuvem. Após os serviços do agente serem reiniciados, seu agente lerá do local jitterbit.conf arquivo.

Editar manualmente

Embora seja possível editar manualmente o arquivo de configuração local de cada agente, este não é o método preferido para fazer alterações de configuração. Consulte Editar remotamente via Management Console acima para o método preferido.

O arquivo de configuração local está localizado no diretório de instalação da máquina onde o agente privado está instalado. Isso geralmente está em um destes locais:

  • 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 fazer alterações, abra jitterbit.conf em um editor de texto, edite-o e salve o arquivo. Você deve ter permissões de administrador do sistema para editar jitterbit.conf.

O formato do arquivo de configuração é o seguinte:

  • As seções são definidas por linhas simples contendo o nome da seção entre colchetes. Exemplo:

    [Section]
    
  • Chaves/valores são definidos por um nome de chave, seguido por um único sinal de igual, seguido pelo valor.

    Não deve haver espaços entre a chave, o sinal de igual e o valor. Exemplo:

    mykey=myvalue
    
  • Alguns valores podem exigir aspas simples ou duplas. Exemplo:

    mykey="my value"
    
  • As chaves devem estar em sua seção correta, conforme documentado aqui, para serem encontradas e terem efeito.

  • Os nomes de seção e nomes de chave não diferenciam maiúsculas de minúsculas.

  • A ordem dos itens dentro de uma seção não importa.

  • Os comentários podem ser denotados por um único hash (#) personagem. Qualquer coisa na linha após o # será ignorado.

  • Não tenha nenhuma linha que contenha um único hash (#) caractere. Isso fará com que a próxima linha seja ignorada.

  • Todos os nomes de arquivo são relativos à pasta do diretório de instalação home, a menos que indicado de outra forma.

    Importante

    Use barras para caminhos de arquivo/diretório, mesmo no Windows (como C:/Windows/Temp).

Reinicie os serviços Jitterbit

Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

Na máquina onde cada agente privado está instalado, primeiro pare os serviços e depois reinicie-os.

Windows Linux
No menu Iniciar:

Parar serviços Jitterbit
Iniciar serviços Jitterbit

No diretório de instalação do Agente Jitterbit:

> StopServices.bat
> StartServices.bat

De um prompt:

$ sudo jitterbit stop
$ sudo jitterbit start

Use um arquivo de configuração alternativo

Para usar um arquivo de configuração alternativo, você pode (no Windows) iniciar o agente privado a partir de uma linha de comando:

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

Atualizar um agente privado

O arquivo de configuração é preservado ao atualizar um agente privado. Ou seja, o existente jitterbit.conf arquivo não é sobrescrito ao instalar sobre uma instalação de agente existente.

De tempos em tempos, pode haver adições ou alterações jitterbit.conf conforme anunciado através das notas de lançamento do Harmony. Para aproveitar quaisquer melhorias ou fazer ajustes, você pode adicionar manualmente novas configurações e valores ao seu arquivo de configuração existente após a atualização.

Outra opção é desinstalar e reinstalar o agente para obter a cópia mais recente do jitterbit.conf, tendo em mente que você precisará reaplicar quaisquer personalizações aplicadas anteriormente. Para fins de backup, recomendamos fazer uma cópia do seu arquivo de configuração de agente privado existente antes de reinstalar.

Definições de configuração e valores padrão

Estas seções descrevem cada configuração disponível dentro do jitterbit.conf arquivo e os valores padrão para cada configuração.

Nota

Na tabela a seguir, um valor de 0 é intercambiável com um valor de false e um valor de 1 é intercambiável com um valor de true.

Dentro do jitterbit.conf arquivo, linhas que começam com # significa que essas linhas são comentários que são ignorados na configuração real. Vários parâmetros opcionais são comentados dessa forma; para usar esses parâmetros, você deve remover o início # para que o parâmetro seja lido como parte do arquivo de configuração.

Aviso

Ao editar o arquivo de configuração, observe que o restante de uma linha comentada com # não deve ser deixado em branco, ou a próxima linha será lida como um comentário, mesmo que não comece com #.

[Settings]

Chave
Valor padrão Descrição
TempDir

Por padrão, o TempDir a configuração é deixada em branco e o diretório temporário fornecido pelo sistema operacional será usado, com os arquivos temporários do Jitterbit localizados em %temp%\jitterbit ou /tmp/jitterbit.

No Windows com o diretório temporário padrão do sistema operacional, isso seria C:\Windows\Temp\jitterbit.

No Linux com um diretório temporário padrão do sistema operacional de /tmp, isso seria /tmp/jitterbit.

Para usar um diretório temporário diferente, defina TempDir igual ao seu caminho absoluto. Use barras, mesmo no Windows. O diretório deve existir e ser legível e gravável pelo agente privado Jitterbit.

CurlDebugDir

Por padrão, o CurlDebugDir parâmetro é deixado em branco e logs de depuração detalhados não são criados.

Para obter logs de depuração detalhados de solicitações FTP e HTTP, você pode alterar o valor deste parâmetro para qualquer caminho de diretório válido onde você deseja que os logs de depuração sejam salvos. Cada solicitação criará um novo arquivo neste diretório.

Veja também Logs de depurar do Curl.

EnableLocalFileLocation false

Por padrão, EnableLocalFileLocation está definido para false. Isso significa que o uso de arquivos locais como fontes ou destinos está desabilitado.

Para usar arquivos locais em seu agente privado, você pode habilitar arquivos locais alterando o valor deste parâmetro para true. Para obter mais informações, consulte Habilitando o local do arquivo local.

JavaScriptMaxIterations 50000

O número máximo de iterações de loop permitidas no Harmony é 50.000. O número máximo de iterações de loop em JavaScript é por script, não por loop.

Por exemplo, um script JavaScript contendo três loops, onde cada loop executa 25.000 iterações, seria um total de 75.000 iterações em execução dentro de um script.

Para aumentar o número máximo de iterações permitidas em qualquer script JavaScript, adicione manualmente JavaScriptMaxIterations=X onde X é maior que 50000.

RecoverableStatusCode 500,502,503,504

Por padrão, RecoverableStatusCode está definido para a lista de códigos de erro de 500,502,503,504 para a versão 10.34 e posterior do agente privado.

Para agentes privados 10.30 a 10.33, o RecoverableStatusCode a configuração e a lista de códigos de erro devem ser adicionadas manualmente:

RecoverableStatusCode=500,502,503,504

Quando RecoverableStatusCode está definido e a opção Repetir está selecionada em uma conexão HTTP, a atividade se recupera dos códigos de erro listados e tenta a atividade novamente.

EnableAPITimeout false

Por padrão, EnableAPITimeout não está presente no jitterbit.conf arquivo e deve ser adicionado manualmente.

Se EnableAPITimeout está definido para true, as operações acionadas pelas APIs do API Manager usarão as configurações de tempo limite de operação definidas em Integration Studio ou Design Studio.

[DBInfo]

Chave
Valor padrão
Descrição
User jitterbit

Por padrão, quando um agente privado Jitterbit é instalado, um banco de dados PostgreSQL local é instalado. Esta seção fornece o nome de usuário do agente privado para esse banco de dados PostgreSQL local.

Não recomendamos alterar o banco de dados PostgreSQL local padrão. No entanto, para usar um banco de dados PostgreSQL diferente, é aqui que você especificaria suas informações e credenciais.

Nota

O instalador do agente silencioso do Windows versão 10.48 ou posterior config64.ps1 script permite a especificação de um nome de usuário de agente alternativo em seu Postgres_agent_username campo, que irá atualizar o User valor aqui.

DisableOdataCount false Desativa o $count e $inlinecount configurações em consultas OData recebidas. Defina como true se você tiver problemas de desempenho no banco de dados de segundo plano como resultado da funcionalidade de contagem. Isso está disponível apenas com um agente privado 9.6 ou posterior.
Password gerado na instalação
Driver 'PostgreSQL ODBC Driver(UNICODE)' Windows 32 bits
'PostgreSQL Unicode(x64)' Windows 64 bits
'PostgreSQL-jitterbit' Linux
SystemDbName 'postgres'
Server 127.0.0.1
Port 6432 Para a versão 10.60 ou anterior do agente privado, a porta padrão é 6543.

[APIInfo]

Chave
Valor padrão Descrição
DebugJDML false Definir para true para adicionar registro adicional de chamadas OData nos logs da API, incluindo o SQL real enviado ao banco de dados. Isso está disponível somente com um agente privado 9.6 ou posterior.

[ProcessEngine]

Chave
Valor padrão Descrição
MaxNumberOfWorkerThreads auto

Por padrão, quando MaxNumberOfWorkerThreads está definido para auto, o número de threads de trabalho será duas vezes o número de núcleos.

Você pode alterar esse valor para qualquer número de um mínimo de 1 até um máximo de 200.

RunOperationsInSeparateProcess true

Por padrão, quando RunOperationsInSeparateProcess está definido para true, as operações serão executadas em processos separados. Quando esta opção é true, o padrão é tempo de execução ilimitado para o tempo que uma operação pode ser executada.

Para definir um limite de quanto tempo cada operação pode ser executada, você pode definir MaxOperationRuntimeSeconds para o número de segundos permitido. Você pode opcionalmente especificar um MaxOperationRuntimeMessage que será registrado nos casos em que o tempo máximo de tempo de execução for atingido.

Não é recomendado desligar RunOperationsInSeparateProcess. Você pode fazer isso configurando RunOperationsInSeparateProcess como false. Nesse caso, MaxOperationRuntimeSeconds e MaxOperationRuntimeMessage não se aplicará.

MaxOperationRuntimeSeconds
MaxOperationRuntimeMessage
EnableDebugDump false

Por padrão, EnableDebugDump é false e o despejo de depurar não está habilitado. Para habilitar, defina como true.

Se habilitado, você pode definir DebugDumpDir para o caminho para um diretório para o depurar. Se não for especificado, DebugDumpDir será o padrão para o TempDir configuração sob [Settings].

Para especificar um diretório, defina DebugDumpDir igual ao seu caminho absoluto. Use barras, mesmo no Windows. O diretório deve existir e ser legível e gravável pelo agente privado Jitterbit.

DebugDumpDir

[PredefinedGlobalVariables]

Esta seção fornece os valores padrão de variáveis globais predefinidas, que também são conhecidas como variáveis Jitterbit. Elas podem ser substituídas caso a caso, definindo a variável correspondente em um script.

Para obter documentação completa sobre todas as variáveis que podem ser definidas nesta seção, consulte Integration StudioVariáveis Jitterbit ou Design Studio variáveis Jitterbit.

Chave
Valor padrão Descrição
jitterbit.source.db.preserve_char_whitespace false Por padrão, os espaços em branco iniciais e finais de um banco de dados de origem não são preservados. Para preservar os espaços em branco iniciais e finais, altere o valor para true.
jitterbit.target.db.include_null_in_sql_statement false Por padrão, nulo não é incluído em uma instrução SQL de um banco de dados de destino. Para incluir nulo, altere o valor para true.
jitterbit.scripting.nesting.max 10 Por padrão, até 10 scripts aninhados são permitidos. Para diminuir ou aumentar esse máximo, altere o valor para outro número.
jitterbit.scripting.while.max_iterations 50000 Por padrão, cada loop while é limitado a 50.000 iterações em um script escrito na linguagem Jitterbit Script. Para diminuir ou aumentar esse máximo, altere o valor para outro número.
jitterbit.scripting.db.auto_commit true Por padrão, os scripts do banco de dados serão confirmados automaticamente. Para usar transações do banco de dados, você pode alterar esse valor para false.
jitterbit.scripting.db.max_rows 10000 Por padrão, o número máximo de linhas de banco de dados afetadas por um script é 10.000. Esse número limita a quantidade de linhas a serem retornadas para o DBExecute, DBLookup, e DBLookupAll funções (ver Integration StudioFunções de banco de dados ou Design Studio Funções de banco de dados). Para diminuir ou aumentar esse máximo, altere o valor para outro número.
jitterbit.scripting.ldap.scope 1 Por padrão, os scripts permitem o uso de LDAP. Para desativar esta opção, defina como 0.
jitterbit.scripting.ldap.include_dn_in_results false Por padrão, os scripts não incluem o nome distinto (DN) no Active Directory. Para incluir o DN, altere esta opção para true.
jitterbit.scripting.ldap.use_paged_search false Por padrão, a pesquisa paginada para LDAP é desativada no script. Por padrão, o Active Directory permite que suas consultas extraiam apenas um certo número de registros por vez. Se esta opção estiver definida como false e você executar uma consultar que exceda esse limite, sua consultar falhará. Se você definir isso como true, O Jitterbit recuperará os dados em páginas para que o limite do Active Directory não seja excedido.
jitterbit.scripting.ldap.max_search_results 1 Por padrão, o máximo de resultados de pesquisa retornados de uma pesquisa LDAP por padrão é 1. Para mais resultados, aumente esse número.
jitterbit.scripting.ldap.return_null_if_no_results false Se definido como true, então uma consultar LDAP sem registros correspondentes à consultar retornará um único NULL valor.
jitterbit.source.text.csv_nullable false Por padrão, se estiver usando um arquivo CSV de texto como arquivo de origem, nulos não são permitidos. Altere este valor para true para permitir nulos.
jitterbit.target.http.remove_trailing_linebreaks true Se definido como true, as quebras de linha finais serão removidas antes que os dados de destino sejam publicados.
jitterbit.target.xml.num_for_bool false Por padrão, os valores de destino booleanos XML são representados com valores de string: "false" e "true". Se definido como true, os valores de destino booleanos XML serão representados com "0" ou "1" para false e true valores respectivamente.
jitterbit.source.ftp.transfer_timeout 3600 Por padrão, o tempo limite de transferência para fontes FTP é de 3.600 segundos. Para aumentar ou diminuir, altere o valor para outro número.
jitterbit.target.ftp.transfer_timeout 3600 Por padrão, o tempo limite de transferência para alvos FTP é de 3.600 segundos. Para aumentar ou diminuir, altere o valor para outro número.
jitterbit.http.enable_cookies false Por padrão, os cookies não são habilitados para conexões HTTP. Para habilitar cookies, altere este valor para true.

[TransformationEngine]

Chave
Valor padrão Descrição
WriteLog 0

Por padrão, WriteLog está definido para 0, o que significa que o registro detalhado de transformações está desativado.

Para ativar o registro detalhado de transformações para fins de depuração, você pode alterar este valor para 1.

Não é recomendado manter o registro habilitado, pois essa opção pode produzir muitos arquivos. Além disso, observe que o registro detalhado também pode ser ativado no nível de operação, o que é preferível.

Quando WriteLog está habilitado e WriteLogDir é deixado em branco por padrão, os logs de depurar serão gravados em JITTERBIT_HOME/DataInterchange/Temp/Debug. Se você quiser alterar o diretório onde os logs são salvos, você pode especificar o valor de WriteLogDir como o local de diretório desejado.

Para obter mais informações, consulte Registro de depurar de operação.

WriteLogDir
ValidateXML 1

Por padrão, ValidateXML está definido para 1, o que significa que a validação XML está ativada.

Para desativar toda a validação XML em uma escala global, defina como 0. No entanto, isso não é recomendado. É recomendado definir isso no nível de transformação.

LdapEnableAutoUpdateMode false

Por padrão, o modo de atualização automática para LDAP não está habilitado.

Se alterado para true, o modo de atualização automática permite que você pesquise cada entrada para determinar se ela deve ser adicionada ou atualizada.

TimingOn 0

Por padrão, TimingOn está definido para 0, o que significa que a criação de perfil de arquivos não está ativada.

Para ativar a criação de perfil globalmente, altere este valor para 1. Quando habilitado, os arquivos de criação de perfil são gravados em JITTERBIT_HOME/DataInterchange/Temp/LOG por padrão. Você não pode alterar o diretório de log para este parâmetro.

AutoStreaming 1

Por padrão, AutoStreaming está definido para 1, o que significa que o streaming automático está ativado.

Para desabilitar o streaming, defina este parâmetro como igual a 0. No entanto, isso não é recomendado. É recomendado fazer isso em transformações individuais.

Veja também Integration Studio Processamento de Transformação ou Design Studio transformações de fluxo e lote.

UseOldRuleForLoopOneOfXmlNode 0

Por padrão, este parâmetro é definido como 0, o que significa que esta regra não está habilitada.

A única instância em que este parâmetro deve ser definido como 1 é garantir compatibilidade com versões anteriores. Quando definido como 1, uma regra que estava presente em versões anteriores para criar um dos nós de destino XML será usada.

AutoXsiNil 0

Por padrão, este parâmetro é definido como 0.

Se este valor for definido como 1, então a transformação criará automaticamente um xsi:nil="true" atributo para um elemento que é obrigatório e não mapeado.

DefaultEntityResolution true Por padrão, a análise sintática de tipos de IDoc é habilitada. Para desabilitar essa análise sintática extra em um agente privado, adicione manualmente DefaultEntityResolution=false no [TransformationEngine] seção em jitterbit.conf.

[OperationEngine]

Chave
Valor padrão Descrição
Debug false

Por padrão, Debug está definido para false e o modo de depurar não está habilitado.

Para habilitar o modo de depurar, defina o valor como true. Isso fará com que mensagens de processo adicionais sejam gravadas no arquivo de log. Você pode querer habilitar isso se tiver dados temporários que não devem ser excluídos.

Nota

Ambos os Debug valor e o WriteLog valor deve ser definido como 1(verdadeiro) para que os logs sejam gerados.

Veja Registro de depurar de operação para obter informações adicionais.

AlwaysRunSuccessOperation false

Por padrão, este parâmetro é definido como false.

Se definido como true, então as operações seriam definidas para sempre serem executadas com sucesso, mesmo que não haja dados. Esta opção pode ser útil quando não há arquivos de origem disponíveis para uma origem baseada em arquivo, mas você quer que a operação seja executada como se tivesse sido bem-sucedida.

TemporaryStorageRootDirectory

Por padrão, quando não especificado, o diretório raiz de armazenamento temporário será TemporaryStorage e sob o diretório temporário do sistema operacional, ou sob o diretório temporário especificado pelo TempDir configuração sob [Settings].

No Windows com o diretório temporário padrão do sistema operacional, isso seria

C:\Windows\Temp\jitterbit\TemporaryStorage

No Linux com um diretório temporário padrão do sistema operacional de /tmp, isso seria

/tmp/jitterbit/TemporaryStorage

Para especificar um diretório de armazenamento temporário diferente, defina TemporaryStorageRootDirectory igual ao seu caminho absoluto. Use barras, mesmo no Windows. O diretório deve existir e ser legível e gravável pelo agente privado Jitterbit; caso contrário, a configuração será ignorada.

Consulte Locais de arquivo de log para obter informações adicionais.

MaxNumberOfOperationThreads

Por padrão, quando este parâmetro não é especificado, o número de threads de operação é ilimitado.

Para definir um número máximo de threads, você pode usar um número como valor aqui.

MaxOperationStackDepth 50

Por padrão, o número máximo de chamadas de operação síncrona aninhadas permitidas é 50.

Para aumentar ou diminuir esse máximo, defina o número desejado. Para tornar esse parâmetro ilimitado, defina o valor como 0 ou um número negativo. No entanto, observe que definir esse parâmetro como ilimitado não é recomendado, pois pode causar instabilidade no sistema.

MaxAsyncOperationChainLength 50

Por padrão, o número máximo de operações assíncronas permitidas em uma única cadeia é 50.

Isso é para proteger contra loops de operação infinitos. Para aumentar ou diminuir esse máximo, defina o número desejado. Para tornar esse parâmetro ilimitado, defina o valor como 0 ou um número negativo.

MaxAsyncOperationChainLengthOverrideAllowed true

Por padrão, este parâmetro é definido como true, o que significa que é possível substituir o comprimento máximo da cadeia de operação assíncronas. Quando esta opção está habilitada, você pode substituir o comprimento máximo da cadeia definindo a variável global $jitterbit.operation.max_async_chain_length (ver Integration StudioOperação Variáveis Jitterbit ou Design Studio Operação Variáveis Jitterbit).

Se esta opção for alterada para false, não será possível substituir o comprimento da cadeia usando a variável global.

AlwaysDeleteTempDir false

Por padrão, este parâmetro é definido como false, o que significa que os arquivos de operação temporários são mantidos até que sejam limpos de forma assíncrona.

Para sempre excluir arquivos de operação temporários, mesmo em caso de erros, defina como true.

WriteLog 0

Por padrão, WriteLog é definido como 0(falso).

Para habilitar WriteLog modo, defina o valor para 1 (true). Isso fará com que mensagens de processo adicionais para operações de API e programadas sejam gravadas no arquivo de log. Você pode querer habilitar isso se tiver dados temporários que não devem ser excluídos.

[APIOperation]

Chave
Valor padrão Descrição
EnableErrorLogging true

Por padrão, EnableErrorLogging é true, significando apenas operações de API (configuradas para APIs personalizadas ou serviços OData) com erros são registrados nos logs de operação.

Se esta opção estiver definida como false, registro de erros nos logs de operação está desabilitado.

EnableLogging false

Por padrão, EnableLogging é false, significando todas as operações de API (configuradas para APIs personalizadas ou serviços OData) não são registrados nos registros de operação. Observe que você ainda pode visualizar os logs de processamento da API no API Manager Logs da API página.

Se EnableLogging está definido para true, então todas as operações da API são registradas nos logs de operação. Note que quando EnableLogging está definido para true, o cenário para EnableErrorLogging é ignorado (já que todos os logs de operação da API seriam registrados).

EnableOperationIdLogging false

Por padrão, EnableOperationIdLogging é false, o que significa que o ID de uma operação que causa uma falha não será registrado.

Se esta opção foi definida como true, então o ID da operação que operação causando a falha é registrado e pode ser usado para determinar a causa raiz.

APIOperationLogging false

Por padrão, APIOperationLogging não está presente no jitterbit.conf arquivo e deve ser adicionado manualmente.

Se APIOperationLogging está definido para true, um log registrará o início de uma chamada de API e o tempo decorrido.

Cuidado

Ativar esta configuração gerará pelo menos quatro linhas adicionais para cada operação de API, o que pode resultar em arquivos de log muito grandes.

[HttpEndPoints]

Importante

[HttpEndPoints] as configurações se aplicam somente ao Design Studio endpoints HTTP hospedados.

Chave
Valor padrão Descrição
EnableErrorLogging true

Por padrão, EnableErrorLogging é true, significando apenas endpoint hospedado em HTTP chamadas com erros são registradas no log de atividades.

Se esta opção fosse definida como false, o registro de erros no log de atividades seria desativado.

EnableLogging true

Por padrão, EnableLogging é definido como verdadeiro para endpoints hospedados em HTTP, o que significa que todas as chamadas de endpoint hospedadas em HTTP são registradas no log de atividades. Para desabilitar o log de operação para endpoints hospedados em HTTP, você pode alterar este valor para false. Você pode querer desabilitar o registro para maior eficiência e rendimento sob carga.

Observe que quando EnableLogging está definido para true, então a configuração para EnableErrorLogging é ignorado (já que todas as chamadas HTTP seriam registradas).

Se ambos EnableLogging e EnableErrorLogging foram definidos para false, então nenhum registro seria habilitado.

[AutoScaling]

Chave
Valor padrão Descrição
DeregisterAgentOnJVMShutdown true

Se DeregisterAgentOnJVMShutdown está definido para true (ou não estiver presente), o cancelamento do registro do agente deve ocorrer, mesmo ao interromper o agente (a menos que seja interrompido usando o comando "Drain Stop" do Management Console).

Se DeregisterAgentOnJVMShutdown está definido para false então o cancelamento do registro do agente não acontece ao parar o agente (a menos que não seja interrompido usando o comando "Drain Stop" do Management Console).

[ResultFiles]

Chave
Valor padrão Descrição
DisableSuccess false

Por padrão, DisableSuccess é false, o que significa que a criação de arquivos de sucesso está habilitada.

Você pode desejar ativar esta opção configurando-a para true se você não quiser que arquivos de sucesso sejam criados, o que pode economizar espaço em disco.

DisableFailure false

Por padrão, DisableFailure é false, o que significa que a criação de arquivos de falha está habilitada.

Você pode desejar ativar esta opção configurando-a para true se você não quiser que arquivos de falha sejam criados, o que pode economizar espaço em disco.

[PredefinedServerGlobalDataElement]

Chave
Valor padrão
Descrição
definido pelo usuário definido pelo usuário

Esta seção é usada para criar variáveis globais predefinidas personalizadas que são inicializadas para qualquer operação que comece no agente. Se você especificar bubble='gum', isso adicionará uma variável global predefinida chamada bubble com o valor inicial de "gum" que pode ser referenciado em scripts como $bubble ou usando Get("bubble").

Veja Integration StudioVariáveis Jitterbit ou Design Studio Variáveis globais.

[Scheduler]

Chave
Valor padrão Descrição
AutoStart 1 Por padrão, este parâmetro é definido como igual a 1, significado AutoStart está habilitado.
SleepTimeInSeconds 5

Por padrão, o tempo de espera é definido como 5 segundos.

Este valor pode ser aumentado ou diminuído dependendo de suas necessidades.

WriteLog 0

Por padrão, este parâmetro é definido como 0 e o registro de depurar do agendador está desativado. Esta é a configuração recomendada, pois ativar o registro de depurar do agendador pode gerar um grande volume de registros e pode causar degradação do desempenho.

Para ativar o registro de depurar do agendador, altere este valor para 1. O log é gravado no diretório temporário e é chamado scheduler_debug.log.

[FileCleanup]

Chave
Valor padrão Descrição
AutoStart 1

Por padrão, este parâmetro é definido como igual a 1, significado AutoStart está habilitado.

Se você alterar esta opção para 0, a limpeza de arquivos não será executada automaticamente, desabilitando efetivamente a limpeza de arquivos.

SleepTimeInSeconds 5

Por padrão, o tempo de espera é definido como 5 segundos.

Este valor pode ser aumentado ou diminuído dependendo de suas necessidades.

FrequencyInHours 24.0

Por padrão, a limpeza de arquivos será executada uma vez a cada 24 horas.

Este valor pode ser aumentado ou diminuído dependendo de suas necessidades.

[SMTPClient]

Chave
Valor padrão Descrição
DefaultSMTPServers

Especifica os servidores SMTP padrão a serem usados quando uma mensagem de email deve ser enviada e nenhum servidor SMTP foi especificado pelo usuário.

Adicione os servidores SMTP em uma lista separada por vírgulas.

DefaultFromEmail Especifica um endereço de email padrão a ser usado no campo "De", caso nenhum tenha sido especificado pelo usuário.
DefaultAccount
DefaultAccountPassword
UseSSL
Se o(s) seu(s) servidor(es) SMTP precisarem de autenticação, especifique a conta e a senha aqui. Defina UseSSL para true se o servidor SMTP exigir SSL/TLS.

[SSH]

Certifique-se de que esses arquivos podem ser lidos pelo aplicativo Jitterbit e por mais ninguém!

Chave
Valor padrão Descrição
PublicKeyFile

Não há padrão PublicKeyFile. Você pode especificar o caminho absoluto para sua chave pública aqui, se aplicável. Por exemplo:

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

PrivateKeyFile

Não há padrão PrivateKeyFile. Você pode especificar o caminho absoluto para sua chave privada aqui. Por exemplo:

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

PrivateKeyPassphrase Não há padrão PrivateKeyPassphrase. Você pode especificar sua senha de chave privada aqui, se necessário.
Configurado pelo usuário para vários conjuntos

Vários conjuntos de chaves podem ser configurados definindo, por exemplo:

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

ou

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

Com uma entrada como:

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

[SSL]

Certifique-se de que esses arquivos podem ser lidos pelo Jitterbit, mas por mais ninguém! Apenas certificados e chaves com formato PEM são suportados.

Chave
Valor padrão Descrição
CertificateFile

Não há padrão CertificateFile. Você pode especificar o caminho absoluto para o arquivo de certificado do cliente SSL aqui. Por exemplo:

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

PrivateKeyFile

Não há padrão PrivateKeyFile. Você pode especificar o caminho absoluto para sua chave privada aqui. Por exemplo:

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

PrivateKeyPassphrase Não há padrão PrivateKeyPassphrase. Você pode especificar sua senha de chave privada aqui, se necessário.
Configurado pelo usuário para vários conjuntos

Vários conjuntos de certificados e chaves podem ser configurados definindo, por exemplo:

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

ou

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

ou

$jitterbit.web_service_call.ssl_cert_id = "Me";

Com uma entrada como:

CertificateFileMe='C:/Users/My Name/Certs/me.crt'
PrivateKeyFileMe='C:/Users/My Name/Certs/me.key'
PrivateKeyPassphraseMe=mysecret

[Settings/XMLSchemas]

Estas configurações definem os esquemas XML disponíveis.

Chave Valor padrão
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]

Certos drivers de banco de dados exigem caracteres especiais para delimitar nomes de tabelas/colunas. Se seu aplicativo exigir configurações diferentes, você pode modificar essas entradas.

Muitos drivers ODBC exigem que nomes de tabelas e campos sejam colocados entre aspas se eles diferenciarem maiúsculas de minúsculas ou contiverem caracteres especiais. Configure os caracteres de aspas para seu driver nesta seção se eles ainda não estiverem incluídos. Caracteres especiais que são suportados como delimitadores incluem / . * = ? | ( ) [ ] { e }. Esses delimitadores são definidos especificando o Quote Begin e Quote Endnesta seção.

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 e Quote End são necessários somente para tabelas ou colunas que contenham caracteres especiais.

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

MySQL

Para MySQL, Quote Begin e Quote End são necessários para tabelas com espaços.

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

Driver MySQL 3.51

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

Driver 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'='\"'

Driver ODBC Oracle

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

Oracle em OraClient10g_home2

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

Acesso

'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'=']'

MS Excel

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

MS Excel - Nome 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 seção é usada com configurações de proxy para chamar recursos externos.

Chave
Valor padrão Descrição
MaxConnections 50 Número máximo de conexões totais a serem mantidas no pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 20).
MaxConnectionsPerRoute 5 Número máximo de conexões por rotear. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 2).
TimeoutInSeconds 60 Tempo limite, em segundos, para esperar por uma conexão do pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente resultando em nenhum tempo limite, significando que o tempo limite será indefinido enquanto espera por uma conexão ficar disponível).
HttpSocketTimeoutInSeconds 180 Tempo limite, em segundos, após estabelecer a conexão, que o socket cliente aguarda por uma resposta após enviar a solicitação. Este é o tempo decorrido desde que o cliente enviou a solicitação ao servidor antes que o servidor responda. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tempo limite, em segundos, para aguardar a conexão com o hospedar remoto.

[HttpConnectionPoolLocal]

Esta seção é usada com recursos locais (serviços SOAP, API).

Chave
Valor padrão Descrição
MaxConnections 50 Número máximo de conexões totais a serem mantidas no pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 20). Este valor pode ser definido como 100. Veja Nota.
MaxConnectionsPerRoute 50 Número máximo de conexões por rotear. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 2). Este valor pode ser definido como 100. Veja Nota.
TimeoutInSeconds 60 Tempo limite, em segundos, para esperar por uma conexão do pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente resultando em nenhum tempo limite, significando que o tempo limite será indefinido enquanto espera por uma conexão ficar disponível).
HttpSocketTimeoutInSeconds 180 Tempo limite, em segundos, após estabelecer a conexão, que o socket cliente aguarda por uma resposta após enviar a solicitação. Este é o tempo decorrido desde que o cliente enviou a solicitação ao servidor antes que o servidor responda. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient é usado (atualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tempo limite, em segundos, para aguardar a conexão com o hospedar remoto.

Nota

Estas aplicam-se apenas a [HttpConnectionPoolLocal] configurações.

Se você definir MaxConnections e MaxConnectionsPerRoute para 100, faça estas alterações adicionais:

  1. Edite o jitterbit-agent-config.properties arquivo e conjunto:

    max.concurrent.requests=100
    

    Não defina max.concurrent.requests acima de 100. Isso reverterá o valor para o padrão de 16.

  2. Edite o httpd.conf arquivo e conjunto:

    ThreadsPerChild 101
    

[Debug]

Chave
Valor padrão Descrição
WebServiceDebugFile ''

Por padrão, a gravação em um arquivo de depurar de serviço web está desabilitada.

Quando habilitado, os serviços web de backend gravarão informações de depurar neste arquivo enquanto estiverem no modo de depurar.

[ErrorHandling]

Esta seção fornece opções de configuração sobre como lidar com potenciais situações de erro no backend. Os valores possíveis são:

  • Ok: A situação é considerada normal; continue normalmente.
  • Warning: Registre um aviso e continue.
  • Error: A situação é considerada fatal.
Chave
Valor padrão Descrição
NoRowsAffectedOnDbUpdates Ok Uma instrução de atualização em um destino de banco de dados que não afeta nenhuma linha é Ok conforme a definição acima.
NoTargetDataGenerated Ok Nenhum dado de destino foi gerado Ok conforme a definição acima.
NoWebServiceRequestData Warning Nenhum dado disponível para gerar uma solicitação de serviço da web válida gera um Warning conforme a definição acima.
EmptyDatabaseSource Warning Uma fonte de banco de dados plana está vazia e gera um Warning conforme a definição acima.

[JavaBackend]

Chave
Valor padrão Descrição
DebugLogLevel Não há padrão DebugLogLevel. Os valores aceitáveis são SEVERE(mais alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(mais baixo), OFF, ou ALL conforme definido em https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JavaUiBackend]

Chave
Valor padrão Descrição
LogLevel OFF O valor padrão para LogLevel é OFF, indicando que o registro está desativado. Os valores aceitáveis são SEVERE(mais alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(mais baixo), OFF, ou ALL conforme definido em https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JDBCEngine]

Chave
Valor padrão Descrição
SessionTimeout 60 O valor padrão para SessionTimeout é 60, que é o número de minutos ociosos após os quais uma sessão JDBC aberta atingirá o tempo limite. Isso é usado como uma medida de segurança, pois as sessões normalmente serão fechadas pelo servidor após o uso. Você pode alterar o tempo limite da sessão ajustando o número.
ClientSessionTimeout 180 O valor padrão para ClientSessionTimeout é 180, que é o número máximo de minutos que uma operação JDBC pode levar. Depois disso, a operação falhará. Se você acha que uma operação JDBC (como um processo de gravação de destino JDBC) levará mais tempo do que isso, você deve aumentar esse número.
LogLevel INFO O valor padrão para LogLevel é INFO, indicando que mensagens informativas estão sendo registradas. Os valores aceitáveis são SEVERE(mais alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(mais baixo), OFF, ou ALL conforme definido em https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[LDAP]

O [LDAP] seção de um arquivo de configuração de agente privado pode ser usada para adicionar suporte UTF-8 para Microsoft Windows e Active Directory com agentes privados do Windows que sejam versão 9.5 ou superior.

Chave Valor Descrição
CharacterEncoding ISO-8859-1 Suporta codificação UTF-8.

Isso pode ser garantido se você usar o LDAPReplace() função para substituir um valor em um Active Directory, conforme visto abaixo, e descobrir que o texto é convertido em um resultado diferente da entrada, como François sendo substituído por FrançOis:

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

Para evitar problemas com caracteres especiais, adicione o [LDAP] seção como segue e reinicie o agente:

  1. Atualize o jitterbit.conf arquivo com as seguintes linhas:

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

Para mais informações, veja Integration Studio Funções LDAP ou funções LDAP do Design Studio.

[ConnectorsInfo]

Chave
Valor padrão
Descrição
MSAXUrl http://127.0.0.1:8002/AX/ Isso é usado pelo Microsoft Dynamics AX Connector (Design Studio ou Integration Studio) e não deve ser alterado, a menos que seja instruído pelo suporte do Jitterbit.
MSCrmUrl http://127.0.0.1:8000/CRM/ Isso é usado pelo Microsoft Dynamics CRM Connector (Design Studio ou Integration Studio) e não deve ser alterado, a menos que seja instruído pelo suporte do Jitterbit.
jitterbit.connectorcall.timeout 300 Valor de timeout em segundos. Isso é usado por certos conectores e não deve ser alterado a menos que seja instruído pelo suporte do Jitterbit.

[VerboseLogging]

Esta seção está presente em agentes privados 10.48 e posteriores e é usada para a geração de dados de entrada e saída de componentes quando registro de depurar de operação está habilitado em um indivíduo Integration Studio operação em execução em um agente privado 10.48 ou posterior.

Ao atualizar uma versão anterior do agente privado para 10.48 ou posterior, a geração de dados de entrada e saída é habilitada automaticamente por padrão, mesmo que o [VerboseLogging] seção e suas chaves não estão presentes no arquivo de configuração.

A geração de dados de entrada e saída do componente não é afetada pela configuração do grupo de agentes Cloud logging enabled. Os dados de entrada e saída do componente serão registrados na nuvem Harmony mesmo se o registro na nuvem estiver desabilitado, a menos que verbose.logging.enable é explicitamente definido como false. Isso substitui a geração de dados de entrada e saída do componente quando Habilitar modo de depuração até é configurado em um indivíduo Integration Studio operação, mas não impede que arquivos de log de depurar de operação sejam gerados. Ambos os tipos de logs de depurar de operação são abordados em Log de depurar de operação.

Chave
Valor padrão
Descrição
verbose.logging.enable true

Quando true ou quando esta configuração não estiver presente no arquivo de configuração, os dados de entrada e saída do componente serão gravados no Integration Studio log de operação quando registro de depurar de operação está habilitado em um indivíduo Integration Studio operação em execução em um agente privado 10.48 ou posterior. Definido como false para evitar que os dados de entrada e saída do componente sejam registrados na nuvem Harmony.

Cuidado

Quando esta configuração não está presente no arquivo de configuração de um agente privado 10.48 ou posterior, a configuração é tratada como se estivesse presente e definida como true. Ou seja, a geração de dados de entrada e saída do componente é habilitada por padrão em todos os agentes 10.48 e posteriores, a menos que essa configuração seja explicitamente definida como false.

verbose.logging.commpress.folder.path Por padrão, essa configuração é comentada e não é usada. Ela não deve ser alterada, a menos que seja instruída pelo suporte do Jitterbit.
verbose.logging.log.folder.path Por padrão, essa configuração é comentada e não é usada. Ela não deve ser alterada, a menos que seja instruída pelo suporte do Jitterbit.
verbose.logging.log.file.extension .verbose Isto é usado para registro de depurar de operação e não deve ser alterado a menos que seja instruído pelo suporte do Jitterbit. Esta configuração não precisa estar presente no arquivo de configuração para que os dados de entrada e saída do componente sejam gerados.
verbose.logging.use.dynamic.host.for.collector.url true Isto é usado para registro de depurar de operação e não deve ser alterado a menos que seja instruído pelo suporte do Jitterbit. Esta configuração não precisa estar presente no arquivo de configuração para que os dados de entrada e saída do componente sejam gerados.