Solução de problemas do Design Studio

Este guia cobre erros e problemas comuns encontrados ao usar o Jitterbit Design Studio. Comece com os passos de diagnóstico abaixo e, em seguida, encontre seu problema específico na seção relevante.

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

Para problemas com o agente privado executando suas operações do Design Studio, consulte a solução de problemas do agente privado. Para erros que ocorrem quando as operações são executadas, o guia de solução de problemas de operação cobre o Studio em vez do Design Studio, mas muitas das entradas (por exemplo, operações travadas, erros de script e falhas de conexão) são aplicáveis também às operações do Design Studio.

Passos de diagnóstico

Verifique o log de erros

O Design Studio exibe erros do sistema em um painel de erros integrado. Selecione Log de Erros no menu Visualizar para abri-lo. Cada erro aparece como uma entrada separada com uma descrição. Para salvar os detalhes do erro para um caso de suporte, clique em Salvar no canto superior direito do painel de erros.

Verifique a página de problemas conhecidos

Revise a página de problemas conhecidos do Design Studio para questões que foram identificadas nas versões recentes do Design Studio.

Falhas de login e conexão

Erro de configuração de certificado SSL ou filtro de proxy

• Sintoma: O Design Studio exibe um erro de certificado SSL ou filtro de proxy ao tentar fazer login.
• Causas possíveis:
  • Um certificado SSL assinado ou certificado CA usado pela sua rede (por exemplo, de um filtro da web, proxy ou VPN) não está presente no Jitterbit Java KeyStore.
  • A lista de permissões de IP para o proxy da sua rede ou filtro da web não inclui os endereços necessários do Jitterbit. Veja as informações da lista de permissões.
• Solução: Para etapas completas de resolução, incluindo como adicionar certificados ao Jitterbit Java KeyStore, veja o erro de configuração de certificado SSL ou filtro de proxy.

Usuários SSO fora da região da organização não conseguem fazer login

• Sintoma: Após a ativação do single sign-on (SSO) Harmony para a organização, usuários cuja região Harmony é diferente da região padrão à qual a caixa de diálogo de login do Design Studio se conecta não conseguem completar o login SSO. Usuários na região padrão fazem login sem problemas.
• Causa possível: O Design Studio padrão utiliza uma única URL de região Harmony na caixa de diálogo de login. Quando o SSO é ativado, o redirecionamento SSO resolve apenas contra a região Harmony que hospeda a organização, portanto, os usuários devem apontar o Design Studio para a URL dessa região antes de fazer login.
• Solução:
  • Na caixa de diálogo de login do Design Studio, pressione Ctrl + Shift + U para abrir o campo de URL. Insira a URL da região Harmony da organização (por exemplo, https://na-east.jitterbit.com para NA ou https://emea-west.jitterbit.com para EMEA), e então complete o login SSO.
  • Para tornar a alteração persistente, defina a URL no arquivo de configuração client.properties:
    • Abra <Jitterbit Studio Home>\configuration\client.properties em um editor de texto (no macOS, o caminho é /Applications/Jitterbit Studio [version].app/Contents/Java/configuration/client.properties).
    • Descomente o parâmetro cloud.url e defina-o para a URL regional.
    • Salve o arquivo e reinicie o Design Studio.

Instalação e inicialização

macOS: erro "Propriedades do Cliente Não Existem" ao iniciar

• Sintoma: O Design Studio não inicia no macOS com um erro indicando que as propriedades do cliente não existem.
• Possível causa: O Design Studio foi iniciado diretamente da imagem de disco (.dmg) em vez de ser iniciado a partir da pasta Aplicativos. O aplicativo deve ser copiado para a pasta Aplicativos antes que consiga localizar seus arquivos de configuração.
• Solução:
  1. Saia do Design Studio se ele estiver em execução.
  2. Abra o arquivo instalador .dmg.
  3. Arraste o ícone do Jitterbit Studio para o atalho da pasta Aplicativos na janela do instalador.
  4. Inicie o Design Studio a partir da pasta Aplicativos (ou a partir do Spotlight/Lançador), não a partir da imagem de disco.

Design Studio sinalizado como software malicioso no macOS Sequoia

• Sintoma: No macOS 15 (Sequoia), o macOS exibe um aviso de que o Design Studio é um software malicioso e impede sua abertura.
• Possível causa: O Gatekeeper do macOS alerta sobre aplicativos que não são notarizados pela Apple e são distribuídos fora da Mac App Store. Como o Design Studio é distribuído a partir da página de Downloads do portal Harmony, o macOS informa que não pode verificar se há software malicioso. Este é um comportamento padrão do macOS, não um problema real com o instalador.
• Solução:
  1. Confirme que o Design Studio foi baixado da página oficial de Downloads do portal Harmony.
  2. Se você vir o aviso de software malicioso para uma instalação baixada do portal, o aviso pode ser ignorado: ele não indica um risco real de segurança com o instalador do Jitterbit.

Problemas de exibição

Interface desfocada ou pequena em displays de alta densidade do Windows 10

• Sintoma: Elementos do Design Studio aparecem desfocados ou muito pequenos ao serem executados no Windows 10 com um display de alta DPI, como um monitor 4K.
• Possível causa: Uma configuração padrão de escalonamento de DPI do Windows 10 que não é compatível com o Design Studio.
• Solução: Para etapas de resolução, veja Erro de escalonamento de display de alta densidade do Windows 10.

Desempenho

Tempo de carregamento longo do projeto ao usar um proxy

• Sintoma: Abrir um projeto do Design Studio leva mais de vários minutos ao se conectar através de um proxy. Isso pode ser acompanhado por um erro como:

  Message: Unable to load image icon at this address: https://citizen.jitterbit.eu/v1/endpoints/s3images/financialforce.png
  Details: Can't get input stream from URL!
  

• Possível causa: O atraso é tipicamente causado pelo Design Studio tentando buscar ícones de receita do Citizen Integrator através de um proxy que não consegue acessar o servidor de imagens externo.

• Solução: Para etapas de resolução, veja Tempos de carregamento longos ao usar um proxy.

Transformações

A transformação com um script falha com o erro /PRESCRIPT/ node

• Sintoma: Uma transformação que utiliza um script falha em tempo de execução com:

  Can not find target node (/PRESCRIPT/).
  The structure may have changed so try to open the transformation 'example' and refresh the structure trees.
  

• Causa possível: A estrutura interna XML da transformação tornou-se inconsistente com o esquema de destino atual, tipicamente após uma mudança de esquema.

• Resolução:
  1. Abra a transformação com falha no Design Studio.
  2. No lado Destino, clique no botão de atualizar na parte superior da árvore de estrutura. Isso relê o esquema e reconstrói a estrutura interna da transformação.
  3. Salve e implante a transformação.

Unmap não desmapeia um campo quando usado junto com RunScript

• Sintoma: A expressão de mapeamento de um campo de destino envolve tanto RunScript quanto Unmap, mas o campo não é desmapeado. Para um destino JSON ou XML, o campo aparece na saída com um valor null em vez de ser omitido.

• Causas possíveis:

  • RunScript precede Unmap na mesma expressão de mapeamento (por exemplo, RunScript("<TAG>script:MyScript</TAG>"); Unmap();). Em versões do agente anteriores a 12.9, essa combinação não desmapeava o campo.
  • Unmap é chamado de dentro do script invocado por RunScript, em vez de diretamente na própria expressão de mapeamento do campo de destino. RunScript retorna o resultado do script chamado como uma string em vez de propagar um sinal de desmapear de volta para o mapeamento, então chamar Unmap de dentro do script chamado não tem efeito, em nenhuma versão do agente, independentemente de qualquer lógica condicional em torno da chamada. Este é o comportamento esperado.

• Resolução:

  • Se RunScript e Unmap forem ambos chamados diretamente na expressão de mapeamento do campo de destino, atualize o agente privado para a versão 12.9 ou posterior.
  • Se Unmap for chamado de dentro do script invocado por RunScript, mova a chamada de Unmap para fora do script chamado e para a própria expressão de mapeamento do campo de destino, por exemplo:

RunScript("<TAG>script:MyScript</TAG>"); If(<condition>, Unmap(), <value>);

Gerenciamento de Projetos

Não é recomendado armazenar projetos do Design Studio em um compartilhamento de arquivos de rede

• Sintoma: Um projeto do Design Studio armazenado em um compartilhamento de arquivos de rede (em vez de localmente ou no armazenamento em nuvem Harmony) apresenta perda de dados, onde as alterações na interface do usuário não persistem após reabrir o projeto, ou o desempenho é visivelmente mais lento do que o esperado.
• Possível causa: A Jitterbit não recomenda armazenar áreas de trabalho de projetos do Design Studio em um compartilhamento de arquivos de rede. O armazenamento em compartilhamento de arquivos de rede carece dos mecanismos de bloqueio de arquivos que o Design Studio requer, levando a salvamentos inconsistentes e potencial perda de dados.
• Resolução: Mova a área de trabalho do projeto para o armazenamento local ou use o armazenamento em nuvem Harmony em vez de um compartilhamento de arquivos de rede.

O download do projeto falha com o erro Invalid XML character

• Sintoma: O download de um projeto para o Design Studio falha com um erro indicando que um caractere XML inválido foi encontrado no conteúdo do elemento, por exemplo:

  An invalid XML character (Unicode: 0x15) was found in the element content of the document
  

  ou:

  org.xml.sax.SAXParseException; lineNumber: 17499; columnNumber: 21; An invalid XML character (Unicode: 0x5) was found in the element content of the document.
  

• Possível causa: Os metadados do projeto contêm um caractere de controle (como 0x05 ou 0x15) que não é válido em XML. Isso pode resultar de uma URL de endpoint corrompida ou de caracteres incomuns colados em scripts, notas ou outros campos de texto.

• Resolução:
  1. Abra o projeto no Design Studio (ou use um backup local recente) para inspecionar os metadados.
  2. Revise URLs de endpoints, scripts e notas em busca de caracteres invisíveis ou incomuns e remova ou substitua-os. O número da linha na mensagem de erro pode ajudar a localizar a área afetada no XML exportado.
  3. Salve e implante o projeto corrigido, em seguida, tente o download novamente a partir do Design Studio.
  4. Se o conteúdo problemático não puder ser identificado, entre em contato com o suporte da Jitterbit com a mensagem de erro completa e o ID do projeto para possível reparo de metadados no backend.

Componentes do projeto ausentes após download ou importação

• Sintoma: Abrir ou importar um projeto mostra operações na lista, mas nenhum componente (transformações, scripts, esquemas) aparece, ou a exportação de um projeto em arquivo .json falha ao importar. A causa geralmente é um único componente corrompido na exportação do projeto que quebra a análise de todo o arquivo.
• Possível causa: Um componente dentro da exportação do projeto possui JSON malformado, como um corpo vazio ou caracteres incomuns que invalidam o arquivo.
• Resolução:
  1. Exporte o projeto do portal Harmony para produzir um arquivo .json.
  2. Abra o arquivo .json em um editor de texto e inspecione o array components em busca de entradas que pareçam vazias, malformadas ou contenham caracteres incomuns.
  3. Remova o objeto JSON completo do componente suspeito do array components.
  4. Salve o arquivo e importe-o de volta para o Harmony.
  5. Se a corrupção não for identificável, envie a exportação do projeto para suporte Jitterbit para análise.

Operações ou transformações duplicadas aparecem em um projeto baixado

• Sintoma: Alguns usuários que baixam o mesmo projeto veem operações ou transformações duplicadas com nomes e esquemas idênticos, e essas duplicatas são sinalizadas como inválidas (marcadas em vermelho) no Design Studio. Outros usuários veem uma versão limpa do mesmo projeto.
• Possível causa: O projeto foi migrado no nível da operação (em vez de no nível do projeto), e a migração adicionou cópias duplicadas de dependências (como transformações) no projeto original.
• Resolução:
  1. Faça um backup do projeto antes de fazer quaisquer alterações.
  2. Identifique as operações ou transformações duplicadas. Exclua as duplicatas mantendo os originais.
  3. Implemente o projeto limpo. Todos os usuários que rebaixarem o projeto receberão a versão limpa.
  4. Para evitar isso no futuro, evite usar migração no nível da operação em um projeto que já contém os componentes de origem. Use migração no nível do projeto ou migre seletivamente apenas as dependências que não estão presentes.

A importação do projeto Salesforce falha com um requisito de versão incorreto

• Sintoma: Importar ou abrir um projeto com um endpoint Salesforce falha com um erro como:

  The Jitterpak requires version 12.7.0.0 or higher. The Studio is currently running version [your Design Studio version]. This means that the Jitterpak cannot be opened by this Studio.
  

  Isso pode ocorrer mesmo em uma versão atual e suportada do Design Studio, porque o Design Studio nunca teve um lançamento 12.x.

• Possível causa: O projeto foi exportado do Design Studio 11.63 ou 11.64. Essas versões marcam um projeto contendo um endpoint Salesforce com um requisito de versão incorreto (12.7.0.0) em vez da versão mínima correta. O Design Studio 11.64.1 e versões posteriores exportam a versão requerida correta.

• Resolução:

  • Se o projeto foi exportado para um arquivo local .jpk:

    1. Renomeie o arquivo .jpk para .zip e extraia-o.
    2. No environment.properties, altere o valor de requires-version para corresponder à sua versão instalada do Design Studio, por exemplo: requires-version=11.63.0.0.
    3. No jitterpak.properties, altere o valor de required_version para o valor codificado correspondente. Para o Design Studio 11.63.0.0, use required_version=110630000000000. Para qualquer outra versão, exporte um novo projeto vazio do seu Design Studio instalado e copie os valores de required_version e requires-version dos arquivos desse projeto.
    4. Comprime os arquivos extraídos de volta em um arquivo .zip, renomeie-o para .jpk e, em seguida, importe-o.

    Esses passos corrigem apenas o arquivo .jpk que você edita. Re-exportar o projeto do Design Studio 11.63 ou 11.64 escreve novamente o requisito de versão incorreto, portanto, atualize para o Design Studio 11.64.1 ou posterior para evitar isso.

  • Se o erro ocorrer ao baixar ou abrir um projeto implantado na nuvem Harmony em vez de ao importar um arquivo local .jpk:

    1. Atualize para o Design Studio 11.64.1 ou posterior.
    2. Entre em contato com o suporte Jitterbit para solicitar a correção do backend para o requisito de versão armazenado do projeto, que não está disponível na interface do Design Studio. Solicite a correção apenas após a atualização: abrir ou re-exportar o projeto com uma versão anterior afetada posteriormente pode escrever o requisito de versão incorreto de volta no projeto.

Notificações

Falha de SOAP não é implantada quando configurada para acionar um e-mail diretamente

• Sintoma: Configurar uma falha de SOAP para acionar diretamente uma notificação por e-mail não é implantado ou não funciona como esperado.
• Possível causa: Implantar uma operação na qual uma falha de SOAP aciona diretamente uma mensagem de e-mail pode produzir um erro.
• Resolução:
  1. Configure a falha de SOAP para acionar uma operação em vez disso.
  2. Nessa operação, use a função SendEmailMessage em um script para enviar o e-mail de notificação.

FTP e fontes de arquivo

Transferências de arquivos se repetem inesperadamente

• Sintoma: Uma operação retransfere um arquivo de origem que já foi processado em uma execução anterior.
• Possível causa: O Design Studio rastreia três critérios para determinar se um arquivo já foi transferido: nome do arquivo, data de modificação e ID da operação. Se algum desses valores tiver mudado desde a última transferência, o Design Studio trata o arquivo como novo e o transfere novamente.
• Resolução: Para evitar que um arquivo específico seja retransmitido, exclua sua entrada da lista de histórico de transferências: selecione a caixa de seleção ao lado da entrada no painel inferior e clique em Excluir.

FTP: Modo passivo e restrições de firewall de porta alta

• Sintoma: Uma fonte FTP conecta-se com sucesso a partir de uma estação de trabalho, mas falha quando a operação é executada no agente privado, ou as transferências de arquivos expiram apesar de o agente conseguir alcançar o servidor FTP.
• Possível causa: O modo passivo FTP utiliza portas de número alto atribuídas dinamicamente para transferências de dados. Firewalls que restringem conexões de saída a portas bem conhecidas bloqueiam essas conexões de canal de dados, mesmo quando o canal de controle (porta 21) está aberto.
• Resolução:
  • Confirme que o Modo Passivo está habilitado na configuração da fonte FTP (ele está habilitado por padrão).
  • Trabalhe com seu administrador de rede para abrir o intervalo de portas de número alto usado pelo seu servidor FTP para conexões de dados passivas no firewall entre o host do agente privado e o servidor FTP.

FTP: Os caminhos das pastas de sucesso e erro estão no agente, não no servidor FTP

• Sintoma: Arquivos não estão aparecendo na pasta de sucesso ou erro configurada após a execução de uma operação FTP, ou os caminhos parecem resolver para locais inesperados.
• Causas possíveis:
  • Os campos de caminho da pasta de sucesso e da pasta de erro em uma fonte FTP referem-se a diretórios na máquina do agente privado, não no servidor FTP remoto. Caminhos relativos são interpretados em relação ao sistema de arquivos do host do agente.
  • Variáveis de palavras-chave de nome de arquivo não são resolvidas nesses campos.
• Resolução:
  • Insira caminhos absolutos no host do agente privado para os campos da pasta de sucesso e da pasta de erro (por exemplo, C:\Jitterbit\processed\ no Windows ou /var/jitterbit/processed/ no Linux).
  • Não use palavras-chave de nome de arquivo ou caracteres especiais, como *, nesses campos de caminho.
  • Confirme que a conta de serviço do agente tem permissões de gravação nos diretórios configurados.

FTP: A listagem do diretório não pode ser analisada

• Sintoma: Uma fonte FTP falha ao listar arquivos, ou arquivos conhecidos estão faltando na fonte, mesmo existindo no servidor FTP.
• Causa possível: Alguns servidores FTP retornam listagens de diretório em um formato não padrão que o Design Studio não consegue analisar usando seu analisador padrão.
• Resolução:
  • Na configuração da fonte FTP, ative Listar apenas nomes de arquivos. Isso faz com que a fonte use o comando NLST, que retorna apenas nomes de arquivos em vez de uma listagem completa de diretório e é mais amplamente suportado entre servidores FTP.
  • Alternativamente, defina a variável Jitterbit jitterbit.source.ftp.enable_regex_parser como true antes da etapa de leitura FTP para habilitar um analisador de listagem mais flexível.

FTP target: O uso de Renomear FTP não é funcional com operações de arquivo SFTP

• Sintoma: Arquivos gravados em um servidor SFTP usando um alvo FTP com Usar Renomear FTP habilitado falham ou não são gravados corretamente quando o tipo de operação é arquivar.
• Possível causa: A opção Usar Renomear FTP não é funcional ao gravar em um servidor SFTP em uma operação de arquivamento.
• Resolução: Na configuração do alvo FTP, desmarque a caixa Usar Renomear FTP quando o servidor de destino for um servidor SFTP e a operação gravar um arquivo de arquivamento.

FTP target: Criar Diretórios Automaticamente é pouco confiável

• Sintoma: Uma operação de alvo FTP falha porque um diretório de destino não existe, mesmo com Criar Diretórios Automaticamente habilitado.
• Possível causa: É um problema conhecido que a opção Criar Diretórios Automaticamente funciona de forma inconsistente. Dependendo do servidor FTP específico, o diretório pode não ser criado.
• Resolução:
  • Crie manualmente os diretórios necessários no servidor FTP antes de executar a operação.
  • Se você usar Criar Diretórios Automaticamente, confirme que o diretório foi criado antes de confiar nele em produção.

Fonte de Compartilhamento de Arquivos: Arquivos individuais maiores que 2 GB não podem ser recuperados

• Sintoma: Recuperar um arquivo grande de uma fonte de Compartilhamento de Arquivos falha, mesmo que o arquivo exista e a conexão de origem esteja configurada corretamente.
• Possível causa: Fontes de Compartilhamento de Arquivos têm uma limitação conhecida onde arquivos individuais maiores que 2 GB podem não ser recuperáveis.
• Resolução: Divida arquivos maiores que 2 GB em segmentos menores antes de colocá-los no compartilhamento de arquivos para recuperação.

Fonte HTTP

O teste de conexão falha mesmo quando o endpoint está acessível

• Sintoma: O teste de conexão de uma fonte HTTP falha com um erro de conexão ou autorização, mas o endpoint é confirmado como acessível e retorna dados quando acessado diretamente em um navegador ou cliente de API.
• Possível causa: O botão Testar Conexão na configuração da fonte HTTP envia uma solicitação HTTP HEAD. Alguns servidores não suportam o método HEAD e retornam um erro 405 ou similar, embora as solicitações GET e POST sejam bem-sucedidas.
• Resolução:
  1. Se o endpoint for confirmado como acessível em um navegador ou por meio de uma solicitação GET/POST direta, o teste de conexão falho pode ser desconsiderado. Prossiga com a implantação e execução da operação para verificar a conectividade real.
  2. Se a operação também falhar em tempo de execução, investigue mais a fundo usando os logs da operação.

Conector NetSuite

Erro de URL do data center: Use a URL WSDL específica da conta

• Sintoma: Um endpoint do NetSuite que anteriormente se conectava com sucesso agora falha com:

  Connector Error: Error getting the data center URL.
  ...
  In this account, you must use account-specific domains with this SOAP web services endpoint.
  

  ou:

  You are not requesting the correct data center for your company.
  

• Possível causa: O NetSuite não aceita mais URLs WSDL genéricas (por exemplo, https://webservices.netsuite.com/...) ou URLs WSDL específicas de data center (por exemplo, https://webservices.na3.netsuite.com/...). O endpoint deve usar uma URL WSDL específica da conta.

• Resolução:
  1. No NetSuite, vá para Configuração > Empresa > Informações da Empresa e abra a aba URLs da Empresa para encontrar o domínio específico da conta.
  2. Construa a URL WSDL específica da conta no formato https://<account-id>.suitetalk.api.netsuite.com/wsdl/v2025_1_0/netsuite.wsdl.
  3. Atualize o campo URL de Download WSDL na configuração do endpoint do NetSuite com a URL específica da conta.
  4. Para instruções completas, veja URL WSDL específica da conta do NetSuite.

Usuários TFA não devem usar o tipo de autenticação SSO

• Sintoma: Um endpoint do NetSuite configurado com autenticação de login único (SSO) falha ou se comporta de maneira inesperada para um usuário com autenticação de dois fatores (TFA ou 2FA) habilitada em sua conta do NetSuite.
• Causa possível: Usuários do NetSuite com TFA habilitada não devem usar o tipo de autenticação SSO ao configurar um endpoint do NetSuite. Essa combinação pode causar a falha do endpoint. O tipo de autenticação SSO também está sendo descontinuado pelo NetSuite.
• Resolução:
  1. Habilite a autenticação baseada em token (TBA) na conta do NetSuite.
  2. Reconfigure o endpoint do NetSuite para usar TBA em vez de SSO.

TBA: erro INSUFFICIENT_PERMISSION em tempo de execução apesar do teste de conexão bem-sucedido

• Sintoma: Um endpoint do NetSuite configurado com autenticação baseada em token (TBA) testa a conexão com sucesso, mas as operações falham em tempo de execução com:

  INSUFFICIENT_PERMISSION
  

• Causa possível: O papel usado para gerar os tokens de acesso TBA não possui permissões suficientes para as operações que estão sendo executadas. O teste de conexão é bem-sucedido mesmo com um papel com permissões insuficientes, mas as verificações de permissão em tempo de execução falham.

• Resolução:
  1. No NetSuite, mude para um papel de Acesso Total ou Administrador ao gerar os tokens de acesso, ou adicione as permissões necessárias ao papel atual.
  2. Regere os tokens de acesso usando o papel atualizado e reconfigure o endpoint do NetSuite.

O dropdown de pesquisa salva está vazio quando o objeto tem mais de 1.000 pesquisas salvas

• Sintoma: O dropdown de pesquisa salva na configuração da atividade NetSuite não é preenchido com nenhuma opção, mesmo que existam pesquisas salvas para o objeto no NetSuite.
• Possível causa: O NetSuite impõe um limite de 1.000 registros em solicitações de API. Se um objeto tiver mais de 1.000 pesquisas salvas, a solicitação de API para recuperá-las excede esse limite e não retorna resultados, deixando o dropdown vazio.
• Resolução: No NetSuite, exclua ou arquive pesquisas salvas que não estão mais em uso para reduzir a contagem total abaixo de 1.000 para o objeto afetado. O dropdown será preenchido assim que a contagem for reduzida. Para mais detalhes, veja limitações de pesquisa salva do NetSuite.

Valores NULL ou em branco não podem ser passados para campos personalizados do NetSuite

• Sintoma: Mapear um valor NULL ou em branco (string vazia) para um campo personalizado do NetSuite não limpa o campo no NetSuite.
• Possível causa: A API do NetSuite não aceita valores NULL ou em branco para campos personalizados através da abordagem padrão de mapeamento de campos.
• Resolução: Para passar valores NULL ou em branco para um campo personalizado, mapeie o campo de origem tanto para os campos filhos externalId quanto name do nó de destino do campo personalizado na transformação. Para mais detalhes, veja Passando valores nulos para campos personalizados.

Segmentos personalizados não exibidos na configuração da atividade

• Sintoma: Segmentos personalizados não aparecem na tela de configuração da atividade do NetSuite quando se espera que estejam disponíveis para mapeamento.
• Causa possível: A conta de usuário do NetSuite configurada no endpoint não possui permissões suficientes para acessar o segmento personalizado ou o objeto ao qual está associado.
• Resolução:
  1. No NetSuite, verifique se a conta de usuário configurada no endpoint do NetSuite possui as permissões apropriadas para interagir com o segmento personalizado e seu objeto associado.
  2. Se as permissões forem insuficientes, atualize o papel do usuário no NetSuite para incluir o acesso necessário ao segmento personalizado.

Conector SAP

IDocs não encontrados quando uma operação agendada é executada em um agente diferente

• Sintoma: Em um grupo de múltiplos agentes usando processamento de IDoc de armazenamento e encaminhamento, a operação agendada que escaneia arquivos IDoc armazenados não encontra arquivos para processar em algumas execuções, e o processamento de IDoc é atrasado ou ocorre fora de ordem.
• Causa possível: No processamento de armazenamento e encaminhamento, o Listener de Eventos SAP armazena cada IDoc recebido no sistema de arquivos local do agente que o recebeu. Uma operação separada em um cronograma rápido então escaneia e processa esses arquivos, mas o Harmony pode despachar essa operação agendada para qualquer agente do grupo. Cada agente processa apenas os arquivos armazenados em si, portanto, arquivos armazenados em um agente não são processados até que o cronograma selecione esse agente novamente.
• Resolução: Cada agente processa seus próprios arquivos armazenados na próxima vez que a operação agendada for executada nele, portanto, os arquivos são eventualmente processados. Se os IDocs devem ser processados em uma ordem garantida, ou sem esperar pela próxima execução agendada do agente de armazenamento, escreva os arquivos IDoc em um recurso compartilhado que todos os agentes possam acessar, como um site FTP, um sistema de arquivos compartilhado ou um banco de dados. Observe que um armazenamento de dados externo adiciona um ponto de falha; clusters de agentes são usados para failover e balanceamento de carga.

Envios em massa de IDoc podem exceder os limites de conexão do endpoint de destino

• Sintoma: Após uma grande operação em massa do SAP enviar milhares de IDocs, operações contra um sistema de destino a jusante (como Salesforce) falham intermitentemente com erros de limite de conexão ou login.
• Possível causa: Os IDocs são enviados de forma assíncrona. Quando milhares de IDocs são gerados por uma atualização em massa, todos eles tentam acionar suas operações a jusante simultaneamente. Sistemas como o Salesforce impõem limites de conexão de API concorrentes, e uma repentina inundação de operações acionadas por IDoc pode exceder esses limites.
• Resolução:
  • Use um padrão de armazenar e encaminhar: configure o ouvinte de IDoc para gravar os IDocs recebidos em arquivos temporários, depois use uma operação agendada para processá-los em lotes controlados a uma taxa previsível.
  • Revise os limites de conexão concorrente e de chamadas de API do endpoint de destino e configure a operação do Design Studio para permanecer dentro desses limites, controlando o número de operações simultâneas.

Payload de IDoc do SAP perdido quando o endpoint de destino está inacessível

• Sintoma: Um IDoc é recebido pelo Ouvinte de Eventos do SAP, mas os dados não chegam ao endpoint de destino e não podem ser recuperados.
• Possível causa: No processamento direto, se o endpoint de destino estiver inacessível quando o IDoc é processado, o payload não é entregue e é permanentemente perdido. Não há um mecanismo de nova tentativa automática no processamento direto.
• Resolução: Use o processamento de armazenar e encaminhar em vez disso: configure a primeira operação para gravar o IDoc recebido em um arquivo temporário, depois use uma operação agendada para processar o arquivo. Se o destino estiver inacessível, o arquivo é retido e reprocessado na próxima execução agendada. Para orientações sobre como implementar o processamento de armazenar e encaminhar, veja Melhores práticas para SAP.

SAP IDoc store-and-forward: Arquivos temporários excluídos após 24 horas

• Sintoma: Em um fluxo de trabalho de IDoc de armazenamento e encaminhamento, arquivos temporários que não foram processados estão ausentes do diretório de armazenamento antes que a operação de processamento tenha sido executada.
• Possível causa: Por padrão, arquivos temporários de IDoc no processamento de armazenamento e encaminhamento são excluídos automaticamente após 24 horas. Se a operação de processamento agendada não for executada dentro desse intervalo (por exemplo, devido a inatividade do agente), os arquivos são removidos antes que possam ser processados.
• Resolução:
  • Certifique-se de que a operação de processamento agendada seja executada pelo menos uma vez a cada 24 horas para processar os arquivos antes que expirem.
  • Alternativamente, aumente o período de retenção se um intervalo mais longo for necessário. Para detalhes, veja Melhores práticas para SAP.

A operação BAPI é bem-sucedida, mas a transação não é confirmada no SAP

• Sintoma: Executar um BAPI parece ser realizado sem erro, mas a transação esperada não aparece no SAP.
• Possível causa: O Conector SAP emite um commit de transação BAPI apenas quando o BAPI retorna um tipo de resposta S (Sucesso). Se o BAPI retornar um tipo de resposta I (Informação), E (Erro) ou W (Aviso), nenhum commit é emitido e a transação não é salva no SAP.
• Resolução:
  1. Verifique o campo TYPE do nó RETURN na resposta do BAPI para confirmar o tipo de resposta que está sendo retornado.
  2. Se você estiver usando um BAPI personalizado, atualize-o para retornar um tipo de resposta S quando a transação deve ser confirmada. Para mais detalhes, veja Solução de problemas de commits BAPI.

O Listener de Evento SAP não captura IDocs no Windows

• Sintoma: O serviço Listener de Evento SAP está em execução, o sistema SAP relata que os IDocs de saída foram enviados com sucesso, mas nenhuma operação é acionada. Os logs do agente mostram erros de conexão para o ID do programa RFC, como:

  serverException occured on [Program ID] connection null
  

• Causa possível: O arquivo de serviços do Windows no host do agente não contém uma entrada para o serviço de gateway SAP. Sem essa entrada, o listener do ID do programa RFC não consegue resolver o nome do host e a porta do gateway SAP, impedindo que os iDocs sejam entregues ao Design Studio.

• Resolução:

  1. No host Windows que executa o agente privado, abra %WINDIR%\System32\drivers\etc\services como administrador.

  2. Adicione as seguintes linhas:

     sapgw00 3300/tcp
     sapgw00 3300/udp
     

  3. Salve o arquivo, reinicie o serviço Listener de Evento SAP e o agente, e teste novamente enviando um IDoc do SAP.

O nome do serviço sapgw00 e a porta 3300 correspondem ao serviço de gateway SAP padrão para o número do sistema 00. Se o seu sistema SAP usar um número de sistema diferente, ajuste as entradas de acordo (por exemplo, sapgw01 3301/tcp e sapgw01 3301/udp para o número do sistema 01).