Pinning a file prevents it from being modified. Essentially, it makes the pinned version the current version of the file and prevents any change to the file that would increase its version number. Doing a Get Latest will retrieve the pinned version of the file. To activate or deactivate, click on Pin/Unpin from the Source menu in the Main Window, or Pin/Unpin in the Action menu on the History Explorer.
Restrictions
• You cannot pin a file that is already pinned. You must unpin it before pinning it to a different version.
• You cannot pin a file that is currently checked out.
• You cannot pin a folder that has a file checked out anywhere below it.
Delete a Pinned File
You can delete a pinned file. If it is undeleted, it remains pinned at the same version number as when it was deleted.
Branch a Pinned File
Branching a pinned file will automatically unpin it at the new location. Branching a shared pinned file will unpin it at its current location since branching a shared file keeps the file in its current location.
Pin a Shared File
If a file has a primary share associated with it, the pin only applies to that link of the shared file. Other links can modify and retrieve the current version. When that shared link is unpinned, the most recent version is immediately available (e.g., the changes made to it via other shares is now available at that link).
If a file has a secondary share associated with it, the pin applies to all links of the secondary share.
Share a Pinned File
If a file is pinned and is then shared (either a primary or a secondary share), the newly shared file inherits the pin. Unpinning a file that is automatically pinned after a primary share unpins it only for that link. All other links are still pinned and must be unpinned individually (just as they were all shared individually).
Please see Share Items for more information.
Commit Pin
You can Pin the current version of a file or folder from the main window, or you can Pin a historical version from the History Explorer. Pin operations are placed in their own change set (which is independent of any other pending changes) and always happens immediately, regardless of the Auto-Commit option.