To edit a document, select it on the main screen list of records and click on the toolbar button. If the document was created through a wizard, it is also possible to perform this operation through the Document data option in the Summary step.
The document data screen will be displayed with the data entered during the addition already filled out. The presentation of some sections and fields on the screen and their availability for filling depend on the characteristics, controls and configurations established in its category. The following sections may be displayed:
General data
This section will display the document data entered during its creation, which can be edited. The document ID #, title, author, responsible, validity and summary may be edited according to the configurations made in the category. It also possible to switch the category of the document. It will be possible to view the status, revision number, validity date and quantity of views of the electronic file. To obtain a detailed description of the displayed fields, view the Adding a new document section.
When the user transfers a document from one category to another, they should keep in mind:
▪The system allows you to transfer documents that are configured to be stored in a database to a controlled directory and vice versa, regardless of the situation they are in. ▪If a record schedule has been configured for the source category, when the user transfers the document to another category that has a different record schedule and such record schedule has not been configured with the same steps, the document will return to the previous step, configured in the record schedule of the category where it will be transferred. ▪For categories with Revision and Physical record controls, the user cannot transfer the documents to other categories that do not have the same configurations of the source categories. |
Attributes
This section will only be displayed if at least one attribute is associated in the Attribute tab of the document category. If the document was created using the wizard, the attributes may be displayed already filled out, but it will be possible to edit them. The way to fill in an attribute varies according to the configurations established when creating it. Note that the blocked attributes will not be available for editing.
▪If the document has an electronic file with a docvariable that uses the value of an attribute and this value is edited in this section, after saving the record, the system will send the file to the conversion queue to pdf, so it can be converted again. ▪If a watermark that uses the value of an attribute is applied to the document and this value is edited in this section, after saving the record, the updated value will be displayed in the watermark when printing it. |
Keyword
In this section, it is possible to associate keywords with the document. If keywords were associated with the document during the addition, they will be displayed.
To associate keywords with the document, in the available field, type the name of the desired keyword and press Enter on the keyboard or use the button to select it. Associate all desired keywords. Use the other buttons next to the field to add a new keyword and associate it with the document.
As the keywords are associated, they will be displayed in the area just below the field. To disassociate a keyword from the document, hover the mouse on the word and click on the Close option. To disassociate all document keywords, click on the button, placed next to the Keyword field.
|
General
Current revision
|
Revision
|
Displays the ID # of the document current revision.
|
ID #
|
Displays the date until which the document current revision is valid.
|
Reference revision
|
Revision
|
If the revision ID # has been defined to be Numeric or Text, this field will be filled out by the system with the number/letter that corresponds to the document current revision. If it is Customized, enter an ID # for the revision that is being created.
|
Cycle
|
Displays the revision cycle number, according to the revision process:
▪ISO9000 based: Every time a participant rejects a document revision, the system changes the number in this field. ▪Workflow: Whenever the activity that is configured to start a new cycle is enabled for the responsible user, the system increments a number in this field. |
Date
|
After the revision is closed, it displays the date in which this operation was performed.
If the "Allow entering the revision date" option is checked in the general parameters, this field will be displayed enabled and blank. In this case, if the field:
▪Is not filled out: After the revision is closed, it displays the date in which this operation was performed. ▪Is filled out: The system will consider the entered date as the revision validity date. If the revision is closed before the entered date, the revision will remain with the Closure status until the date when the document is published. |
Status
|
Displays the revision step in which the document is found.
|
Reason
|
Fill out this field to enter a reason to open the revision. In this case, select the desired reason. Use the other buttons next to the field to add a new reason for the revision and clear the field.
|
Control
|
Planned
|
Enter the scheduled dates to start and end the revision.
|
Actual
|
Displays the actual start (date when the electronic file of the document was opened for the first time for editing) and end (closure) date of the revision.
|
Revision publication
|
Displays the closure configuration defined in the category of the document under revision, but the user can edit it while it is in progress. In that case, select whether the revision closure will be:
▪Automatic: When the releaser executes their task, the revision will be automatically closed, meaning that the system will not generate the revision Closure step. ▪Manual: When the releaser executes their task, the system will generate the Closure step for the responsible users. |
Responsible
|
Displays the user and date in which the creation of the revision was performed and with the user and date in which was held the release of the revision, that is, when it was executed its closure.
If the closure is automatic, the name of the user who performed the last revision step will be informed.
|
Description
|
Use the available field to describe the document revision.
|
Explanation
|
Use the available field to enter an explanation for the document revision. It will be mandatory to fill out this field if the "Require explanation to be filled out when revision is started" option is checked in the revision control configuration.
|
Participant
This tab will only be displayed for ISO9000 based document revisions. The filling out of the information in this section depends on the route type selected in the document category. If it is a "Fixed & unique" route, this section may not be edited. If it is a "Fixed" route, the participants may only be selected through a revision route. If it is a "Variable" route, the participants may be selected through a route or through the buttons of the Step sub-tab.
Cycle: Displays the cycle revision. If so, select the previous cycles to view the members of the responsible route who performed the previous revisions of the document. Click on the button to import the participants flow from another revision route already created in SE Document. At this point, the participants are displayed in the Step subtab.
Status: Displays the "Under revision" status while the revision is still in progress. After the revision release, it displays the "Closed" status.
Start: Displays the data on which the revision was created.
End: Displays the date on which the revision was ended.
Closure: Displays the data of the user who closed revision. If the closure is automatic, the name of the user who performed the last revision step will be informed.
In the bottom part of the screen, it is possible to view/establish the participants of the revision route of the document, according to the definitions of its type. If the configured route type is Variable and a revision route is entered, the participants will be displayed in the list of records on this tab. In case a revision route has not been entered, it is possible to configure the desired participants. To do that, use the toolbar buttons next to the list of records:
|
Click on this button to add a participant in the document revision. View the Configuring a revision route section to obtain a detailed description of how to add a new participant. It is important to point out that if the participant is being added to a route associated with the revision, this addition will only be valid for the revision of the document, not being replicated to the route record made through the Configuration Revision Route menu.
|
|
Click on this button to change the sequence, deadline, or checklist of the participant.
|
|
Click on this button to delete the selected participant. Remember that it will not be possible to delete the participant when they have already received the revision execution task.
|
|
Click on this button to view the responsibility flow of the revision route.
|
|
Click on this button to import the flow of the participants of another revision route already registered in the SE Document. It is important to point out that if the revision route is the Fixed type, only this button will be enabled and this will enable the user to edit the revision route entered in the category of the document, however, it will not be possible to edit its members.
|
Regardless of the route type, it will not be possible to add, edit, or remove participants from those steps that have already been executed.
|
Workflow
This tab will be displayed, instead of the "Participant" tab, for document revisions that are controlled by a process instantiated in the SE Workflow component. See a description for the fields displayed in this tab in the Creating a revision section.
Change
Click on the button to enter the changes that have been made to the document being revised. The changes can be entered both by the user who is creating the revision and for the drafters. On the screen that will be displayed, fill out the following fields:
Fields
|
Location
|
Enter the document location in which the change was performed.
|
Change
|
Describe the change performed in the previously entered location.
|
Critique
Click on the button to add critiques regarding the document being revised. The screen that will be opened will be divided in two tabs:
Tabs
|
Critique
|
Fill out the Description field with the improvements that must be implemented in the document that is being revised. Critiques can be added by the user creating the revision or by the reviewers, approvers and/or releasers of the revision, during the execution of the corresponding steps.
|
Solution
|
When a critique has been added, the Solution field should be used to inform the solutions that were made in the document. Only the drafter can fill out this tab during the execution of the respective step.
|
Request
In this tab, it is possible to associate a document revision request with the revision being created, indicating that it has been executed. If no request meets the revision, this tab can be disregarded. In order for this feature to function properly, it is necessary for the SE Request component to be part of the solutions acquired by its organizations.
On the side toolbar, the following buttons are available:
|
Click on this button to associate a request with the revision. On the screen that will open, enter the request related to the revision and save the record.
|
|
Click on this button to disassociate the request selected in the list of records from the revision.
|
|
Click on this button to view the data screen of the request selected in the list of records.
|
▪The document revision requests must be issued through the SE Request component. Whereas request executions may be performed through this tab or through the "Request execution" task. ▪Refer to the specific SE Request component documentation for more information on issuing requests. |
|
In this section, it is possible to view and associate the documents that compose the relationship of this particular document. To create a relationship between documents, click on the Add relationship button and select the desired type:
Contract addendum
It will only be available if the document category is of the contract type. In the Document selection field, associate a document that is an addendum of the contract in question.
Addendum contract
It will only be available if the document category is of the contract type. In the Document selection field, associate a document that is a contract with the addendum in question.
Document translation
In the Document selection field, associate a translation document to create a relationship between them. To do that, the documents must be in a different language from the original document, so that they represent the document translated to other languages.
Note: It will only be possible to add one document for each language.
Option
|
Notify structure revision
|
With this option checked, when a revision for a document with translation relationship is created, the Translation revision task will be generated to check the need to revise the related documents.
|
Notify when closing the revision
|
With this option checked, when a revision for a document with translation relationship is closed, the Translation revision task will be generated to check the need to revise the related documents.
|
After the associations are performed, when hovering the mouse over a related translation document, the "Actions" button will be displayed. Click on it to view the options to delete the translation, view the document data, and view its electronic file.
Where used
In the Document selection field, associate or add a document that has the document in question in its structure. If a previously created document is selected, it is possible to define if the current revision or a specific revision will be associated. If it is a specific revision, enter the number of the revision you wish to use.
Composed of
In the Document selection field, associate documents that compose the structure of the document in question. If a previously created document is selected, it is possible to define if the current revision or a specific revision will be associated. If it is a specific revision, enter the number of the revision you wish to use.
After the associations are performed, when hovering the mouse over a related structure document, the "Actions" button will be displayed. Click on it to view the options to disassociate, view the document data, and view its electronic file.
For the "Where" and "Composed of" relationships, if in the general parameters screen:
▪The "Allow only current revision in the structure" option is checked in the Document tab, it is only possible to associate with the relationship the current revisions of other documents, that is, the options that allow associating revisions of a certain cycle or in progress will not be displayed. ▪The "Notify structure revision" option is checked in the Revision tab, when going through a revision, the system will create the "Revision acknowledgment" task. |
|
In this section, it is possible to associate the electronic files of the document. If the category of the document has files associated in the Details Template tab, these will be displayed in the list of records. The appearance of the section and the buttons available in the sidebar will vary according to the configurations performed in the category of the document and in the general parameters. See more information in the Electronic file section.
▪If the document has a template form, this section will only be available if its electronic file type is "Multiple". ▪If the "Require electronic file" option is checked in the document category, it will not be possible to release it if at least one electronic file is associated with it. |
|
This section will only be displayed if the Printed copy control is configured in the document category. In it, it is possible to manage the copy stations responsible for the printed copies of the document On the side toolbar, the following buttons are available:
|
Click on this button to associate the copy station responsible for the document being created. See further details in the "Defining a printed copy" topic below.
|
|
Click on this button to edit the number of copies scheduled for the station selected in the list of records.
|
|
Click on this button to view the data regarding sending the copies to the station selected in the list of records.
|
|
Click on this button to disassociate the copy station selected in the list of records from the document.
|
Defining a printed copy
|
To establish the copy station in which the printed copies copied must remain and the number of copies programmed for the station, click on the button on the side toolbar. On the screen that will be opened, the following fields are available:
Fields
|
Copy station
|
Click on the button next to this field to select the desired copy station. The selection screen that will be opened will display the hierarchy of the copy stations recorded in the system.
Check those that will be responsible for the printed copies. Use the and buttons from the selection screen toolbar to check all the stations in the hierarchy and uncheck all the selections made. Once done, save your selection.
|
# of copies
|
Enter the number of printed document copies that are programmed to be assigned to this particular station. The distribution of the defined copies will be through the Management Copy Distribution menu.
|
|
|
This section will only be displayed if, in the document category, the Electronic copy control is configured and if the "Execute applicability evaluation" is checked. It will only be filled out after the execution of the Applicability evaluation task, allowing the user to view whether the document was considered applicable or not. Click the button to view the distribution list data screen.
|
In this section, it is possible to define translations for the title in the language of the document. To do that, select the language to which you wish to translate and enter the translated title in the required field. Thus, when logging into the system with the respective language, the document title will be displayed as translated.
Note: The language to which the title was translated will be displayed next to the title.
|
This section will only be available if the Indexing control is defined in the document category and the "Indexing approval" option is checked. The fields and buttons displayed will vary according to the approval process defined in the category:
Responsibility route
It is possible to view or define the responsible parties for the document approval. The completion of the information depends on the route type selected in the category. If it is a "Fixed & unique" route, this section may not be edited.
Field
|
Responsibility route
|
Select the responsibility route for the approval of the document. If the route defined is "Fixed", it will only be possible to define another route through this field, however, it will not be possible to edit its members. Note that only the approval responsibility routes will be available for selection.
|
Approval type
|
Displays the approval type (Incremental or Circular) defined at the time of the responsibility route creation selected previously; however, it is possible to edit it.
|
Cycle
|
Displays a number indicating the approval cycle that the document is going through. Each time the document is rejected and goes through approval again, the system increases a number. Select the previous cycles to view the members of the responsibility route that performed the approval.
|
Option
|
Checked
|
Unchecked
|
Wait for all members approval*
|
The document will go to the next approval step after all route members release their tasks.
|
The document will go to the next approval step as soon as a member of the current step releases the task.
|
*It will be displayed checked or unchecked by the system according to the configurations performed when creating the route
If the route type defined in the category is "Variable", on the side toolbar of the list of records, the following buttons are available:
|
Click on this button to add a new user responsible for the approval of the document. It is possible for the responsible party to be a system user or an external guest. In the case of a guest, the document will be sent for approval via e-mail. See further details in the E-mail template section.
Refer to the Configuring a responsibility route section to obtain a detailed description on how to add responsible parties for the document approval. Note that by adding a new responsible user to a route associated with the document approval, this inclusion will not be replicated to the route record made by the Configuration Responsibility route menu.
|
|
Click on this button to edit the data of the responsible for approval selected in the list of records.
|
|
Click on this button to delete the responsible for approval selected in the list of records.
|
Workflow
The information related to the instantiated process (workflow) for document approval will be displayed. On the side toolbar, the following buttons are available:
|
Click on this button to view the data screen of the process selected in the list of records.
|
|
Click on this button to view the flowchart of the process displayed in the list of records. Refer to the specific SoftExpert BPM Suite - Process Modeling (SE Process) component documentation for more details on process flowcharts.
|
|
Click on this button to view the process history displayed in the list of records.
|
▪Refer to the SE Process specific documentation for more information on the process history and data screen. ▪Refer to the SE Workflow specific documentation for further details on process instance and activity execution. |
|
This section will only be displayed if, in the document category, the Revision control is configured, and the revision process is "Workflow". When selecting it, the screen to view the process flowchart (workflow) that controls the document revision is opened. Refer to the specific SoftExpert BPM Suite - Process Modeling (SE Process) component documentation for more details on process flowcharts.
|
This section will only be displayed if, in the document category, a template form is associated. By selecting this option, it is possible to view the content of the template form of the document. Note that the form is only available for editing when the document is found in the indexing stage, revision draft or if the document has no indexing or revision stage at the moment of its registration.
If the type of the document's electronic file is "Single" and it contains a template form, when it is released, the form will be converted to pdf and displayed in the "Electronic file" section, as long as the "Publish PDF files" option is checked in the category.
|
|
Click on the arrow under this option to configure and issue the desired document label and data reports. This button also allows configuring a new report or associating an existing report and also viewing the parameters that can be used in the configuration of new reports.
|
In this section, it is possible to manage the sharing of the electronic files of the document. The list of records will show the people to whom the sharing link was sent.
Using the columns displayed in the list, you can: enable or disable the link, view whether the email with the share link was read or not, change the link restriction situation to public or private, and change the public link validity. Use the buttons on the side toolbar to delete a shared link and to resend the email with the link for sharing.
|
Use the options available to save the record after all the necessary configurations and associations for the document are performed.
|