Configuring an import spreadsheet
Prerequisite
- Access to the Document (DC010) menu.
Introduction
SoftExpert Document allows for importing documents and revisions directly into the system, which makes it easier to add and update mass records.
This feature can be used both to create new documents and to create revisions in existing documents.
To perform the import, it is necessary to download the spreadsheet template in Excel format and configure its fields according to the instructions provided below.
Downloading and configuring the import spreadsheet
1. Access the Document (DC010) menu.
2. Expand the arrow next to the Create button.
3. Select the Via import option.
4. Click on the Click here to download the template file link.
5. Find and open the DOCXLSIMPORT.xlsx file that will be downloaded.
6. Once the spreadsheet opens, fill out the columns with information corresponding to the fields of the documents or revisions you wish to import. See below how to fill out the columns:
Spreadsheet columns
| Category |
Enter the ID # of the category that will be used to classify the documents to be created. This resource will work correctly only if the logged user has the Add permission enabled in the security list of the category in which they wish to create the documents. |
| ID # | Enter the ID #s of the documents that will be created. |
| Title | Enter the titles of the documents that will be created. The title does not need to be the same as the name of the electronic file. |
| Revision | Enter the ID # of the revision referring to the documents that will be created. |
| Date | Enter the validity date of the documents that will be created in the YYYY-MM-DD format. |
| Author | Enter the authors (responsible parties) of the documents that will be created. |
| Summary | Enter a brief description for the documents that will be created. |
| Keywords | Enter the keywords that will be associated with the documents to be created. Use a semicolon ( ; ) to enter more than one keyword for the same document. |
| Electronic file |
Fill in this field with the directory containing the electronic files of the documents that will be created. If the file type is set to Complex, fill in the field in this format: path/file name/ID # of the structure node in which the file will be inserted/file name with extension If the structure has several folder levels, enter only the ID # of the folder in which the file will be inserted, without the need to add upper level folders. For example: |
| Start date (Actual) |
This column must be filled out if, in the document category, it is defined that the revision process uses the ISO 9000 model, the route type is Variable, and there is no revision route selected in the corresponding field. Enter the start date of the document revision process. This date will be available on the document data screen, in the Revision > General > Control section, in the Start date field of the Actual grouping. Enter the date in the YYYY-MM-DD format (for example: 2025-02-17). |
Add more columns to customize your import, if you wish:
| Sequential | Enter the sequence in which the documents must be imported. |
| Attributes |
Adjust the column title to match the ID # of the attribute associated with the category in which the document will be created. If the attribute is multivalued, use a semicolon ( ; ) to separate the values. Insert as many columns as needed, according to the number of attributes defined for the category. |
| Separator |
Fill out this column only if you wish to use any separator other than the default one.
If you prefer to use other characters, enter a character or a sequence of characters that are not present in the values to be inserted. If this column is not filled out, the default separators (comma and semicolon) will be used automatically, as described above. |
| Responsible for the document | Enter the ID of the user who will be responsible for the documents that will be created. |
| Type |
This column is optional and must be used only to import a revision to a document that already exists. Insert one of the specified values in order for the system to perform the corresponding operation: 1. Verification of existing documents
2. Creation of existing revisions
3. Creation of revisions or new documents
4. Editing of existing documents The system checks if there already is a document with the provided ID #. Restrictions:
|
| Validity |
Enter the validity date of the documents that will be created. This date indicates until when the document will remain valid. In order for the completion of this field to be accepted, the default validity time associated with the previously selected category must be configured as Variable. Otherwise, the system will issue an error alert and will not carry out the import. The configuration of a default validity time can be set in the Control tab of the data screen of the corresponding category. |
| Where used | Enter the ID # of a document previously created in the system, to which the documents for import will be linked as part of its structure. If there is not a document with the provided ID #, the system will issue an error alert and will not carry out the import. |
| Draft |
This column must be filled out if, in the document category, it is defined that the revision process uses the ISO 9000 model, the route type is Variable, and there is no revision route selected in the corresponding field. Enter the ID of the users participating in the draft step referring to the revision of the documents to be created, as well as the number of days for the step to be executed. Use a semicolon ( ; ) to separate the pieces of information. For example: USER001 has not executed the revision step; therefore, the deadline will be calculated from the provided "Start date (Actual)" date and from the recorded number of days. USER002 has executed the step, so the execution date and value 1 have been inserted. Conclusion: All defined participants will have a revision sequence equal to 1. |
| Review |
This column must be filled out if, in the document category, it is defined that the revision process uses the ISO 9000 model, the route type is Variable, and there is no revision route selected in the corresponding field. Enter the ID of the users participating in the review step referring to the revision of the documents to be created, as well as the number of days for the step to be executed. Use a semicolon ( ; ) to separate the pieces of information. For example: USER001 has not executed the revision step; therefore, the deadline will be calculated from the provided "Start date (Actual)" date and from the recorded number of days. USER002 has executed the step, so the execution date and value 1 have been inserted. Conclusion: All defined participants will have a revision sequence equal to 1. |
| Approval |
This column must be filled out if, in the document category, it is defined that the revision process uses the ISO 9000 model, the route type is Variable, and there is no revision route selected in the corresponding field. Enter the ID of the users participating in the approval step referring to the revision of the documents to be created, as well as the number of days for the step to be executed. Use a semicolon ( ; ) to separate the pieces of information. For example: USER001 has not executed the revision step; therefore, the deadline will be calculated from the provided "Start date (Actual)" date and from the recorded number of days. USER002 has executed the step, so the execution date and value 1 have been inserted. Conclusion: All defined participants will have a revision sequence equal to 1. |
| Release |
This column must be filled out if, in the document category, it is defined that the revision process uses the ISO 9000 model, the route type is Variable, and there is no revision route selected in the corresponding field. Enter the ID of the users participating in the release step referring to the revision of the documents to be created, as well as the number of days for the step to be executed. Use a semicolon ( ; ) to separate the pieces of information. For example: USER001 has not executed the revision step; therefore, the deadline will be calculated from the provided "Start date (Actual)" date and from the recorded number of days. USER002 has executed the step, so the execution date and value 1 have been inserted. Conclusion: All defined participants will have a revision sequence equal to 1. |
| Repository |
This column must be created and filled out only if the Physical file control is defined in the document category. When this column is completed correctly, the document will be archived automatically in the first step configured in the record retention schedule associated with the category, without task generation. Insert the physical path in the following format: storage place + . + repository ID # For example: The document will not be created if:
Additional rules:
|
7. Save the spreadsheet.
- Name the template as you wish; however, its extension must be in the .xlsx or .xls format. The import feature is only compatible with these two formats.
- Column titles must have the same name as that of the fields displayed on the document data screen and must be in the same language as SoftExpert Suite at the time of the import.
- If the title token of a column is customized in SoftExpert Administration, the column name must be equivalent to the customized token.
When adding a revision:
- If the date of the revision is not set, the latter will be added in the draft step.
- If the revision is added in progress, it will not be possible to enter the release date for the revision participants.
- If there are no participants inserted in the spreadsheet, the system will use those inserted in the previous revision.
Conclusion
With the spreadsheet properly configured, the import process can already be executed in the system. As of this point, it is possible to import new documents or create revisions for already filed documents, in a quick and standardized manner.
To continue, select one of the options below, as needed: