BPM - Integração BPM G5/G6 - Ocorre uma inconsistência no retorno do json utilizando SXI-API quando do retorno de apenas 1 registro de uma tabela, onde o mesmo não é definido como um array
Incidente
Quando montada uma fonte de dados através do SXI disponibilizado para conversão em Rest dos web services, o retorno é feito como um array quando utilizada uma tabela, contudo, o SXI está se comportando de forma equivocada quando do retorno de apenas 1 registro, uma vez que não é montado um array nessa circunstância.
Causa
Este problema ocorre devido a versão da SXI-API não estar preparada para tratar o envio dos arrays de retorno da G5.
Solução
Para solução deste problema, é necessário atualização do componente de integração e alteração da URL do serviço. Desta forma todos os retornos, utilizando este serviço ou fonte de dados, serão definidos como um array. Para isso, execute os passos abaixo:
1. Execute o processo de undeploy e redeploy do componente conforme o Artigo Como realizar o redeploy da SXI-API para integração BPM / G5;
2. Acesse a URL da API em https://>server>:<porta>/SXI-API/version;
Importante
Deve ser apresentada no navegador a versão 2.1.0 ou superior.
3. Acesse a Plataforma com usuário administrador dos Processos BPM;
5. Entre no menu X Platform / BPM / Configurações / Serviço Externo ou X Platform / BPM / Configurações / Fontes de Dados (dependendo do recurso que irá alterar);
6. Altere a URL do recuso incluindo ao final da mesma o parâmetro
useAlwaysArray=true, desta forma os retornos que contém apenas 1 registro também serão transformados em Array por default;
7. Salve as alterações do serviço externo ou fonte de dados;
8. Valide a integração.