Páginas filhas
  • Desenvolvimento de APIs para o produto Logix

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Para desenvolvimento de API específica de cliente é preciso adicionar o sufixo "_espec" no nome do fonte para que não gere conflitos com os fontes de APIs disponibilizadas pelo produto padrão e a compilação de fonte específico acabe sobrepondo funções do fonte padão.  Exemplo: transportadoras_espec.4gl
  • No TFS os arquivos com o código fonte das APIs específicas devem ser armazenados respeitando o mesmo padrão de pastas utilizado para as APIs do produto padrão, ou seja:

Exemplo:

API PADRÃO     → $/Logix/Fontes_Doc/Sustentacao/V12/V12/suprimentos/suprimentos/api/v1/Request.4gl

API ESPECÍFICA → $/Logix/Fontes_Doc/Customizacao/V12/<cliente>/suprimentos/suprimentos/api/v1/Tributos_espec.4gl  (sufixo "_espec" no final do nome do arquivo)

  • As funções internas do fonte de API específica deverá ter nome de funções acrescentando a letra "e" (específico) ao final do nome do módulo, assim como já é muito utilizado no nome de fontes específicos atualmente. Neste todas funções internas da API específica, utilizando como exemplo a API específica "Tributos" citada logo acima, deverão ficar definidas com o seguinte prefixo vdpe_v1_tributos.

Exemplos:

vdpe_v1_tributos()          >> função principal para definição de rotas

vdpe_v1_tributos_post() >> Função acionada pelo método POST (definida na função de rotas)

vdpe_v1_tributos_get()   >> Função acionada pelo método GET (definida na função de rotas)

Informações
titleImportante

Os programas 4GL disponibilizados, deverão seguir o padrão de localização abaixo:

Exemplos:

Objeto de NegócioFunção de roteamento
\suprimentos\obrigacoes_fiscais\api\v1\transportadoras.4globf_v1_transportadoras
\suprimentos\suprimentos\api\v1\estoque.4glsup_v1_estoque
\adm_producao\manufatura\api\v1\apontamento_horas.4glman_v1_apontamento_horas
Nota
titleImportante - Desenvolvimento de APIS específicas de clientes (Fábrica de Software)


     Dentro do código fonte 4GL a definição da função principal (roteadora) é de fundamental importância, pois é ela que será primeiramente chamada e que definirá como será a execução das outras funções com base na requisição solicitada. Segue abaixo um exemplo de definição:

...