Document toolboxDocument toolbox

DMS File Table Commands


The functions of the DMS that are available for the user are shown above the File Table with access to the buttons controlled via DMS Security Permissions.   

You can control and structure your project files and workflows using folder setup in conjunction with this button access .  Also refer to DMS Configurations Guidelines for further details.

Please be aware that Security Group permissions and thus button access is controlled on a folder by folder basis and therefore you may be able to do things in 1 folder and not in another.  Refer to your Superuser or DMS Admin for Security Group queries.

Multi Document Select

By selecting multiple files with the Select column Document Actions can be carried out against multiple files in one go.

The maximum no of Documents that can be selected at once is 500.

Document Actions

Add Document


Upload documents into the current folder.  Navigate to the required folder and click Add (Security group controlled) to show the Upload Panel.

You can either:

  1.  Drag and drop file(s) to be uploaded into the the green box or 
  2.  Select individual files by clicking on the Select button

The maximum file upload to the DMS is 6GB in each upload.  Likewise, with larger individual files, 6GB is also the maximum size which can be uploaded. 

File types are filtered to accept valid files and all files are anti-virus scanned on upload.  If a file type you need isn't accepted please contact Clearbox support with details for inclusion.


Once documents have been added to the Wizard they will get a coloured dot shown in the 'Saved' Column, with the following meanings:

 Blue Dots shows files that have been recognised as uploaded to the system already.  Any Metadata associated with these files will therefore not be editable during this upload stage.  The Revision and Document Purpose are editable need to be saved.

 Red Dots show files that have not been recognised on the system already.  All Metadata, Revision and Document Purpose fields are editable and need to be saved.

 Green Dots show files that have had their Metadata details saved in the Wizard.  These files are ready to be Uploaded.

 

If default configuration is used: The document filename will appear within the Filename and Title box. You can change the Owner, Author, Title, enter a Document Number, amend the Revision Date, choose a Revision and select a Document Suitability.

If ISO19650 configuration is used: If a file has been named according to the standard, including the optional elements, and the metadata values are configured in the project they will be recognised at upload stage and pre-populated into the File Identifier fields. Values for the IDs can be changed from those extracted from the filename, but the filename remains unchanged.  The ISO19650 filename formats that are recognised are:

  • ISO1650ID
  • ISO19650ID_OptionalTitle
  • ISO19650ID_OptionalTitle-Suitability-Revision

Select files (far left had column) to edit metadata fields in the section below.  If multiple files are selected then only the common metadata fields will remain enabled, with uncommon fields disabled.   The files then have to be individually selected if you need to amend other fields. 

All documents can have Upload Comments added to them in the bottom text entry field.  Please note that files that have had comments added are not able to be moved in the DMS.

Once the metadata has been set click Save and the blue and red dots shown in 'Saved' column will turn green.  If the save is not successful an error message will appear.

The system will only allow one document with the same File Identifier to be uploaded onto the platform. If the same File Identifier is used then it will flag this up to you and provide you with the next number. 

If a document is being revised and it has DMS Codes configured to Copy on Revise, those codes will be copied to the new file revision being uploaded.

Once you are ready to continue select all the files you wish to Upload and click Upload. You will prompted to confirm the number of files you are uploading.


Antivirus scan

Note that all files are scanned for viruses upon upload to BIMXtra, with infected files being replaced with .TXT details files.



Revise

There are two options available to you to revise documents:

Add (Refer Above)

You can use Add to revise a file that already exists in the DMS. Select the folder where the document is located and Add the revised files. 

Please note: This relies on you making sure the documents have the same filename. If they do not, then the documents will be added as new entities and therefore duplicates on the system.

Refer to Add Document for details.


Revise Documents

You can also use the Revise button to revise a file or a group of files. Select the file(s) you want to revise and then select the Revise button. 

The selected file(s) will be displayed in the pop up with various document metadata details shown.

Select each file in turn in the top panel and edit the settings in the bottom panel:

  • Revision - Of the revised file
  • Document Purpose / Suitability - Of the revised file
  • Recipient - Notify users via email of the File Revision
  • Primary File - Select a new file from your PC to become the next revision of the the existing file.  Use this if you need to revise a file that doesn't have the same filename as the existing one
  • Secondary Files - Select any secondary files to add to this file revision
  • Comment - Add Revision Comments to the File
  • Copy Annotations - If the document being revised has annotations this option will copy those annotations to the new file revision,
  • Copy DMS Codes - If the document being revised has DMS Codes configured to Copy on Revise, this option will copy those codes to the new file revision,
  • Copy External Metadata - If the document being revised has External Metadata this option will copy that metadata to the new file revision,

Revisioning Codes

The revision codes used in the DMS containers are as follows:

WIP:   Both Step and Point Revisions are used, with the user setting Step Revisions and the System automatically setting Point revisions.  When a document is uploaded for the first time within WIP it will be given both a Step and a Point revision.  When the document is revised the Point revision will be set automatically with the Step revision set by the User.  The Revision can be overridden by the user with the above Revision setting.

EG, Upon first upload of a document the revision will default to either $.1 or P01.1 depending on which configuration is used.  When the document is revised it will be given a Step revision set by the user EG A.1 or P02.1 and it will be given a Point revison automatically incremented by the system  EG A.2 or P02.2

Share:   Only Step Revisions are used and they are automatically incremented by the system.  The Revision can be overridden by the user with the above Revision setting.

Published: The revisioning works the same as it does in Share.

Delete


Allows a User to Delete documents in the current folder.  Navigate to the required folder, select the required files and click Delete (Security group controlled) to delete the latest revision of each file.  Use the Delete function again to delete any further revisions of your files in reverse sequence order.  It is not possible to only delete a particular revision of a file without also deleting all prior revisions of it first.

E.g. If a file has 3 revisions, using the delete button once will leave the 2nd revision as the primary file.  Using delete again, will leave the 1st revision as the primary file.  Delete once more will remove all history of that file.
To remove all revisions of a file in a single action, you may prefer to use the Archive function.

Restore Deleted Files

Deleted files are removed from the DMS tree however remain available for review and recovery in the Deleted Documents page.


Edit Metadata

Required Role

Access to the Edit Metadata command is controlled by the Metadata UI Edits role.

Access to edit the DMS Codes is controlled by the Metadata Columns role and access to edit the External Metadata is controlled by the project configuration.


Edit the Metadata, DMS Codes and External Metadata of selected files. 

Right Click on the column layouts in order to show and hide columns, including the DMS Codes and External Metadata fields.

Save the layout of your columns as currently configured.

Multiple File editing

Note that with multiple files selected in the Edit Metadata window that all files will have the new values saved against them once the Save button is used.



Move

Access to the move function is based on a users folder permissions defined in Security Groups.  It allows allows files to be moved to a different folder within the same tab they're in. E.g., a file in WIP can only be moved to another folder within WIP. 
Please note that a file can only been moved if nothing has been done to it in the DMS.

  • The file cannot be moved if it has been edited
  • The file cannot be moved if it has multiple revisions
  • The file cannot be moved if a secondary file has been added
  • The file cannot be moved if it is in the document basket
  • The file cannot be moved if it has a comment made against it

To move a file(s), select it/them and click move. A pop up will appear with the folder tree expanded to level 1. Select the folder that the document needs to be moved to and click OK.



Distribute


This button can be used to Distribute shared and published documents
For more detail on distributing documents click here


Download

 
Multiple files can be downloaded into a .zip file, including any Secondary files.  If a single Primary file is required, you can also use the Download/View column.

Select the files to download and click the download button.

  • Download As - Select the filename style to give to the downloaded Primary files
  • Include Secondary Files - Option to include them in the download zip as well.  Secondary Files will be placed into a zip folder with the same name as the Primary file and suffixed with '.2.zip'
  • Max Zip Size - The maximum size of zip file to download.  Downloads will be split into as many zip files of this size as required to include all selected files.
  • Fastest-Best - Sets the Compression type for the zip file which determines the zip file size and time taken to create.  Fastest will be the fastest produced zip, but may not be smallest possible size.  Best will be the best compressed (smallest size) zip, but may take longer to produce.

Burn-On-Download: For projects with Annotation Merge feature enabled, downloaded PDFs will include the current state of Annotation redlines at the time of download.

The notification tray will highlight the files that are downloading into the zip and once they are ready you will be able to click on the blue link text to get the files.

Once all your zip files have downloaded you can unzip them locally to get your download files, EG:

Archive


Archive an entire File record from a folder and send all it's document revisions to the Archive section of the DMS. Please be sure that this action is required as there is currently no way to restore the information. The archive tab is controlled via Security Permissions, if you need access, please contact your project Superuser.

Add Comms

Create a new Comm with any currently selected DMS files automatically added to the Comm.  Any files that are selected will be added after the Comm is Saved and it has reached the Submit stage.  Further files can be added before the Comm is finally Submitted.

Link to Folder

Allows the linking of selected files to Dynanic & Static folders.

You can also use the Mouse Right Click menu to link selected files

Dynamic

Link selected files into a Dynamic Folder.

Static

Link selected files into a Static Folder.

Comments

Shows all comments from the last 24 hours that you have not read that are registered against documents in the current folder.  Navigate through multiple pages with the page controls at the bottom of the panel.


Basket

The Basket is a function where the user can add and remove files from many areas of the DMS for use at a later stage.  It holds a reference to each of the added files, not a copy of them. 

Add


You can add files from any folders in the DMS into the Document Basket.  The basket has the following limitations:

  • The basket has a limit of containing 500 items.  However some of the functions in the basket can only operate on 100 items (refer individual commands below).

View

Shows Document Basket for actioning currently held documents.

Latest revisions of documents are shown in normal font:

Old revisions of docs shown in Italics font:

From here you can then run the following commands on the files in the basket:

  • Download - Download the selected files (max 500 files),
  • Distribute - Distribute selected files (max 500 files),
  • Edit - Edit Metadata for selected files (max 250 files),
  • Dynamic - Link selected files to a Dynamic folder (max 100 files),
  • Static - Link selected files to a Static folder (max 100 files),
  • Add Comms - Add a new Comm with the currently selected basket documents attached (max 100 files),
  • Remove - Remove selected files from the Document Basket
  • Empty - Empty the Document Basket
  • Empty Document and Close Basket - Empty and Close the basket
  • Metadata - Run the Metadata report on the currently selected basket documents (max 500 files).
  • Save Layout - Save your current Document Basket Layout.


Reports

Metadata


The Metadata report provides details of files and any metadata they hold.  There are 4 options for the exported XLS format file:

  • Current View - Exports the entire WIP / Shared / Published Tree View that is currently selected.
  • Current Folder - Exports the current folder
  • Current Folder (incl. Subfolders) - Export the current folder and all the subfolders
  • Search Results - Exports current search results that are visible in the DMS window.

Note: Reports can only be run from the root Folders of WIP/Share/Published views by users with the DMS Admin role.

The XLS file contains 2 tabs with Metadata as follows:

DMS Meta Report

The DMS Meta Report tab contains the file details and the DMS Codes shown in the current file table window.

Included are URL links to:

  • Download each doc directly,
  • Add each doc to your basket,
  • View each doc in the project DMS

External Metadata

The External Metadata tab contains summary information and the External Metadata defined for each file.

These values can be edited in the XLS and uploaded back to update the DMS vlaues.

Use the Upload Metadata command to update the values in the DMS with the XLS edited values.



Upload Metadata

Required Role

Access to the Upload Metadata command is controlled by the Metadata Upload Edits role.

Upload edited Metadata reports to the DMS and update the values of External Metadata for each of the files in the report.

Requires External Metadata to be enabled on the project.

Signoff


The Signoff report provides details of all document distributions in the project and is exported in XLS format.

User Journal

For users with the DMS Admin role, the User journal provides a log of all activities based on a user selection.  In other words you can look and see which documents and actions a user has undertaken in the system.

Please note the page Size limit at the bottom of the screen is also the limit of filtered results with the column filters.  Therefore you should ensure your page size is large enough to capture all possible results for your filter selection.

All information displayed can be exported to Excel.

The user log is also available in Docs For Review


Options

Save Layout

Save the current layout of your DMS File Table, including visible columns and column sorting order, and apply it to all folders across the current project.  Therefore you can have different page layouts to suit each of your projects.

Table Options

 Set the table options.

  • Excel Style Filters - Display the Excel style Column headers filters.  Note that these filters work on the current Page listing, and not across all filtered results if that extends past the current page limit. 
  • Freeze table column - The number of columns on the left hand side of the table to freeze if the table is panned across to the right.
  • Row Height - The height of each row before any text wrapping that might happen for long values.

Notifications

Manage your DMS email notifications for the current project.  This provides you a XLS Daily Digest of any selected activity for the folders you setup, with the option to Include Subfolders.  Digests are only sent if any of the selected activities are triggered on your monitored folders that day.

You can manage the folder notifications you have for the current folder.

Current Folder

Add a Daily Digest notification for the current folder, with the option to Include Subfolders.

Manage Notifications

Shows the folders you are receiving Daily Digests for.  Use the Delete button to the right to remove Notifications for that folder.

Security

For users with the Security Group role, allows configuration of folder permissions as an alternative method to that via the Security Groups page.  This method allows a 'folder based' approach to setting security groups, where all security groups accessing a folder can be configured in a single XLS.

Folder Based Security Group configuration

Download the configuration XLS to enable the folder based security group configuration. Optionally, include all sub folders (from the currently selected folder), and include de-activated security groups as well.

Configure the folder permissions for each Security Group, as required:

Upload Configuration XLS

Upload the configuration XLS previously edited (above).

A notification is provided upon completion of the upload of the configuration file.





Contact Clearbox: 0844 800 0981 | info@clearboxbim.com