Chapter 5 Managing Repository Documents

Temporary protection for document access in the repository

When you consolidate, freeze, lock or delete a document in the repository, a temporary protection is applied to the entire document in the repository (all versions included). This pseudo lock guarantees the exclusive access over the document to the user. For example, you cannot consolidate the same document on two branches simultaneously. If you are working in a team, you cannot lock a version that another team member is currently consolidating, of you cannot freeze a version that another team member is currently locking.

This temporary protection is released once the action is over.

If PowerDesigner crashes or if you disconnect from the repository when the consolidate, freeze, lock or delete action is still running, the temporary protection remains on the document in the repository. The next time you try to obtain the exclusive access right to consolidate, freeze, lock or delete this document, a message box appears to inform you that the document is already in exclusive access. To continue, you have to bypass the protection or cancel the action.

WARNING!

Caution
Bypassing the temporary protection when you are not entitled to perform such task can severely damage your document in the repository.

If the document was protected and blocked from your workstation

PowerDesigner verifies the machine name, not the connected user.

PowerDesigner	What you should do
Two sessions running on your workstation: for example, you are consolidating a document in one session, and you want to lock a version of the same document from another PowerDesigner session	You must not bypass the temporary protection and wait for the consolidation to end
One session crashed when you were consolidating a document	You can bypass the temporary protection to continue the operation

If the document was protected and blocked from another machine on the network

You are a team member

You cannot perform an action over a document with a temporary protection.

For example, a team member works with the repository on a laptop computer, consolidates a document, disconnects before the end of consolidation, and leaves the office. In this case, the temporary protection remains on the document, this is why you cannot work on this document.

You have to ask a data administrator with the Manage All Documents right to perform any action on this document (lock for example), this will display the message box and allow the data administrator to bypass the protection and release the document.

You are a data administrator

You want to modify a document with a temporary protection, the message box indicates on which machine the document was blocked.

You have to check if the user is actually working on the document, and if such is the case, wait for him to finish. If this user no longer works in the team, you can bypass the protection of the document.
You are asked by a team member to bypass a temporary protection set on a document. You just have to perform an action on the document (lock for example) this will display the massage box and let you bypass the protection and release the document.