Document Placeholders

Document Placeholders

When uploading your documents to BIMcollab Twin, you can choose to use a Placeholder for a document instead of immediately uploading at that point in time. These contain all the relevant information about the document, but allow you to perform the actual upload of the file at a later stage.
To learn more about how to upload documents in the document module you can refer to this article: Upload documents

Create a placeholder

Placeholders can be create in one of two ways: either by adding individual placeholders manually, or using an Upload List to generate multiple placeholders.

Manually add placeholder

To add a document placeholder, first navigate to the project phase you want to add it to.
  1. From the Documents module, click on the "Add to project phase" button in the top right corner.
  2. Select the "Placeholder" button. You do not need to add a file at this stage.


  3. Your personal queue will then be updated to include the placeholder you just created.
    Select the placeholder(s) you would like to add information to and then click on the "Add information to uploaded files" button.


  4. Fill in the metadata information just like you would for a normal document upload. All required fields will be marked with an asterisk "*".

    You can also choose to add a notification to send to a team member.


  5. Click on the "Save" button at the bottom of the page once you are done.
  6. You will then receive a summary of all the document placeholders that have been created. Click "continue" to return to the main documents page.


  7. The placeholder is added with a "" icon next to the document name. Any information regarding the Document Date, Version Date, Version number, Version description or Status will remain unfilled until a document is actually uploaded.


Add multiple placeholders from upload list

To add placeholders without adding the metadata for each file at upload, you can make use of an Upload list which will bulk add placeholders based on the document information that is specified in the Excel file. 

To create an Upload list, you first need to download the Excel template file which is available here. Then, fill this in with all the document information for the placeholders you wish to create. 
To learn more about how to use the Upload list Excel template, you can consult this article: Upload list
When creating the upload list, the metadata fields related to the latest version should be left blank for placeholders, since this information cannot be predicted in advance. All of the light blue columns in the Excel list, including the File Data, Document Date and all Version Details fields should be left blank. These will be added when the actual models are uploaded.


  1. Navigate to the required level of your project (location, project or phase) and from the Documents module, click on the "Add" button in the top right corner.
  2. Drag and drop or choose the upload list file you have created to upload to the Add Documents field.

  3. Click on the "Upload" button
  4. Review any potential notifications or information of the new placeholders that have been uploaded.


  5. On the same page, click on the "Go to the personal queue" button.
  6. Click on "Add information to uploaded files" to review all the metadata that was imported from the upload list. 



  7. Click "Save" after adding or adjusting the information for the documents in your queue.
  8. Click on "Continue" in the next page.
     
  9. Now you can get back to the document overview where you can find the newly added document placeholders.


Personal Queue
You can view your pending document placeholders at any time by selecting the 'Personal Queue' button within the document module. This section will display any placeholders requiring additional information before they can be uploaded and added to the document list.


When viewing your Personal queue, you can remove any placeholder by checking them and selecting the  button.


It is possible to bulk edit placeholders by multi-selecting them in your personal queue, then when you choose to "Add information to uploaded files", each placeholder's information can be filled in on the same page.





Upload Document to Placeholder

Once you are ready to share your documents to BIMcollab Twin, you can upload them to the placeholders you have already made. Just like creating the placeholders themselves, you can also add documents to them either manually or by using an upload list.

Manually add document to placeholder

  1. Click on the document number of the placeholder you would like to upload a document to. 
  2. Go to the versions (1) tab and click on the "Add version" (2) button.


  3. The document number field will be automatically filled in since you have specified this before.
    Complete the required information marked with an asterisk "*":
    1. Upload the file (1)
    2. Specify a version number (2)
    3. Add version date (3)
    4. Specify a status (4)

  4. Once all the required information is complete, click on the "Upload" (5) button.
  5. The "documents created" page will appear which summarises all the documents that have been created. This includes their version numbers as well as if they are associated with any workflows.
    Click "Continue" to return to the documents page.


  6. A document version has now been added, and the placeholder is now considered as a regular document in your document list.

Add multiple documents to placeholders from upload list

If you wish to bulk upload documents using an Upload List, you can also use this to add documents to more than one placeholder at a time.
  1. First, edit your Upload List excel spreadsheet and add the missing information for the blue cells: File Name, Document Date and Version Details

For file name, this should exactly match the file name of the document and include the file type extension (Eg .pdf).
      2. Save the Excel file.
      3. In Twin, navigate to the location, project, or phase where your placeholders are located and click on the "Add to" button.
      

      4. Drag and drop, or choose the file(s) together with the upload list to be uploaded.
      

      5. Click the "Upload" button. 
      6. Review the information and notifications if any. Click on the "Go to personal queue" button.
      

      7. Check the documents you would like to add information to and then select the "Add information to uploaded files" button.
      

      8. Confirm the additional metadata information added to the Upload List for File Name, Document Date and Version Details. All required fields will be marked with an asterisk "*".
      
      9. You can also choose to add a notification to send to a team member.
      

      10. Click on the "Save" button at the bottom of the page once you are done.
      11. The "documents created" page will appear which summarises all the documents that have been created. This includes their version numbers (as specified in the Upload List) as well as if they are associated with any workflows.
             Click "Continue" to return to the documents page.
            
      12. The placeholders are now considered as a regular documents in your document list.
      
      

    • Related Articles

    • Document sets

      The document sets section (1) lists all document sets. Sets can be used to bundle documents. For example, all documents for a particular permit application. Per document the choice can be made whether a specific version is added to the set, or always ...

    • Document number

      Within BIMcollab Twin, the document number is incredibly important. This is because the entire version management depends on corresponding document numbers. When uploading documents, it is checked whether the document number is already known within ...

    • Document events in Twin

      Clicking on a document number in the document overview list displays the document's details. These details are organized into several tabs, including: Document, Versions, Attachments, Links, Document Sets, To Do's, Workflows, and Events. The Events ...

    • Customizing columns in a document list and using filters

      The document overview displays information organized into columns. The order and visibility of these columns are customizable, so you can define how the information is shown. You can also use filters to customize what information is shown in the ...

    • Upload list

      Uploading documents When uploading documents, BIMcollab Twin asks for document details, which can be filled in automatically using a special upload list, especially when a lot of documents need to be uploaded. This list links the file name to the ...