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 para os anexos podem ser:

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

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

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

Image Added

Objetivo das regras

...

As regras têm As regras tem 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ários 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, essas as regras são validadas na seguinte ordem:

1. Verifique os “proibidos”, lança exceção se encontrar algum registro inválido.
2. Demais regras, some os anexos válidos para a primeira condição encontrada.
3. Se utilizar o “qualquer” e não houver condição válida, considere válido. Sem "qualquer" e sem condição válida, não permita a movimentação.

...

As regras de anexo não são obrigatórias em nenhum componente. Elas podem ou não ser definidas de acordo com as necessidades específicas de cada processo ou negócio.

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 é verificado nas demais regras. Por isso, existe uma ordem na qual as regras são verificadas e é importante considerá-la ao criar as regras.

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

• 1º → 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.

• 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 para 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 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 é 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 nessa e em qualquer quantidade na etapa.

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

Xxxxxxxxxx...

Xxxxxxxxxxxx

Regra específica

Xxxxxxxxxxxx

Regra avançada

Xxxxxxxxxxxx

Exemplos de uso

Regra específica

...

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

É possível definir, por exemplo, que somente é permitido adicionar anexos com 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 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 avançadas para anexos.

Exemplos de uso

...

Reunimos aqui vários cenários nos quais 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>

Dúvidas frequentes

...

Confira aqui algumas dúvidas frequentes sobre anexos em solicitações ou em etapas das solicitações. Clique na dúvida 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 todas as dúvidas</a>