Ir para o conteúdo

Solução de problemas do SDK do Conector

Solução de problemas

Esta página fornece dicas e sugestões para solucionar problemas ao usar o SDK do Conector Jitterbit. Consulte a página de Problemas conhecidos para informações adicionais.

P: Registrei meu conector, editei o arquivo de manifesto e construí o conector; no entanto, não o vejo aparecendo no arquivo de log do agente como carregado. O que pode estar errado?

R: Se você não vê o conector sendo carregado ou vê uma mensagem de erro no log, verifique se a construção foi realizada corretamente. Descompacte o arquivo JAR que foi criado e verifique o arquivo MANIFEST.MF dentro, confira se os arquivos estão todos presentes e se o conteúdo do manifesto corresponde ao que você pretendia. Se você estiver executando no sistema operacional Windows, há um problema conhecido com a construção de arquivos JAR onde a última entrada de um manifesto é ignorada se não houver uma quebra de linha/retorno de carro no final. Se, ao abrir o arquivo em um editor de texto, você não vê uma linha em branco no final, adicione uma e tente reconstruir e reiniciar seu agente.

Verifique se o registro do conector foi realizado corretamente usando a API de registro para recuperar os conectores registrados para a organização que você está usando. O nome sob o qual o conector está registrado deve ser o mesmo que o nome usado no arquivo JSON que descreve a interface do Studio e nos arquivos de código-fonte Java. Verifique os logs do agente e do servidor Tomcat em busca de mensagens indicando que o conector foi visto e registrado corretamente.

P: Meu conector não está aparecendo na interface do Studio. O que pode estar errado?

R: Verifique estes pontos:

  • Verifique se o arquivo de interface do conector (por padrão, adapter.json) é um JSON válido; o agente relatará erros no log se houver algum problema.
  • Verifique nos logs do agente se o conector foi registrado com o Harmony; os logs devem listar as informações fornecidas no arquivo MANIFEST.MF, incluindo o nome do conector registrado, autor, chave do conector, ID do tipo de entidade de endpoint e IDs de atividade.
  • Use esta coleção do Postman para ver quais adaptadores (conectores) o Harmony está retornando.
  • Verifique se o registro do conector foi realizado corretamente usando a API de registro para recuperar os conectores registrados para a organização que você está usando.
  • O nome sob o qual o conector está registrado deve ser o mesmo que o nome usado no arquivo JSON que descreve a interface do Studio e nos arquivos de código-fonte Java. Verifique os logs do agente e do servidor Tomcat em busca de mensagens indicando que o conector foi visto e registrado corretamente.
  • Ocasionalmente, pode ser necessário incrementar a versão no MANIFEST.MF do conector, reconstruir e, em seguida, redistribuir para que as alterações sejam propagadas.
  • Se estiver usando um agente privado do Windows, tente reiniciar o agente.

Q: Onde estão os arquivos de log que devo consultar para depurar problemas de conector?

A: Os arquivos de log são aqueles do servidor Tomcat do agente Jitterbit. Eles estão localizados em um diretório do agente Jitterbit:

<JITTERBIT_HOME>/tomcat/logs

No sistema operacional Windows, o log é chamado catalina.<date_stamp>.out; no sistema operacional Linux (e no agente Docker), o arquivo de log atual é chamado catalina.out e, à medida que aumenta de tamanho, é transferido para catalina.<date_stamp>.out.

Q: Ao tentar executar operações com meu conector, elas retornam com um erro de conversão de tipo autorreferencial nos logs de operação. Como posso corrigir isso?

A: Se o erro de conversão de tipo parecer semelhante a Caused by: java.lang.ClassCastException: org.jitterbit.connector.connectorName.ConnectorNameConnection cannot be cast to org.jitterbit.connector.connectorName.ConnectorNameConnection, siga este procedimento:

  • Pare o agente.
  • Remova o arquivo JAR do conector do diretório de conectores do agente.
  • Reinicie o agente.
  • Adicione o arquivo JAR do conector novamente.

Q: Um campo de solicitação aparece como um nó obrigatório na transformação e o sinaliza como inválido, mesmo que o campo deva ser opcional. Como posso corrigir isso?

A: Verifique a declaração minOccurs para esse elemento no esquema de solicitação XSD da atividade. Um elemento que omite minOccurs tem como padrão minOccurs="1" e é tratado como obrigatório, independentemente do valor de maxOccurs. Para tornar o campo opcional, declare minOccurs="0" explicitamente. Para mais detalhes, consulte Campos de solicitação obrigatórios e opcionais.