Em Desenvolvimento
Esta documentação ainda está em desenvolvimento. Agradecemos sua paciência!
Pular para o conteúdo principal
Versão: 03.007.000

Registro da Tabela

Campo que permite permite associar um registro de tabela (Item previamente cadastrado) ao formulario do fluxo, como por exemplo selecionar um cliente da lista de clientes. Para utilizar este recurso, é necessário que uma estrutura de tabela na tenha sido criada e configurada.

  • Obrigatório:

    • Campo do tipo caixa de seleção que pode ser marcada (ativada) ou desmarcada (desativada). Quando marcada, fará com que o usuário do fluxo seja obrigado a alimentar dados neste campo, não sendo possível prosseguir para próxima tarefa sem preenchê-lo.
  • Rótulo:

    • Nome ser exibido acima do campo para identificá-lo visualmente no formulário.
  • Texto De Ajuda:

    • Texto onde pode ser documentada alguma informação que possa auxiliar o usuário no preenchimento do campo (visível ao passar o mouse sobre o ícone de interrogação “?”).
  • Nome:

    • Campo onde deve ser informado um valor único(a nível de formulário) em formato alfa numérico, que será usado como uma “variável” para armazenar e recuperar o valor informado pelo usuário.
  • Valor:

    • Aqui poderá ser atribuído um valor inicial ao campo, utilizando um numero inteiro correspondente ao ID (Identificador único) do registro de tabela desejado.

      Exemplo:

      CODE
      3
  • Registro Da Tabela:

    • Selecione na lista suspensa, qual estrutura de tabela deseja utilizar. É necessário que já exista pelo menos um estrutura de tabela já criada.
  • Filtrar:

    • Permite filtrar e exibir no formulário, somente uma parte dos registros de tabela existentes. Por exemplo, imagine que gostaria que usuário formulário fluxo, somente visualizasse os clientes da Filial 1. Considerando que existe um campo Filial na estrutura da tabela clientes, bastaria seguir os passos abaixo para criar o filtro:

      • Marque a Caixa de Seleção Filtrar
        • Campo A Filtrar
          • informe o nome do campo no qual deseja aplicar o Filtro, no nosso exemplo seria o campo:

            CODE
            filial  
          • Selecione o operador de comparação:

            • Equal → Igual (Seria utilizado este no nosso exemplo)
            • Not Equal → Diferente
          • Valor a Filtrar: Informe o valor do filtro. No nosso exemplo:

            CODE
            1
  • Filtro Avançado:

    • Oferece a opção de criar filtros personalizados, utilizando expressões customizadas combinando mais de um campo e ou mais de um operador logico (AND OR por exemplo), operador de comparação (Igual, Diferente, contém e etc.). Tais expressões devem ser construídas baseando se na sintaxe da linguagem Ruby, fazendo as comparações de campos (colunas da tabela) com os valores desejados. Os valores podem ser fixos (valor atribuído arbitrariamente) ou dinâmicos utilizando variáveis.

      • Veja um exemplo de filtro que combina mais de campo e mais de um operador logico:

        RUBY
        'r{filial}' == '1' and 'r{status}' == 'ativo'
      • onde:

        • filial e status→ São nomes de campos da estrutura de tabela

        • 1 → valor atribuído arbitrariamente

        • r → Padrão obrigatório para identificar um campo de tabela. O formato sempre será:

          RUBY
          r{nome_do_campo_tabela}
          • No caso do uso de valores dinâmicos por meio de variáveis, o campo a ser usado na expressão precisa ser obrigatoriamente um campo (qualquer) do mesmo formulário ou um campo do tipo hidden para armazenar os valores.
            • Agora vejamos um exemplo comparando o valor dos campos da tabela com o valor de um campo oculto (tipo hidden) do seu formulário. Lembrando que é necessário setar um valor para o campo. Isso pode ser feito setando um variável de entrada com mesmo nome do campo, na tarefa desejada.

              CODE
              'r{filial}' == '${campo_hidden_filial}' and 'r{status}' == '${campo_hidden_status}'
  • Adicionar:

    • Se selecionado, irá permitir que o usuário do fluxo adicione registro de tabela a partir do formulário onde a tabela é exibida. Do contrário somente os administradores poderá adicionar novos registros, através da tela de gerenciamento de tabelas.
  • Condição:

    • Campo do tipo caixa de seleção que pode ser marcada (ativada) ou desmarcada (desativada). Quando marcada, fará com que o campo somente seja exibido se o resultado do teste condicional for TRUE.

      Expressão Condicional:

      • Campo do tipo texto onde deve ser criada a expressão condicional. E possível utilizar valores (campos ou variáveis) do mesmo formulário ou de outros formulários (tarefas anteriores já executadas).

      • Exemplo de uma expressão condicional (Use aspas simples):

        CODE
        ${nomeCampo} == 'minasgerais'

      Onde nomeCampo é nome de qualquer campo do mesmo formulário.

info

Caso desejar utilizar, no teste condicional, um campo de outra tarefa (formulário diferente), será necessário utilizar um campo oculto, e nele “setar” o valor desejado, por meio dos eventos da tarefa.