Following TeamForge 19.3, the TeamForge 20.0 release extends the user experience enhancements to the Documents List page. You have the option to switch between the old and new Documents List pages using the **The New Documents** toggle button at the top right corner of the Documents List page.

The new Documents List page brings you cool new functions on top of the existing document management functions to ensure a better document management experience.

Here’s a list of noteworthy features to the Documents List page.

The Left Navigation Pane

A new left navigation pane lets you quickly access your documents. The left navigation pane consists of the following menus.

  • All Files—A drop-down menu that shows the document folder tree. Clicking the ALL Files menu, by default, lists the documents in the Root Folder. However, you can select any other folder from the drop-down menu to view the documents of that specific folder. The folder you last selected is persisted throughout the session to let you start from the same folder when you later visit the Documents List page.
  • Recent Files—Lists the recently viewed/added documents.
  • Favorites—Lists the documents marked as favorites.
    Refurbished Documents Home Page Menu

Concatenation of the Document Name and ID

Document name and ID are concatenated to better identify documents in the new Documents List page. The Name column shows the concatenated document name and ID. While document IDs are linkified, document names are plain text.

Existing List View: Document Name and Document ID in separate columns
Redesigned List View: Document Name and Document ID (link) shown under the "Name" column

Action Buttons Replaced by Action Icons

The action buttons for performing operations such as monitoring, moving, and copying documents are replaced by action icons in the enhanced Documents List page.

The bell icon represents the monitoring feature and the more (…) icon lists additional actions such as New Folder, Rename, Move/Copy, Download, and Monitoring Users.

Action Icons

Documents List Page Shows Both Folders and Files

Unlike the old Documents List page that shows only documents when you select a folder, the new Documents List page lists both folders and files (documents) when you select a folder from the left navigation pane.

Old Documents List page showing just a list of documents
The new Documents List page showing both document folders and documents

Monitor and Unmonitor Document Folders and Documents

To monitor a document folder that you want, select the document folder from the left navigation pane and click the monitor icon (the grey bell icon ) from the list view.

The bell icon’s color toggles between blue and grey when a folder is monitored and unmonitored respectively. To unmonitor this document folder, click the monitor icon (the blue bell icon ).

Unmonitored document folder with grey bell icon
Monitored document folder with blue bell icon

In general, to monitor or unmonitor a document folder or document, select the required folder or the document from the list and click the monitor bell icon.

In-context monitor icons for the individual document folders and documents

Add a New Subfolder to a Document Folder

To add a new subfolder to a document folder:

  1. Select a document folder from the All Files left navigation menu or from the list view.
  2. Click the more icon ( ).
  3. Select the New Folder option.
    "New Folder" option
  4. Type a folder name and click Save.
    New subfolder name

    The new subfolder gets created and added to the list successfully.

    Create new document folder

Rename Document Folders and Documents

To rename a document folder or a document:

  1. Select the folder or document.
  2. Click the more icon ( ).
  3. Select Rename.
    The Rename menu
  4. Type a new name and click Save or press Enter.
    Renaming a document folder
    Renaming a document

Move or Copy Documents and Document Folders

While you can can move or copy documents to folders both within and across projects, you cannot move document folders from one project to another.

Move or Copy a Single Document

To move or copy a single document:

  1. Click the more icon ( ) of the document that you want to move.
  2. Select Move/Copy from the menu.
    \Move/Copy\ the selected document

    The Move/Copy dialog box appears. By default, the Move/Copy dialog box has the current project and Root Folder selected.

  3. Select the project where you want the document copied or moved to from the drop-down list.
    Select the target project
  4. Select the folder where you want the document copied or moved to. You can also create new document folders if you want. Click New Folder and create a new document folder.
    Select the document folder
  5. Click Move or Copy to move and copy the selected document respectively.

Move or Copy Multiple Documents

To Move/Copy multiple documents at once:

  1. Select the list of documents you want to move or copy from the list view.
  2. Select Move/Copy from the top-level menu. The Move/Copy dialog box appears.
  3. Repeat steps 3, 4 and 5 to move or copy the selected documents.

Move a Single Document Folder

To move a single document folder to another document folder in the same project:

  1. Select the document folder from the Documents List page.
  2. Select Move/Copy from the more icon ( ) of the document folder. The Move dialog box appears. By default, the Root Folder is selected.
  3. Select a folder from the tree view where you want to move the selected document.
    Select the destination document folder
  4. Click Move.

Move Multiple Document Folders

To move multiple document folders to another document folder in same project:

  1. Select the document folders from the list view and select Move/Copy from the more icon ( ) at the top of the Documents List page.
  2. Repeat steps 3 and 4 to have the selected folders moved.

Download Documents and Document Folders

To download the top-level document folder, any subfolders, and documents on the Documents List page, click the more icon ( ) of the document folder or document and select Download from the menu.

"Download" a top-level folder

The document folders are downloaded as TAR files. Spaces, if any, in the document folder name, are encoded with an underscore. For example, a document folder named teamforge release 19.3, when downloaded, becomes “teamforge_release_19.3”.

When a document is downloaded, only the active version of the document is downloaded. The downloaded file name is in the format “<document_id>-<active document version>”. For instance, for a document with the id “doc1796” and with two versions “Version 1” and “Version 2”, of which “Version 1” is the active version, then the name of the downloaded document reads “doc1796-Version1”.

You can download multiple documents and folders or both. In this case, the downloaded TAR file name reads as TeamForge["\"] where `UUID` is the unique id.

To download multiple documents, multiple document folders, or a combination of both document folders and documents:

  1. Select the required documents and/or document folders.

  2. Click the more icon at the top of the Documents List page.

  3. Click Download.

You can restrict downloads by both the file size and number. For more information, see the documentation for these site-options.conf tokens:

You can also track your downloads with the download progress indicator.

Download progress indicator

Users Monitoring Document Folders and Documents

You can view the list of users monitoring a document folder or a document from the redesigned documents list page. While viewing the monitoring users, you can more users to the monitoring users list as well.

To view the list of users monitoring a document:

  1. Go to Project Home > Documents page.

  2. Click the The New Documents toggle button to go to the redesigned Documents List page.

  3. Click the more icon ( ) against the required document folder or document.

  4. Select the Monitoring users option.

    "Monitoring users" option
    List of users monitoring the selected document or document folder
  5. Click Add User to add more users to the list.

  6. Click the close button on the Monitoring users dialog.

The users now monitor the document or document folder.

If you’re a site administrator or a document administrator, you can delete a user from the monitoring users list.

Click the delete icon against the user name that you want to delete from the list of monitoring users.

Delete option

Now the user no longer monitors the document or document folder.

Set Documents as Favorites

You can set a document as your favorite document using the favorite option ( ) on the redesigned documents list page. The documents set as favorite are added to the list of favorite documents so that you can quickly revisit them.

To set a document as a favorite document:

  1. Go to Project Home > Documents page.

  2. Click the The New Documents toggle button to go to the redesigned documents list page.

  3. Set documents as favourite documents.

    • To set a single document as your favorite document, click the star icon ( ) against a document on the documents list page.

      Set the document as favorite
    • To set multiple documents as your favorite documents, select the required documents on the list page, and click the star icon ( ) next to the bell icon on top of the documents list page.

      Set the selected documents as favorites

    After the documents are set as favourite documents, a star icon is shown next to the documents’ name/id. Also, the grey star icon changes to blue star icon.

    Selected documents are set as favorites

    To see the list of your favorite documents, select the Favorites left navigation menu on the documents home page.

    List of favorite documents

Lazy-loading of Document Folders and Documents

Unlike the old Documents List page, the new page supports lazy-loading of documents and document folder as you scroll down the page.

This optimizes the performance by not loading a large number of documents and document folders right away while keeping you waiting to do things.

Known Issue: As long as the contents of a document folder with a large number of documents/sub folders are being loaded, you cannot perform any other action on the new Documents List page.

Configure Default Document Columns

The Column Configuration feature for Documents has been enhanced in the redesigned documents list page.

To configure the document columns:

  1. Go to Project Home > Documents page.

  2. Click the The New Documents toggle button to go to the redesigned Documents List page.

  3. Click the Column Configuration icon ( ) on this page.

  4. Select the Column Configuration option.

    Column Configuration option
  5. Select the required user-defined (flex) field from the All fields list.

    Column Configuration Dialog
  6. Click the > button to move the selected field to Selected fields list.

  7. Repeat the steps 5 and 6 to add more fields to the list of selected fields.

    You can change the order of the fields added to the Selected fields list. To reorder the fields, click and drag the required field and drop it up or down any other field in the list.

    For instance, if you want to place the second item “MultiSelect1” field as the third item in the list, just click, drag, and drop it after the “Text1” field, which is the third item currently.

    Reordering fields in "Selected fields" list
  8. Click Apply & Save to save the settings before it is applied on the documents list page.

  9. Enter a name for the configuration.

  10. Select the Make it Default checkbox to set this as the default configuration.

  11. Click Save.

    The saved configuration is listed under the Column Configuration and is applied successfully on the documents list page.

    Saved column configuration

Save an Applied Column Configuration

You can saved a defined configuration of document columns after applying it.

To apply and then save a column configuration:

  1. Click the Column Configuration icon ( ) on the documents list page.

  2. Select the Column Configuration option.

    Column Configuration option
  3. Select the required user-defined (flex) field from the All fields list.

    Column Configuration Dialog
  4. Click the > button to move the selected field to Selected fields list.

  5. Repeat the steps 5 and 6 to add more fields to the list of selected fields.

    You can change the order of the fields added to the Selected fields list. To reorder the fields, click and drag the required field and drop it up or down any other field in the list.

    For instance, if you want to place the second item “MultiSelect1” field as the third item in the list, just click, drag, and drop it after the “Text1” field, which is the third item currently.

    Reordering fields in "Selected fields" list
  6. Click Apply.

  7. After the configuration is applied, repeat steps 1 and 2 to open the Column Configuration dialog.

  8. Click Apply & Save.

  9. Enter a name for the configuration.

  10. Select the Make it Default checkbox to set this as the default configuration.

  11. Click Save.

The saved configuration is shown on the documents list page.

Delete a Column Configuration

You can delete a saved column configuration, if required.

To delete a column configuration:

  1. Click the Column Configuration icon ( ) on the documents list page.

  2. Hover your mouse on the user-defined column configuration name for the delete icon to show up.

  3. Click the delete icon.

    Delete option
  4. Click Confirm to delete the configuration.

    Confirm deletion of column configuration

    The selected column configuration is deleted successfully.

Search Document Folders and Documents

You can search for document folders and documents from the Documents List page.

  • You can search for a document by its Name, Status, Last Edited By (user) and Last Edited On (date) fields defined in the column configuration.
  • You can search for a document folder by its Name, Last Edited By (user), and Last Edited On (date) fields.

To search for a document or a document folder:

  1. Select the column configuration on which you want to search.

  2. Click the search icon.

  3. Type at least two characters of the search keyword in the search text box to view the search results as you type.

    Search for Documents Folders and Documents

    Documents matching the search keyword are displayed.

    Search Results for Documents

    Document Folders matching the search keyword are displayed.

    Search Results for Document Folders

The Documents List page’s search function supports @user and #status simple search.

@user
Use the @user simple search to search for documents and document folders that are last edited by a specific user. Username predictions are shown as soon as you type @ followed by at least two characters of the username in the Search text box.
Username predictions as you type
@user search results
#status
Use the #status simple search to search for documents and document folders that are in a specific status. A list of available statuses to search for are shown as you type # in the Search text box.
A list of available statuses shown as soon as you type `#`
#status search results

Recent Documents

You can see the list of recently added, modified, and viewed documents from the Recent Files page.

Select the Recent Files left navigation menu on the documents home page to view the list of documents that are recently added, modified, and viewed.

List of recently added, modified, and viewed documents

Tag Cloud

Tags are another means of navigating/classifying your documents. While nothing has changed with the way you create or manage tags, TeamForge 20.0 unlocks the potential of tags as a means of navigation/classification and brings tags to the forefront in the form of tag clouds.

A Tag Cloud is a group of tags added to the left navigation pane of the Documents List page. You can filter documents by tags.

Tag Cloud
  • The Tag Cloud shows the most recently used tags.
  • Click a tag to list all the documents that are associated with that tag.
  • Click All Tags to view all the tags in the Documents List page.
  • A tag in the tag cloud is visually distinguishable by its size and shade.
  • The font size and shade of a tag indicates the number of documents associated with a tag.
  • A bigger font size and a darker shade means that more number of documents are associated with the tag.
  • Tags in the Tag Cloud are sorted and listed—the tags list starts with the most recently used tags followed by the least recently used ones.