Keynote Manager can operate in two modes:
.txt
keynote file that is shared between Revit users on a local network. This means that the same keynote file is being used and modified by multiple users..txt
keynote file that is hosted on BIM360 and is made available locally by the Autodesk Desktop Connector.In either of these modes, Keynote Manager needs to ensure multiple users do not overwrite each others’ work. To achieve that:
Local Network: Keynote Manager creates a .lock
file alongside the keynote text file to notify other Keynote Manager users that the keynote file is being written.
<aside>
<img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/33feab1e-63a3-4f80-a9b7-9d7d1a7551e8/alert.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/33feab1e-63a3-4f80-a9b7-9d7d1a7551e8/alert.png" width="40px" /> Deleting an orphaned .lock
file when there are no users active, should solve the stuck Keynote Manager problem
</aside>
BIM360: Keynote Manager uses the Autodesk Desktop Connector API to ask BIM360 to lock the keynote file when a user opens Keynote Manager.
This effectively stops others from writing their changes until the first user has closed Keynote Manager and released the file.
<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/33feab1e-63a3-4f80-a9b7-9d7d1a7551e8/alert.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/33feab1e-63a3-4f80-a9b7-9d7d1a7551e8/alert.png" width="40px" /> You can unlock the keynote file from BIM360 portal
</aside>
When a user edits a keynote, Keynote Manager will write some info inside the keynote file (hidden to Revit) that a user has borrowed that specific keynote for editing. If you have a sticky lock on a specific keynote, manually clear the content of Locks Table
in the keynote file. These locks are written in between the two lines below
# --------------------- @table(locks_table:"Locks Table")
>>> locks are listed here...
# ===================== @db(keynotesdb:"pyRevit Keynotes Manager DB")
For example a lock with id tf5n6dURvk+JrZQ5r3gD5g==
exists in this keynote file example:
# @datastore("txt") @source("C:\\Users\\ehsan\\Desktop\\Keynotes.txt") ...
# ===================== @db(txn_db:"Internal DB")
# --------------------- @table(locks_table:"Locks Table")
# tf5n6dURvk+JrZQ5r3gD5g== leo-wx-rir eirannejad w8/8rO/UOUyP0vs1oS53zA== ...
# ===================== @db(keynotesdb:"pyRevit Keynotes Manager DB")
C1 CATEGORY ONE
C2 OTHER CATEGORY
# --------------------- @table(keynotes:"Keynotes Table")
So to clear the locks, remove the lock lines. Coordinate this with your team so you are the only person changing the file