Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleConsult the correct documentation:

This documentation refers to the new process editor of the platform. If you are using the current process editor, access Configure activity


Índice
maxLevel3
exclude.*ndice


Speaking of rules for attachments in requests...


The rules for attachments are conditions or prerequisites that can be defined 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, in 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.
Informações
titleNote:

The rules for attachments are not mandatory in any component. They can or cannot be defined according to the specific needs of each stage, process, or business.

If no rule is defined, it is allowed to add any type and any quantity of attachments, meaning that no validation is performed.

Dica
titleTip!

Click here to learn how to configure rules for attachments in a stage of the process.


Objective of the rules


The rules aim to expedite the resolution of requests, as they prevent the request from being forwarded without the necessary content 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 is being requested.


Order of rule verification


At the moment of moving the request to the next step, the rules for attachments of the current step are verified, and if any of them are not met, a message is displayed informing which rules have been met and which have not.

It is necessary for all rules to be met and all attachments to be valid for the step to be completed and the request to be sent to the next one. When an attachment is considered valid for a rule, it is not verified against the other rules. Therefore, there is an order in which the rules are verified, and it is important to consider this when creating the rules.

The order of rule verification for the attachments of the step is:

  • 1º → The rules for quantity, name, and extension are verified. Valid attachments for each rule are analyzed. If any of the rules are not met, the validation message is displayed, and sending to the next step is not allowed.
  • It is verified if there is a rule with any and if there is an attachment that has not met any previous rules. If so, the attachment will be considered valid, as it meets the rule with any (which is the last to be verified), and sending to the next step is allowed. Otherwise – there is no rule with any, but there is an attachment that has not met any previous rules – the validation message is displayed, and sending to the next step is not allowed, even if the other attachments have met the previous rules.

    Painel
    borderColor#ebecf0

    Estado
    subtletrue
    titleEXAMPLE 1

    A step has 3 rules for attachments, one of which is with any one.
    4 attachments were added. 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 were met and all attachments are valid. Therefore, submission to the next step is allowed
    .

    Painel
    borderColor#ebecf0

    Estado
    subtletrue
    titleEXAMPLE 2

    A step has 2 rules for attachments and none of them use any one.
    3 attachments were added. 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 will not be considered valid. Therefore, submission to the next step is not allowed
    .


General rule


General rules are the simplest and serve to define the required number of attachments or whether the attachment can be of any type and in any quantity at the step.

Check below an example for each condition available for creating general rules for attachments.

Painel
borderColor#ebecf0

The attachment must be equal to 2.

It is mandatory to add two attachments at this step, and adding more is not allowed.

Painel
borderColor#ebecf0

The attachment must be greater than 0.

It is mandatory to add at least one attachment at this step, and adding more than one is allowed.

Painel
borderColor#ebecf0

The attachment must be greater than or equal to 1.

It is mandatory to add at least one attachment at this step, and adding more than one is allowed.

Painel
borderColor#ebecf0

The attachment must be less than 3.

It is allowed to add up to two attachments at this step or leave the step without attachments.

Painel
borderColor#ebecf0

The attachment must be less than or equal to 4.

It is allowed to add up to four attachments at this step or leave the step without attachments.

Painel
borderColor#ebecf0

The attachment must be any one.

It is allowed to add any type and any quantity of attachments at this step, including leaving the step without attachments.

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 1

In a process of Request for hour exemption due to medical issues for the Payroll area, the requester must necessarily submit the medical certificate that justifies the exemption. The certificate is accepted in any format, which can be an image, a photo, a PDF document, a ZIP file, in short, no requirements are made regarding the type of file. However, only one certificate is allowed to be submitted per request, meaning that if the requester has more than one certificate, they must open a request for each one.

Thus, the rule can be defined as follows:

→ The attachment must equal 1.

It is mandatory to add one attachment of any type. And it is not allowed to add more than one.

Multimedia
nameregra-simples-1.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
autostarttrue
spacefluig
height5%

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 2

In a process of Simple budget approval, the person responsible for the approval prefers that the details be provided directly in the request form, so that when opening the request for analysis, the amount to be approved is already evident, without the need to open a document to see the information.

→ In this case, it is not necessary to add any rules, just activate the option Prohibit attachments, which means that no attachments are allowed at this stage. The budget details must be added in the request form.

Multimedia
nameregra-simples-2.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
autostarttrue
spacefluig
height5%


Specific rule


Specific rules need to be combined with general rules to allow or require specific characteristics of the attachments, such as file name and extension.

It is possible to define, for example, that only attachments with a certain type of extension are allowed or to require that the attached file follows a predetermined naming pattern.

Check below some examples of specific rules for attachments.

Painel
borderColor#ebecf0

→ The attachment must be equal to 1 with the file name containing the term note at the beginning.

It is mandatory to add an attachment that has the term note at the beginning of its name.

Painel
borderColor#ebecf0

→ The attachment must be less than or equal to 2 with the extension equal to .zip.

It is allowed to add up to two attachments with the .zip extension or leave the step without attachments.

Painel
borderColor#ebecf0

→ The attachment must be equal to 1 with the name and extension containing the term boleto at the beginning and the term .pdf at the end.

It is mandatory to add an attachment that has the term boleto at the beginning of its name and that is a PDF document.

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 1

In a ticket opening process for the IT department, the requester needs to send at least one image of the inconsistency that is occurring or of the resource for which they are requesting assistance. Only images of the PNG type are accepted. If possible, it is also interesting to send the log, but it must be in TXT format and is not mandatory.

Thus, the rules can be defined as follows:

→ The attachment must be greater than or equal to 1 with the extension equal to .png.

It is mandatory to add at least one attachment that is an image with the .png extension. However, if the requester wishes, they can add more attachments.

→ The attachment must be greater than or equal to 0 with the extension equal to .txt.

If the requester can obtain the log, they can attach it to the request to facilitate analysis. However, it is not mandatory to attach it.

→ The attachment must be equal to 0 with the extension equal to .exe.

For security reasons, it is not allowed to add any attachment that has the .exe extension.

Multimedia
namevídeo-regras-chamado.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
spacefluig
height5%

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 2

In a payment request process for the Finance area, the requester must submit three documents: the electronic invoice, the payment slip, and a detailed list of the products or services acquired. The documents must be in PDF format and identified by the respective names "boleto", "fatura", and the invoice must be identified with the code "NF" at the beginning of the name.

Thus, the rules can be defined as follows:

→ The attachment must be equal to 1 with the name and extension containing the term boleto in the name and the term pdf in the extension.

It is mandatory to add an attachment that has the name boleto and is a document with the .pdf extension.

→ The attachment must be equal to 1 with the name and extension containing the term fatura in the name and the term pdf in the extension.

It is mandatory to add an attachment that has the name fatura and is a document with the .pdf extension.

→ The attachment must be equal to 1 with the name and extension containing the term NF at the beginning of the name and the term pdf at the end of the extension.

It is mandatory to add an attachment with the characters NF at the beginning of its name and with the .pdf extension to identify it as the invoice. Attachments such as NF_10355.pdf, NF89665.doc.pdf, NF-58361.pdf would be accepted.

Multimedia
nameregra-específica-2.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
spacefluig
height5%


Advanced rule


The advanced rules are defined from an expression that can use a combination of the following characters:

  • * (asterisk): allows for any characters to be present or absent before or after it.

    Painel
    borderColor#ebecf0

    Estado
    subtletrue
    titleEXAMPLE

    boleto*
    → 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 would be accepted.

  • | (pipe): means "or" and allows defining multiple patterns.

    Painel
    borderColor#ebecf0

    Estado
    subtletrue
    titleEXAMPLE

    .pdf|.doc|.docx|.txt
    → means it can be .pdf, .doc, .docx, or .txt – extensions allowed by | – which may have any name before the extension – allowed by *. Attachments such as processo.pdf or anotações.txt would be accepted.

  • ! (exclamation): means "different from" or "prohibited" and allows blocking a pattern.

    Painel
    borderColor#ebecf0

    Estado
    subtletrue
    titleEXAMPLE

    !*.zip
    → means different from .zip – the extension is prohibited by ! – it can have any name before the extension – allowed by *. Attachments like boleto.pdf or processo.png would be accepted.

Check out some more examples of advanced rules for attachments.

Painel
borderColor#ebecf0

→ The attachment must be equal to 1 with advanced condition fatura.pdf|nota.pdf.

It is mandatory to add an attachment named fatura or nota with the .pdf extension. Adding more than one is not allowed.

Painel
borderColor#ebecf0

→ The attachment must be any with advanced condition !server.*.

It is allowed to add any type of attachment with a name different from server and with any extension or leave the step without attachments. The name server is prohibited.

Painel
borderColor#ebecf0

→ The attachment must be greater than or equal to 3 with advanced condition boleto.pdf.

It is mandatory to add at least 3 attachments, and more can be added, that contain the term boleto in the name and with the .pdf extension.

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 1

In a Travel Reimbursement Request process for the Finance area, the requester can submit proof of payment for the stay, transportation, and ticket if the trip was for an event. The proofs need to be in PDF and identified by name.

Thus, the rules can be defined as follows:

→ The attachment must be greater than or equal to 1 with advanced condition estadia.pdf|transporte.pdf|ingresso.pdf.

It is mandatory to add at least one attachment, and more can be attached, that contains the term estadia, transporte, or ingresso in the name and with the .pdf extension.

Multimedia
nameregra-avançada-1.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
autostarttrue
spacefluig
height5%

Painel
borderColor#ebecf0

Estado
subtletrue
titleSCENARIO 2

In a Request for Office Supplies process for the Purchasing area, the requester needs to submit a photo of the requested material to serve as a reference and facilitate the purchase. This photo can be of various types.

Thus, the rules can be defined as follows:

→ The attachment must be greater than or equal to 1 with advanced condition .png|.jpg|.jpeg|.bmp.

It is mandatory to add at least 1 attachment with any name that is an image with one of the allowed extensions: .png, .jpg, .jpeg, or .bmp.

Multimedia
nameregra-avançada-2.mp4
width100%
pagePlataforma ❙ Regras para anexos em solicitações
autostarttrue
spacefluig
height5%


Usage examples


We have gathered several scenarios here in which rules for attachments can be applied. 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 on each scenario to see its details.


HTML
<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">Open/close all scenarios</a>
Section
Painel
borderColor#ebecf0

Toggle Cloak
id@1
Require at least one attachment in the step.

Cloak
id@1

trueRULE

→ The attachment must be greater than 0.

trueMESSAGE

→ It is mandatory to add at least one attachment of any type.

Results
No attachment added.

Rule not met.

Rule not met.

One attachment with the .pdf extension added.

Rule met.

Rule met.

One attachment with the .zip extension added.

Rule met.

Rule met.

One attachment with the .zip extension and one with the .pdf extension added.

Rule met.

Rule met.

One attachment with the .jpg extension added.

Rule met.

Rule met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rule met.

Rule met.

Painel
borderColor#ebecf0

Toggle Cloak
id@2
Prohibit attachment in the step.

Cloak
id@2

To prohibit attachments in a step, it is not necessary to create any rule; just activate the option Prohibit attachments, which determines that no attachments are allowed in the step.

Painel
borderColor#ebecf0

Toggle Cloak
id@3
Require an attachment with the .zip extension.

Cloak
id@3

trueRULE

→ The attachment must be equal to 1 with the extension equal to .zip.

trueMESSAGE

→ It is mandatory to add an attachment with the .zip extension.

Results

No attachment added.

Rule not met.

Rule not met.

One attachment with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .zip extension added.

Rule met.

Rule met.

One attachment with the .zip extension and one with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .jpg extension added.

Rule not met.

Rule not met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@4
Require an attachment with the .zip extension AND an attachment with the .pdf extension.

Cloak
id@4

trueRULES

→ The attachment must be equal to 1 with the extension equal to .zip.
→ The attachment must be equal to 1 with the extension equal to .pdf.

trueMESSAGES

→ It is mandatory to add an attachment with the .zip extension.
→ It is mandatory to add an attachment with the .pdf extension.

Results

No attachment added.

Rules not met.

Rules not met.

One attachment with the .pdf extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension and one with the .pdf extension added.

Rules met.

Rules met.

One attachment with the .jpg extension added.

Rules not met.

Rules not met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rules not met.

Rules not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@5
Require an attachment with the extension .zip OR .pdf.

Cloak
id@5

trueRULE

→ The attachment must be equal to 1 with advanced condition .zip|.pdf.

trueMESSAGE

→ It is mandatory to add an attachment with the .zip or .pdf extension.

Results

No attachment added.

Rule not met.

Rule not met.

One attachment with the .pdf extension added.

Rule met.

Rule met.

One attachment with the .zip extension added.

Rule met.

Rule met.

One attachment with the .zip extension and one with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .jpg extension added.

Rule not met.

Rule not met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@6
Require an attachment with the extension .zip and allow other types of attachments to be added or not.

Cloak
id@6

trueRULES

→ The attachment must be equal to 1 with the extension equal to .zip.
→ The attachment can be any.

trueMESSAGE

→ It is mandatory to add an attachment with the .zip extension.

Results

No attachment added.

Rules not met.

Rules not met.

One attachment with the .pdf extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension added.

Rules met.

Rules met.

One attachment with the .zip extension and one with the .pdf extension added.

Rules met.

Rules met.

One attachment with the .jpg extension added.

Rules not met.

Rules not met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rules met.

Rules met.

Painel
borderColor#ebecf0

Toggle Cloak
id@7
Prohibit attachment with the extension .zip and allow other types of attachments to be added or not.

Cloak
id@7

trueRULES

→ The attachment must be equal to 0 with the extension equal to .zip.
→ The attachment can be any.

trueMESSAGE

→ It is not allowed to add an attachment with the .zip extension.

Results

No attachment added.

Rules met.

Rules met.

One attachment with the .pdf extension added.

Rules met.

Rules met.

One attachment with the .zip extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension and one with the .pdf extension added.

Rules not met.

Rules not met.

One attachment with the .jpg extension added.

Rules met.

Rules met.

One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rules not met.

Rules not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@8
Require an attachment with the extension .zip and require at least one other type of attachment.

Cloak
id@8

trueRULES

→ The attachment must be equal to 1 with the extension equal to .zip.
→ The attachment must be greater than or equal to 1 with a different extension from .zip.

trueMESSAGES

→ It is mandatory to add an attachment with the .zip extension.
→ It is mandatory to add at least one attachment with a different extension from .zip.

Results

No attachment added.

Rules not met.

Rules not met.

One attachment with the .pdf extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension added.

Rules not met.

Rules not met.

One attachment with the .zip extension and one with the .pdf extension added.

Rules met.

Rules met.

One attachment with the .jpg extension added.

Rules not met.

Rules not met.
One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rules met.

Rules met.

Painel
borderColor#ebecf0

Toggle Cloak
id@9
Require one or more attachments of image type.

Cloak
id@9

trueRULE

→ The attachment must be greater than or equal to 1 with advanced condition .png|.jpg|.gif.

trueMESSAGE

→ It is mandatory to add at least one attachment with the extension .png, .jpg, or .gif.

Results

No attachment added.

Rule not met.

Rule not met.

One attachment with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .zip extension added.

Rule not met.

Rule not met.

One attachment with the .zip extension and one with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .jpg extension added.

Rule met.

Rule met.
One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@10
Allow only image type attachments, but without making it mandatory.

Cloak
id@10

trueRULE

→ The attachment must be greater than or equal to 0 with advanced condition .png|.jp*g|.gif.

trueMESSAGE

→ Only attachments with the extensions .png, .jpg, .jpeg, or .gif are allowed.

Results

No attachment added.

Rule met.

Rule met.

One attachment with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .zip extension added.

Rule not met.

Rule not met.

One attachment with the .zip extension and one with the .pdf extension added.

Rule not met.

Rule not met.

One attachment with the .jpg extension added.

Rule met.

Rule met.
One attachment with the .pdf extension, one with the .zip extension, and one with the .jpg extension added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@11
Require an attachment with specific name and extension.

Cloak
id@11

trueRULE

→ The attachment must be equal to 1 with the name and extension equal to the name containing the term server and the extension being .log.

trueMESSAGE

→ Only one attachment with the name server.log is allowed.

Results

No attachment added.

Rule not met.

Rule not met..

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule not met.

Rule not met.

An attachment server.txt added.

Rule not met.

Rule not met.
An attachment server.log.zip added.

Rule not met.

Rule not met.

An attachment server.zip added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@12
Require an attachment with a specific term at the beginning of the name and a specific extension.

Cloak
id@12

trueRegras

→ The attachment must be equal to 1 with advanced condition server*.log.

trueMESSAGE

→ It is mandatory to add an attachment with server at the beginning of the name and with the extension .log..

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule met.

Rule met.

An attachment server.txt added.

Rule not met.

Rule not met.
An attachment server.log.zip added.

Rule not met.

Rule not met.

An attachment server.zip added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@13
Require an attachment with a specific term at the beginning of the name and extension

Cloak
id@13

trueRULE

→ The attachment must be equal to 1 with the name and extension containing the term server at the beginning and the extension the term .log at the beginning.

trueMESSAGE

→ It is mandatory to add an attachment with server at the beginning of the name and with .log at the beginning of the extension.

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule met.

Rule met.

An attachment server.txt added.

Rule not met.

Rule not met.
An attachment server.log.zip added.

Rule met.

Rule met.

An attachment server.zip added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@14
Require an attachment containing a specific term in the name and at the beginning of the extension.

Cloak
id@14

trueRULE

→ The attachment must be equal to 1 with advanced condition *server*.log*.

trueMESSAGE

→ It is mandatory to add an attachment that contains server in the name and .log at the beginning of the extension.

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule met.

Rule met.

An attachment server-2018.log added.

Rule met.

Rule met.

An attachment server.txt added.

Rule not met.

Rule not met.
An attachment server.log.zip added.

Rule met.

Rule met.

An attachment server.zip added.

Rule not met.

Rule not met.

Painel
borderColor#ebecf0

Toggle Cloak
id@15
Prohibit attachment with a specific term in the name and allow other types of attachments to be added or not.

Cloak
id@15

trueRULES

→ The attachment must be any with advanced condition !*server*.

OR

→ The attachment must be equal to 0 with advanced condition *server*.
→ The attachment must be any.

trueMESSAGE

→ It is not allowed to add an attachment that contains server in the name.

Results

No attachment added.

Rules met.

Rules met.

An attachment server.log added.

Rules not met.

Rules not met.

An attachment abcserver.log added.

Rules not met.

Rules not met.

An attachment server-2018.log added.

Rules not met.

Rules not met.

An attachment server.txt added.

Rules not met.

Rules not met.
An attachment server.log.zip added.

Rules not met.

Rules not met.

An attachment server.zip added.

Rules not met.

Rules not met.

An attachment boleto.pdf added.

Rules met.

Rules met.

Painel
borderColor#ebecf0

Toggle Cloak
id@16
Prohibit attachment with specific term in the name and require an attachment with another name.

Cloak
id@16

trueRULE

→ The attachment must be equal to 1 with advanced condition !*server*.

trueMESSAGE

→ It is mandatory to add an attachment that does not contain server in the name.

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule not met.

Rule not met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule not met.

Rule not met.

An attachment server.txt added.

Rule not met.

Rule not met.
An attachment server.log.zip added.

Rule not met.

Rule not met.

An attachment server.zip added.

Rule not met.

Rule not met.

An attachment boleto.pdf added.

Rule met.

Rule met.

Painel
borderColor#ebecf0

Toggle Cloak
id@17
Require attachment with specific extension only if it has a specific name or any attachment of another extension.

Cloak
id@17

trueRULE

→ The attachment must be equal to 1 with advanced condition server.log|!*.log.

trueMESSAGE

→ It is mandatory to add an attachment with the name server and with the extension .log or any attachment with a different extension from .log.

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule met.

Rule met.

An attachment server.txt added.

Rule met.

Rule met.
An attachment server.log.zip added.

Rule met.

Rule met.

An attachment server.zip added.

Rule met.

Rule met.

An attachment boleto.pdf added.

Rule met.

Rule met.

Painel
borderColor#ebecf0

Toggle Cloak
id@18
Require attachment with specific term at the beginning of the name and specific extension or any attachment of another extension.

Cloak
id@18

trueRULE

→ The attachment must be equal to 1 with advanced condition server*.log|!*.log.

trueMESSAGE

→ It is mandatory to add an attachment with server at the beginning of the name and with the extension .log or any attachment with a different extension from .log.

Results

No attachment added.

Rule not met.

Rule not met.

An attachment server.log added.

Rule met.

Rule met.

An attachment abcserver.log added.

Rule not met.

Rule not met.

An attachment server-2018.log added.

Rule not met.

Rule not met.

An attachment server.txt added.

Rule met.

Rule met.
An attachment server.log.zip added.

Rule met.

Rule met.

An attachment server.zip added.

Rule met.

Rule met.

An attachment boleto.pdf added.

Rule met.

Rule met.

Painel
borderColor#ebecf0

Toggle Cloak
id@19
Prohibit attachment with specific term in the name and allow any attachment with specific extension.

Cloak
id@19

trueRULES

→ The attachment must be equal to 0 with the file name containing irpf in the middle.
→ The attachment must be any with the extension equal to .zip.

trueMESSAGES

→ It is not allowed to add an attachment that contains irpf in the name.
→ It is allowed to add any attachment with the extension .zip.

Results

No attachment added.

Rules not met.

Rules not met.

An attachment declaracao-irpf.pdf added.

Rules not met.

Rules not met.

An attachment abcserver.log added.

Rules not met.

Rules not met.

An attachment server-2018.log added.

Rules not met.

Rules not met.

An attachment server.txt added.

Rules not met.

Rules not met.
An attachment server.log.zip added.

Rules met.

Rules met.

An attachment server.zip added.

Rules met.

Rules met.

An attachment irpf.zip added.

Rules not met.

Rules not met.


Frequently asked questions


Check here some frequently asked questions about attachments in requests or in stages of requests. Click on the question to see its details.

HTML
<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">Open/close all questions</a>
Section
Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-1
What happens if the attachment does not meet the rule?

Cloak
id@saiba-mais-1

The stage in which the request is located cannot be completed and, consequently, the request cannot be sent to the next stage.

All existing rules in the stage must be met, and all added attachments must be validated by at least one rule for it to be completed and the request sent to the next.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-2
What types of files are allowed as attachments?

Cloak
id@saiba-mais-2

There is a wide range of file extensions that are allowed as attachments. The main extensions that are listed for selection when creating rules for attachments are detailed below. However, it is also possible to select other more specific ones.

Additionally, if the desired extension is not suggested for selection, it can be typed in, and it will be considered normally in the rule.

Main extensions
Documents.doc / .docxMicrosoft Word Document
.pdfPortable Document Format
.txtPlain Text File
.rtfRich Text Format
.odtOpenDocument Text Document
Spreadsheets.xls / .xlsxMicrosoft Excel Spreadsheet
.csvComma-Separated Values
.odsOpenDocument Spreadsheet
Presentations.ppt / .pptxMicrosoft PowerPoint Presentation
.odpOpenDocument Presentation
Images

.jpg / .jpeg

JPEG Image
.pngPortable Network Graphics
.gifGraphics Interchange Format
.bmpBitmap Image
.svgScalable Vector Graphics
Audio.mp3MPEG Audio Layer III

.wav

Waveform Audio File Format

.aac

Advanced Audio Coding

.flac

Free Lossless Audio Codec
Video

.mp4

MPEG-4 Video File

.avi

Audio Video Interleave

.mkv

Matroska Video File

.mov

Apple QuickTime Movie

.wmv

Windows Media Video
Compressed files

.zip

Zip Archive

.rar

RAR Archive

.7z

7-Zip Archive

.tar.gz

Compressed Tarball File
Executable and system files

.exe

Windows Executable File

.dll

Dynamic Link Library

.sys

Windows System File

.sh

Shell Script

.bat

Batch File
Source code and scripts

.html / .htm

HyperText Markup Language File

.css

Cascading Style Sheets File

.js

JavaScript File

.py

Python Script

.java

Java Source Code File

.c / .cpp

C / C++ Source Code File
Database

.sql

Structured Query Language Data File

.db / .sqlite

SQLite Database File

.mdb / .accdb

Microsoft Access Database
Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-3
What is the maximum allowed size for an attachment in the request?

Cloak
id@saiba-mais-3

By default, the maximum allowed size per attachment (file) is 100MB. However, it is possible to customize this size in the , which can be decreased or increased up to a limit of 1GB. To do this:

01. Access the Control Panel.

02. In the Technical Parameters group, click on Parameters.

03. In Maximum upload size via web (MB), enter the desired size per file in megabytes.

Note:

To set a size greater than the limit of 1GB, it is necessary to follow the steps described in . However, when setting a maximum size greater than the limit (1GB), resources may experience instability when attachments (files) are added.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-4
What is the necessary number of attachments for a stage of the request?

Cloak
id@saiba-mais-4

There is no defined minimum or maximum quantity. This depends on the stage and the process in question.

The question that can be asked is: "What evidence or documents are necessary at each stage for the request to be analyzed and successfully completed?" This answer will guide the quantity and rules for the attachments.

#ebecf0

trueEXAMPLE
In the Payment stage of a Payment Request process, the Finance area only makes payments via bank slip. In this case, the slip needs to be attached by the requester at the time of opening the request. Therefore, the Request Payment stage (which is the first stage of the process) must require at least one attachment, which is the bank slip necessary for the payment to be made when the request reaches the Payment stage.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-5
What is the maximum allowed number of attachments in a request or in a stage of the request?

Cloak
id@saiba-mais-5

There is no restriction on the maximum number of attachments that can be added to a request (considering all stages) or in a single stage of the request.

However, when adding more than 600 attachments (files) at once, a message is displayed warning that there may be instability in the resource. Even so, the attachments are added as long as they do not exceed the maximum allowed size per file defined in the , which by default is 100MB, and can be changed up to the limit of 1GB.

Informações
titleAttention!

This documentation is valid from the Voyager update (2.0). If you are using a previous update, it may contain information different from what you see on your platform.



HTML
<style type="text/css">
.confluenceTable .confluenceTd {
    vertical-align: middle !important;
}
</style>

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