Pular para o conteúdo principal
Versão: 2.2.3

Troubleshooting

Veja nas seguintes seções os problemas que podem ser apresentados ao informar o corpo da requisição/resposta ou no teste de consumo e suas possíveis resoluções:

Problemas ao informar o corpo da requisição/resposta

Durante as etapas "Parâmetro de entrada" e "Parâmetros de saída" da fonte de dados REST, ao inserir um exemplo de corpo de requisição/resposta, é possível que um dos casos a seguir ocorra, impossibilitando, desta forma, o avanço para a próxima etapa:

O array "Identificador do parâmetro", informado no exemplo, deve conter apenas um item e este deve ser um objeto JSON

Esse problema ocorre quando, no JSON que está sendo passado para o corpo de exemplo, contém algum atributo que é do tipo "array", porém, este tem mais de um elemento e/ou seu tipo não é "objeto". Dentro da fonte de dados REST são reconhecidos apenas arrays que contenham um objeto dentro dele, visto que o exemplo informado será utilizado para montagem dos atributos.

Exemplo inválido

{
"request": [1, 2, 3, 4],
"request2": [
{
"id": 0
},
{
"id": 0
}
]
}

Exemplo válido

{
"request": [
{
"id": 0
}
]
}

No exemplo inválido, ambos os atributos (request e request2) não são válidos para o componente. A fonte de dados utiliza os atributos apenas de um objeto especificado para ler os atributos. Desta forma, somente pode haver um objeto dentro da lista.

Caso seu exemplo de corpo de requisição/resposta contenha mais de um objeto, basta deixar apenas um deles dentro da estrutura de lista. Senão, caso houver elementos que não sejam objetos, estes não serão suportados pela fonte de dados REST.

Não foi possível identificar o tipo do parâmetro "Identificador do parâmetro". Por favor, insira um valor válido para que seja possível identificar o tipo de dado

Esse problema ocorre quando algum atributo do JSON do corpo de requisição/resposta está com valor "null". Como a fonte de dados utiliza o JSON informado para mapear os atributos necessários a fim de fazer o consumo dos dados, um tipo null não pode ser identificado pelo componente, já que ele precisa de um tipo definido de forma clara.

Exemplo inválido

{
"request": null
}

Exemplo válido

{
"request": 1000
}

Para resolver essa situação basta definir o tipo correto para o atributo especificado. Caso não saiba qual é o tipo do atributo a ser aplicado, deve ser verificado na especificação do serviço a ser integrado.

No exemplo válido, o tipo do atributo será identificado como numérico. No valor do atributo, adicione um valor que corresponde ao tipo desejado pelo serviço integrado.

O objeto "Identificador do parâmetro" deve ter pelo menos um filho

Esse problema ocorre quando, no JSON do corpo de requisição/resposta, há um atributo que é um objeto JSON, porém este não tem nenhum filho associado. Com isso, o componente não consegue interpretar o atributo.

Exemplo inválido

{
"“request": [
"r1" : {}
]
}"

Exemplo válido

{
"request":[
"r1":{
"id":90,
"name":"test"
}
]

No exemplo inválido, o JSON não será interpretado corretamente pelo componente, já que o atributo "r1" é um objeto sem filhos associados.

Para resolver o problema, deve-se mapear corretamente os filhos do atributo com o problema. Essas informações devem ser verificadas na especificação do serviço a ser integrado.

Problemas ao consumir a fonte no teste de consumo

Não foi possível montar o corpo da requisição/resposta para a fonte de dados

Este problema pode ocorrer por alguma das seguintes situações:

  • Mapeamento incorreto do corpo de requisição/resposta na fonte de dados: Verifique se os atributos mapeados no corpo de requisição/resposta estão de acordo com o serviço a ser consumido.
  • Parâmetros do tipo PATH foram declarados, porém nem todos foram preenchidos: Preencha todos os parâmetros do tipo PATH antes de consumir a fonte.

Não foi possível chamar o serviço da fonte de dados: java.net.ConnectException: Connection refused (Connection refused)

Pode significar que o host e a porta do serviço especificado (na URL passada durante a etapa "Dados do serviço REST") não estão sendo encontrados ao consumir o serviço. Verifique se a URL declarada é válida para consumo.

Não foi possível chamar o serviço da fonte de dados: java.net.UnknowHostException

Ao tentar consumir o serviço, a fonte não está encontrando o host do serviço. Verifique se o domínio da URL é um domínio válido.

HTTP Code

Se for retornado algum dos status HTTP como resposta ao consumir o serviço, verifique a seguinte tabela de acordo com o status retornado:

  • 401 (HTTP 401 Unauthorized)
    • O serviço requer autenticação para ser consumido. Verificar se a fonte de dados tem autenticação e ela está correta.
  • 403 (HTTP 403 Forbidden)
    • O serviço especificado não permite acessar o recurso requisitado.
  • 500 (HTTP 500 Internal Server Error)
    • Ocorreu algum erro não esperado no recurso a ser consumido.