Solução de Problemas do SDK do conector¶

Solução de problemas¶

Esta página fornece dicas e sugestões para solucionar problemas usando o Harmony Connector SDK. Veja o Problemas conhecidos para obter informações adicionais.

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

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

Verifique se o registro do conector foi realizado corretamente usando o API de registro para recuperar o registrado conectores para a organização que você está usando. O nome sob o qual o conector está registrado deve ser o mesmo como o nome usado no arquivo JSON que descreve a IU do Integration Studio e nos arquivos de origem Java. Verifique tanto o agente e o servidor Tomcat registra mensagens indicando que o conector foi visto e registrado corretamente.

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

R: Verifique estes pontos:

• Verifique se o arquivo de IU do conector (por padrão, adapter.json) é um JSON válido; o agente reportará erros no log se houver algum problema.
• Verificar nos logs do agente se o conector foi registrado no Harmony; os logs devem listar os informações fornecidas no MANIFEST.MF arquivo, incluindo o nome do conector registrado, autor, chave do conector, ID de tipo de entidade de endpoint e IDs de atividade.
• Use esta coleção do carteiro para ver qual adaptadores (conectores) Harmony está retornando.
• Verifique se o cadastro do conector foi realizado corretamente utilizando o API de registro para recuperar o registrado conectores para a organização que você está usando.
• O nome sob o qual o conector está registrado deve ser o mesmo usado no arquivo JSON que descreve o IU 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, reimplantar para que as alterações se propaguem.
• Se estiver usando um Windows Agente Privado, tente reiniciar o agente.

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

R: Os arquivos de log são aqueles para o servidor Tomcat do Harmony Agente. Eles estão localizados em um Diretório do Agente Harmony:

<JITTERBIT_HOME>/tomcat/logs

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