Histórico da Página

...

1. Visão Geral
2. Como cadastrar uma fórmula visual para executar em uma API
3. Gatilhos disponibilizados para APIs
4. Seleção e uso do contexto na Fórmula Visual
5. Exemplos de Utilização

01. VISÃO GERAL

A partir da versão 12.1.29 é possível customizar APIs através de Formulas Visuais. Foram criados gatilhos específicos para esse tipo de FV, que mostraremos a seguir.

...

A Fórmula Visual deve estar cadastrada com a opção Executa em API (POCO) habilitada, conforme exibido na imagem abaixo. 

Image Modified

Ao marcar a opção Executa em API (POCO), automaticamente o campo Visível para todas as coligadas será habilitado e não é possível desmarcá-lo. 

...

Abaixo estão todos os gatilhos para API:

Image Modified

Os gatilhos Antes/Depois de recuperar todos (get) correspondem ao GetAll e os gatilhos Antes/Depois de recuperar (Get), correspondem ao GetOne.

...

Primeiro: Selecionar o contexto para a Fórmula Visual:

Image Modified

Segundo: Adicionar a atividade de Gerar exceção, clicar em Ligações, na propriedade 'Mensagem de Erro', clicar em reticências. 

...

Obs.: As propriedades das APIs serão sempre listadas abaixo da hierarquia de _Items.

Image Modified

Terceiro: Adicionar um gatilho para essa Fórmula Visual. 

...

No Postman, aplicativo que usamos para realizar testes de APIs, chamamos o endpoint de usuários, buscando o usuário mestre. 

Image Modified

Veja que o retorno foi uma exceção, contendo na mensagem o valor do campo userName (do contexto) e o nome da Fórmula Visual.

...