Configure a task for Zoom Nightshift in the Windows Task Scheduler

Configure a task for Zoom Nightshift in the Windows Task Scheduler

Zoom Nightshift reduces the time spent on clash management even further by performing repetitive tasks while you are away from your computer. It can automatically check new model versions, update Smart Issues and shared Lists to BIMcollab Nexus, so your issue overview is up to date when you start working.
It automates actions in Zoom using JSON script files in combination with the Windows Task Scheduler.

The Windows Task Scheduler is a tool that allows to create and run any task on your computer automatically. It allows you to start applications, run commands and execute scripts. The tasks can either be executed at a chosen day and time or be triggered when a specific event occurs.
The Task Scheduler is available on all Microsoft Windows systems.

With Nightshift, you can automate the following action in BIMcollab Zoom:
  1. Open models / Add to project
  2. Connect to project
  3. Filter issues
  4. Update issues
  5. Run and share all Lists
  6. Synchronize project
To run a script with Zoom Nightshift, make sure you meet these requirements:
  1. You are using Windows
  2. You are using Zoom 5.2 or more recent with an active license
  3. The space and project you want to connect to in Zoom from the script is located in the list of recent projects and your credentials are remembered
  4. You have Zoom editing rights in the project you connect to

Create a JSON script

Create a JSON script that indicates which actions should take place when Zoom Nightshift is initiated. Save the file in a location of your choosing on your computer.
Note: Don't use any spaces in the name of the script file.
You can find more information on how to create a JSON script, as well as an example script in the article Create a JSON script for Zoom Nightshift.

Configure a task in the Task Scheduler

Follow these steps to configure a task in the Task Scheduler to run Zoom Nightshift:
Note: These steps describe the workflow in Windows 10
  1. Go to the Windows Start Menu
  2. Choose Windows Administrative Tools > Task Scheduler
  3. Create a separate folder to store your tasks for Zoom Nightshift by right-clicking on the main folder in the Task Scheduler Library, and choosing 'New Folder...'
  4. Give the folder a clear and unique name
  5. Select the newly created folder
  6. Choose 'Create Basic Task...' in the Actions menu
  7. Give the task a name and description so the goal of the task is clear, and click 'Next'

  8. Indicate the trigger of the task
    Depending on which trigger you chose, you will be asked to indicate a starting time for the first execution of the task and how often the task should take place

  9. In the 'Action' tab, choose the action 'Start a program'
  10. When you click 'Next' you will be asked to browse to the program or script you want to execute
    Browse to the executable file of BIMcollab Zoom at C:\Program Files\KUBUS\BIMcollab Zoom\BIMcollab Zoom.exe
  11. In the 'Add arguments (optional)' field, add "-robotscript=" followed by the filepath of the JSON script file
    For example: "-robotscript=C:\User\Username\Desktop\Nightshift.JSON"

  12. Check all parameters of the task in the Finish dialog, and click 'Finish'
  13. The task will be run at the indicated times of the task triggers
You can always edit the parameters of the task by right-clicking on the task in the Scheduler and choosing 'Properties'.

Run the task immediately

Would you like to run the created task immediately, instead of waiting for the scheduled time to hit?
For example, you received new models in the morning, and would like to update the issues of the project during your lunchbreak to continue working in the afternoon.
To do this you can create a shortcut for the task, to start running it in an instant.
  1. Find a place on your computer where you want to create the shortcut to the task, for example on your desktop for easy access
  2. Right click in the folder, and choose New > Shortcut
  3. Under 'Type location of the item', enter:
    C:\Windows\System32\schtasks.exe /run /tn "TaskName"
  4. Replace "TaskName" with the "name of the folder\name of the task"  in the Task Scheduler
    With the example below, the location would look like : C:\Windows\System32\schtasks.exe /run /tn "Zoom Nightshift\Update Smart Issues Example Project"

  5. Click 'Next'
  6. Give the shortcut a name, and click 'Finish'
The shortcut will be placed in the location where you created it. You can double click it at any time to start running the task immediately.

Follow up on the status of the task

Once the task has run, you can check whether all actions were performed successfully in the Nightshift logfile.
All logfiles are located at C:\Users\<Username>\AppData\Roaming\KUBUS\BIMcollab Zoom\Nightshift.
Replace with the name of your own user profile in windows.
The AppData folder is a hidden folder by default. Display the hidden folders in the File Explorer to navigate to the correct location.

    • Related Articles

    • Create a JSON script for Zoom Nightshift

      Zoom Nightshift automates actions in Zoom using JSON script files in combination with the Windows Task Scheduler. With Nightshift, you can automate the following actions in BIMcollab Zoom: Open models / Add to project Connect to project Filter issues ...
    • Retrieve a Zoom license

      When a BIMcollab Zoom license is available for you, you can retrieve the license to make use of Zoom's full potential. There are three different license types (named company licenses, floating company licenses or a personal license), which can be ...
    • Purchase a Zoom license

      BIMcollab Zoom licenses can be purchased in two ways: Company licenses as part of a BIMcollab Nexus subscription. Per space one license type can be chosen. We offer two company license types: Named (Single) licenses are assigned to one specific user. ...
    • System requirements BIMcollab Zoom

      Windows Operating system Microsoft® Windows® 10 or 11 Internal memory 16GB RAM or more (8GB minimum) Mouse A mouse with scroll wheel is highly recommended Graphics A dedicated video card with support for OpenGL 3.3 graphics Apple OS X Operating ...
    • Can I use BIMcollab Zoom on a Windows touch screen device?

      Yes you can. Gestures like two finger pan, pinch to zoom and selecting are supported.