/IWFND/GW_CLIENT

A /IWFND/GW_CLIENT funciona como um cliente HTTP dentro do sistema SAP Gateway. Escolhe-se um método (GET, POST, PUT, PATCH, MERGE, DELETE ou HEAD), informa-se uma URI de requisição, adicionam-se headers e um payload, e executa-se. A resposta aparece ao lado da requisição, com status HTTP, headers e corpo. Na mesma tela é possível:

• adicionar opções de URI como $count ou $format=json;
• ir para o log de erros, para a manutenção do serviço ou para a implementação do serviço;
• transformar uma resposta na próxima requisição com Use as Request;
• limpar ou reconstruir o cache de metadados no hub, no back-end ou em ambos.

A /IWFND/GW_CLIENT responde à pergunta que um app SAP Fiori esconde: o que o próprio serviço retorna?

Um comprador da Alder Manufacturing relata que a lista de fornecedores não mostra nenhuma entrada para a Cedar Office Supply:

1. Copie a URI da requisição com falha nas ferramentas de desenvolvedor do navegador, por exemplo /sap/opu/odata/sap/ZALDER_SUPPLIER_SRV/SupplierSet com seu filtro.
2. Inicie a /IWFND/GW_CLIENT, selecione GET e cole a URI.
3. Execute e leia o status HTTP e o corpo da resposta.
4. Altere uma coisa de cada vez: remova o filtro, adicione $format=json, solicite a entidade individual pela chave.
5. Para uma gravação com falha, reconstrua a requisição com o mesmo método, os mesmos headers e o mesmo payload; o SAP Gateway exige um X-CSRF-Token válido, obtido com um GET anterior, nas requisições de modificação.
6. Se o erro veio do relato de um usuário, abra a entrada na /IWFND/ERROR_LOG e reexecute-a de lá, em vez de digitá-la novamente.

Uma requisição que falha na /IWFND/GW_CLIENT é um problema do serviço; uma requisição que funciona ali aponta de volta para o app ou seus parâmetros.

A /IWFND/GW_CLIENT transforma um sintoma vago do app em um status HTTP que aponta para uma camada.

A /IWFND/GW_CLIENT pode salvar uma requisição como caso de teste em um grupo de teste, no banco de dados ou como arquivo no PC. Um caso de teste guarda o método, a URI, os headers, o payload e um status HTTP esperado; a validação de resposta compara uma nova resposta com uma armazenada.

A SAP entrega grupos de exemplo, CORE_SAMPLES para OData V2 e V4_TEST para OData V4, que só funcionam quando os serviços chamados por eles estão ativos. Para um serviço customizado, um pequeno grupo de teste executado após cada transporte detecta regressões antes dos usuários. Os casos de teste fazem da /IWFND/GW_CLIENT uma ferramenta leve de teste de regressão, e não apenas uma tela de depuração.

• /IWFND/ERROR_LOG e /IWBEP/ERROR_LOG: localizam a requisição com falha e a reexecutam na /IWFND/GW_CLIENT.
• /IWFND/TRACES: registra traces de payload e de performance quando a requisição funciona, mas os dados parecem errados.
• /IWFND/MAINT_SERVICE: verifica o registro e o system alias quando o serviço não é encontrado.
• SU53: confirma uma falha de autorização por trás de um 403.

Vale lembrar que o resultado reflete o usuário e as autorizações com que a requisição de teste é executada, que normalmente não são os do usuário que relatou o problema. A /IWFND/GW_CLIENT reproduz a requisição; as transações relacionadas explicam o resultado.