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.

Q: 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 sendo carregado. O que pode estar errado?

A: 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 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 da última entrada. 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 usuário do Integration Studio e nos arquivos de origem Java. Verifique os logs do agente e do servidor Tomcat em busca de mensagens indicando que o conector foi visto e registrado corretamente.

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

A: Verifique estes pontos:

Verifique se o arquivo de interface do usuário 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 usuário do Integration Studio e nos arquivos de origem 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 verificar para depurar problemas de conector?

A: Os arquivos de log são os 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 cresce, é 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.