...

Falando de regras para anexos em solicitações... Image Removed

As regras 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:

...

Speaking of rules for attachments in requests... Image Added

...

The rules for attachments are conditions or prerequisites that you can define in the Start and Activity components, which represent stages of a process. They can require, prohibit, or allow attachments with specific characteristics, such as file names, extensions, number of files, among others – regardless of the attachments that already exist in the request, from previous stages, for example – ensuring that the stage is complete and meets the criteria required for the request to proceed.

The rules for attachments can be:

• general: these are simpler rules aimed at requiring quantities of attachments;

• specific: these are rules that, combined with the general ones, allow for requiring specific characteristics of the attachments, such as name or extension;

• advanced: these are specific rules with conditions defined from special characters, each with its own meaning.

Image Added

Rule objectives

...

The rules aim to expedite the resolution of requests, as they prevent the forwarding of requests lacking the content required for analysis in the next step being complete or correct, for example, which would require the request to be returned for adjustments.

In this way, the rules help to avoid rework and delays in the resolution of requests, as well as aim to facilitate the analysis of each step and the understanding of what the request demands.

Order of rule verification

...

When you move the request to the next step, the system verifies the rules for attachments of the current step, and if any of them are not met, it displays a message notifying which rules have been met and which have not.

All rules must be met and all attachments must be valid to complete the step and send the request to the next one. When an attachment is considered valid for a rule, the system does not verify it against the other rules. Therefore, there is an order for rule verification, and you must consider it when creating the rules.

The order of rule verification for the step attachments is:

• 1º → The system verifies the rules for quantity, name, and extension, analyzing the attachments valid for each rule. If any of the rules are not met, it displays the validation message, preventing that it be sent to the next step.

• 2º → It verifies whether a rule exists with any, and whether an attachment has not met any previous rules. If so, the attachment is considered valid, as it meets the rule with any (which is the last to be verified), and allowed to continue to the next step. Otherwise – there is no rule with any, but there is an attachment that has not met any previous rules – the system displays the validation message, preventing the sending to the next step, even if the other attachments have met the previous rules

...

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

Objetivo das regras

As regras 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 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 EXAMPLE 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 é permitidoA step has 3 rules for attachments, one of which is with any one. → You add 4 attachments. Two of them met the first rule, one met the second rule, and the fourth did not meet either of the two rules (which are checked before the rule with any one). → Since the third rule has the any one, this fourth attachment meets it. In this case, all rules are met and all attachments are valid. Therefore, it can move to the next step.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo EXAMPLE 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 a quantidade exigida de anexos ou se o anexo pode ser de qualquer tipo e em qualquer quantidade na etapa.

• A step has 2 rules for attachments and none of them use any one. → You add 3 attachments. One met the first rule, another met the second rule, and the third did not meet either of the two rules. → Since there is no rule with any one, this third attachment did not meet any rule. In this case, it is not considered valid. Therefore, it cannot move to the next step.

General rule

...

General rules are the simplest. They are useful for defining the required number of attachments, as well as whether the attachment can be of any type or in any quantity at the step.

Check below an example for each condition available for creating general rules for attachmentsConfira 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 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.

Specific rule

...

You need to combine specific rules with general rules to allow or require specific attachment characteristics, such as file name and extension.

You can define, for example, that the user can only add attachments with a certain type of extension, or require that the attached file follows a predetermined naming pattern.

Check below some examples of specific attachment rulesConfira a seguir alguns exemplos de regras específicas para anexos.

Regra avançada

Advanced rule

...

You must set the advanced rules from an expression that can use a combination of the following charactersAs 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 deleasterisk): allows for any characters to be present or absent before or after it.

  Painel
  borderColor #ebecf0
  Estado subtle true title ExemploEXAMPLE 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 means containing the term boleto at the beginning of the name, which may or may not have any other characters after the term, including in the extension – allowed by *. Attachments such as boleto.pdf or boleto-janeiro.png seriam aceitos are acceptable.

• | (pipe): significa means "ou" e permite definir múltiplos padrõesor" and allows defining multiple patterns.

  Painel
  borderColor #ebecf0
  Estado subtle true title ExemploEXAMPLE * .pdf|*.doc|*.docx|*.txt → significa que pode ser → means it can be .pdf, .doc, .docx, ou or .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 – extensions allowed by | – which may have any name before the extension – allowed by *. Attachments such as processo.pdf or anotações.txt are acceptable.

• ! (exclamaçãoexclamation): significa means "diferente dedifferent from" ou or "proibido" e permite barrar um padrãoprohibited" and allows blocking a pattern.

  Painel
  borderColor #ebecf0
  Estado subtle true title ExemploEXAMPLE !*.zip → significa diferente de means different from .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.the extension is prohibited by ! – it can have any name before the extension – allowed by *. Attachments like boleto.pdf or processo.png are acceptable.

Check out some more examples of advanced rules for attachmentsConfira 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.

Examples

...

We have gathered several scenarios here in which you can apply attachment rules. The examples include the rule, a help message to comply with the rule, and the results according to the scenario.

Examples of general, specific, and advanced rules are demonstrated. Click each scenario to see its detailsSã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>Open/fecharclose todosall os cenários<scenarios</a>