Glossário

passo

11min

Visão Geral

Um "Passo", dentro do contexto de um fluxo na plataforma Fluid, é uma unidade individual de operação que executa uma ação específica. É um componente que define a lógica de negócio ou a manipulação de dados necessária para avançar no processo de integração. Passos são os elementos fundamentais de um fluxo, permitindo a criação de processos de integração detalhados e multifacetados.

5 passos de um fluxo
Aqui vemos 5 passos de um fluxo


Função dos Passos

Cada passo em um fluxo é configurado para realizar uma tarefa, como acessar um serviço web, processar dados, realizar uma consulta a um banco de dados ou invocar uma API. Os passos são encadeados para formar um fluxo coerente, onde a saída de um passo pode servir como entrada para o próximo, criando uma cadeia lógica de operações.

Tipos de Passos

Na Fluid, os passos podem variar amplamente em complexidade e função, dependendo do conector utilizado e da tarefa a ser executada. Existem diferentes tipos de passos para diferentes propósitos, incluindo:

  • Passos de Leitura e Escrita:
    Para buscar ou enviar dados a uma fonte específica.
  • Passos de Transformação:
    Para modificar dados de acordo com regras ou lógica definidas.
  • Passos de Controle de Fluxo:
    Para direcionar a execução do fluxo com base em condições ou resultados.

Configuração dos Passos

Cada passo é configurado através de uma interface gráfica que permite definir suas ações e comportamento. Isso inclui:

  • Conexão:
    Especificar com qual sistema ou serviço o passo irá interagir.
  • Operação:
    Determinar a ação exata que o passo deve executar.
  • Parâmetros:
    Definir os dados necessários para o passo e mapear como serão utilizados.

Identificador e Nome de Visualização

A partir da última atualização, a nomenclatura dos passos foi aprimorada para melhorar a usabilidade e facilitar a referência dentro dos fluxos.

Identificador do Passo

O Identificador do Passo é um nome único utilizado internamente para referenciar o passo dentro dos fluxos. Ele segue as seguintes regras:

  • Não pode conter espaços ou caracteres especiais.
  • É utilizado em referências dentro dos fluxos e em expressões dinâmicas.
  • Deve ser único dentro do fluxo para evitar conflitos.
  • Caso o usuário não defina um nome de visualização, o identificador será exibido no canvas.

Exemplo:

  • Identificador: consultaDados

Nome de Visualização

O Nome de Visualização é um rótulo amigável exibido na interface visual da plataforma para facilitar a leitura e organização do fluxo. Diferente do identificador, ele pode conter espaços e caracteres especiais.

  • Caso o nome de visualização não seja preenchido, o identificador será utilizado como padrão.
  • Esse nome pode ser alterado sem impactar a execução do fluxo.
  • É útil para tornar os fluxos mais compreensíveis, especialmente em cenários complexos.

Exemplo:

  • Nome de Visualização: Consulta de Dados do Cliente
Document image


Configuração de um Passo

Para configurar um passo no fluxo:

  1. Arraste o conector desejado para o canvas.
  2. Acesse a aba Propriedades.
  3. Defina um Identificador do Passo (campo obrigatório).
  4. Opcionalmente, defina um Nome de Visualização.
  5. Configure as demais parametrizações do conector.
  6. Salve as alterações.

Exibição no Canvas

  • O Nome de Visualização será exibido na interface do usuário, tornando a compreensão mais intuitiva.
  • Caso não seja informado, o Identificador do Passo será utilizado como padrão.
  • Durante a execução, logs e depuração poderão exibir o identificador para fins técnicos.

Monitoramento e Depuração

Passos individuais podem ser monitorados para verificar o sucesso ou falhas, o que é essencial para a depuração e otimização do fluxo. A plataforma Fluid fornece ferramentas e logs detalhados que ajudam a identificar e corrigir problemas em tempo real.

Importância dos Passos

Passos bem configurados garantem que o fluxo funcione de maneira eficaz e eficiente, representando a lógica de negócios de maneira clara e organizada. Eles são a base para construir automações poderosas que podem transformar a maneira como você gerencia dados e processos.

Updated 24 Feb 2025
Doc contributor
Did this page help you?