Ir para o conteúdo

Solução de problemas de conectores no Jitterbit Studio

Este guia cobre erros e comportamentos inesperados específicos de conectores individuais do Jitterbit Studio, organizados por conector. Lista apenas conectores com problemas conhecidos e específicos do conector a documentar, não todos os conectores disponíveis. Para a lista completa de conectores, consulte Conectores. Comece com as etapas de diagnóstico abaixo e depois localize seu conector na seção relevante.

Para problemas não específicos de um conector, como uma operação que não é executada ou um problema com uma transformação, script ou função, consulte Solução de problemas de operação. Para problemas com agentes privados, como um agente offline, insalubre ou lento (o que pode impedir que operações sejam executadas), consulte Solução de problemas de agentes privados.

Para uma referência unificada que abrange integração, automação, gerenciamento de API, EDI e problemas de desenvolvimento de aplicativos em um único lugar, consulte o guia de solução de problemas do Harmony.

Todas as entradas de solução de problemas nesta página

Etapas de diagnóstico

Essas etapas aplicam-se à maioria das falhas relacionadas a conectores e são o ponto de partida recomendado antes de investigar um erro de conector específico.

Teste a conexão

Na configuração da conexão, clique no botão Testar para confirmar que a conexão é bem-sucedida. Clicar em Testar também faz download da versão mais recente do conector para o agente, a menos que a política de organização Desativar Atualização Automática de Conector esteja ativada.

Atualize os metadados da conexão e esquemas de atividade

Muitos problemas de conectores, como objetos ausentes, uma lista de campos desatualizada ou um esquema que não corresponde mais ao endpoint, são causados por metadados em cache. Após qualquer alteração no lado do endpoint (novos campos, mudança de versão da API ou alteração de permissão), reabra a atividade afetada e clique no ícone de atualização (Atualizar) para recarregar objetos e esquemas do endpoint.

Confirme a disponibilidade do conector e mantenha-o atualizado

A coluna Disponibilidade do agente na lista de Conectores mostra se um conector requer um agente privado.

Os conectores são lançados e atualizados conforme a agenda de lançamentos do Jitterbit, separadamente do agente. Em agentes privados, testar uma conexão baixa a versão mais recente do conector (consulte Testar a conexão acima), a menos que a política da organização Desabilitar atualização automática de conectores esteja ativada. Para atualizar os conectores de um grupo de agentes a qualquer momento, inclusive quando essa política está ativada, selecione Ação > Atualizar conectores para o grupo na página Agentes do Console de gerenciamento.

Ative o log detalhado do conector

Quando orientado pelo suporte do Jitterbit, ative o log detalhado do conector no agente privado para capturar detalhes em nível de conector, reproduza o problema e analise os logs. O log detalhado usa uma entrada de logger específica do conector; a linha exata a ser adicionada ao logback.xml é fornecida na seção Troubleshooting da página de documentação do próprio conector, em Conectores.


Configuração de conexão

Propriedades de configurações avançadas: variáveis contendo JSON bruto devem ser escapadas

  • Sintoma: Muitos conectores incluem uma tabela de Propriedades de configurações avançadas para configurações de conexão opcionais. Variáveis usadas nesses campos que contêm JSON bruto devem ter o JSON escapado; passar JSON bruto não escapado por meio de uma variável causa deformação do valor do campo.
  • Possível causa: Os campos na tabela de Propriedades de configurações avançadas não suportam variáveis que contenham objetos JSON não escapados.
  • Resolução:
    • Antes de passar conteúdo JSON por meio de uma variável para um campo de Propriedades de configurações avançadas, escape o JSON. Por exemplo, {"success": "true"} deve ser escapado como {\"success\": \"true\"} antes de ser atribuído à variável.
    • Se você estiver inserindo o valor de JSON diretamente no campo (não por meio de uma variável), o escape não é necessário.
    • Variáveis em campos de Propriedades de configurações avançadas são preenchidas em tempo de execução apenas na versão do agente 10.75 / 11.13 ou posterior. Se um valor de variável não aparecer em tempo de execução, confirme se o agente atende a essa versão mínima.

Conector Amazon Bedrock

Amazon Bedrock: erro de modelo "throughput sob demanda não é suportado"

  • Sintoma: Uma atividade do Amazon Bedrock falha com:

    Invocation of model ID <model-name> with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.
    
  • Possível causa: Alguns modelos, incluindo os modelos GPT-5.6 do OpenAI, não suportam throughput sob demanda e requerem a ID de um perfil de inferência entre regiões em vez da ID do modelo retornada na lista Selecionar um modelo da atividade.

  • Resolução:
    1. No Console de gerenciamento da AWS, acesse Amazon Bedrock > Perfis de inferência e localize a ID do perfil de inferência para o modelo. Por exemplo, a ID do perfil de inferência para anthropic.claude-3-5-haiku-20241022-v1:0 nos EUA é us.anthropic.claude-3-5-haiku-20241022-v1:0. Para os modelos GPT-5.6 do OpenAI, os prefixos de ID de perfil de inferência válidos variam por modelo e região (por exemplo, us. ou global.), como us.openai.gpt-5.6-terra ou global.openai.gpt-5.6-terra. Para a ID de perfil de inferência exata para seu modelo e região, consulte os cartões de modelo da AWS para GPT-5.6 Sol, GPT-5.6 Terra e GPT-5.6 Luna.
    2. Insira a ID do perfil de inferência usando a opção Inserir identificador de modelo na configuração da atividade.

Conector Cloud Datastore

A atividade Query Items não retorna todos os registros correspondentes ao filtrar em múltiplos valores do mesmo campo

  • Sintoma: uma atividade Query Items usada para procurar vários registros específicos de uma vez (por exemplo, por uma lista de valores de Key) retorna apenas um registro, embora todos os registros existam no armazenamento e possam ser confirmados na página Cloud Datastore do Console de Gerenciamento.
  • Causa possível: o filtro da consulta combina múltiplas condições no mesmo campo (por exemplo, vários valores de Key diferentes em um único filtro). As condições de filtro do Cloud Datastore podem ser combinadas apenas quando cada condição especifica um campo diferente; um filtro não pode especificar o mesmo campo mais de uma vez, e não é possível aplicar mais de uma condição ou operador ao mesmo campo.
  • Resolução: emita uma chamada Query Items separada para cada valor em vez de combinar múltiplos valores do mesmo campo em um único filtro. Para detalhes sobre as condições de filtro suportadas, consulte Atividade Query Items.

A atividade Delete Items relata sucesso, mas não deleta o registro

  • Sintoma: uma atividade Delete Items do Cloud Datastore relata sucesso no log de operações, mas o registro de destino ainda existe quando consultado posteriormente.
  • Causa possível: Delete Items identifica registros pelo valor de Key (ou Alternative Key) do armazenamento, fornecido no array keys ou ids da solicitação. (Ambos os arrays aceitam valores de key ou alternative key.) Se o ID interno do registro for fornecido em vez de seu valor de key, nenhum item corresponderá, e a atividade relatará sucesso sem deletar nada.
  • Resolução:
    • Na transformação que prepara a solicitação de Delete Items, mapeie o valor de Key (ou Alternative Key) do armazenamento, não o ID interno do registro.
    • Ao encadear a partir de uma atividade Query Items, mapeie o valor de key da resposta da consulta para a solicitação de exclusão.

Conector Coupa

Coupa: autenticação por chave de API retorna 403 Forbidden

  • Sintoma: uma operação do conector Coupa falha com um erro Forbidden (403) ao usar autenticação por chave de API.
  • Causa possível: a partir da versão R35 do Coupa (janeiro de 2023), as chaves de API do Coupa foram descontinuadas e não são mais suportadas para autenticação. Conexões configuradas para usar autenticação por chave de API recebem um erro 403.
  • Resolução:
    1. Na configuração da conexão Coupa, alterne da autenticação por chave de API para autenticação OAuth 2.0.
    2. Na sua instância do Coupa, crie uma aplicação cliente OAuth 2.0 e obtenha as credenciais do cliente.
    3. Atualize a configuração da conexão com as credenciais OAuth 2.0, salve e teste novamente.

Conector de banco de dados

Banco de dados (JDBC): DBLookup ou DBExecute falha com erro de decodificação Base64

  • Sintoma: Uma função DBLookup ou DBExecute direcionada a um banco de dados PostgreSQL ou SQL Server por meio de um driver JDBC falha em tempo de execução com:

    Base64 decoding failed. Reason: error:00000000:lib(0)::reason(0)
    

    Isso ocorre sempre que o valor retornado se parece com dados codificados em Base64, como um JWT ou outro token de acesso, mesmo que a mesma consulta tenha êxito quando executada diretamente no banco de dados.

  • Possível causa: Versões do agente anteriores à 12.9 podem tentar incorretamente decodificar em Base64 um valor de resultado JDBC que corresponda a um padrão semelhante a Base64, independentemente de o valor ser realmente dados codificados em Base64.

  • Resolução:

    • Para agentes privados, atualize para a versão 12.9 ou posterior. Os agentes em nuvem recebem a atualização automaticamente.
    • Se não conseguir atualizar imediatamente, evite ativar a verificação de Base64 convertendo o valor afetado para hexadecimal na consulta SQL e depois decodificando-o em uma etapa de script usando HexToString. Por exemplo, no PostgreSQL: SELECT encode(<column>, 'hex'). Use a função SQL equivalente decode(...,'hex') com StringToHex ao escrever o valor novamente no banco de dados.

Banco de dados (ODBC): Caracteres multibyte não são tratados corretamente

  • Sintoma: Ao ler ou escrever em um banco de dados por meio do conector de banco de dados usando um driver ODBC, caracteres multibyte ou não ASCII (por exemplo, caracteres acentuados ou não latinos) não são tratados corretamente.
  • Possível causa: O suporte a caracteres multibyte para o conector de banco de dados por meio de um driver ODBC não está habilitado por padrão. A variável Jitterbit jitterbit.scripting.db.multibyte.enable deve ser definida como true. Esse suporte está disponível na versão 12.6 do agente e posterior e não é necessário ao usar um driver JDBC.
  • Resolução:

    1. Confirme se o agente é versão 12.6 ou posterior.
    2. Defina a variável jitterbit.scripting.db.multibyte.enable como true antes da operação de banco de dados ser executada. Por exemplo, em uma etapa de script:

      $jitterbit.scripting.db.multibyte.enable = true;
      

    Como alternativa, use um driver JDBC para a conexão do banco de dados, que trata caracteres multibyte sem essa variável.

Banco de dados: Conexão bloqueada pela política de segurança

  • Sintoma: O teste de conexão do conector de banco de dados falha com:

    HttpErrorResponse: The database connection could not be established due to a security policy violation.
    

    com uma linha de detalhes nomeando uma conexão de loopback:

    Details: java.lang.IllegalArgumentException - JDBC connections to loopback addresses are not permitted.
    

    ou um parâmetro de string de conexão específico:

    Details: java.lang.IllegalArgumentException - JDBC connection parameter 'allowmultiqueries' cannot be enabled.
    
  • Possível causa: A versão 12.10 do agente e posteriores restringem certas conexões de banco de dados e parâmetros de string de conexão por padrão, por motivos de segurança. Isso inclui conexões para localhost ou 127.0.0.1 e parâmetros de string de conexão específicos para os drivers MySQL, PostgreSQL, Oracle e SQL Server. Uma conexão que funcionava antes pode falhar após atualizar um agente privado para a versão 12.10, pois a restrição se aplica por padrão mesmo que a seção [JdbcSecurity] não seja adicionada automaticamente a um arquivo jitterbit.conf existente.

  • Resolução: Em um agente privado, configure a seção [JdbcSecurity] do arquivo de configuração do agente (jitterbit.conf) para permitir a conexão específica ou o parâmetro necessário e reinicie o agente.

Banco de dados: Timeouts de conexão sob carga

  • Sintoma: Operações de origem ou destino do banco de dados falham intermitentemente sob carga concorrente pesada, com uma exceção similar a:

    java.sql.SQLException: Network error IOException: Connection timed out
    Caused by: java.net.ConnectException: Connection timed out
    
  • Possível causa: Cada operação de banco de dados abre uma nova conexão JDBC física e a fecha em seguida, em vez de reutilizar uma existente. Sob carga concorrente, isso cria movimento de conexão suficiente no banco de dados de destino para que algumas tentativas de conexão atinjam o timeout.

  • Resolução: A versão 12.11 do agente e posteriores podem agrupar e reutilizar conexões em vez de abrir e fechar uma para cada operação, reduzindo esse movimento. Em um agente privado, defina jdbc.hikari.enabled=true na seção [SourceTargetPooling] do arquivo de configuração do agente (jitterbit.conf) e reinicie o agente.

Banco de dados: Erros de comprimento de campo em Insert, Update ou Upsert

  • Sintoma: Uma atividade Insert, Update ou Upsert do Banco de dados falha com um status de operação Error quando um valor de origem mapeado é mais longo do que o permitido pela coluna de destino. O log de operação contém um dos seguintes:

    One or more values were truncated when inserting and/or updating the field
    
    Field value too long
    FieldName: m_site  Length: 3  Length Allowed: 1
    
  • Possível causa: Por padrão, se um valor de origem mapeado exceder o comprimento definido da coluna de destino, a atividade rejeita a linha e relata um status Error em vez de truncar o valor.

  • Resolução:
    1. Na configuração da atividade Insert, Update ou Upsert do Banco de dados, ative Allow truncation of character fields to avoid field length errors. Com essa opção ativada, valores que excedem o comprimento do campo de destino são truncados e a operação relata um status Success with Info em vez de um status Error.
    2. Se o truncamento não for aceitável, ajuste ou transforme o campo de origem no mapeamento de transformação para que os valores nunca excedam o comprimento da coluna de destino, ou aumente a coluna de destino no lado do banco de dados.
    3. Reimplante e execute novamente a operação.

Banco de dados: JAR do driver JDBC sobrescrito em atualizações do agente

  • Sintoma: Arquivos JAR do driver JDBC customizado instalados para o conector de Banco de dados são deletados ou sobrescritos quando o agente é atualizado.
  • Possível causa: Apenas o diretório <JITTERBIT_HOME>/tomcat/drivers/lib/ é preservado entre atualizações de agente. Arquivos JAR de driver customizado colocados em outro lugar nos diretórios do agente fazem parte da implantação gerenciada e podem ser removidos ou sobrescritos durante uma atualização.
  • Resolução:
    • Coloque arquivos JAR do driver JDBC customizado em <JITTERBIT_HOME>/tomcat/drivers/lib/. Este diretório é preservado durante atualizações de agente.
    • Se os drivers estão atualmente no local errado, mova-os para o diretório correto e reinicie o agente.

Banco de dados: Caracteres especiais em nomes de colunas causam falhas de consulta

  • Sintoma: Consultas de Banco de dados ou transformações falham quando uma tabela de origem tem nomes de colunas que contêm caracteres especiais como @.
  • Possível causa: Os drivers ODBC não conseguem lidar com certos caracteres especiais em nomes de colunas de banco de dados.
  • Resolução:
    1. Crie uma visualização de banco de dados na tabela física que exponha a coluna afetada sob um nome que não contenha caracteres especiais.
    2. Aponte a atividade de Banco de dados para a visualização em vez da tabela original.

Banco de dados: Instrução SQL excede limite de 2.000 caracteres

  • Sintoma: Uma atividade Consulta de Banco de dados falha ou é truncada quando a instrução SQL configurada é muito longa.
  • Possível causa: O campo de instrução SQL em uma atividade Consulta de Banco de dados aceita um máximo de 2.000 caracteres.
  • Resolução:
    1. Crie uma visualização de banco de dados que encapsule a lógica de consulta complexa.
    2. Referencie o nome da visualização na atividade Consulta em vez da instrução SQL completa.

IBM DB2 em iSeries: Conexão JDBC falha

  • Sintoma: Uma conexão de Banco de dados para IBM DB2 em iSeries (AS/400 ou IBM i) usando um driver JDBC falha ao conectar.
  • Possível causa: Algumas conexões com DB2 em iSeries usando um driver JDBC enfrentam problemas que não ocorrem com um driver ODBC.
  • Resolução: Altere a conexão para usar um driver ODBC em vez de JDBC. Conexões ODBC são suportadas apenas em agentes privados.

IBM DB2: Configuração do driver JDBC JCC (arquivo JAR e de licença obsoletos)

  • Sintoma: Uma conexão de Banco de dados usando o driver JDBC JCC do IBM DB2 falha com um erro referenciando uma licença ausente, ou falha ou produz erros de compatibilidade com versões mais recentes do DB2.
  • Possíveis causas:
    • O arquivo de driver db2jcc.jar implementa a especificação JDBC 3 obsoleta. O atual db2jcc4.jar implementa JDBC 4, que versões mais recentes do DB2 exigem.
    • O driver JCC requer um arquivo JAR de licença separado. O arquivo JAR do driver sozinho não é suficiente.
  • Resolução:
    • Use o driver db2jcc4.jar, não o obsoleto db2jcc.jar. Instale-o em <JITTERBIT_HOME>/tomcat/drivers/lib/ no agente privado.
    • Obtenha o arquivo JAR de licença da IBM (chamado db2jcc_license_cisuz-XX.jar, onde XX é o número da versão) e copie-o para <JITTERBIT_HOME>/tomcat/shared/lib/.
    • Alternativamente, use a biblioteca de código aberto JTOpen (também conhecida como driver AS400), que não requer o driver JCC nem um arquivo de licença.

Kerberos: "Could not initialize class KerbAuthentication"

  • Sintoma: Uma conexão de Banco de dados usando autenticação Kerberos falha com:

    Could not initialize class com.microsoft.sqlserver.jdbc.KerbAuthentication
    
  • Possível causa: Os arquivos de configuração Kerberos no host do agente não têm as permissões de arquivo corretas.

  • Resolução:
    1. No host do agente privado, defina as permissões de arquivo nos arquivos de configuração Kerberos (jaas.conf, krb5.conf e o arquivo de cache de tíquete Kerberos) como 644:
chmod 644 jaas.conf krb5.conf krb5cc_agent
  1. Reinicie o agente após aplicar as alterações de permissão.

Kerberos: Erros JGSS ou GSS durante teste de conexão

  • Sintoma: Uma conexão de Database usando autenticação Kerberos falha com erros referenciando jgss ou gss.
  • Possível causa: A JVM está configurada com -Dsun.security.jgss.native=true, o que a direciona a usar a biblioteca GSSAPI nativa do SO. Em alguns sistemas, isso entra em conflito com a configuração do Kerberos.
  • Resolução:
    1. Remova o parâmetro -Dsun.security.jgss.native=true dos argumentos JVM do agente.
    2. Em krb5.conf, adicione udp_preference_limit = 1 na seção [libdefaults] para forçar TCP em vez de UDP para o tráfego Kerberos.
    3. Reinicie o agente.

Microsoft Excel: "Operation must use an updateable query"

  • Sintoma: Uma atividade de Insert ou Update de Database destinada a um arquivo Microsoft Excel (via ODBC) falha com:

    [Microsoft][ODBC Excel Driver] Operation must use an updateable query
    
  • Possível causa: O driver ODBC do Excel abre o arquivo do Excel em modo somente leitura por padrão, a menos que a string de conexão defina explicitamente o modo leitura/escrita.

  • Resolução: No campo Connection String da conexão de Database (inserido em Optional Settings com Use Connection String selecionado), acrescente ReadOnly=0; ao final da string de conexão para abrir o arquivo do Excel em modo leitura/escrita.

MySQL: Acesso negado apesar de credenciais corretas

  • Sintoma: A conexão com um banco de dados MySQL usando o Database connector falha com:

    Access denied for user 'root'@'%' to database 'test'
    

    mesmo quando o nome de usuário e a senha estão corretos.

  • Possível causa: O MySQL pode conceder permissões diferentes com base no endereço IP do cliente. Uma conta de usuário pode ter os privilégios necessários de endereços IP específicos, mas não do endereço IP do agente privado.

  • Resolução:

    • No MySQL, verifique se a conta de usuário tem as concessões necessárias para conexões do endereço IP do agente privado. A sintaxe exata de concessão varia conforme a versão do MySQL (consulte a documentação do MySQL ou entre em contato com seu administrador de MySQL), mas geralmente tem a forma:

      GRANT ALL ON database.* TO 'user'@'agent-ip';
      
    • Teste a conectividade usando um cliente MySQL instalado diretamente no host do agente para isolar se o problema é baseado em rede ou específico do Jitterbit.

MySQL: Enable Batch não melhora o desempenho de Insert ou Update

  • Sintoma: Uma atividade de Insert ou Update de Database usando o driver JDBC do MySQL mostra pouca ou nenhuma melhoria de desempenho após habilitar Enable Batch, mesmo com um grande número de registros.
  • Possível causa: Por padrão, o driver JDBC do MySQL (Connector/J) envia uma instrução por linha independentemente de Enable Batch, em vez de um verdadeiro lote no servidor.
  • Resolução: No campo Additional Connection String Parameters da conexão, adicione rewriteBatchedStatements=true.

MySQL: driver ODBC não listado no menu suspenso do Studio

  • Sintoma: ao configurar uma conexão Banco de dados com MySQL usando um driver ODBC em um agente privado, o driver instalado não aparece no menu suspenso Driver no Studio.
  • Causa possível: o gerenciador ODBC no host do agente privado não está exibindo o driver, geralmente devido a uma incompatibilidade entre 32 bits e 64 bits ou a uma instalação incompleta do driver.
  • Resolução:
    • No host do agente privado (Windows), abra Fontes de Dados (ODBC) (em Ferramentas Administrativas) e confirme se o driver MySQL ODBC está listado. Para opções de driver MySQL, consulte Conectar ao MySQL.
    • Confirme se o agente está se conectando à máquina correta: o driver ODBC deve estar instalado no host do agente, não na máquina do usuário do Studio.

PostgreSQL: erro de incompatibilidade de codificação do cliente

  • Sintoma: um teste de conexão do conector Banco de dados com PostgreSQL falha com um erro de "incompatibilidade de codificação do cliente".
  • Causa possível: a codificação que o servidor PostgreSQL usa difere da codificação padrão assumida pelo driver ODBC do PostgreSQL.
  • Resolução:
    • Nas configurações de conexão do Banco de dados, adicione ConnSettings=SET CLIENT_ENCODING to 'LATIN1' (substituindo a codificação real do servidor) ao campo Parâmetros adicionais da string de conexão.
    • No Windows, se o servidor usar uma codificação Cirílica, como WIN1251, também defina a codificação do cliente como WIN1251 nas configurações do driver ODBC.

PostgreSQL: use o driver fornecido pela Jitterbit no Linux

  • Sintoma: operações usando o conector Banco de dados para conexão com PostgreSQL de um agente privado Linux falham ou produzem erros, mesmo quando aparentemente existe um driver instalado.
  • Causa possível: muitas distribuições Linux incluem um driver ODBC do PostgreSQL empacotado com unixODBC que não funciona de forma confiável com o Harmony.
  • Resolução: não use o driver PostgreSQL empacotado pela distribuição. Use o driver ODBC do PostgreSQL incluído na instalação do agente Jitterbit.

SQL Server JDBC: falha na autenticação integrada do Windows

  • Sintoma: para agentes privados, uma conexão Banco de dados com SQL Server usando um driver JDBC e autenticação integrada do Windows falha com:

    This driver is not configured for integrated authentication. ClientConnectionId:...
    

    Com o driver MS JDBC do SQL Server, os logs do agente também podem exibir:

    java.lang.UnsatisfiedLinkError: no mssql-jdbc_auth-8.2.0.x64 in java.library.path
    
  • Causas possíveis:

    • Usando o driver SQL Server jTDS: o arquivo ntlmauth.dll necessário para autenticação integrada do Windows está ausente do diretório JRE que o agente Jitterbit usa no tempo de execução.
    • Usando o driver MS JDBC do SQL Server ou um driver JDBC mais recente da Microsoft para SQL Server: a DLL mssql-jdbc_auth necessária para autenticação integrada do Windows está ausente dos diretórios JRE que o agente Jitterbit usa no tempo de execução. Colocar a DLL no mesmo diretório que o arquivo JDBC JAR não é suficiente.
    • A string de conexão não inclui os parâmetros necessários para o driver.
  • Resolução: Escolha a opção que corresponde ao seu driver JDBC:
    • SQL Server jTDS:
      1. No host do agente privado, copie ntlmauth.dll (da pasta x64/SSO do pacote de download do projeto jTDS) para <JITTERBIT_HOME>/jre/bin.
      2. Nas configurações de conexão do banco de dados, adicione integratedSecurity=true ao campo Parâmetros Adicionais de String de Conexão.
      3. Reinicie o serviço do agente Jitterbit.
    • SQL Server MS JDBC ou um driver JDBC mais recente da Microsoft para SQL Server:
      1. No host do agente privado, copie mssql-jdbc_auth-x.x.x.x64.dll (da distribuição do driver JDBC, usando a versão que corresponde ao arquivo JDBC JAR incluído no seu agente) para <JITTERBIT_HOME>/jre/bin e <JITTERBIT_HOME>/jre/lib. Faça backup do arquivo, pois ele pode ser removido durante atualizações principais do agente.
      2. Nas configurações de conexão do banco de dados, adicione integratedSecurity=true;trustServerCertificate=true ao campo Parâmetros Adicionais de String de Conexão.
      3. Reinicie o serviço do agente Jitterbit.

Autenticação do Windows do SQL Server: Privilégios insuficientes

  • Sintoma: Uma conexão de Banco de Dados usando autenticação do Windows do SQL Server falha mesmo quando as credenciais de domínio parecem corretas.
  • Causa possível: O usuário de domínio do Windows que executa o serviço do agente Jitterbit não possui os privilégios de nível do SO necessários para a Segurança Integrada do Windows.
  • Resolução:
    1. Conceda ao usuário de domínio os privilégios do Windows Fazer logon como um serviço e Agir como parte do sistema operacional no host do agente privado.
    2. Confirme que o usuário de domínio tem permissões de leitura e escrita no diretório de instalação do agente Jitterbit.
    3. Reinicie o serviço do agente Jitterbit após aplicar as alterações de privilégios.

SQL Server: "Não é possível inserir valor explícito para coluna de identidade" ao inserir em uma coluna de identidade

  • Sintoma: Uma operação de conector de Banco de Dados que escreve em uma tabela do SQL Server com uma coluna de identidade falha com:

    Database Error: Cannot insert explicit value for identity column in table '<table>' when IDENTITY_INSERT is set to OFF.
    
  • Causa possível: A coluna de identidade está incluída na instrução INSERT que o conector de Banco de Dados gera para o destino. O SQL Server rejeita um INSERT que referencia uma coluna de identidade em sua lista de colunas (com um valor explícito ou nulo) enquanto IDENTITY_INSERT está definido como OFF. Mapear o campo para um valor nulo não o exclui: um campo de destino é omitido do INSERT apenas quando é mapeado com a função Unmap.

  • Resolução:

    • Para permitir que o SQL Server atribua o valor de identidade automaticamente, exclua a coluna do INSERT mapeando o campo de destino de identidade com a função Unmap. Para excluir a coluna apenas quando a origem não fornece um valor, use um mapeamento condicional:

      If($source.id != "", $source.id, Unmap())
      

      Quando a condição for falsa, Unmap remove a coluna do INSERT e o SQL Server atribui o próximo valor de identidade. (Fornecer um valor explícito na ramificação verdadeira ainda exige que IDENTITY_INSERT esteja ON; veja a próxima opção.)

    • Se for necessário inserir valores explícitos na coluna de identidade, defina IDENTITY_INSERT na tabela de destino em scripts pré e pós-SQL na atividade:

SET IDENTITY_INSERT <table> ON;
SET IDENTITY_INSERT <table> OFF;

Use esta opção apenas quando você quiser controlar intencionalmente valores de identidade fora do banco de dados. Permite que valores explícitos sejam inseridos na coluna de identidade.

SQL Server: Falha na conexão com erro de certificado PKIX

  • Sintoma: Uma conexão de Banco de Dados com SQL Server falha com:

    "encrypt" property is set to "true" and "trustServerCertificate" property is set to "false" but the driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption: Error: (certificate_unknown) PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.
    

    Uma conexão que funcionava anteriormente pode começar a falhar após uma atualização do agente para a versão 12.8 ou posterior.

  • Possível causa: As versões atuais do driver SQL Server MS JDBC solicitam uma conexão criptografada por padrão e validam o certificado que o servidor de banco de dados apresenta. A conexão falha quando esse certificado não pode ser rastreado até uma autoridade de certificação (CA) que o agente já confia, como um certificado auto-assinado, um certificado emitido internamente ou o certificado CA do Amazon RDS que uma instância do Amazon RDS para SQL Server apresenta. Esta é uma falha de confiança de certificado em vez de criptografia, portanto um banco de dados pode ter criptografia habilitada e um certificado válido instalado e ainda assim falhar. A versão 12.8 do agente atualizou o driver agrupado para uma versão que solicita criptografia por padrão, portanto uma conexão configurada antes dessa atualização pode falhar depois.

  • Resolução: Insira encrypt=false; no campo Parâmetros Adicionais da String de Conexão em Configurações Opcionais da conexão Banco de Dados, ou inclua em uma string de conexão manual. Funciona em agentes na nuvem e privados. Para mais informações, consulte Criptografia de conexão e certificados do servidor.

    Aviso

    Com encrypt=false, os dados viajam entre o agente e o banco de dados sem criptografia. Use esta opção apenas onde isso for aceitável para os dados e o caminho de rede envolvido.


Conector EDI for Cloud v2

As entradas de solução de problemas do conector EDI for Cloud v2 estão documentadas no guia Solução de problemas de EDI, juntamente com problemas de Jitterbit EDI. As entradas relevantes incluem:


Conector de Email

Teste de conexão do Gmail falha com erro de autenticação

  • Sintoma: Um teste de conexão para uma conta do Gmail usando Autenticação Básica falha com um erro de autenticação, mesmo quando a senha correta da conta do Google é inserida.
  • Possível causa: Google requer uma senha de aplicativo para contas com Verificação em 2 Etapas habilitada. A senha da conta do Google não é aceita por SMTP ou IMAP quando a Verificação em 2 Etapas está ativa; apenas senhas de aplicativo são aceitas.
  • Resolução:
    1. Na sua conta do Google, gere uma senha de aplicativo para a aplicação Jitterbit (consulte a página Conectar com senhas de aplicativo do Google).
    2. Na configuração de conexão de Email no Studio, insira a senha de aplicativo no campo Senha SMTP e/ou Senha IMAP em vez da senha da conta do Google.

A assinatura S/MIME falha ou é rejeitada por provedores de email em nuvem

  • Sintoma: Emails configurados com assinatura S/MIME falham ao enviar, são rejeitados pelo servidor do destinatário ou chegam sem assinatura ao usar um provedor de email em nuvem como Microsoft 365 ou Exchange Online.
  • Possíveis causas:
    • Provedores de nuvem exigem um certificado S/MIME emitido por uma autoridade de certificação (AC) confiável. Certificados autoassinados não são aceitos por provedores de nuvem como Microsoft 365 (Exchange Online).
    • S/MIME funciona apenas ao usar agentes privados. Se a operação for executada em um agente em nuvem, a assinatura S/MIME não se aplica, independentemente do tipo de certificado.
  • Resolução:
    1. Obtenha um certificado S/MIME de uma AC confiável. Let's Encrypt fornece certificados gratuitos aceitos pelos principais provedores de nuvem.
    2. Substitua o certificado autoassinado na atividade Enviar Email do Email pelo certificado emitido pela AC (consulte Pré-requisitos para criptografia S/MIME).
    3. Para agentes privados, confirme que o certificado foi importado corretamente no armazenamento de confiança padrão do agente. Para agentes em nuvem, a assinatura S/MIME não é suportada.

A conexão de Email do Microsoft 365 usando autenticação ROPC falha quando MFA está ativado

  • Sintoma: Uma conexão OAuth 2.0 do Microsoft 365 que usa a concessão de Credenciais do Proprietário do Recurso (ROPC) falha na autenticação, mesmo quando o nome de usuário, senha, ID do cliente, ID do locatário e segredo do cliente estão todos corretos.
  • Possível causa: A autenticação ROPC exige que a autenticação multifator (MFA) seja desativada para as credenciais do Microsoft 365 usadas com o conector. A concessão ROPC não consegue satisfazer um desafio de MFA, portanto a solicitação de token falha quando uma política de MFA se aplica à conta.
  • Resolução:
    • Use uma conta do Microsoft 365 cujas credenciais não estejam sujeitas a uma política de MFA. Para manter a segurança, crie um locatário ou diretório dedicado do Microsoft Entra ID que não imponha MFA, conforme descrito em Pré-requisitos para Microsoft 365.
    • Se o MFA não puder ser removido da conta, use um método de autenticação diferente e suportado para a conexão em vez do ROPC.

O envio de Email falha quando o mesmo endereço aparece em múltiplos campos de destinatário

  • Sintoma: Uma atividade Enviar Email do Email falha em tempo de execução quando o mesmo endereço de email está presente em mais de um dos campos Para, CC ou BCC.
  • Possível causa: O conector de Email não permite que o mesmo endereço apareça em múltiplos campos de destinatário em uma única solicitação de envio. Isso se aplica a endereços configurados diretamente na atividade e a endereços fornecidos dinamicamente através de um mapeamento de transformação.
  • Resolução:
    • Revise os campos Para, CC e BCC na configuração da atividade e em qualquer mapeamento de transformação da atividade para confirmar que nenhum endereço aparece em mais de um campo.
    • Se listas de destinatários forem montadas dinamicamente usando variáveis ou scripts, adicione uma verificação de deduplicação antes de passar os endereços para a atividade.

Conectores Epicor

Epicor Prophet 21: Operação falha em tempo de execução com múltiplas condições de filtro

  • Sintoma: Uma atividade Query do Epicor Prophet 21 falha em tempo de execução quando a Filter String contém mais de uma condição de filtro, mesmo que a atividade pareça válida no Studio.
  • Possível causa: Uma limitação na API do Epicor Prophet 21 Middleware impede que múltiplas condições de filtro sejam processadas. A operação parece válida no Studio, mas falha em tempo de execução quando mais de um filtro está presente.
  • Resolução:
    • Reduza a Filter String para uma única condição de filtro.
    • Se múltiplas condições de filtro forem necessárias, recupere um conjunto de resultados mais amplo usando um único filtro e aplique a filtragem adicional em uma etapa de transformação ou script após a atividade.

Conectores de arquivo

FTP, Compartilhamento de Arquivo e Armazenamento Local: "Nenhum arquivo corresponde ao filtro de arquivo" em etapas de arquivamento ou acompanhamento

  • Sintoma: Uma atividade de leitura do FTP, Compartilhamento de Arquivo ou Armazenamento Local falha porque o arquivo que se espera ler não está mais no caminho de origem:

    Failed to read file from the source "Read". Reason: No files match the file filter "<filter>".
    

    A atividade que processou anteriormente o arquivo foi bem-sucedida; a falha ocorre em uma etapa posterior (frequentemente uma etapa de arquivamento ou notificação) que tenta ler o mesmo arquivo com o mesmo filtro.

  • Possíveis causas:

    • A atividade de processamento já moveu ou deletou o arquivo de origem como parte de seu comportamento After Processing, portanto a etapa de arquivamento não tem nada para corresponder.
    • Uma operação filha é iniciada de forma assíncrona e a operação pai tenta ler o arquivo de saída da filha antes de ela ter terminado de gravá-lo.
    • Uma atividade FTP Write com Use FTP Rename habilitado (o padrão) grava o arquivo sob um nome temporário e o renomeia para o nome final após a conclusão. Uma operação de leitura downstream acionada antes da conclusão da renomeação não encontrará o arquivo.
  • Resolução:
    • Confirme se a etapa anterior já tratou o arquivamento por meio de suas opções integradas After Processing (mover, renomear, deletar). Se sim, uma etapa de arquivamento separada é redundante e deve ser removida.
    • Se uma etapa de arquivamento separada for necessária, redesenhe a cadeia de modo que o processamento e o arquivamento aconteçam em relação à mesma referência de arquivo na memória, em vez de fazer uma releitura da origem. Por exemplo, passe o conteúdo lido por Temporary Storage para a etapa de arquivamento, em vez de fazer uma releitura do caminho de origem.
    • Se uma etapa posterior ler a saída produzida por uma operação filha, execute a filha de forma síncrona para que sua saída exista antes da leitura. Defina o Run type da ferramenta Invoke Operation como Synchronously ou, ao chamar a operação a partir de um script, execute RunOperation de forma síncrona (o padrão). Inserir um atraso fixo (por exemplo, com a função Sleep) adiciona latência e não garante que o arquivo esteja pronto.
    • Se uma atividade FTP Write estiver gravando no mesmo local, verifique se Use FTP Rename está habilitado na atividade FTP Write. Se a leitura downstream for acionada antes da conclusão da renomeação, desabilite Use FTP Rename na atividade de gravação ou garanta que a operação de leitura não seja executada até que a operação de gravação tenha sido totalmente concluída.

FTP, Compartilhamento de Arquivos e Armazenamento Local: Pasta de erro não gravada em caso de falha de conexão

  • Sintoma: Após uma atividade de FTP, Compartilhamento de Arquivos ou Armazenamento Local falhar, nenhum arquivo aparece na pasta de erro configurada.
  • Possível causa: A pasta de erro foi projetada para arquivar uma cópia do arquivo de origem após o processamento malsucedido, portanto captura arquivos apenas quando a atividade é executada e depois falha (por exemplo, um erro de permissão de gravação no servidor). Se a conexão com o servidor não puder ser estabelecida, a operação falha antes de a atividade ler qualquer arquivo, portanto não há arquivo para gravar na pasta de erro.
  • Resolução:
    • Se a pasta de erro estiver vazia após uma falha, verifique os logs de operação para um erro no nível de conexão (como falha de autenticação ou mensagem de host inacessível).
    • Use o botão Teste na conexão para confirmar se o problema está no nível de rede ou autenticação.

FTP, Compartilhamento de Arquivos e Armazenamento Local: Palavras-chave de nome de arquivo não resolvidas em caminhos de pasta de sucesso e erro

  • Sintoma: As operações movem arquivos para pastas de sucesso ou erro após o processamento, mas o caminho de destino inclui texto de palavras-chave não expandido em vez de valores resolvidos. A operação pode falhar ou gravar arquivos em locais inesperados.
  • Possíveis causas:
    • Os campos de caminho de pasta de sucesso e pasta de erro em atividades de FTP, Compartilhamento de Arquivos e Armazenamento Local não suportam substituição de palavras-chave de nome de arquivo. As variáveis não são expandidas nesses campos.
    • Esses campos referem-se a diretórios na máquina do agente privado, não no servidor remoto. Caminhos relativos são interpretados em relação ao sistema de arquivos do host do agente.
  • Resolução:
    • Use apenas caminhos literais (sem variáveis de palavras-chave de nome de arquivo) para os campos de pasta de sucesso e erro.
    • Se caminhos dinâmicos forem necessários, adicione uma etapa de script após a atividade para mover ou renomear o arquivo processado para o local pretendido usando funções de arquivo.

FTP, Compartilhamento de Arquivos, Armazenamento Local e Armazenamento Temporário: Gravar Cabeçalhos não produz arquivo somente de cabeçalho quando a origem não retorna registros

  • Sintoma: Uma atividade de gravação baseada em arquivo com a opção Gravar Cabeçalhos ativada (FTP Write, File Share Write, Local Storage Write ou Temporary Storage Write) não grava cabeçalhos quando a origem não retorna registros. Um arquivo vazio é criado ou nenhum arquivo é criado (se Não criar arquivos vazios também estiver selecionado).
  • Causa: Este é o comportamento esperado. Os cabeçalhos são gravados como parte da saída da transformação, e a transformação é executada apenas quando a origem retorna pelo menos um registro. Quando a origem não retorna registros, a transformação é ignorada, portanto nenhuma saída (incluindo cabeçalhos) é gravada e o Studio registra um aviso de que a origem está vazia. Isso não é específico de um conector de origem ou destino de arquivo simples em particular.

FTP: Operação falha após muitos logins rápidos no mesmo servidor

  • Sintoma: Uma operação que usa o conector FTP (em protocolo FTP ou SFTP) que se autentica no mesmo servidor muitas vezes em rápida sucessão (por exemplo, lendo centenas de arquivos pequenos dentro de um loop, ou muitas operações executadas no mesmo servidor conforme programação) eventualmente falha com negação de login ou erro de conexão. A mesma operação funciona sem problemas com carga menor.
  • Possíveis causas:
    • O conector FTP abre e autentica uma nova conexão para cada execução de atividade e a fecha quando a operação termina; uma sessão não é reutilizada entre atividades, entre execuções de operação ou entre projetos. Isso é intencional. Quando muitas operações são executadas no mesmo servidor, por exemplo várias operações programadas ou múltiplos projetos direcionados ao mesmo host, cada execução se autentica independentemente.
    • O servidor remoto está configurado com um número máximo de conexões, autenticações por minuto ou sessões simultâneas por usuário, e a taxa combinada de login do Jitterbit excede esse limite.
  • Resolução:
    • Quando possível, reformule a operação para fazer menos conexões. Substitua uma atividade de Leitura dentro de um loop por uma única atividade de Leitura que use um curinga no campo Obter Arquivos (por exemplo, *.xml ou data_*.csv), depois divida os dados recuperados em registros individuais dentro de uma transformação.
    • Se a operação precisar processar arquivos um de cada vez, peça ao administrador do servidor FTP para aumentar o limite por usuário de conexões simultâneas ou autenticações por minuto.

SFTP "Login denied. Authentication failure." ao usar chaves SSH

  • Sintoma: Uma operação SFTP usando autenticação de chave privada SSH falha com Login denied. Authentication failure., mesmo que as mesmas chaves se autentiquem com sucesso em um cliente SFTP interativo.

    Failed to get ftp directory list for url sftp://example.com:22/. Login denied. Authentication failure.
    
  • Possíveis causas:

    • A chave privada está protegida por uma frase-passe, mas a configuração PrivateKeyPassphrase está faltando na seção [SSH] do arquivo jitterbit.conf do agent.
    • Uma senha está configurada no endpoint FTP junto com a chave privada. A presença de uma senha nas configurações do endpoint interfere com a autenticação baseada em chave.
  • Resolução:

    • Para agents privados, confirme que a seção [SSH] do jitterbit.conf contém o caminho correto de PrivateKeyFile e, se a chave está protegida por frase-passe, o valor correspondente de PrivateKeyPassphrase (consulte Conectando ao SFTP com chaves SSH).
    • Na configuração do endpoint FTP, limpe o campo Senha quando a autenticação for por chave SSH.
    • Confirme que a chave está em um formato que o agent suporta (OpenSSH). Converta a chave com ssh-keygen se estiver em formato PuTTY (.ppk) ou outro formato diferente de OpenSSH.

FTP Write: "Use FTP Rename" falha ao escrever em um servidor SFTP

  • Sintoma: Uma atividade de Escrita FTP configurada com a opção Use FTP Rename falha quando o destino é um servidor SFTP, com um erro semelhante a:

    Failed to put ... to the url ...
    Quote command returned error. Rename command failed: <reason>.
    

    O <reason> geralmente é No such file or directory ou Permission denied para um arquivo cujo nome contém caracteres multibyte.

  • Possíveis causas:

    • Em agents anteriores à versão 11.56, a opção Use FTP Rename não respeitava de forma confiável a etapa de renomeação ao escrever em um servidor SFTP, particularmente em operações de padrão de arquivo.
  • O nome do arquivo contém caracteres multibyte e o servidor SFTP não oferece suporte para renomear arquivos cujos nomes os contêm. A partir da versão 12.8 do agente, o conector FTP pode ler e escrever arquivos com nomes multibyte; porém, com Use FTP Rename o agente carrega o arquivo com um nome temporário (sufixo -jbupload) e depois o renomeia para o nome final, e se o servidor não conseguir renomear o nome multibyte, retorna uma mensagem enganosa de Permission denied. Nomes de arquivo usando apenas caracteres ASCII não são afetados. Esta é uma limitação do servidor SFTP, não do Jitterbit.

  • Resolução:

    • Certifique-se de que o agente está na versão 11.56 ou posterior, onde Use FTP Rename com SFTP funciona conforme esperado. Os agentes na nuvem são atualizados automaticamente; atualize os agentes privados se necessário.

    • Desmarque a caixa de seleção Use FTP Rename na configuração da atividade para que o agente escreva diretamente no caminho de destino em vez de fazer upload para um nome temporário e depois renomear. Isso evita a etapa de renomeação e resolve ambas as causas.

    • Para o caso de caracteres multibyte, alternativamente use um servidor SFTP que ofereça suporte para renomear arquivos cujos nomes contêm caracteres multibyte.

SFTP: Append to file não é suportado

  • Sintoma: Uma atividade de Escrita de FTP configurada com a opção Append To File não acrescenta ao arquivo existente quando o destino é um servidor SFTP.
  • Possível causa: O protocolo SFTP não oferece suporte para acrescentar a arquivos existentes. Esta é uma limitação no nível do protocolo, não um problema de configuração do Jitterbit.
  • Resolução:
    • Use FTP ou FTPS se o comportamento de acréscimo for necessário.
    • Se SFTP for necessário, implemente a lógica de acréscimo manualmente: leia o conteúdo do arquivo existente, combine-o com os novos dados e escreva o resultado completo de volta como um arquivo completo.

FTP: Nomes de arquivo contendo # não são tratados corretamente

  • Sintoma: Uma atividade do conector FTP (sobre o protocolo FTP ou SFTP) falha quando o nome do arquivo de origem ou destino contém um caractere jogo da velha (#). A leitura do arquivo retorna um erro como No File with that name ou Error in SSH Layer, e a escrita do arquivo produz um nome de arquivo truncado.
  • Possível causa: O conector FTP trata o caminho do arquivo como uma URL, na qual o caractere jogo da velha é um delimitador de fragmento reservado. O conector analisa a parte do caminho anterior ao # e descarta o resto.
  • Resolução:
    • Renomeie os arquivos para remover ou substituir o caractere # antes que o Jitterbit os leia ou escreva.
    • Para fazer com que o conector codifique em URL os nomes que contêm caracteres especiais como #, defina jitterbit.source.ftp.encode_url como true em um script de transformação para nomes de arquivo ou pasta de origem, e jitterbit.target.ftp.encode_url como true para arquivos escritos no destino.

File Share: Caminhos UNC com nomes de servidor falham em agentes na nuvem

  • Sintoma: Conexões de File Share que usam caminhos UNC (por exemplo, \\server\share) falham ao conectar quando a operação é executada em um agente na nuvem.
  • Possível causa: Os agentes na nuvem conseguem resolver caminhos UNC usando um endereço IP público, mas não conseguem resolver nomes de host de servidor em caminhos UNC.
  • Resolução:
    • Substitua o nome do servidor no caminho UNC pelo endereço IP público do servidor (por exemplo, \\192.0.2.1\share).
    • Se a resolução de nome do servidor em caminhos UNC for necessária, use um agente privado.

File Share: Arquivos maiores que 2 GB podem falhar na recuperação

  • Sintoma: Uma atividade Ler do File Share pode falhar ao recuperar arquivos individuais maiores que 2 GB. Arquivos menores são recuperados sem problemas.
  • Causa possível: O conector File Share tem uma limitação conhecida com arquivos individuais maiores que 2 GB.
  • Resolução: Nenhuma opção de configuração remove esse limite. Como alternativa, divida o arquivo em segmentos menores na origem para que cada arquivo tenha menos de 2 GB antes da atividade Ler do File Share recuperá-lo.

Armazenamento Local: Não disponível em agentes na nuvem

  • Sintoma: Uma operação usando um conector Armazenamento Local falha quando é executada em um agente na nuvem.
  • Causa possível: O Armazenamento Local acessa o sistema de arquivos da máquina onde o agente está instalado. Os agentes na nuvem são executados em um ambiente hospedado e não expõem um sistema de arquivos local para esse fim.
  • Resolução:
    • Use agentes privados para qualquer operação que exija o conector Armazenamento Local. O Armazenamento Local está desabilitado em agentes privados por padrão, portanto, também o habilite no arquivo de configuração do agente privado (consulte Habilitar local de arquivo).
    • Para fluxos de trabalho do agente na nuvem, substitua o Armazenamento Local por Armazenamento Temporário ou um conector de armazenamento externo (File Share, FTP ou Cloud Datastore).

Armazenamento Temporário: Arquivos ausentes quando lidos por uma operação posterior

  • Sintoma: Arquivos de Armazenamento Temporário gravados por uma operação estão ausentes quando uma operação posterior tenta lê-los.
  • Causas possíveis:
    • O serviço de limpeza do Harmony exclui arquivos do Armazenamento Temporário após 24 horas por padrão.
    • Cada agente em um grupo de agentes tem seu próprio Armazenamento Temporário local. Operações na mesma cadeia de operações têm garantia de serem executadas no mesmo agente, mas uma operação posterior que não esteja na mesma cadeia pode ser distribuída para um agente diferente e acessar uma instância de Armazenamento Temporário diferente, portanto não encontra o arquivo, independentemente da janela de 24 horas. Consulte Notas importantes.
  • Resolução:
    • Vincule operações que devem compartilhar arquivos de Armazenamento Temporário na mesma cadeia de operações usando ações de operação, onde o comportamento do Armazenamento Temporário é consistente e confiável.
    • Para agentes privados, a frequência de limpeza pode ser ajustada na seção [FileCleanup] de jitterbit.conf. Consulte [FileCleanup].
    • Se arquivos não puderem ser consumidos na mesma cadeia ou precisarem persistir por mais de 24 horas, use um conector de armazenamento persistente acessível para todos os agentes (como File Share, FTP ou Cloud Datastore) em vez do Armazenamento Temporário.

Armazenamento Temporário: Caracteres restritos em caminhos de arquivo

  • Sintoma: Uma atividade Ler ou Gravar de Armazenamento Temporário falha quando o caminho do arquivo contém determinados caracteres especiais.
  • Causa possível: Os seguintes caracteres não são suportados em caminhos de arquivo de Armazenamento Temporário: ~, %, $, ", <, >, :, ?
  • Resolução:
    • Remova ou substitua os caracteres não suportados no caminho do arquivo. Os seguintes caracteres são suportados: !, @, #, ^, &, *, (, ), [, ], ', ;
    • Ambas / e \ são aceitas como separadores de caminho.

Armazenamento Temporário: Limite de tamanho de arquivo de 50 GB em agentes de nuvem

  • Sintoma: Uma atividade de Armazenamento Temporário Write falha ao gravar arquivos grandes através de um agente de nuvem.
  • Possível causa: Agentes de nuvem impõem um tamanho máximo de arquivo de 50 GB por arquivo para Armazenamento Temporário.
  • Resolução:
    • Use um agente privado para workflows que precisam gravar arquivos individuais maiores que 50 GB no Armazenamento Temporário.
    • Se apenas agentes de nuvem estiverem disponíveis, divida os grandes conjuntos de dados em múltiplos arquivos menores que 50 GB antes de gravar no Armazenamento Temporário.

Conector HTTP

HTTP v2: Cabeçalho de Autorização duplicado causa erro 400 Bad Request

  • Sintoma: As operações do conector HTTP v2 falham com um erro 400 quando a autenticação em nível de conexão e um cabeçalho de solicitação Authorization definido manualmente estão configurados na mesma conexão ou atividade.
  • Possível causa: Quando a autenticação está configurada em uma conexão HTTP v2 (por exemplo, Basic ou OAuth), o conector adiciona automaticamente um cabeçalho Authorization a cada solicitação. Adicionar um segundo cabeçalho Authorization manualmente resulta em dois cabeçalhos conflitantes, que a maioria dos servidores rejeita com um erro 400.
  • Resolução:
    • Remova qualquer cabeçalho Authorization adicionado manualmente dos cabeçalhos de solicitação na configuração da atividade ou conexão.
    • Use apenas as configurações de autenticação integradas da conexão para lidar com a autorização. Não adicione um cabeçalho Authorization manual junto com autenticação configurada.
    • Se precisar definir o cabeçalho Authorization dinamicamente no nível da atividade, configure o tipo de autenticação da conexão como No Auth e configure o cabeçalho de solicitação Authorization da atividade conforme necessário.

HTTP v2: Valor JSON em uma variável de projeto de cabeçalho de solicitação falha ao analisar

  • Sintoma: Uma atividade de HTTP v2 que lê um valor de cabeçalho de solicitação de uma variável de projeto contendo uma string JSON falha com um erro de análise:

    Expected a ',' or ']' at 139 [character 140 line 1]
    

    O mesmo JSON funciona quando colado diretamente na coluna Value da tabela Request Headers.

  • Possível causa: Quando um valor de cabeçalho de solicitação é lido de uma variável de projeto, o conector HTTP v2 não escapa das aspas incorporadas da mesma forma que faz quando você digita o valor diretamente na tabela Request Headers. As aspas não escapadas quebram a string de cabeçalho antes de chegar ao destino.

  • Resolução:
    • Ao armazenar JSON em uma variável de projeto que será usada como valor de cabeçalho, escape cada aspas duplas com uma barra invertida. Por exemplo, armazene o valor como {\"success\": \"true\"} em vez de {"success": "true"}.
    • Se o conteúdo JSON for estático, cole-o diretamente na coluna Value da tabela Request Headers em vez de usar uma variável. O conector aplica o escape necessário nesse caminho.

HTTP e HTTP v2: URL contém múltiplos caracteres ?

  • Sintoma: Uma operação HTTP ou HTTP v2 falha no sistema de destino. Os logs do agente mostram que a URL da requisição contém mais de um ? entre segmentos, por exemplo https://api.example.com/endpoint?param1=A?param2=B.
  • Causa possível: Parâmetros de query foram declarados em dois lugares: anexados diretamente ao caminho da URL e também adicionados à tabela Request Parameters (Parâmetros de Requisição) da atividade. O conector concatena ambos os conjuntos, inserindo um segundo ? em vez de um &.
  • Resolução:
    • Remova qualquer segmento de string de query do caminho da URL. A URL base deve conter apenas o caminho em si (por exemplo, https://api.example.com/endpoint).
    • Defina cada parâmetro de query na tabela Request Parameters (Parâmetros de Requisição) da atividade. O conector insere os caracteres ? e & automaticamente ao construir a URL final.

HTTP v2: Dupla codificação de URL quando "Encode request URL" está ativada

  • Sintoma: Chamadas de API REST feitas através do conector HTTP v2 falham no sistema de destino porque os parâmetros da URL aparecem duplamente codificados na requisição de saída (por exemplo, um espaço %20 se torna %2520).
  • Causa possível: Quando Encode request URL (Codificar URL da Requisição) está ativada nas configurações de conexão do HTTP v2, o conector codifica a URL inteira antes de enviá-la. Se os parâmetros da URL já contêm caracteres codificados em percentual, esses caracteres são codificados uma segunda vez.
  • Resolução:
    • Desative Encode request URL (Codificar URL da Requisição) nas configurações de conexão do HTTP v2 quando a URL ou os parâmetros já estão codificados ou construídos usando a função URLEncode.
    • Se Encode request URL (Codificar URL da Requisição) deve permanecer ativada, certifique-se de que os parâmetros passados para a URL não sejam pré-codificados antes de chegarem à conexão.

HTTP v2: Operação falha quando Base URL redireciona

  • Sintoma: Uma operação HTTP v2 falha imediatamente quando a Base URL configurada retorna uma resposta de redirecionamento (3xx).
  • Causa possível: Follow redirects (Seguir redirecionamentos) está desativado nas configurações de conexão do HTTP v2, portanto as respostas de redirecionamento são tratadas como falhas em vez de serem seguidas automaticamente.
  • Resolução: Nas configurações de conexão do HTTP v2, ative Follow redirects (Seguir redirecionamentos) para permitir que o conector siga automaticamente as respostas de redirecionamento até a URL de destino final.

HTTP v2: Variáveis no Path da atividade não são resolvidas

  • Sintoma: Uma atividade HTTP v2 usa uma variável global, de projeto ou Jitterbit em seu campo Path (Caminho), mas em tempo de execução a variável é enviada literalmente (não resolvida) em vez de ser substituída por seu valor.
  • Causa possível: Uma URL completa (uma que inclui o protocolo e o host, como https://api.example.com/...) foi inserida no campo Path (Caminho). Variáveis não são suportadas em URLs completas. Elas são resolvidas apenas em um caminho parcial que é anexado à Base URL da conexão.
  • Resolução:
    1. Na conexão HTTP v2, defina a Base URL para a porção de protocolo e host do endpoint (por exemplo, https://api.example.com).
    2. No campo Path (Caminho) da atividade, insira apenas o caminho parcial que segue a URL base e coloque a variável dentro desse caminho parcial (por exemplo, /records/[recordId]). O conector resolve a variável e anexa o resultado à Base URL em tempo de execução.

HTTP v2: Código de status de resposta não disponível em variáveis Jitterbit

  • Sintoma: Scripts que leem variáveis de origem ou destino Jitterbit para capturar o código de status de resposta HTTP após a execução de uma atividade HTTP v2 não recebem valor. A mesma abordagem funciona com o conector HTTP, mas não com HTTP v2.
  • Possível causa: O conector HTTP v2 não popula variáveis origem ou destino Jitterbit. Os dados de resposta, incluindo o código de status HTTP, são retornados através do schema de resposta da atividade.
  • Resolução:
    • Para capturar o código de status usando o schema de resposta padrão, mapeie o campo statusCode, que se encontra sob o nó responseItem/error da resposta e contém o código de status HTTP (por exemplo, 200, 403). Para detalhes sobre a estrutura do schema de resposta, consulte a documentação de configuração da atividade para qualquer atividade HTTP v2.
    • Para capturar o código de status ao usar um schema de resposta personalizado, ative Include Additional Properties from HTTP Response in the Schema na configuração da atividade. Isso envolve o schema com uma estrutura definida por Jitterbit que inclui __jitterbit_api_statuscode__ (o código de status) e __jitterbit_api_errorbody__ (o corpo da resposta para solicitações malsucedidas).
    • Para que o código de status fique disponível quando a API retorna uma resposta malsucedida, ative Ignore operation error in case of non-successful status code nas configurações opcionais da atividade. Sem essa configuração, a operação falha em respostas malsucedidas antes que os dados de resposta possam ser mapeados.

HTTP v2: Namespaces XML reescritos ao usar um schema de solicitação personalizado

  • Sintoma: Uma operação HTTP v2 que envia uma carga XML para um serviço web SOAP ou XML falha com um erro do servidor (como 500 Internal Server Error) mesmo que a mesma carga tenha sucesso quando enviada do Postman ou SoapUI. Ao inspecionar o corpo da solicitação recebido pelo destino, verifica-se que as declarações de namespace XML foram consolidadas no elemento raiz e os prefixos de namespace originais foram substituídos por genéricos (por exemplo, soapenv:Envelope se torna Envelope xmlns="...", e os prefixos de elemento são renumerados como ns, ns1, ns2).
  • Possível causa: Quando um schema de solicitação personalizado é usado na configuração da atividade HTTP v2, a transformação normaliza o XML por padrão, movendo todas as declarações de namespace para o nó raiz e reatribuindo seus prefixos. Serviços SOAP e outros endpoints XML que validam a consistência de prefixos de namespace rejeitam a carga modificada.
  • Resolução:

    • Na versão do agente 12.8 ou posterior, defina jitterbit.target.xml.preserve.namespace.prefix como true em uma etapa de script anterior à transformação, para manter os prefixos de namespace do XML de origem em vez de reatribuir prefixos genéricos:

      $jitterbit.target.xml.preserve.namespace.prefix = true;
      
    • Se seus agentes privados forem anteriores à versão 12.8, ou o destino também rejeitar a consolidação de declarações de namespace no elemento raiz, use o schema de solicitação padrão em vez de um personalizado e mapeie a carga XML completa como string no campo body do schema. A carga é então tratada como string em vez de XML analisado, então suas declarações de namespace são preservadas. O schema de resposta ainda pode ser um schema personalizado.

HTTP v2: Espaços codificados como + em vez de %20

  • Sintoma: Chamadas à API REST usando o conector HTTP v2 falham no sistema de destino porque espaços na URL são codificados como + em vez de %20, causando um erro de recurso não encontrado no destino.
  • Solução:
    • Na conexão HTTP v2, ative a opção Encode request URL. O conector codifica a URL da solicitação em URL, codificando espaços como %20.
    • Forneça a URL da solicitação completamente sem codificação. Não pré-codifique caracteres nem aplique a função URLEncode à URL, porque caracteres já codificados se tornam dupla-codificados quando Encode request URL está ativado (por exemplo, example+string%20value se torna example%20string%2520value).

HTTP: Envia null como a string "null"

  • Sintoma: Uma atividade HTTP POST ou PUT envia campos mapeados com a função Null como a string "null" (ou os omite) em vez de emitir um literal null JSON. Isso ocorre quando o esquema de solicitação é definido na atividade.
  • Causa possível: Quando o esquema de solicitação é definido na atividade HTTP, o conector não serializa um Null mapeado como um null JSON. Quando o esquema é definido na transformação, sem nenhum esquema de solicitação fornecido na atividade, o conector envia um Null mapeado como um null JSON corretamente.
  • Solução:
    • Migre a atividade para o conector HTTP v2, que serializa Null corretamente. A Jitterbit recomenda converter conexões e atividades HTTP existentes para HTTP v2.
    • Se a atividade deve permanecer em HTTP, defina o esquema de solicitação na transformação em vez de na atividade, e deixe o esquema de solicitação da atividade não definido. Com o esquema definido na transformação, o conector serializa um Null mapeado para um null JSON corretamente.

Conector LDAP

Falha ao Deletar Entrada LDAP quando a entrada de destino possui entradas filhas

  • Sintoma: Uma atividade LDAP Delete Entry falha com um erro do servidor LDAP (por exemplo, notAllowedOnNonLeaf ou uma mensagem indicando que a entrada não é um nó folha).
  • Causa possível: O protocolo LDAP não permite deletar uma entrada que possui entradas filhas (subordinadas). A entrada deve ser um nó folha sem filhos para que a exclusão tenha sucesso.
  • Solução:
    • Antes de deletar a entrada pai, delete todas as entradas filhas primeiro. Percorra a hierarquia das entradas mais profundas para cima.
    • Se for necessário deletar uma subárvore inteira, implemente um script que identifique e delete entradas de baixo para cima na árvore, usando RunOperation com a atividade LDAP Delete Entry para cada entrada.

Busca de Entrada LDAP: Expressão de filtro diferencia maiúsculas e minúsculas em alguns servidores

  • Sintoma: Uma atividade LDAP Search Entry não retorna resultados ou retorna um erro, mesmo que as entradas consultadas existam no diretório.
  • Causa possível: Alguns servidores LDAP exigem que nomes de atributos em expressões de filtro correspondam ao caso exato usado pelo esquema do servidor. A expressão de filtro pré-preenchida pelo Studio usa caso título para a classe estrutural (por exemplo, ObjectClass), mas alguns servidores exigem um caso diferente (por exemplo, objectClass).
  • Solução:
    1. Na configuração da atividade LDAP Search Entry, revise o campo Filter Expression pré-preenchido.
    2. Ajuste o caso dos nomes de atributos para corresponder ao que o servidor LDAP de destino espera. Por exemplo, altere ObjectClass para objectClass se o servidor exigir minúsculas.
    3. Consulte a documentação ou definição de esquema do servidor LDAP para as convenções de nomenclatura de atributo necessárias.

Conectores Microsoft

Microsoft SharePoint Online: conexões de esquema SOAP falhando após aposentadoria do IDCRL

  • Sintoma: Operações utilizando um conector Microsoft SharePoint Server com o tipo de conexão de esquema SOAP começaram a falhar ou retornar erros de autenticação ao se conectar ao SharePoint Online.
  • Causa possível: Microsoft descontinuou o método IDCRL (Identity Client Runtime Library) utilizado por conexões de esquema SOAP ao SharePoint Online. Após 1º de maio de 2026, operações que usam o esquema SOAP do SharePoint para conexões ao SharePoint Online devem falhar.
  • Resolução:
    1. No Studio, abra cada conexão SharePoint afetada e altere a configuração Schema de SOAP para REST.
    2. Reconfigure quaisquer atividades que usavam o esquema SOAP para usar operações REST equivalentes.
    3. Teste e reimplante as operações afetadas.
    4. Para detalhes de migração, consulte a documentação do conector Microsoft SharePoint Server.

Microsoft Dynamics 365 Business Central v2: nomes de tipo incompatíveis com metadados

  • Sintoma: Operações utilizando o conector Microsoft Dynamics 365 Business Central v2 falham com erros indicando que nomes de tipo na carga são incompatíveis com os metadados OData.
  • Causa possível: Certos endpoints da API OData do Dynamics 365 Business Central requerem anotações de tipo OData na carga da solicitação. Por padrão, o conector não inclui essas anotações, o que causa erros de incompatibilidade de tipo para esses endpoints.
  • Resolução:
    1. Abra a configuração da atividade Update do Microsoft Dynamics 365 Business Central v2.
    2. Em Configurações opcionais, ative Definir tipo OData na carga.
    3. Salve a atividade e teste novamente as operações afetadas.

Microsoft Entra ID: atributos de extensão não selecionáveis como condições de filtro de consulta

  • Sintoma: Ao configurar uma atividade Query do Microsoft Entra ID, o campo onPremisesExtensionAttributes e seus campos de atributo de extensão filho (por exemplo, extensionAttribute1 até extensionAttribute15) não aparecem no seletor Object Fields na etapa 3 e não podem ser selecionados como condições de filtro de cláusula condicional.
  • Causa possível: onPremisesExtensionAttributes é um objeto de tipo complexo (aninhado). O seletor Object Fields da etapa 3 expõe apenas campos de tipo de dados primitivos; campos de tipo complexo são excluídos da lista de seleção.
  • Resolução: Os campos onPremisesExtensionAttributes não precisam ser selecionados na etapa 3 para serem retornados. Aparecem no esquema de saída da atividade na etapa 4 e são preenchidos em tempo de execução quando a operação é executada. Para acessar valores de atributo de extensão, mapeie de onPremisesExtensionAttributes e seus campos filho na transformação.

Atividade Microsoft Entra ID Update: campos DateTime rejeitados com incompatibilidade de tipo Edm.String

  • Sintoma: Uma atividade Update do Microsoft Entra ID falha com:
Um valor foi encontrado com um nome de tipo incompatível com os metadados.
O valor especificou seu tipo como 'Edm.String', mas o tipo especificado nos metadados é 'Edm.DateTimeOffset'.
[HTTP/1.1 400 Bad Request]
  • Possível causa: O conector envia valores de campo DateTime (como employeeHireDate) sem a anotação @odata.type exigida pela API do Microsoft Graph. Sem a anotação, o valor é interpretado como Edm.String em vez de Edm.DateTimeOffset, causando um erro 400.
  • Resolução:
    1. Abra a configuração da atividade Update do Microsoft Entra ID.
    2. Na etapa 1, expanda Configurações opcionais e ative Set OData type on payload.
    3. Salve a atividade, reimplante e execute novamente a operação.

Consulta do Microsoft Entra ID: "Unsupported or invalid query filter clause" em propriedades filtradas

  • Sintoma: Uma atividade Query do Microsoft Entra ID falha quando uma condição de filtro é aplicada na etapa 3:

    (Request_UnsupportedQuery) Unsupported or invalid query filter clause specified for property '<property>' of resource '<object>'. [HTTP/1.1 400 Bad Request]
    

    A mesma consulta é bem-sucedida quando nenhum filtro é aplicado.

  • Possível causa: A filtragem de certas propriedades do Microsoft Entra ID (como companyName e createdDateTime) usa a capacidade de consulta avançada da API do Microsoft Graph, que requer $count=true na string de consulta. Sem ela, a API rejeita o filtro mesmo quando a sintaxe é correta. O conector inclui automaticamente o cabeçalho ConsistencyLevel: eventual obrigatório, mas $count=true deve ser adicionado separadamente.

  • Resolução: escolha uma das seguintes opções dependendo da aba usada na etapa 3:
    • Aba Básica: Marque a caixa de seleção Include Count. Isso adiciona $count=true à consulta automaticamente.
    • Aba Avançada: Acrescente &$count=true à string de filtro manualmente. Por exemplo:

      $filter=companyName eq 'Example Corp'&$count=true
      

Para a lista de propriedades que exigem sintaxe de consulta avançada, consulte Advanced query capabilities on Microsoft Entra ID objects na documentação do Microsoft Graph.

As operações do Microsoft Dynamics AX 2012 falham com "Logon failed"

  • Sintoma: as operações que usam o conector Microsoft Dynamics AX contra o AX 2012 falham em tempo de execução, mesmo que o teste de conexão seja bem-sucedido no Studio. O log do Jitterbit Dynamics AX 2012 Connector REST Service contém:

    The server has rejected the client credentials.
    
    The logon attempt failed
    

  • Causa: O campo Domain Name na conexão do AX 2012 não está definido com o valor correto. A autenticação do AX 2012 requer que o Domain Name seja a extensão do nome de domínio DNS (por exemplo, yourcompany.com), não um nome de domínio curto ou NetBIOS. Um valor de domínio incorreto causa que o AX rejeite credenciais válidas com uma falha de logon, mesmo quando o teste de conexão é bem-sucedido.

  • Resolução:
    1. Abra a conexão do Dynamics AX 2012 no Studio.
    2. Defina o campo Domain Name como sua extensão de nome de domínio DNS (por exemplo, yourcompany.com), não um nome de domínio curto/NetBIOS.
    3. Confirme se o Login é o nome de usuário da conta de serviço do AX com os privilégios necessários e reinsira a Password para descartar um valor obsoleto.
    4. Teste a conexão e execute novamente a operação.

Conector NetSuite

Nota

NetSuite possui um guia de resolução de problemas dedicado que aborda problemas adicionais de conexão, configuração de esquema, atividade e desempenho. Consulte Resolução de problemas do NetSuite.

Criar, atualizar ou fazer upsert no NetSuite falha com "is not a legal value for Country"

  • Sintoma: Uma atividade NetSuite Create, Update ou Upsert falha quando o valor de origem de um campo de país não corresponde a um valor enum Country do NetSuite:

    FaultString: org.xml.sax.SAXException: <country_value> is not a legal value for {urn:types.common_<version>.platform.webservices.netsuite.com}Country
    
  • Causa possível: A API SuiteTalk do NetSuite requer que Country (e outros campos enumerados) seja um dos valores enum predefinidos do WSDL (por exemplo, _unitedStates). Um nome de país de exibição, um código de país ISO ou qualquer valor que não corresponda exatamente ao enum do WSDL é rejeitado.

  • Resolução:
    • Na transformação que mapeia para o destino do NetSuite, traduza o valor de país de origem para o valor enum correspondente do NetSuite antes de gravar. Um dicionário de referência cruzada, uma declaração Case ou uma tabela de pesquisa funcionam para isso.
    • Crie a referência cruzada a partir do enum Country definido no WSDL SuiteTalk do NetSuite que seu conector está usando. Os valores válidos mudam entre versões do WSDL, então sempre verifique em relação à versão do WSDL configurada atualmente na conexão.
    • Aplique a mesma abordagem a qualquer outro campo apoiado por um enum do NetSuite (por exemplo, State, Currency) onde os valores de origem ainda não correspondem ao enum do WSDL.

Conector OData

Conjuntos de entidades OData v2 falham ao carregar com "No entity sets found"

  • Sintoma: Configurar uma atividade Query do OData que aponta para um serviço OData v2.0 retorna um erro ao buscar a lista de objetos, embora o teste de conexão seja bem-sucedido:

    An error occurred while fetching the data:
    Error while generating for query activity object list. The Exception is No entity sets found for the address provided.
    
  • Causa possível: O suporte para serviços OData V2 foi adicionado ao conector OData na versão 11.59 do agente, através da configuração de conexão OData version. Em agentes anteriores à versão 11.59, o conector suporta apenas OData V4, portanto uma conexão apontada para um serviço OData V2 não pode preencher a lista de objetos. A mesma falha ocorre na versão 11.59 ou posterior se OData version for deixada como V4 para um serviço OData V2.

  • Resolução:
    1. Para agentes privados, atualize para a versão 11.59 ou posterior. Agentes em nuvem recebem a atualização automaticamente.
    2. Na conexão OData, defina OData version como V2 (o padrão é V4). Salve e teste a conexão novamente.
    3. Reabra a atividade Query do OData. Os conjuntos de entidades devem carregar agora.

OData: Microsoft Dynamics 365 retorna apenas os dados da empresa padrão

  • Sintoma: Uma conexão OData a um endpoint Microsoft Dynamics 365 Finance and Operations retorna dados apenas da empresa padrão do usuário, portanto registros de outras empresas estão faltando nos resultados.
  • Causa possível: Por padrão, um endpoint OData Dynamics 365 Finance and Operations retorna apenas os dados que pertencem à empresa padrão do usuário. Para fornecer à conexão um escopo entre empresas (expandido), uma cláusula de filtro entre empresas deve ser anexada à URL de metadados OData da conexão (a URL $metadata). Na URL de metadados, ?cross-company=true por si só não aplica o escopo expandido.
  • Resolução: Na conexão OData, anexe uma cláusula de filtro dataAreaId à URL de metadados OData, substituindo usrt pelo seu identificador de área de dados e salve e teste novamente:
?$filter=dataAreaId eq 'usrt'&cross-company=true

Para saber mais sobre como o Dynamics 365 agrupa dados do OData por empresa, consulte a documentação da Microsoft sobre comportamento entre empresas.


Conectores Oracle

Oracle EBS: erro de conexão "arquivo JAR do provedor personalizado não está presente"

  • Sintoma: A conexão com uma instância do Oracle E-Business Suite (EBS) falha com:

    Error connecting to Oracle EBS instance. Error is: The custom provider JAR file is not present in the Jitterbit Private Agent or it is not in the right location ($JITTERBIT_HOME/Connectors/Providers)
    
  • Possível causa: O conector Oracle EBS requer que o driver JDBC do Oracle (ojdbc8.jar) seja colocado manualmente no agente privado. Este arquivo não é incluído no agente e deve ser adicionado antes da conexão funcionar.

  • Resolução:
    1. Faça o download de ojdbc8.jar no site da Oracle (uma conta Oracle é obrigatória).
    2. Coloque ojdbc8.jar no diretório $JITTERBIT_HOME/Connectors/Providers/ no host do agente privado.
    3. Reinicie todos os agentes no grupo de agentes.
    4. Teste novamente a conexão do Oracle EBS.

Conectores Salesforce

Nota

O conector Salesforce possui um guia de solução de problemas dedicado que cobre autenticação, esquema, configuração de atividade, limite de registros e problemas de atividade em lote. Consulte Solução de problemas do conector Salesforce.

Salesforce Events: Eventos não podem ser habilitados após reinicialização do agente

  • Sintoma: Após reinicializar ou reinstalar um agente privado, os eventos do conector Salesforce Events falham ao habilitar, mesmo quando as credenciais de conexão estão corretas.
  • Possível causa: Após uma reinicialização, o arquivo JAR do conector pode ainda não estar presente no agente. Habilitar um evento requer que o conector seja baixado no agente primeiro.
  • Resolução:
    1. Abra a configuração de conexão do Salesforce Events no Studio.
    2. Clique em Test para testar a conexão. Isso força o download do JAR do conector para o agente.
    3. Após o teste de conexão ser bem-sucedido, tente habilitar o evento novamente.

Salesforce Events: "O canal especificado não é válido" ao habilitar uma atividade de escuta do Change Data Capture

  • Sintoma: Habilitar uma operação que contém uma atividade de escuta do Salesforce Events Change Data Capture (CDC) falha com um erro similar a:

    Unable to subscribe to [/data/<ObjectName>ChangeEvent:-1] [...]: 400::The channel specified is not valid {/data/<ObjectName>ChangeEvent}
    
  • Possível causa: O objeto não está selecionado para Change Data Capture no Salesforce.

  • Resolução: No Salesforce, vá para Setup > Platform Tools > Integrations > Change Data Capture, adicione o objeto a Selected Entities e habilite a operação novamente. Para ver as etapas completas, consulte Selecionar as entidades que geram eventos.

Salesforce Events: Limitações da atividade de escuta

Os seguintes comportamentos das atividades de escuta de Salesforce Events (Subscribe Event e as atividades de Subscribe Insert, Update e Delete CDC Event) são esperados e não indicam um defeito do conector:

  • Não é possível ativar eventos porque o número máximo de inscritos foi atingido. A instância Salesforce limita o número de clientes (inscritos) simultâneos. Quando esse limite é atingido, nenhum evento adicional pode ser ativado. Reduza o número de inscritos ativos conectados à instância.
  • Símbolos de medição como $ e % estão faltando na resposta. Esses símbolos não são retornados, por design da API Salesforce.
  • Campos não modificados são retornados como null nas respostas de Change Data Capture (CDC). Para atividades de CDC, apenas os campos alterados são preenchidos; campos não modificados são retornados como null, por design da API Salesforce.

Conector SAP

Múltiplas atividades SAP em uma operação falham em tempo de execução

  • Sintoma: Uma operação que contém mais de uma atividade de SAP, ou que combina uma atividade SAP com uma atividade NetSuite, Salesforce, Salesforce Service Cloud, ServiceMax ou SOAP, é implantada sem nenhum erro de validação, mas falha quando executada.
  • Possível causa: Operações que misturam esses tipos de atividade parecem válidas no Studio e podem ser implantadas com sucesso, mas essas combinações não são suportadas em tempo de execução. As regras de validação de operação não sinalizam esse padrão como um erro em tempo de design. Este é um problema conhecido documentado do Studio.
  • Solução:
    • Projete cada operação para conter apenas uma única atividade SAP, sem nenhuma outra atividade SAP, NetSuite, Salesforce, Salesforce Service Cloud, ServiceMax ou SOAP na mesma operação.
    • Se dados de múltiplos sistemas forem necessários em um único fluxo de trabalho, divida a lógica em operações separadas e encadeie-as usando ações de operação.

SAP RFC: "No RFC authorization for function module BAPI_TRANSACTION_COMMIT"

  • Sintoma: Uma atividade de RFC do SAP falha em tempo de execução com:

    JCoException occurred No RFC authorization for function module BAPI_TRANSACTION_COMMIT
    
  • Possíveis causas:

    • A conta de usuário SAP na conexão não tem autorização S_RFC para BAPI_TRANSACTION_COMMIT ou seus grupos de funções relacionados.
    • O módulo de função BAPI_TRANSACTION_COMMIT não está configurado como habilitado para remoto no sistema SAP.
    • A transformação de solicitação que precede a atividade não define o campo de controle de commit.
  • Solução:

    • No sistema SAP, confirme que o módulo de função BAPI_TRANSACTION_COMMIT está habilitado para remoto.
    • Na transformação de solicitação que precede a atividade RFC do SAP, defina o campo BAPI_COMMIT como true.
    • Verifique se a conta de usuário SAP referenciada na conexão tem autorização S_RFC para BAPI_TRANSACTION_COMMIT e todos os grupos de funções relacionados.
    • Se o problema persistir, entre em contato com o administrador SAP BASIS para revisar as atribuições de objeto de autorização do usuário.

A conexão SAP falha com "Invalid language key"

  • Sintoma: Uma conexão do SAP falha durante a inicialização com um erro sobre a chave de idioma:

    Connector Error: AdapterResourceException: Error while creating Destination. 00024Invalid language key when configuring the text environment.
    
  • Possível causa: O código de Idioma configurado no endpoint SAP não é válido para o sistema SAP de destino: o código não está instalado ou suportado naquele sistema, ou está digitado incorretamente ou com capitalização incorreta (por exemplo, en em vez de EN). O SAP rejeita a chave inválida ao inicializar o ambiente de texto do destino.

  • Resolução:
    1. Edite o endpoint SAP no Studio e configure o campo Idioma com um código de idioma válido de duas letras (por exemplo, EN para inglês).
    2. Verifique se o valor corresponde a um idioma instalado e ativo no sistema SAP de destino. Se tiver dúvidas, confirme o idioma padrão do usuário de integração no perfil de usuário SAP e use aquele.
    3. Teste a conexão a partir do Studio para confirmar que a inicialização é bem-sucedida antes de reimplementar a operação.

Conector ServiceNow

As execuções iniciais de operação são lentas após reinicialização do agente ou em agentes na nuvem

  • Sintoma: As operações que usam o conector do ServiceNow são executadas lentamente em dois cenários:

    • Em agentes privados, a primeira operação após o agente reiniciar pode levar vários minutos; as execuções subsequentes são rápidas.
    • Em agentes na nuvem, as execuções são intermitentemente lentas, levando minutos sempre que o cache de metadados do conector é atualizado.

    Isso pode causar timeouts de API de downstram.

  • Possível causa: O conector armazena em cache os metadados do ServiceNow de forma agressiva. Após uma reinicialização do agente em um agente privado (ou em cada execução de um agente na nuvem que não preservou o cache), a primeira operação deve reconstruir o cache, o que leva vários minutos.

  • Resolução:
    • Em um agente privado, reduza a lentidão pós-reinicialização adicionando getcolumnsmetadata=onUse às Opções avançadas do endpoint do ServiceNow. Esta configuração é eficaz apenas em agentes privados.
    • Para um desempenho consistente em agentes na nuvem, chame a API REST do ServiceNow por meio do conector HTTP v2 em vez de usar o conector ServiceNow. O conector HTTP v2 não armazena metadados em cache e evita o atraso de reconstrução.

Conector ServiceNow v2

ServiceNow v2: Um objeto não é listado pelo nome do conector ServiceNow

  • Sintoma: Um objeto que pode ser selecionado por um nome familiar no conector do ServiceNow não pode ser encontrado por esse mesmo nome no conector do ServiceNow v2.
  • Causa: O uso pela conector ServiceNow v2 da API REST do ServiceNow expõe objetos usando o nome real da tabela backend do ServiceNow, que pode diferir do nome usado para o mesmo objeto no conector ServiceNow. Por exemplo, o objeto chamado System no conector ServiceNow corresponde a Sys no conector ServiceNow v2.
  • Resolução: No ServiceNow, procure o nome real da tabela do objeto em System Definition > Tables, e depois pesquise esse nome na configuração de atividade do conector ServiceNow v2.

Conector Shopify

Shopify: As seleções de objetos de atividade podem mudar após atualização de versão de API

  • Sintoma: Após alterar a versão da API em uma conexão Shopify, uma ou mais atividades Shopify retornam erros ou se comportam de forma inesperada, e um objeto configurado ou sub-objeto parece ter sido alterado.
  • Possível causa: Shopify lança novas versões de API trimestralmente e descontinua versões mais antigas após 12 meses. Ao mudar para uma versão de API diferente, objetos ou sub-objetos que não estão disponíveis na nova versão podem deixar de ser selecionáveis, causando a alteração da seleção configurada da atividade quando a configuração é atualizada.
  • Resolução:
    1. Após alterar a versão da API Shopify na conexão, abra cada configuração de atividade Shopify afetada.
    2. Clique em Refresh para recarregar os objetos disponíveis para a nova versão da API.
    3. Revise as seleções de objeto e sub-objeto para confirmar que refletem sua intenção na nova versão.
    4. Atualize as seleções que foram alteradas para os objetos de substituição corretos.
    5. Reimplemente e reteste as operações afetadas.
    6. Para informações sobre cronogramas de descontinuação de versão da API Shopify, consulte o changelog do Shopify.

Conector Snowflake

Snowflake: Conexões baseadas em senha falhando após descontinuação de autenticação

  • Sintoma: Operações conectando ao Snowflake usando o tipo de autenticação Password (Deprecated) começaram a falhar após funcionar anteriormente, por exemplo com:

    HttpErrorResponse: Error opening connection. Exception is Failed to authenticate: MFA authentication is required, but none of your current MFA methods are supported for programmatic authentication.
    
  • Possível causa: Snowflake está descontinuando a autenticação de fator único (apenas senha), inclusive para contas do tipo LEGACY_SERVICE necessárias para este tipo de autenticação. Snowflake migra contas LEGACY_SERVICE para TYPE=SERVICE gradualmente, por conta, o que bloqueia a autenticação baseada em senha completamente; algumas contas também têm autenticação multifator (MFA) habilitada, o que é incompatível com esta conexão programática totalmente automatizada, já que MFA requer intervenção humana. Consulte Password (Deprecated) para o cronograma de descontinuação.

  • Resolução: Atualize a conexão do conector Snowflake no Studio para usar autenticação OAuth ou Key-Pair, e configure a conta de usuário Snowflake para corresponder, garantindo que não esteja inscrita em MFA.

Snowflake: Instância de desenvolvedor em hibernação, tabelas de metadados não sendo preenchidas

  • Sintoma: Ao configurar uma atividade Snowflake, a lista de objetos disponíveis não é preenchida ou aparece vazia, mesmo que o teste de conexão seja bem-sucedido.
  • Possível causa: Instâncias de Desenvolvedor do Snowflake entram em estado de hibernação quando não são acessadas recentemente. Embora o teste de conexão possa ser bem-sucedido em uma instância hibernada, a instância pode não retornar metadados de tabelas e objetos.
  • Resolução:
    1. Faça login na interface web do Snowflake para reativar a instância.
    2. Reabra a conexão Snowflake no Studio e clique em Test para reteste as credenciais.
    3. Reabra a configuração da atividade para atualizar a lista de objetos disponíveis.

Snowflake Query: Incompatibilidade de maiúsculas/minúsculas do nó raiz de esquema plano causa erro ProcessFlatStream

  • Sintoma: Uma atividade de Consulta do Snowflake que usa um esquema simples falha em tempo de execução com:

    StartElement() error, starting element does not match with the root.
    qName= "<table_name_lowercase>", root name="<TABLE_NAME_UPPERCASE>"
    
    ProcessFlatStream error
    

    Este erro ocorre quando a consulta inclui uma cláusula WHERE, uma cláusula LIMIT ou uma referência a variável em uma cláusula WHERE.

  • Possível causa: O conector Snowflake retorna o nome da tabela em minúsculas na resposta XML. Quando o Studio gera um esquema simples a partir da consulta, o nome do nó raiz é criado em maiúsculas. A incompatibilidade entre o nó raiz do esquema (maiúscula) e o nó raiz da resposta XML (minúscula) causa falha no processamento de fluxo simples.

  • Resolução: Escolha uma das seguintes opções:
    • No esquema simples, altere o nome do nó raiz para minúsculas para corresponder à saída do conector. Por exemplo, renomeie SALES_ORDERS para sales_orders.
    • Use o esquema espelho com mapeamento padrão em vez de um esquema simples construído manualmente. O esquema espelho deriva sua estrutura diretamente da resposta do conector e não apresenta esta incompatibilidade de maiúsculas e minúsculas.

Snowflake Merge: stageName e fileContent estão faltando no esquema de solicitação para estágios externos

  • Sintoma: Uma atividade Merge do Snowflake configurada em um estágio externo mostra um esquema de solicitação sem os campos stageName e fileContent. A mesma atividade configurada em um estágio interno expõe ambos os campos.
  • Possível causa: Os estágios externos são referências somente leitura para arquivos que já existem no armazenamento em nuvem externo (S3, GCS ou Azure Blob). A atividade Merge não pode fazer upload de conteúdo de arquivo em um estágio externo, portanto o esquema omite os campos que direcionam esse upload.
  • Resolução:
    • Quando a atividade se destina a um estágio externo, certifique-se de que os arquivos de dados já estão presentes no local de armazenamento em nuvem que o estágio referencia. A atividade Merge lê diretamente desses arquivos; nenhum campo fileContent é necessário.
    • Quando é necessário enviar conteúdo de arquivo da operação, configure a atividade Merge para usar um estágio interno. O esquema então expõe stageName e fileContent.

Snowflake Insert or Merge: erros de sintaxe SQL de caracteres especiais

  • Sintoma: Uma atividade Snowflake Insert ou Merge falha com um erro de compilação SQL como:

    SQL compilation error:
    syntax error line 1 at position <n> unexpected '<token>'.
    

    Os valores das colunas também podem aparecer com mapeamento incorreto, com dados de um campo aparecendo na coluna errada.

  • Possíveis causas:

    • Os valores de campo contêm aspas simples (por exemplo, um valor como corner's) não são escapados antes de serem incluídos na carga SQL. A aspa não escapada encerra a string prematuramente, causando o restante do valor ser interpretado como sintaxe SQL em vez de dados.
    • Um nome de coluna de destino contém um caractere especial, como um hífen (por exemplo, Zip-Code). O Snowflake requer que um identificador contendo um caractere especial seja entre aspas; sem aspas, produz um erro de sintaxe no hífen.
  • Resolução:

    • Para valores contendo aspas simples: Nas Configurações opcionais da conexão Snowflake, ative Escapar caracteres especiais. Isto escapa automaticamente as aspas simples nas cargas das atividades Insert e Invoke Stored Procedure. Para atividades Merge, ou como alternativa para Insert, use SQLEscape no mapeamento de transformação para escapar aspas simples nos valores de campo afetados antes de chegarem à atividade.
    • Para nomes de coluna contendo caracteres especiais: Confirme que a opção Usar aspas para identificadores Snowflake está ativada na conexão (ativada por padrão).

Snowflake: Erro de espaço heap do Java ao consultar grandes conjuntos de dados

  • Sintoma: Uma atividade Query do Snowflake falha com o seguinte erro quando a consulta retorna um grande número de linhas:

    Error executing query activity. Exception is Java heap space
    

    O conector reporta o erro desta forma porque encapsula o erro Java subjacente, que aparece mais abaixo no rastreamento de pilha:

    Caused by: java.lang.OutOfMemoryError: Java heap space
    

    Se este erro ocorre em consultas que retornam poucas linhas, ou o mesmo agente também falha com erros de heap através de outros conectores, a causa é mais provavelmente a alocação de heap geral do agente do que o tamanho do conjunto de resultados. Consulte Java heap space: OutOfMemoryError.

  • Possível causa: O conector Snowflake carrega todo o conjunto de resultados da consulta na memória JVM antes de passá-lo para a transformação. Com conjuntos de resultados muito grandes, isso esgota o heap JVM do Tomcat no agente privado.

  • Resolução: Para grandes volumes de consultas, use o conector Database com um driver Snowflake JDBC em vez do conector Snowflake. O conector Database não armazena todo o conjunto de resultados na memória, portanto pode lidar com muito maiores volumes de consultas. Instale o driver Snowflake JDBC no agente privado e configure uma conexão Database que o utilize. No agente 12.x ou posterior, essa conexão Database também precisa de enableArrowResultFormat=false&jdbc_query_result_format=json em sua string de conexão; consulte Snowflake: Operações falham no agente 12.x.

    Se precisar permanecer no conector Snowflake, qualquer um dos itens a seguir pode reduzir a pressão de memória, embora nenhum seja garantido como suficiente para conjuntos de dados com milhões de linhas:

    • Divida a consulta em lotes usando as cláusulas SQL LIMIT e OFFSET, executando a operação repetidamente com deslocamentos incrementais até que todas as linhas sejam processadas.
    • Aumente o tamanho do heap JVM do Tomcat no agente privado (consulte Memória heap do Tomcat).

Snowflake: Operações falham no agente 12.x

  • Sintoma: Em um agente privado executando a versão 12.x, operações que consultam Snowflake através de um driver Snowflake JDBC (uma conexão Database ou um script DBExecute) falham em tempo de execução, mesmo que o teste de conexão seja bem-sucedido. O erro faz referência à camada de memória Arrow do driver, por exemplo:

    JDBC driver internal error: exception creating result java.lang.ExceptionInInitializerError at net.snowflake.client.jdbc.internal.apache.arrow.memory.unsafe.UnsafeAllocationManager
    

    ou:

    JDBC driver internal error: exception creating result java.lang.NoClassDefFoundError: Could not initialize class net.snowflake.client.jdbc.internal.apache.arrow.memory.RootAllocator
    
  • Possível causa: Por padrão, o driver Snowflake JDBC retorna resultados de consulta em formato Apache Arrow, que não é compatível com a versão 12.x do agente ou posterior. Consulte o artigo de solução de problemas do Snowflake sobre este erro de módulo Java para mais detalhes. O teste de conexão não retorna um conjunto de resultados, portanto ainda passa enquanto as consultas falham. Atualizar a versão do driver JDBC não resolve.

  • Resolução: Defina enableArrowResultFormat como false e jdbc_query_result_format (ou JDBC_QUERY_RESULT_FORMAT) como json para que o driver retorne resultados em JSON em vez de Arrow:
    • Conector Database: Adicione enableArrowResultFormat=false&jdbc_query_result_format=json à string de conexão Snowflake, no campo Parâmetros Adicionais da String de Conexão (ou no campo String de Conexão, se Usar String de Conexão estiver selecionado).
    • Conector Snowflake: Em Configurações opcionais > Propriedades Personalizadas de Conexão, adicione enableArrowResultFormat com um valor de false. Uma linha JDBC_QUERY_RESULT_FORMAT com um valor de JSON já está presente lá por padrão.

Depois, salve, teste novamente a conexão e execute a operação novamente.

Em um agente privado, você pode aplicar a correção no nível da JVM para que não seja necessário repetir para cada conexão, adicionando --add-opens=java.base/java.nio=ALL-UNNAMED a CATALINA_OPTS:

=== "Linux"

    Adicione a seguinte linha a `/opt/jitterbit/tomcat/bin/setenv.sh`:

    ```sh
    export CATALINA_OPTS="$CATALINA_OPTS --add-opens=java.base/java.nio=ALL-UNNAMED"
    ```

    Depois, reinicie o agente.

=== "Windows"

    1.  Abra o Editor do Registro e localize a seguinte chave:

        ```txt
        HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Jitterbit Tomcat Server\Parameters\Java
        ```

    2.  Abra a subchave **Options**.
    3.  No campo **Value data**, adicione `--add-opens=java.base/java.nio=ALL-UNNAMED` às opções existentes de Java.
    4.  Clique em **Ok**.
    5.  Reinicie o agente.

=== "Docker"

    Use uma das seguintes estratégias para aplicar a configuração:

    1.  Atualize o Dockerfile e reconstrua a imagem do Docker:

        ```
        docker build -t my-agent .
        ```

    2.  Inclua na linha de comando do Docker `run`:

        ```
        docker run -e CATALINA_OPTS="--add-opens=java.base/java.nio=ALL-UNNAMED" my-agent
        ```

    3.  Inclua em `docker-compose.yml` e reinicie o contêiner:

        ```
        environment:
          - CATALINA_OPTS=--add-opens=java.base/java.nio=ALL-UNNAMED
        ```

Conector SOAP

Erro de implantação do SOAP: "No WSDL with locator"

  • Sintoma: A implantação de um projeto que inclui uma conexão SOAP, ou uma atividade de SOAP Request ou SOAP Response de API, falha com:

    Failed to deploy - Internal Error: No WSDL with locator
    
  • Possíveis causas:

    • O WSDL foi removido, reimportado ou sua referência interna foi quebrada, portanto o projeto faz referência a um identificador de WSDL que não existe mais.

    • O projeto foi implantado ou transferido para outro ambiente, antes do lançamento do Harmony 12.9, quando a implantação de um projeto podia excluir arquivos WSDL ainda em uso. O lançamento 12.9 impede a exclusão, mas um WSDL excluído antes disso deve ser carregado novamente.

  • Resolução:

    1. Carregue novamente o WSDL do componente afetado:

      • Para uma conexão SOAP, abra a conexão e selecione Upload URL ou Upload file (não Select existing), carregue novamente o WSDL, revise as configurações de Port e Select methods e clique em Save Changes.
      • Para uma atividade de API SOAP Request ou SOAP Response, abra a atividade e carregue novamente o WSDL na etapa 1 de sua configuração.

      Se o carregamento exibir um erro de validação, consulte Requisitos de carregamento de WSDL.

    2. Revise todas as transformações que herdam esquemas do WSDL recarregado e regenere-as se necessário.

    3. Reimplante o projeto.

    4. Se o projeto tiver múltiplos WSDLs e não estiver claro qual foi afetado, consulte Solução de problemas de conexão SOAP para identificá-lo a partir de uma exportação JSON.

SOAP WSDL: schemaLocation deve usar referências relativas

  • Sintoma: Uma conexão SOAP que faz referência a um WSDL com arquivos de esquema XSD importados falha ao carregar ou produz erros de resolução de esquema no tempo de design. O carregamento do WSDL pode exibir um erro como:
Falha ao analisar WSDL: ENOENT: nenhum arquivo ou diretório, abrir '<path>/types.xsd'

onde types.xsd é o nome do arquivo ausente. Quando o WSDL está em um arquivo ZIP, a mensagem de erro começa com Failed to parse WSDL file 'filename': em vez disso, onde filename é o nome do arquivo WSDL no arquivo ZIP.

  • Possíveis causas:

    • O WSDL usa URLs absolutas em seus atributos schemaLocation para arquivos XSD importados (por exemplo, http://example.com/schema.xsd). O agente não consegue buscar esquemas de URLs remotas absolutas ao carregar um WSDL importado localmente.

    • O WSDL importa um arquivo XSD que não foi carregado junto com ele. Arquivos XSD que o WSDL importa usando caminhos relativos devem ser carregados em um arquivo ZIP junto com o WSDL.

  • Resolução:

    1. Edite o WSDL para que todas as referências schemaLocation usem caminhos relativos (por exemplo, schema.xsd em vez de http://example.com/schema.xsd).

    2. Coloque todos os arquivos XSD referenciados no mesmo diretório que o WSDL, ou no local relativo que cada schemaLocation especifica. Adicione os arquivos WSDL e XSD a um arquivo ZIP e carregue o arquivo ZIP na conexão SOAP usando Upload file.

    3. Para todos os requisitos de upload, consulte Requisitos de upload de WSDL.

Conector SOAP reescreve prefixos e estrutura de namespaces XML

  • Sintoma: O envelope XML produzido por uma atividade SOAP não corresponde aos prefixos de namespace literais ou à estrutura do WSDL de origem (por exemplo, o conector substitui xmlns:ns1 por xmlns:glob). Serviços SOAP rigorosos que comparam o texto exato do prefixo rejeitam a solicitação.
  • Possível causa: O mecanismo de transformação processa mensagens SOAP como XML estruturado, não como texto literal. Ele produz uma carga útil semanticamente equivalente que pode usar prefixos de namespace diferentes dos do WSDL de origem.
  • Resolução: Para serviços SOAP que exigem uma estrutura XML literal, ignore o conector SOAP e construa a carga útil da solicitação como uma string:
    1. Crie uma conexão HTTP v2 apontando para a URL do serviço SOAP.
    2. Em uma transformação, construa o envelope SOAP como uma string, concatenando literais de string e valores mapeados com o operador +. Alternativamente, leia um modelo de um arquivo e substitua valores dinâmicos com Replace.
    3. Na atividade POST do HTTP v2, use o esquema de solicitação padrão (não carregue um esquema de solicitação personalizado) e mapeie a string do envelope SOAP construído para o campo body desse esquema. O conector envia o valor body como está, preservando o XML literal.
    4. Defina o cabeçalho Content-Type como text/xml ou application/soap+xml e defina o cabeçalho SOAPAction se o serviço exigir.
    5. Leia a resposta do serviço no campo responseContent do esquema de resposta padrão da atividade.

SOAP: mensagens MTOM/XOP não são compatíveis


Conector VTEX

Teste de conexão falha com "Você não tem permissão para acessar este recurso"

  • Sintoma: Um teste de conexão VTEX falha com um erro de permissão no Studio, embora as mesmas credenciais funcionem em ferramentas externas como Postman.
Você não tem permissão para acessar este recurso
  • Possível causa: O usuário VTEX ou a chave de aplicação associada à conexão não tem uma ou mais permissões que o conector usa para validar a conexão. Essas permissões são mais rigorosas do que as necessárias para acesso básico aos dados.
  • Resolução:
    1. No portal administrativo do VTEX, abra o perfil de acesso atribuído ao usuário ou à chave de aplicação que o Jitterbit está usando.
    2. Confirme se o perfil de acesso inclui o recurso License Manager com acesso ao recurso Get account by identifier.
    3. Salve o perfil e teste novamente a conexão VTEX no Studio.

Conector Workday

Workday: WSDL v42.0 e v42.1 retornam erros para serviços específicos

  • Sintoma: Operações que usam o conector Workday configurado com versão WSDL 42.0 ou 42.1 falham ao acessar os serviços web Human_Resources ou Resource_Management.
  • Possível causa: Sabe-se que WSDL v42.0 retorna erros para os serviços Human_Resources (v42.0) e Resource_Management (v42.0). Sabe-se que WSDL v42.1 retorna erros para o serviço Human_Resources (v42.1). Esses são problemas conhecidos específicos dessas versões WSDL.
  • Resolução:
    1. Na configuração de conexão do Workday, altere a versão WSDL para 41.x ou 43.0 ou posterior para operações que usam os serviços Human_Resources ou Resource_Management.
    2. Teste a conexão e execute novamente as operações afetadas para confirmar que o problema foi resolvido.

Workday: Teste de conexão falha com "The task submitted is not authorized"

  • Sintoma: Um teste de conexão do Workday falha com:

    Error occurred while opening connection. The Exception is Processing error occurred. The task submitted is not authorized.
    

    Esse erro pode ocorrer com ambos os tipos de autenticação Basic Auth e JWT Bearer. Observe que as operações podem ser executadas com sucesso no tempo de execução mesmo quando o teste de conexão retorna esse erro, pois o teste chama um serviço Workday específico (Get_Message_Template_Translation_Request) que requer uma permissão que a ISU pode não ter, enquanto as operações de integração reais chamam serviços diferentes.

  • Possíveis causas:

    • O Integration System User (ISU) não foi atribuído ao grupo de segurança Setup Administrator no Workday. A chamada de teste de conexão do conector é rejeitada se o ISU não tiver essa associação ao grupo de segurança.
    • O campo Workday Host contém um valor incorreto. Um host incorreto causa falha na conexão antes de tentar a autenticação.
  • Resolução:

    1. Verifique se o valor Workday Host na configuração de conexão está correto. O host deve ser a URL base do seu tenant do Workday (por exemplo, https://wd5-impl-services1.workday.com/). Você pode confirmar o valor correto a partir da página View API Client do Workday.
    2. Na instância do Workday, abra a tarefa Assign Users to User-based Security Group, selecione Setup Administrator e confirme se o ISU está listado em System Users. Se não estiver, adicione o ISU. Para ver as etapas completas, consulte Pré-requisitos.
    3. Confirme se a tarefa Configure Web Service Security também foi concluída para o ISU, conforme descrito na página Pré-requisitos.
    4. Teste novamente a conexão.