Falando de regras

...

para anexos em solicitações... Image Modified

...

As regras de anexo para os anexos são condições ou pré-requisitos que podem ser definidos nos componentes Início e Atividade, que representam etapas de um processo. Elas podem exigir, proibir ou permitir anexos com algumas características específicas, tais como nome dos arquivos, extensões, quantidade de arquivos, dentre outras – independentemente dos anexos que já existem na solicitação, em etapas anteriores, por exemplo – garantindo que a etapa esteja completa e dentro dos critérios exigidos para que a solicitação possa seguir adiante.

As regras de anexo para os anexos podem ser:

• gerais:são regras mais simples e visam exigir ou proibir os anexos e/ou quantidades de anexos;

• específicas: são regras que, combinadas com as gerais, permitem exigir ou proibir características específicas dos anexos, como nome ou extensão, por exemplo;;

• avançadas: são regras específicas com condições definidas a partir de caracteres especiais, cada um com seu significado.

Objetivo das regras

...

As regras tem têm como objetivo agilizar a resolução das solicitações, visto que evita que a solicitação seja enviada adiante sem que o conteúdo necessário para análise na próxima etapa esteja faltando ou esteja incorreto, por exemplo, o que exigiria o retorno da solicitação para que ele seja ajustado.

Desta forma, as regras ajudam a evitar retrabalhos e atrasos na resolução das solicitações, bem como visam facilitar a análise de cada etapa e o entendimento daquilo que está sendo solicitado.

Ordem de

...

verificação das regras

...

No momento de movimentar a solicitação para a próxima etapa, as regras de anexo para anexos da etapa corrente são verificadas e, caso uma delas não seja atendida, é exibida uma mensagem informando quais regras foram atendidas e quais ainda não foram.

É necessário que todas as regras sejam atendidas e todos os anexos sejam válidos para que a etapa possa ser concluída e a solicitação enviada para a próxima. Quando um anexo é considerado válido para uma regra, ele não é validado verificado nas demais regras. Por isso, existe uma ordem na qual as regras são validadas verificadas e é importante considerá-la ao criar as regras.

A ordem de validação verificação das regras de anexo para os anexos da etapa é:

• 1º → São verificadas as regras de proibição. Se encontrar um anexo proibido, a mensagem de validação é exibida e o envio para a próxima etapa não é permitido.2º → São verificadas as regras de quantidade, nome e extensão. São analisados os anexos válidos para cada regra. Se qualquer uma das regras não for atendida, a mensagem de validação é exibida e o envio para a próxima etapa não é permitido.

• 3º 2º → É verificado se existe uma regra com qualquer um e se existe um anexo que ainda não atendeu à a nenhuma regra anterior. Em caso afirmativo, o anexo será considerado válido, pois atende à regra com o qualquer um (que é a última a ser verificada) e o envio para a próxima etapa é permitido. Caso contrário – não existe regra com o qualquer um, mas existe um anexo que não atendeu a nenhuma regra anterior – a mensagem de validação é exibida e o envio para a próxima etapa não é permitido, mesmo que os demais anexos tenham atendido às regras anteriores.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo 1: → Uma etapa possui 3 regras de anexopara os anexos, sendo uma com qualquer um. → Foram adicionados 4 anexos. Dois deles atenderam à primeira regra, um deles atendeu à segunda regra e o quarto não atendeu a nenhuma das duas regras (que são verificadas antes da regra com o qualquer um). → Como a terceira regra possui o qualquer um, esse quarto anexo atende à a ela. Neste caso, todas as regras foram atendidas e todos os anexos são válidos. Portanto, o envio para a próxima etapa é permitido.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo 2: → Uma etapa possui 2 regras de anexo para os anexos e nenhuma delas usa o qualquer um. → Foram adicionados 3 anexos. Um atendeu à primeira regra, outro atendeu à segunda regra e o terceiro não atendeu a nenhuma das duas regras. → Como não existe nenhuma regra com o qualquer um, esse terceiro anexo não atendeu a nenhuma regra. Neste caso, ele não será considerado válido. Portanto, o envio para a próxima etapa não será é permitido.

Regra geral

...

As regras gerais são as mais simples e servem para definir se o anexo é obrigatório, qual a quantidade exigida , de anexos ou se o anexo pode ser de qualquer tipo ou se é proibido e em qualquer quantidade na etapa.

Confira abaixo um exemplo para cada condição disponível para criação de regras gerais para anexos.

...

Regra específica

...

As regras específicas precisam ser combinadas com as regras gerais para permitir ou proibir exigir características específicas dos anexos, tais como nome e extensão dos arquivos.

É possível definir, por exemplo, que somente é proibido permitido adicionar anexos com determinados tipos um determinado tipo de extensão ou exigir que o arquivo anexado siga um padrão de nomenclatura pré-determinado.

Confira a seguir alguns exemplos de regras de anexo específicas para anexos.

...

Regra avançada

...

As regras avançadas são definidas a partir de uma expressão que pode utilizar uma combinação dos seguintes caracteres:

• * (asterisco): permite deixar livre para ter ou não quaisquer caracteres antes ou depois dele.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo boleto* → significa conter o termo boleto no início do nome, podendo ter ou não quaisquer outros caracteres depois do termo, inclusive na extensão – permitido pelo *. Anexos como boleto.pdf ou boleto-janeiro.png seriam aceitos.

• | (pipe): significa "ou" e permite definir múltiplos padrões.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo *.pdf|*.doc|*.docx|*.txt → significa que pode ser .pdf, .doc, .docx, ou .txt. – extensões permitidas pelo | – podendo ter qualquer nome antes da extensão – permitido pelo *. Anexos como processo.pdf ou anotações.txt seriam aceitos.

• ! (exclamação): significa "diferente de" ou "proibido" e permite barrar um padrão.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo !*.zip → significa diferente de .zip – extensão foi proibida pelo ! – podendo ter qualquer nome antes da extensão – permitido pelo *. Anexos como boleto.pdf ou processo.png seriam aceitos.

Confira a seguir mais alguns exemplos de regras de anexo avançadas para anexos.

...

Exemplos de uso

...

Reunimos aqui vários cenários nos quais as regras de anexo podem ser aplicadas regras para os anexos. Os exemplos contam com a regra, uma mensagem de auxílio para atender à regra e os resultados de acordo com o cenário.

São demonstrados exemplos de regras gerais, específicas e avançadas. 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 cenários</a>

<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>