Conector de API para Jitterbit Integration Studio
Resumo
O conector de API expõe uma operação ou um conjunto de operações como um endpoint REST consumível. Ele vem com uma conexão pré-configurada que não requer configuração de conexão, como é típico para a maioria dos conectores Harmony. Essa conexão fornece acesso a atividades de API que, uma vez configuradas, interagem com APIs personalizadas configuradas no Jitterbit API Manager.
O conector de API é acessado na aba Endpoints e conectores do projeto da paleta de componentes de design (veja Paleta de componentes de design).
Para informações sobre a relação entre atividades do conector de API e APIs do API Manager, consulte estes recursos:
Importante
Por padrão, operações de API bem-sucedidas (configuradas para APIs personalizadas ou serviços OData) não são incluídas nos logs de operação a menos que uma dessas configurações esteja habilitada:
EnableLogging=true
na seção [APIoperation]
do arquivo de configuração do agente privado. Visão geral do conector
Este conector é destinado a ser usado em conjunto com uma API personalizada do API Manager para expor uma operação ou um conjunto de operações como um endpoint REST consumível.
Os tipos de atividade são usados para criar instâncias de atividades que são destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).
Juntos, a conexão de API pré-configurada e suas atividades são referidos como um endpoint de API:
-
Requisição: Configurada usando um esquema JSON, XML, CSV ou XSD, esta atividade recupera dados quando chamada por uma API personalizada do API Manager e é destinada a ser usada como uma fonte para fornecer dados a uma operação.
-
Resposta: Configurada usando um esquema JSON, XML, CSV ou XSD, esta atividade retorna dados a uma API personalizada do API Manager e é destinada a ser usada como um alvo para consumir dados em uma operação.
-
Requisição SOAP: Configurada usando um esquema WSDL, esta atividade recupera dados quando chamada por uma API personalizada do API Manager e é destinada a ser usada como uma fonte para fornecer dados a uma operação.
-
Resposta SOAP: Configurada usando um esquema WSDL, esta atividade retorna dados a uma API personalizada do API Manager e é destinada a ser usada como um alvo para consumir dados em uma operação.
Nota
Este conector é um conector nativo do Integration Studio, que pode ser referido pela Jitterbit ao comunicar mudanças feitas nos conectores. O cronograma de lançamentos para conectores nativos do Integration Studio é baseado na cadência das aplicações web do portal Harmony.
Variáveis da API Jitterbit
Essas variáveis do Jitterbit são fornecidas especificamente para uso com endpoints da API:
Solução de Problemas
Se você encontrar problemas com o conector da API, as seguintes etapas de solução de problemas são recomendadas:
-
Certifique-se de que a conexão da API foi bem-sucedida usando o botão Testar na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado pode fornecer uma indicação do problema.
-
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
-
Ative o registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
-
Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.
-
Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.
-
Solicitação SOAP e Atividades de Resposta SOAP: Ao implantar uma operação cuja atividade de Solicitação SOAP ou Resposta SOAP teve seu arquivo WSDL substituído, você pode receber este erro:
Falha ao implantar - Erro do Cliente: Não há arquivo enviado com o caminho do cliente ... Atualize para o Studio 8.4.0 ou superior e implante o projeto novamente.
Para resolver, siga estas etapas:
-
Abra a atividade onde o arquivo WSDL foi substituído.
-
Na etapa 1, selecione novamente o arquivo WSDL a ser usado para a atividade e clique em Próximo.
-
Na etapa 2, clique em Concluir.
-
Implemente a operação.
-