Ir para o conteúdo

Edite o Arquivo de Configuração do Agente (jitterbit.conf)

Introdução

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

Faça Alterações de Configuração

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

A edição remota é o método preferido e, ao usar 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 o 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 deverão ser reiniciados para que a alteração na configuração ocorra.

Edite Remotamente Via Management Console

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

  1. Faça login no Portal Harmony e escolha Management Console.
  2. Clique no menu Harmony Portal no canto superior esquerdo e selecione Organizações.
  3. Na tabela, selecione a organização para a qual deseja ativar a configuração do agente remoto.
  4. Na extremidade direita da linha selecionada, use o menu suspenso Ações para selecionar Editar políticas da organização. Você deve ter permissão de 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 remota do Agente e clique em Salvar.

Após a configuração do agente remoto ser habilitada, para editar o arquivo de configuração siga estas etapas:

  1. Clique no menu Harmony Portal no canto superior esquerdo, passe o mouse sobre Agentes e selecione Grupos de Agente.
  2. Na tabela, selecione o Grupo de Agentes para seu Agente Privado.
  3. Na extremidade direita da linha selecionada, use o menu suspenso Actions para selecionar Jitterbit Conf para visualizar o arquivo de configuração.
  4. No pop-up, há duas guias, Config e Db Drivers, que exibem as definições de configuração e drivers de banco de dados especificados em jitterbit.conf. Para fazer alterações ou acréscimos às informações em qualquer uma das aba, clique nos botões Editar ou Adicionar no canto superior direito.
  5. Ao terminar, clique em Enviar.

Dica

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

Aviso

Quando você habilita a configuração remota do agente, a configuração atual do agente (excluindo as informações do banco de dados de cache PostgreSQL local e variáveis globais predefinidas locais) será lida e armazenada na nuvem para que você possa visualizá-la e editá-la remotamente. Depois de ativar a configuração do agente remoto, quaisquer alterações feitas manualmente no agente 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, você pode fazer isso em Organizações em Ações > Editar > Políticas da Organização desmarcando a caixa de seleção "Ativar configuração remota do Agente ". No entanto, observe que você perderá a configuração atual do agente remoto que estava armazenada na nuvem. Depois que os serviços do agente forem reiniciados, seu agente lerá o local jitterbit.conf arquivo.

Editar Manualmente

Embora seja possível editar manualmente o arquivo de configuração local de cada agente, esse não é o método preferido para fazer alterações na 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 ocorre 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 na seção correta, conforme documentado aqui, para serem encontradas e entrarem em vigor.

  • Os nomes das seções e dos nomes das chaves 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 indicados por um único hash (#) personagem. Qualquer coisa na linha seguindo o # será ignorado.

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

  • Todos os nomes de arquivos são relativos à pasta do diretório de instalação inicial, salvo indicação em contrário.

    Importante

    Use barras para caminhos de arquivos/diretórios, 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 tenha efeito.

Na máquina onde cada Agente Privado está instalado, primeiro interrompa 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 após a atualização de um Agente Privado. Ou seja, o existente jitterbit.conf O arquivo não é substituído durante a instalação sobre uma instalação de agente existente.

De tempos em tempos, pode haver acréscimos ou alterações em jitterbit.conf conforme anunciado nas 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 arquivo de configuração existente do Agente Privado antes de reinstalar.

Definições de Configuração e Valores Padrão

Estas seções descrevem cada configuração disponível no 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 ignorados na configuração real. Vários parâmetros opcionais são comentados desta 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 do sistema operacional padrão, isso seria C:\Windows\Temp\jitterbit.

No Linux com um diretório temporário do sistema operacional padrão de /tmp, este 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 Jitterbit Agente Privado.

CurlDebugDir

Por padrão, o CurlDebugDir O parâmetro é deixado em branco e os 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 desse parâmetro para qualquer caminho de diretório válido onde deseja salvar os logs de depuração. Cada solicitação criará um novo arquivo neste diretório.

Veja também Curl Debug Logs.

EnableLocalFileLocation false

Por padrão, EnableLocalFileLocation está configurado para false. Isso significa que o uso de arquivos locais como origens 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 Ativar localização de 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 e não por loop.

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

Para aumentar o número máximo de iterações permitidas em qualquer script JavaScript, adicione manualmente JavaScriptMaxIterations=X onde X é melhor 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 Agente Privado versão 10.34 e posterior.

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á configurado para true, as operações acionadas pelas APIs do API Manager usarão as configurações de tempo limite de operação definidas em Cloud Studio ou Design Studio.

[DBInfo]

Chave
Valor padrão
Descrição
User jitterbit

Por padrão, quando um Jitterbit Agente Privado é 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ê deve especificar 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 atualizará o User valor aqui.

DisableOdataCount false Desativa o $count e $inlinecount configurações em consultas OData recebidas. Definido como true se você tiver problemas de desempenho no banco de dados em segundo plano como resultado da funcionalidade de contagem. Isto está disponível apenas com um Agente Privado 9.6 ou posterior.
Password gerado na instalação
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 o Agente Privado versão 10.60 ou anterior, a porta padrão é 6543.

[APIInfo]

Chave
Valor padrão Descrição
DebugJDML false Definido como true para adicionar registros adicionais de chamadas OData nos logs da API, incluindo o SQL real enviado ao banco de dados. Isto está disponível apenas com um Agente Privado 9.6 ou posterior.

[ProcessEngine]

Chave
Valor padrão Descrição
MaxNumberOfWorkerThreads auto

Por padrão, quando MaxNumberOfWorkerThreads está configurado 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 a um máximo de 200.

RunOperationsInSeparateProcess true

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

Para definir um limite de quanto tempo cada operação pode ser executada, você pode definir MaxOperationRuntimeSeconds ao número de segundos permitido. Opcionalmente, você pode 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 ativar, defina como true.

Se ativado, você pode definir DebugDumpDir para o caminho para um diretório para o dump de depurar. Se não for especificado, DebugDumpDir padrão será 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 Jitterbit Agente Privado.

DebugDumpDir

[PredefinedGlobalVariables]

Esta seção fornece os valores padrão de variáveis globais predefinidas, também conhecidas como variáveis Jitterbit. Eles podem ser substituídos 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 Cloud Studio Variá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 à esquerda e à direita de um banco de dados de origem não são preservados. Para preservar os espaços em branco à esquerda e à direita, altere o valor para true.
jitterbit.target.db.include_null_in_sql_statement false Por padrão, null 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, são permitidos até 10 scripts aninhados. 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 de 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 do banco de dados afetadas por um script é 10.000. Este número limita a quantidade de linhas a serem retornadas para o DBExecute, DBLookup, e DBLookupAll funções (consulte Cloud Studio funçõ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 está desativada no script. Por padrão, o Active Directory permite que suas consultas extraiam apenas um determinado 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 nas 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 obter mais resultados, aumente este número.
jitterbit.scripting.ldap.return_null_if_no_results false Se definido para 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, valores nulos não serão permitidos. Altere este valor para true para permitir nulos.
jitterbit.target.http.remove_trailing_linebreaks true Se definido para 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 sequência: "false" e "true". Se definido para true, os valores alvo 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 destinos 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 estão habilitados para conexões HTTP. Para ativar cookies, altere este valor para true.

[TransformationEngine]

Chave
Valor padrão Descrição
WriteLog 0

Por padrão, WriteLog está configurado 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 esse valor para 1.

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

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

Para obter mais informações, consulte Operation Debug Logging.

WriteLogDir
ValidateXML 1

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

Para desativar toda a validação XML em escala global, defina como 0. Contudo, isto não é recomendado. Recomenda-se 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á ativado.

Se alterado para true, o modo de atualização automática permite pesquisar cada entrada para determinar se a entrada deve ser adicionada ou atualizada.

TimingOn 0

Por padrão, TimingOn está configurado 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 esse valor para 1. Quando ativado, os arquivos de perfil são gravados em JITTERBIT_HOME/DataInterchange/Temp/LOG por padrão. Você não pode alterar o diretório de log deste parâmetro.

AutoStreaming 1

Por padrão, AutoStreaming está configurado para 1, o que significa que a transmissão automática está ativada.

Para desativar a transmissão, defina este parâmetro como igual a 0. Contudo, isto não é recomendado. É recomendável fazer isso em transformações individuais.

Consulte também Cloud 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 a compatibilidade com versões anteriores. Quando definido para 1, será usada uma regra que estava presente em versões anteriores para a criação de um dos nós de destino XML.

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 de tipos de IDoc está habilitada. Para desabilitar esta análise 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á configurado para false e o modo de depurar não está ativado.

Para ativar o modo de depurar, defina o valor como true. Isso fará com que mensagens adicionais do processo sejam gravadas no arquivo de log. Talvez você queira ativar esta opção se tiver dados temporários que não devem ser excluídos.

Nota

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

Consulte Registro de depuração de operação para obter informações adicionais.

AlwaysRunSuccessOperation false

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

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

TemporaryStorageRootDirectory

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

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

C:\Windows\Temp\jitterbit\TemporaryStorage

No Linux com um diretório temporário do sistema operacional padrão 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 Jitterbit Agente Privado; caso contrário, a configuração será ignorada.

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

MaxNumberOfOperationThreads

Por padrão, quando esse 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 permitido de chamadas de operação síncronas aninhadas é 50.

Para aumentar ou diminuir esse máximo, defina como o número desejado. Para tornar este parâmetro ilimitado, defina o valor como 0 ou um número negativo. Entretanto, 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 serve para proteger contra loops de operação infinitos. Para aumentar ou diminuir esse máximo, defina o número desejado. Para tornar este 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íncrona. 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 (consulte Cloud Studio variáveis de operação 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é serem 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 ativar WriteLog modo, defina o valor para 1 (verdadeiro). Isso fará com que mensagens de processo adicionais para API e operações agendadas sejam gravadas no arquivo de log. Talvez você queira ativar esta opção 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, ou seja, todas as operações de API (configuradas para APIs personalizadas ou Serviços OData) não estão registrados nos logs de operação. Observe que você ainda pode visualizar logs de processamento de API no API Manager API Logs.

Se EnableLogging está configurado para true, todas as operações da API serão registradas nos logs de operação. Observe que quando EnableLogging está configurado para true, a configuração para EnableErrorLogging é ignorado (pois 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 causou uma falha não será registrado.

Se esta opção foi definida como true, o ID da operação que causou a falha será registrado e poderá 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á configurado para true, um registro 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 da API, o que pode resultar em arquivos de log muito grandes.

[HttpEndPoints]

Importante

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

Chave
Valor padrão Descrição
EnableErrorLogging true

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

Se esta opção estiver 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 HTTP, o que significa que todas as chamadas de endpoint hospedadas HTTP são registradas no log de atividades. Para desabilitar o log de operação para endpoints hospedados HTTP, você pode alterar esse valor para false. Talvez você queira desativar a geração de registros para obter maior eficiência e rendimento sob carga.

Observe que quando EnableLogging está configurado 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, nenhum registro seria ativado.

[AutoScaling]

Chave
Valor padrão Descrição
DeregisterAgentOnJVMShutdown true

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

Se DeregisterAgentOnJVMShutdown está configurado para false então o cancelamento do registro do agente não ocorre 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 bem-sucedidos está ativada.

Você pode ativar esta opção configurando como true se você não quiser que arquivos sejam criados com sucesso, 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á ativada.

Você pode ativar esta opção configurando como 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 iniciada 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").

Consulte Cloud Studio Variá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á ativado.
SleepTimeInSeconds 5

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

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

WriteLog 0

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

Para ativar o registro de depurar do agendador, altere esse 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 1, significado AutoStart está ativado.

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

SleepTimeInSeconds 5

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

Esse 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.

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

[SMTPClient]

Chave
Valor padrão Descrição
DefaultSMTPServers

Especifica servidores SMTP padrão a serem usados quando uma mensagem email for enviada e nenhum servidor SMTP for especificado pelo usuário.

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

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

[SSH]

Certifique-se de que esses arquivos possam 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 a senha da sua chave privada aqui, se necessário.
Configurado pelo usuário para vários conjuntos

Vários conjuntos de chaves podem ser configurados, 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 possam ser lidos pelo Jitterbit, mas por mais ninguém! Somente certificados e chaves formatados em 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 a senha da sua chave privada aqui, se necessário.
Configurado pelo usuário para vários conjuntos

Vários conjuntos de certificados e chaves podem ser configurados, 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/Meu nome/Certs/me.key'
PrivateKeyPassphraseMe=mysecret

[Settings/XMLSchemas]

Essas 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 o seu aplicativo exigir configurações diferentes, você poderá modificar essas entradas.

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

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 será 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 será usado (atualmente 2).
TimeoutInSeconds 60 Tempo limite, em segundos, para aguardar uma conexão do pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient será usado (atualmente resultando em nenhum tempo limite, o que significa que o tempo limite será indefinido enquanto aguarda a disponibilização de uma conexão).
HttpSocketTimeoutInSeconds 180 Tempo limite, em segundos, após o estabelecimento da conexão, que o soquete do cliente aguarda uma resposta após o envio da 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 será 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 será usado (atualmente 20). Este valor pode ser definido como 100. Consulte a 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 será usado (atualmente 2). Este valor pode ser definido como 100. Consulte a Nota.
TimeoutInSeconds 60 Tempo limite, em segundos, para aguardar uma conexão do pool. Se definido como 0 ou menos, o valor padrão definido pela biblioteca Apache HttpClient será usado (atualmente resultando em nenhum tempo limite, o que significa que o tempo limite será indefinido enquanto aguarda a disponibilização de uma conexão).
HttpSocketTimeoutInSeconds 180 Tempo limite, em segundos, após o estabelecimento da conexão, que o soquete do cliente aguarda uma resposta após o envio da 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 será 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 da Web está desabilitada.

Quando ativada, os serviços da Web de back-end gravarão informações de depurar nesse arquivo enquanto estiver no modo de depurar.

[ErrorHandling]

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

  • Ok: A situação é considerada normal; continue como de costume.
  • Aviso: Registre um aviso e continue.
  • Erro: 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 pela definição acima.
NoTargetDataGenerated Ok Nenhum dado de destino foi gerado é Ok pela definição acima.
NoWebServiceRequestData Warning Nenhum dado disponível para gerar uma solicitação de serviço da web válida gera um Warning pela definição acima.
EmptyDatabaseSource Warning Uma fonte de banco de dados simples está vazia gera um Warning pela definição acima.

[JavaBackend]

Chave
Valor padrão Descrição
DebugLogLevel Não há padrão DebugLogLevel. Os valores aceitáveis são SEVERE (Altíssima), 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 em log está desativado. Os valores aceitáveis são SEVERE (Altíssima), 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 inativos após os quais uma sessão JDBC aberta atingirá o tempo limite. Isto é usado como uma medida à prova de falhas, 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) demorará mais do que isso, aumente 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 (Altíssima), 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] de um arquivo de configuração do Agente Privado pode ser usada para adicionar suporte UTF-8 para Microsoft Windows e Active Directory com Agentes Privados do Windows versão 9.5 ou superior.

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

Isto pode ser garantido se você usar o LDAPReplace() função para substituir um valor em um Active Directory como visto abaixo, e descobrir que o texto é convertido para 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 obter mais informações, consulte Funções LDAP do Cloud Studio 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 Conector Microsoft Dynamics AX (Design Studio ou Cloud Studio) e não deve ser alterado a menos que seja instruído pelo suporte da Jitterbit.
MSCrmUrl http://127.0.0.1:8000/CRM/ Isso é usado pelo Microsoft Dynamics CRM Connector (Design Studio ou Cloud Studio) e não deve ser alterado a menos que seja instruído pelo suporte da Jitterbit.
jitterbit.connectorcall.timeout 300 Valor de tempo limite em segundos. Isso é usado por determinados conectores e não deve ser alterado, a menos que seja instruído pelo suporte da Jitterbit.

[VerboseLogging]

Esta seção está presente no Agentes Privados 10.48 e posterior e é usada para a geração de dados de entrada e saída do componente quando registro de depurar de operação está ativado em uma operação individual do Cloud Studio 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 é automaticamente habilitada 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 Ativar Cloud Logging (consulte Agentes > Grupos de Agente). 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 está explicitamente definido como false. Isso substitui a geração de dados de entrada e saída do componente quando Enable Debug Mode Until está configurado em uma operação individual do Cloud Studio, mas não impede a geração de arquivos de log de depurar da operação. Ambos os tipos de logs de depurar de operação são abordados em Registro de depuração de operação.

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

Quando true ou quando essa configuração não está presente no arquivo de configuração, os dados de entrada e saída do componente são gravados no log de operação do Cloud Studio quando registro de depurar de operação está ativado em uma operação individual do Cloud Studio em execução em um Agente Privado 10.48 ou posterior. Definido como false para evitar que os dados de entrada e saída dos componentes 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 esta configuração seja explicitamente definida como false.

verbose.logging.commpress.folder.path Por padrão, essa configuração é comentada e não é usada. Não deve ser alterado a menos que seja instruído pelo suporte da Jitterbit.
verbose.logging.log.folder.path Por padrão, essa configuração é comentada e não é usada. Não deve ser alterado a menos que seja instruído pelo suporte da Jitterbit.
verbose.logging.log.file.extension .verbose Isso é usado para registro de depurar de operação e não deve ser alterado a menos que seja instruído pelo suporte da 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 Isso é usado para registro de depurar de operação e não deve ser alterado a menos que seja instruído pelo suporte da 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.