Falando de componente Exclusivo...

...

Image Added

...

O componente Exclusivo representa um ponto onde o processo pode tomar um caminho ou outro automaticamente, dependendo das condições definidas e dos dados obtidos para atender a uma das condições. Dessa forma, ele permite automatizar decisões e aumentar a produtividade, flexibilizando a personalização de processos e reduzindo possíveis falhas. Ele também facilita a resolução de exceções em tempo real e garante conformidade com normas de governança.

...

Para determinar essa rota, ele considera uma informação já existente no contexto da solicitação quando ela chega nesse ponto e, a partir dessa informação, verifica qual condição é atendida por ela e direciona a solicitação para o fluxo correspondente à condição atendida.

As condições são verificadas na ordem em que foram criadas na aba Condições. Assim que uma das condições for atendida, as demais não são verificadas. Como cada condição possui um fluxo de destino vinculado, a solicitação é movimentada para a primeira etapa do fluxo correspondente à condição que foi atendida.

Quando um processo é dividido em uma duas ou mais rotas utilizando o componente Exclusivo, cada rota a ser seguida é determinada por um dado com valor diferente.

Quando o processo possui um fluxo sincronizado utilizando esse componente, é importante ressaltar que, dentre as entradas que chegam no ponto de sincronização, apenas uma é suficiente para que a solicitação siga adiante, ou seja, não serão aguardados outros fluxos para movimentar a solicitação.

**imagem**

Requisitos para utilização

Para utilizar o componente Exclusivo, é necessário atentar-se a alguns pontos:

• o fluxo de entrada para ele não pode ter retorno, pois como ele se comporta como uma atividade automática, a solicitação sempre seguirá para o fluxo de saída que corresponder à condição atendida;

• se um dos fluxos de saída possuir retorno, quando a solicitação retornar, a etapa correspondente a ele será executada de forma automática novamente;

• para criar as condições, é necessário que já exista um formulário vinculado ao processo e, pelo menos, uma etapa/atividade posterior a ele. Isso porque, para construir as regras de cada condição, é necessário selecionar os campos do formulário que devem ser considerados na validação da condição e a etapa para a qual a solicitação será enviada quando a condição for atendida.
• ele precisa de, pelo menos, uma 

Condição simples

A condição simples permite criar as regras a partir da própria interface, definido a origem dos dados e os operadores para determinar o que deve ser validado. Para cada regra, é necessário definir:

• o campo do formulário do qual será obtido o valor que será utilizado na comparação;

• o operador que vai determinar qual tipo de comparação será feita: igual ao, maior que, menor que, igual ou maior que, menor ou igual a, diferente de, parcialmente igual a, parcialmente diferente de e qualquer um;

• a origem do valor que será comparado com o valor do campo do formulário, podendo ser um valor vindo de outro campo do mesmo formulário ou um valor inserido manualmente em um campo da regra;

• o outro campo do formulário ou o valor que será comparado com o primeiro campo do formulário, dependendo do que foi definido no tipo.

A validação da regra ocorre da seguinte forma em relação ao segundo valor a ser comparado:

• se a origem do valor é um Campo de formulário, ela será feita comparando o valor dos dois campos do formulário que foram selecionados;

• se a origem é um valor fixo, ela será feita comparando o valor do primeiro campo do formulário selecionado com o valor inserido manualmente no campo da regra.

É possível criar múltiplas regras para compor cada condição. E, também, é possível criar múltiplas condições para cada componente Exclusivo.

A primeira regra adicionada nunca pode ser excluída, apenas as regras adicionadas depois da primeira, pois é necessário que exista pelo menos uma regra para que o componente funcione corretamente.

Exemplos de uso

6. Exemplo de Estrutura da Regra

Se um usuário criar uma regra com dois critérios obrigatórios, ela pode ser assim:

Se o campo "Gestor Solicitante" for igual ao campo "Atribuição do Gestor" E o campo "Gestor Solicitante" for igual a "João da Silva", então o fluxo seguirá para a próxima atividade.

Condição avançada

A condição avançada permite criar as regras a partir de codificação, flexibilizando a criação de condições para pessoas mais técnicas que saibam programar e desejam criar expressões avançadas para as condições usando JavaScript.

Para esse tipo de condição, é disponibilizada uma IDE embutida, ou seja, um editor de código onde as expressões avançadas podem ser escritas. O ambiente para codificação permite a escrita de códigos de forma estruturada.

A condição avançada deve ser escrita utilizando expressões JavaScript e seguindo a estrutura:

• Propriedade: campo do formulário ou variável do processo;

• Condição: operadores como ===, >, <, != etc.;

• Valor: valor fixo ou outra variável.

No ambiente para codificação, também são disponibilizados snippets prontos com os HPIs da plataforma para facilitar a criação das condições. Assim, é possível inserir facilmente chamadas e manipulação de dados. Esses snippets ajudam a reduzir erros de codificação e aceleram a configuração das condições avançadas.

Além disso, o ambiente exibe um exemplo de condição avançada para facilitar o entendimento da construção das regras.

Verificar se existem outras documentações que auxiliam a criação da condição avançada.

Exemplos de uso

Configurar componente Exclusivo

01. No diagrama do processo, clique no componente ExclusivoImage Removed que deseja configurar.

02. Defina um título ou nome para o componente que representa o direcionamento da solicitação para uma das etapas possíveis do fluxo do processo, de acordo com o resultado obtido.

...

Quando o processo possui um fluxo sincronizado utilizando esse componente, é importante ressaltar que, dentre as entradas que chegam no ponto de sincronização, apenas uma é suficiente para que a solicitação siga adiante, ou seja, não serão aguardados outros fluxos para movimentar a solicitação.

Image Added

Requisitos para utilização

...

Para utilizar o componente Exclusivo, é necessário atentar-se a alguns pontos:

• o fluxo de entrada para ele não pode ter retorno, pois como ele se comporta como uma atividade automática, a solicitação sempre seguirá para o fluxo de saída que corresponder à condição atendida;

• se um dos fluxos de saída possuir retorno, quando a solicitação retornar, a decisão será executada de forma automática novamente;

• para criar as condições, é necessário que já exista um formulário vinculado ao processo e, pelo menos, uma etapa/atividade posterior a ele. Isso porque, para construir as regras de cada condição, é necessário selecionar os campos do formulário que devem ser considerados na verificação da condição e a etapa para a qual a solicitação será enviada quando a condição for atendida;

• ele precisa de, pelo menos, uma condição para funcionar corretamente.

Condição simples

...

A condição simples permite criar as regras a partir da própria interface, definindo a origem dos dados e os operadores para determinar o que deve ser validado. Para cada regra, é necessário definir:

• o campo do formulário vinculado ao processo do qual será obtido o valor que será utilizado na comparação e verificação da regra;

• o operador que vai determinar qual tipo de comparação será feita: vazio, igual a, diferente de, contendo, maior que, maior ou igual a, menor que, menor ou igual a, proibido e qualquer um;

• a origem do valor que será comparado com o valor do campo do formulário, podendo ser um valor vindo de outro campo do mesmo formulário ou um valor fixo inserido manualmente em um campo da regra;

• o outro campo do formulário ou o valor fixo que será comparado com o primeiro campo do formulário, dependendo do que foi definido na origem do valor.

A validação da regra ocorre da seguinte forma em relação ao segundo valor a ser comparado:

• se a origem do valor é um campo de formulário, ela será feita comparando o valor dos dois campos do formulário que foram selecionados;

• se a origem é um valor fixo, ela será feita comparando o valor do primeiro campo do formulário selecionado com o valor fixo inserido manualmente na regra.

É possível criar múltiplas regras para compor cada condição. E, também, é possível criar múltiplas condições para cada componente Exclusivo.

Quando existe apenas uma regra criada para uma condição, essa regra não pode ser excluída, pois é necessário que exista pelo menos uma regra em cada condição para que o componente funcione corretamente.

Exemplos de uso

...

Reunimos aqui alguns cenários utilizando as condições simples no componente Exclusivo. Os exemplos contam com a necessidade de decisão do processo, as condições que serão verificadas pelo componente e o resultado de acordo com a condição atendida.

Clique em cada cenário para ver seus detalhes.

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-1', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-1" href="#" data-expand="true">Abrir/fechar todos os exemplos</a>

Condição avançada

...

A condição avançada permite criar as regras a partir de codificação, flexibilizando a criação de condições para pessoas mais técnicas que saibam programar e desejam criar expressões avançadas para as condições usando JavaScript.

Para esse tipo de condição, é disponibilizada uma IDE embutida, ou seja, um editor de código onde as expressões avançadas podem ser escritas. O ambiente para codificação permite a escrita de códigos de forma estruturada.

A condição avançada deve ser escrita utilizando expressões JavaScript e seguindo a estrutura:

• Propriedade: campo do formulário ou variável do processo;

• Condição: operadores como ===, >, <, != etc.;

• Valor: valor fixo ou outra variável.

No ambiente para codificação, também são disponibilizados snippets prontos com as hAPIs da plataforma para facilitar a criação das condições. Assim, é possível inserir facilmente chamadas e manipulação de dados. Esses snippets ajudam a reduzir erros de codificação e aceleram a configuração das condições avançadas.

Além disso, o ambiente para codificação exibe um exemplo de condição avançada para facilitar o entendimento da construção das regras.

Exemplos de uso

...

Reunimos aqui vários cenários utilizando as condições avançadas no componente Exclusivo. Os exemplos contam com a necessidade de decisão do processo, as condições que serão verificadas pelo componente e o resultado de acordo com a condição atendida.

Clique em cada cenário para ver seus detalhes.

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-2', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-2" href="#" data-expand="true">Abrir/fechar todos os exemplos</a>

Configurar componente Exclusivo

...

01. No diagrama do processo, clique no componente ExclusivoImage Added que deseja configurar.

02. Defina um título ou nome para o componente que representa o direcionamento automático da solicitação para uma das etapas possíveis do fluxo do processo, de acordo com o resultado obtido.

03. Clique em Image Added Adicionar condição para definir as condições que precisam ser atendidas para que a solicitação seja direcionada para a etapa correspondente.

04. Em Nome da condição, insira um nome para identificar a condição depois de criada.

05. Selecione o tipo de condição que deseja criar.

06. Se o tipo selecionado foi Condição simples, clique em Regra 1 para expandir e construir a primeira regra para compor a condição.

07. Selecione os dados necessários para construir a regra.

08. Se for preciso adicionar mais regras, clique em Image Added Adicionar regra e configure quantas regras forem necessárias para compor a condição.

09. Se o tipo selecionado foi Condição avançada, no editor de códigos, insira a expressão em JavaScript contendo propriedade, condição e valor.

10. Por fim, em Ao atender a condição, segue para a atividade:, selecione a etapa/atividade para a qual a solicitação deve ser encaminhada quando essa condição for atendida.

11. Clique em Salvar para salvar a condição e suas regras.

12. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Exclusivo.

13. Na mensagem exibida, clique em Ok, entendi.

Adicionar condição simples

...

01. No diagrama do processo, clique no componente ExclusivoImage Added para o qual deseja adicionar uma condição simples.

02. Clique em Image Added Adicionar condição.

03. Em Nome da condição, insira um nome para identificar a condição depois de criada.

04. Selecione a opção Condição simples.

05. Clique em Regra 1 para expandir e construir a primeira regra para compor a condição.

06. Selecione os dados necessários para construir a regra.

07. Se for preciso adicionar mais regras, clique em Image Added Adicionar regra e configure quantas regras forem necessárias para compor a condição.

08. Por fim, em Ao atender a condição, segue para a atividade:, selecione a etapa/atividade para a qual a solicitação deve ser encaminhada quando essa condição for atendida.

09. Clique em Salvar para salvar a condição e suas regras.

10. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Exclusivo.

11. Na mensagem exibida, clique em Ok, entendi.

Adicionar condição avançada

...

01. No diagrama do processo, clique no componente ExclusivoImage Added para o qual deseja adicionar uma condição avançada.

02. Clique em Image Added Adicionar condição.

03. Em Nome da condição, insira um nome para identificar a condição avançada depois de criada.

04. Selecione o tipo Condição avançada.

05. No editor de códigos, insira a expressão em JavaScript contendo propriedade, condição e valor.

06. Em Ao atender a condição, segue para a atividade:, selecione a etapa/atividade para a qual a solicitação deve ser encaminhada quando essa condição for atendida.

07. Clique em Salvar.

08. Ao concluir a inclusão de todas as condições avançadas desejadas, clique em FecharImage Added– localizado no canto superior direito.

Editar condição

...

01. No diagrama do processo, clique no componente ExclusivoImage Added do qual deseja editar uma condição.

02. Em Condições criadas, localize a condição que deseja editar e clique em AçõesImage Added– localizado no seu lado direito.

03. Clique em Editar.

04. Altere os dados desejados nas regras da condição.

05. Clique em Salvar.

06. Ao concluir a edição de todas as condições desejadas, clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Exclusivo.

07. Na mensagem exibida, clique em Ok, entendi.

Excluir condição

...

01. No diagrama do processo, clique no componente ExclusivoImage Added do qual deseja excluir uma condição.

02. Em Condições criadas, localize a condição que deseja excluir e clique em AçõesImage Added– localizado no seu lado direito.

03. Clique em Excluir.

04. Na mensagem de confirmação exibida, clique em Excluir condição para confirmar a exclusão da condição em questão.

05. Ao concluir a exclusão de todas as condições desejadas, clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Exclusivo.

06. Na mensagem exibida, clique em Ok, entendi.

Dúvidas frequentes

...

Confira aqui algumas dúvidas frequentes sobre o componente Exclusivo.

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-3', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-3" href="#" data-expand="true">Abrir/fechar todas as dúvidas</a>

O nome também pode ser alterado diretamente no componente, clicando sobre seu nome atual e depois em EditarImage Removed– localizado no lado direito.

...

...

03. Clique em Image Removed Adicionar condição para definir as condições que precisam ser atendidas para que a solicitação seja direcionada para a etapa correspondente.

04. Em Nome da condição, insira um nome para identificar a condição depois de criada.

05. Selecione o tipo de condição que deseja criar.

06. Xxxxxxxxxxxxxxx

...

07. Xxxxxxxxxxxxxxx

...

08. Xxxxxxxxxxxxxxx

...

09. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Exclusivo.

Adicionar condição simples

01. No diagrama do processo, clique no componente ExclusivoImage Removed para o qual deseja adicionar uma condição simples.

02. Clique em Image Removed Adicionar condição.

03. Em Nome da condição, insira um nome para identificar a condição simples depois de criada.

04. Selecione o tipo Condição simples.

05. Xxxxxxx

...

06. Clique em Salvar.

...

07. Ao concluir a inclusão de todas as condições simples desejadas, clique em FecharImage Removed– localizado no canto superior direito.

Editar condição simples

Excluir condição simples

Adicionar condição avançada

01. No diagrama do processo, clique no componente ExclusivoImage Removed para o qual deseja adicionar uma condição avançada.

02. Clique em Image Removed Adicionar condição.

03. Em Nome da condição, insira um nome para identificar a condição simples depois de criada.

04. Selecione o tipo Condição avançada.

...

05. Xxxxxxx

...

06. Clique em Salvar.

...

07. Ao concluir a inclusão de todas as condições avançadas desejadas, clique em FecharImage Removed– localizado no canto superior direito.

Editar condição avançada

Excluir condição avançada

Dúvidas frequentes

...

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-2', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-2" href="#" data-expand="true">Abrir/fechar todas as dúvidas</a>

Xxxxxxxxxxx

Sim. É possível criar múltiplas regras para cada condição, bem como, criar múltiplas condições para serem avaliadas.

Toggle Cloak
id @saiba-mais-4

Como alternar entre a condição Simples e a Avançada?

Xxxxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-5

 Como testar se as condições definidas estão corretas?

Xxxxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-6

 Por que a solicitação parou depois do componente Exclusivo?

Xxxxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-7

Quais linguagens são suportadas para criar scripts na condição Avançada?

<!-- Hotjar Tracking Code for http://tdn.totvs.com/display/fb -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:1280165,hjsv:6};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>