This documentation refers to the new process editor of the platform. If you are using the current process editor, access Configure activities and flows. |
Speaking of Start component...

The Start component is the initial step of a process and indicates where the flow begins. When opening a process request, this is the first step that you will execute.
You can define who can open process requests through the assignment mechanism of the component. Those who have permission can open process requests from the Start requests feature.
In this component, you can also configure some general characteristics, define attachment rules, deadlines for completion, among other features.

View guided tour of the Start component

01. In the process diagram, click on the Start component
.
02. On the right side, where the component settings are displayed, click
Utilization Guide – located at the bottom.
03. View the presentation of the highlighted feature.
04. Click Next to proceed to the presentation of the next feature.
Click Back to review previous features, if any. |
05. Upon completing the guided tour, click Finish.
If you want, you can click Back to review previous features before you are done. |
Configure Start Component

01. In the process diagram, click the Start component
.
Find the available settings displayed on the right side. |
02. In the General tab, define the general information for the component that represents the first step of the process; that is, the opening of the request.
Title Name of the first step or activity of the process. The person who opens the request performs this step.
 In a Vacation Request process, you could name the Start as Request Vacation.
|
Activity Instructions Instructions aimed at facilitating the understanding of the person who will open the request – or execute this step again if the request returns to them – such as data that need to be provided to expedite the understanding and resolution of the request. Find the instructions in the Request Information tab.
You can add an instructions document that is stored in the Documents resource. To do this, simply use the format [WD:codigodoc] replacing codigodoc with the numeric code of the document. |
Request Password When activated, it determines that the requester must provide their password when opening the request – or when executing this step again if the request returns to them. If the password is incorrect, the requester can enter it as many times as needed. The request will only be enabled when the password is entered correctly. The history of the request opened records the password confirmation. If you have already enabled the Confirm Password option in the Security tab of process settings, this option will be disabled. Steps configured to request a password cannot be automated by Web services. |
Transfer Responsibility When activated, it allows you to transfer responsibility to another person if the request returns to this step |
03. Click on Attachment Settings – located at the bottom – to set the rules for the required attachments in the initial stage of the process; that is, the opening of the request.
The rules for attachments are not required. When not set, you can leave the stage without attachments or to add any type and any number of attachments, as no validation is performed. Click here to understand how attachment rules work before configuring them. |
|
04. To define that the stage should not receive attachments, activate the Prohibit attachments option.
Prohibit attachments When activated, it determines that no files are allowed to be attached in this stage |
05. If the stage allows attachments, click
Add attachment rule to the activity to set the rule.
06. In General rule, choose how the attachment should be, selecting a condition and entering a quantity, if the condition allows.
The available conditions are: - equal to;
- greater than;
- greater than or equal to;
- less than;
- less than or equal to;
- any.

→ The attachment must be greater than or equal to 2. This means that you are required to attach at least two attachments – though you can add more – in this stage. → The attachment must be less than 4. This means that you are allowed to add up to three attachments in this stage or leave it without an attachment. → The attachment must be any. This means that you can add any type and quantity of attachment in this stage or leave it without an attachment. Click here to see more examples of how to use the general rules. |
|
|
|
07. If desired, click Add specific rule to determine some required characteristics for the attachment.
08. Choose the characteristic of the attachment to compose the specific rule.
The available conditions are: - the extension;
- the file name;
- the name and the extension;
- advanced condition: when selected, you need to create the rule from an expression that uses the characters * (asterisk), | (pipe), and ! (exclamation). Refer to step 11 for more details about this option.
|
09. Now, choose the condition that this feature needs to meet.
The available conditions are: - equal to;
- different from;
- containing.
If the selected condition is containing, you can still choose: |
10. Finally, provide the terms that must or must not appear in the name or extension of the attachment, according to the selected feature and condition.

→ The attachment must be any with the extension equal to .zip. This means that you are required to add any attachment that has the .zip extension. → The attachment must be greater than or equal to 0 with the extension equal to .log. This means that you can add one or more attachments with the .log extension or leave the step without attachments. → 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. This means that you are required to add an attachment that has the term boleto at the beginning of its name and that is a PDF document. Click here to see more examples of how to use the specific rules. |
|
|
To remove the selected conditions for the specific rule, click Remove – located at the end of the rule composition. |
11. If the option selected for the specific rule is advanced condition, you can set the rule using an expression that can contain the characters * (asterisk), | (pipe), and ! (exclamation). 
- * (asterisk): allows for any characters before or after it.
- | (pipe): means "or" and allows defining multiple patterns.
- ! (exclamation): means "different from" or "prohibited" and allows blocking a pattern.

→ The attachment must be any with advanced condition !*.zip. You are required to add any type of attachment with an extension different from .zip. The .zip extension is prohibited. → The attachment must be greater than or equal to 2 with advanced condition .pdf|.jpg. You are required to add at least 2 attachments that have one of the allowed extensions: .pdf or .jpg. → The attachment must be equal to 1 with advanced condition fatura.pdf. You are required to add an attachment that contains the term fatura in the name and has the .pdf extension. |
|
Click here to see more examples of how to use the specific rules. |
To remove the conditions defined for the advanced rule, click Remove – located at the end of the rule composition. |
12. In Error message if the rule is not met, define a message or an instruction to assist the person executing the initial step when the attachment they added does not meet this rule.

→ If the rule is: The attachment must be greater than or equal to 1. The message can be: You need to attach at least 1 file of any type. If you wish, you can attach more than 1. → If the rule is: The attachment must be equal to 2. The message can be: You need to attach 2 files of any type. You cannot add more than 2. → If the rule is: The attachment must be greater than or equal to 3 with the extension equal to .pdf. The message can be: You need to attach at least 3 documents of the PDF type. If you wish, you can attach more than 3. |
|
|
13. Click Save.
When saved, the rule is displayed in Created Rules. The rules are displayed in order of creation, from the most recent to the oldest. You can edit or remove the created rules by clicking Actions – located on the right side of the rule – and then on Edit or Delete. When editing or deleting a rule, the display order does not change, meaning they continue to be displayed in order of creation, from the most recent to the oldest. To add more rules, click Add attachment rule to the activity. |
14. Once you have completed the configuration of all desired rules, click Close
– located in the upper right corner.
15. Click the Assignment tab and define who can open requests for the process; that is, who can execute the initial step.
Assignment type How to define who can open requests for this process; that is, who can execute the initial step of the process. The available options are: - Anyone: when selected, it determines that anyone can open requests for this process.
- Specific group: when selected, it determines that only people from a specific group can open requests for this process.
- Specific role: when selected, it determines that only people who hold a specific role can open requests for this process.
Specific group Specific group of people who can submit requests for this process. This field is only displayed when you select the Specific group option in Assignment type. To see the people who are part of the selected group, simply click View , and to remove the selected group, just click Remove – both located on the right side of the group name.
Specific role Specific role held by the people who can submit requests for this process. This field is only displayed when you select the Specific role option in Assignment type. To see the people who hold the selected role, simply click View , and to remove the selected role, just click Remove – both located on the right side of the role name. Specific person Specific person who can submit requests for this process. This field is only displayed when you select the Specific person option in Assignment type. To remove the selected person, simply click Remove – located on the right side of the person's name. |
16. In Tracking, check the options that represent who should be notified when the request leaves this stage or reaches this stage – in case it returns to it.
The available options are: - Notify person responsible: when checked, it determines that a notification about the start of the request be sent to the person responsible for this stage, who, in this case, is the requester themselves or the person to whom the responsibility has been transferred, if the request has returned to this stage.
- Notify manager: when checked, it determines that a notification about the start of the request be sent to the process manager.
Regardless of the checked options, the notification is not sent to the person who performed the action.  A person moves the request to a stage where they themselves are responsible. Even if the Notify responsible option is checked, they do not receive the notification, since the action was performed by themselves.
|
 The process manager moves the request (as responsible or manager) to a stage where the Notify manager option is checked. In this case, they do not receive the notification; only the other process managers receive it.
|
The same applies to all types of notifications, including that of a substitute.  If person A is the substitute for person B and moves the request to a stage where person B is responsible, person A (substitute) is not notified. Only person B and other substitutes for them are notified.
|
|
Notifications can be sent in the Notification center or via email, depending on how the sending options are configured in the personal profile, as well as which options are available for use in the company, which may have been configured globally – for all companies – or by company. |
|
17. Click the Deadline tab and define the information related to the completion of the initial stage of the process.
Working hours to be considered in the execution of this stage. The working hours are used in the calculations of the final deadline and delay of the stage. The working hours that exist in the Working hours resource are displayed for selection. Deadline by time Time, in hours, within which this stage needs to be completed. These hours, along with the selected working hours, are also considered to determine the final deadline for the completion of the stage. This time starts to be counted from the moment the request reaches this stage.  → The selected working hours are configured as: Monday to Friday from 8:00 AM to 6:00 PM.
→ The time for completion of the stage is 1 hour. → The request reached this stage at 5:30 PM on a Tuesday. → Therefore, the final deadline for completion of the stage will be Wednesday at 8:30 AM. After 8:30 AM, the stage will be considered delayed. |
|
18. Click Save draft – located on the right side of the top bar – to save the settings made in the Start component.
19. In the displayed message, click Ok, I understand.
Configuring rules for attachments

01. In the process diagram, click the Start component
for which you want to configure the rules for the attachments of the requests.
02. In the General tab, click Attachment settings – located at the bottom – to define the rules for the necessary attachments in the initial stage of the process; that is, the opening of the request.
The rules for attachments are not required. When not set, you can leave the stage without attachments or to add any type and any number of attachments, as no validation is performed. Click here to understand how attachment rules work before configuring them. |
|
03. To define that the step should not receive attachments, activate the option Prohibit attachments.
Prohibit attachments When activated, it determines that the user is not allowed attach files in this step. |
04. If the step will allow attachments, click
Add attachment rule in the activity to define the rule.
05. In General rule, choose how the attachment should be by selecting a condition and specifying a quantity, if the condition allows.
The available conditions are: - equal to;
- greater than;
- greater than or equal to;
- less than;
- less than or equal to;
- any.

→ The attachment must be greater than or equal to 2. This means that you are required to attach at least two attachments – you can add more – in this stage. → The attachment must be less than 4. This means that you can add up to three attachments in this stage or leave it without an attachment. → The attachment must be any. This means that you can add any type and quantity of attachment in this stage or leave it without an attachment. Click here to see more examples of how to use the specific rules. |
|
|
|
06. If desired, click Add specific rule to determine some required characteristics for the attachment.
07. Choose the characteristic of the attachment to compose the specific rule.
The available conditions are: - the extension;
- the file name;
- the name and the extension;
- advanced condition: when selected, you need to create the rule from an expression that uses the characters * (asterisk), | (pipe), and ! (exclamation). Find more details about this option in step 10.
|
08. Now, choose the condition that this characteristic needs to meet.
The available conditions are: - equal to;
- different from;
- containing.
If the selected condition is containing, you can still choose: |
09. Finally, specify the terms that need to or not appear in the name or extension of the attachment, according to the selected characteristic and condition.

→ The attachment must be any with the extension equal to .zip. This means that you are required to add any attachment that has the .zip extension. → The attachment must be greater than or equal to 0 with the extension equal to .log. This means that you can add one or more attachments with the .log extension or leave the step without attachments. → 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. This means that you are required to add an attachment that has the term boleto at the beginning of its name and that is a PDF document Click here to see more examples of how to use the specific rules. |
|
|
To remove the selected conditions for the specific rule, click Remove – located at the end of the rule composition. |
10. If the option selected for the specific rule is advanced condition, you can define the rule using an expression that can contain the characters * (asterisk), | (pipe), and ! (exclamation). 
- * (asterisk): allows for any characters before or after it.
- | (pipe): means "or" and allows defining multiple patterns.
- ! (exclamation): means "different from" or "prohibited" and allows blocking a pattern.
 
→ The attachment must be any with advanced condition !*.zip. You are required to add any type of attachment with an extension different from .zip. The .zip extension is prohibited. → The attachment must be greater than or equal to 2 with advanced condition .pdf|.jpg. You are required to add at least 2 attachments that have one of the allowed extensions: .pdf or .jpg. → The attachment must be equal to 1 with advanced condition fatura.pdf. You are required to add an attachment that contains the term fatura in the name and has the .pdf extension. |
|
Click here to see more examples of how to use the advanced rules. |
To remove the conditions defined for the advanced rule, click Remove – located at the end of the rule composition. |
11. In Error message if the rule is not met, define a message or an instruction to assist the person executing the initial step when the attachment they added does not meet this rule.
 
→ If the rule is: The attachment must be greater than or equal to 1. The message can be: You need to attach at least 1 file of any type. If you wish, you can attach more than 1. → If the rule is: The attachment must be equal to 2. The message can be: You need to attach 2 files of any type. Adding more than 2 is not allowed. → If the rule is: The attachment must be greater than or equal to 3 with the extension equal to .pdf. The message can be: You need to attach at least 3 documents of the PDF type. If you wish, you can attach more than 3. |
|
|
12. Click Save.
When saved, the rule will be displayed in Created Rules. The rules are displayed in order of creation, from the most recent to the oldest. You can edit or remove the created rules by clicking Actions – located on the right side of the rule – and then on Edit or Delete. Editing or deleting a rule does not change the display order, meaning they continue to be displayed in order of creation, from the most recent to the oldest. To add more rules, click Add attachment rule to the activity. |
13. Once you have completed the configuration of all desired rules, click Close
– located in the upper right corner.
14. Click Save draft – located on the right side of the top bar – to save the changes made to the Start component.
15. In the displayed message, click Ok, I understand.
Edit attachment rule

01. In the process diagram, click the Start component
for which you want to edit the rules for the attachments of the requests.
02. In the General tab, click Attachment settings – located at the bottom.
03. In Created Rules, locate the rule you want to edit and click Actions
– located on the right side of the rule.
04. Click Edit.
05. Change the conditions of the rule as desired.
06. Click Save edit.
The editing of a rule does not change their display order, meaning they continue to be displayed in the order of creation, from the most recent to the oldest. |
07. When you finish editing all the desired rules, click Close
– located in the upper right corner.
08. Click Save draft – located on the right side of the top bar – to save the changes made to the Start component.
09. In the displayed message, click Ok, I understand.
Delete rule for attachments

01. In the process diagram, click the Start component
from which you want to delete the rules for the attachments of the requests.
02. In the General tab, click Attachment settings – located at the bottom.
03. In Created rules, locate the rule you want to delete and click Actions
– located on the right side of the rule.
04. Click Delete.
05. In the confirmation message displayed, click Delete rule.
You cannot restore a rule that has been deleted. The deletion of a rule does not change the display order of the others, meaning they continue to be displayed in the order of creation, from the most recent to the oldest. |
06. When you finish deleting all the desired rules, click Close
– located in the upper right corner.
07. Click Save draft – located on the right side of the top bar – to save the changes made to the Start component.
08. In the displayed message, click Ok, I understand.
This documentation is valid from the Voyager (2.0) update onwards. If you are using a previous update, it may contain information different from what you see on your platform.
|
<!-- 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> |