Pular para o conteúdo principal

Como acessar um Fluxo Web

Visão geral​

Um Fluxo Web é um fluxograma da camada Servidor marcado com a propriedade Web ativada. Com isso, a regra pode ser chamada por uma página HTML ou por qualquer cliente HTTP, sem necessidade de abrir um formulário no Webrun.

Neste guia, o exemplo cadastra um Estado na tabela GER_ESTADO a partir de um botão em uma página HTML simples.

Consultar os fluxos web do projeto​

Antes de montar a URL de chamada, você pode verificar quais fluxos estão disponíveis como Web no seu projeto, seus parâmetros de entrada e a URL de cada regra.

Pelo painel administrativo​

  1. Acesse a Tela de Configuração do Webrun.
  2. Clique em Fluxos Web:

Opção Fluxos Web na Tela de Configuração

A tela exibe os sistemas que possuem fluxos marcados como Web, os respectivos fluxos e os parâmetros necessários para a execução de cada um:

Lista de Fluxos Web

Pela URL direta​

Também é possível acessar a mesma listagem diretamente pelo endereço:

http://INSTANCIA:PORTA/CONTEXTO/webRules.jsp

Substitua os valores conforme o seu ambiente.

Conferência antes de integrar

Use essa tela para validar o nome exato do fluxo (incluindo espaços e acentos) e os parâmetros de entrada antes de montar a URL ou o formulário HTML.

Passo a passo​

1. Criar e publicar o fluxo​

1.1 Montar o fluxograma​

  1. Adicione um processamento Processamento e utilize a função Executar Atualização.

  2. Ao clicar no parâmetro SQL Atualização, a tela Propriedade será aberta:

    Propriedade SQL Atualização

  3. Clique em Construtor SQL. Abrirá a tela Construtor SQL: Inserção. No campo Tabela, selecione GER_ESTADO.

  4. No campo Código (est_cod), informe o valor desejado:

    Campo Código

  5. No campo Nome (est_nome), informe o estado desejado:

    Campo Nome

    A tela deve ficar assim:

    Construtor SQL completo

1.2 Salvar e marcar como Web​

  1. Salve o fluxo na camada Servidor.

  2. Na aba Objeto Fluxos, clique com o botão direito no fluxo e selecione Web:

    Marcar fluxo como Web

  3. Salve o projeto.

2. Criar a página HTML​

Abra um editor de texto e crie um arquivo HTML com o código abaixo. Ajuste a URL do action conforme o seu ambiente e o nome exato do fluxo:

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
  <form method="POST" action="http://127.0.0.1:202/webrunstudio/Fluxo web.rule?sys=TRB">
    <input type="submit" value="CLIQUE" id="botao" name="botao" />
  </form>
</body>
</html>

3. Testar a integração​

  1. Abra o arquivo HTML no navegador.

  2. Clique no botão CLIQUE:

    Botão de teste

  3. Consulte a tabela TRB_ESTADO e verifique se o registro foi criado:

    Registro criado

Montagem da URL​

A URL de chamada segue o padrão:

http://[IP]:[Porta]/[Contexto]/[Nome da regra].rule?sys=[Sigla do sistema]
ItemObservação
Nome da regraDeve ser exatamente como definido no fluxo, incluindo espaços, acentos e caracteres especiais
Parâmetro sysObrigatório — identifica o código do sistema
Demais parâmetrosPodem ser enviados via GET ou POST, com o mesmo nome definido no fluxo

Exemplo com parâmetro de entrada​

Se o fluxo possui um parâmetro chamado Código do Cliente, inclua um campo com o mesmo nome no formulário HTML:

<input type="text" name="Código do Cliente" />

Também é possível enviar arquivos como parâmetro de entrada:

<input type="file" name="arquivo" />

O retorno da regra é enviado na resposta do POST — pode ser texto (String) ou bytes, conforme o retorno definido no fluxo.

Parâmetros reservados

Não utilize como parâmetro de entrada da regra os nomes sys, formID ou locale.

Informações complementares​

  • Para um exemplo completo de envio de arquivos via Fluxo Web, consulte Enviando arquivos via fluxo Web.
  • O sistema que utilizar Fluxos Web não deve conter instância configurada na Área de Trabalho.