Histórico da Página
| Informações | ||
|---|---|---|
| ||
This documentation refers to the new process editor of the platform. If you are using the current process editor, access Configure activity. |
| Í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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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.
2º → 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 subtle true title EXAMPLE 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 subtle true title EXAMPLE 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 | ||
|---|---|---|
| ||
→ The attachment must be equal to 2. It is mandatory to add two attachments at this step, and adding more is not allowed. |
| Painel | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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.
|
| Painel | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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.
|
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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
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.
|
| Painel | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
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.
|
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 subtle true title EXAMPLE
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 subtle true title EXAMPLE
.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 subtle true title EXAMPLE
!*.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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||
|---|---|---|
| ||
→ 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 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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.
|
| Painel | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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.
|
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Informações | ||
|---|---|---|
| ||
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> |
