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.