JEX

JEX - Consultar CEP via Webservice

Neste tópicos veremos como fazer uma requisição do webservice de CEP via JEX. O Webservice que será usado é o da ViaCep, um webservice gratuito que busca todos os CEP's do Brasil.

Conceito:

CEP (Código postal) ou (Código de Endereçamento Postal) é um código desenvolvido pelas administrações postais e criado com o intuito de facilitar a organização logística e localização espacial de um endereço postal.

Acessando o site da ViaCep, você encontra toda a documentação necessária para realizar as requisições JSON, XML, entre outras, nos formatos de retorno.

No print, você pode ver quais os campos criados para puxar as informações conforme o CEP for preenchido. A principal configuração nesse processo, irá partir do primeiro formulário, o campo CEP.

O CEP possui um evento logo na saída do formulário. Ou seja, uma vez que sair desse campo, clicando fora dele ou pressionando enter/tab, uma série de eventos irá acontecer.

O código inserido no PEX basicamente executa: Caso o ViaCep retorne as informações do endereço daquele CEP, então, o valor deles no campo deve ser preenchido, fazendo com que as informações sejam gravadas de forma automática. Claro, apenas caso o CEP exista.

Código JEX:

async function aoSairCampoFormulario() {

JEX - Executar Função

Evento de sistema utilizado para que em determinado momento (configurado ao entrar ou sair do evento) o procedimento BPM execute uma função JEX criada no sistema.

Abaixo mais detalhes do evento:

Descrição: Campo traz por padrão a 'descrição do tipo do evento', mas permite edição;

Momento da execução: Define o momento em que o evento vai ser executado (Ao entrar ou Ao sair).

Função: Ao utilizar o assistente, traz a lista de todas as funções JEX criadas no sistema (Módulo de processos > JEX - Funções).

Assim que selecionada uma função, todo o script dessa função aparecerá no campo abaixo 'Chamada da função' como Somente Leitura para que o usuário verifique o seu código.

Exemplo de utilização simples

Módulo Processos > JEX - Funções

Clicar em 'Novo[F2]'

Descrição 'Somar'

E inserir na tela de código:

async function somar() { const a = 5; const b = 10; const resultado = a + b; console.log(`O resultado da soma é: ${resultado}`); return resultado; }

Após salvar a função, ela ficará disponível para ser utilizada no evento "JEX - Executar função" em qualquer processo BPM do sistema.

JEX - Função Gerar Planilha

Descrição

Função utilizada para gerar planilhas Excel a partir de dados do sistema.

Sintaxe

gerarPlanilha(dados, nomeArquivo, nomePlanilha)

Parâmetros

Exemplo de uso

var dados = [ {nome: "João", idade: 30, cidade: "São Paulo"}, {nome: "Maria", idade: 25, cidade: "Rio de Janeiro"}, {nome: "Pedro", idade: 35, cidade: "Belo Horizonte"} ]; gerarPlanilha(dados, "relatorio_clientes", "Clientes");

Observações