소개

Arsenale Lockpoint 는 Confluence plugin 으로 page 에 첨부된 파일을 버전 관리 시스템처럼 check-out, check-in 방식으로 관리할 수 있는 제품이다.

첨부 파일을 confluence 페이지에 올려놓고 공유할 경우 버전관리가 어렵고 또 동시 편집시 에러가 발생하여 다른 편집자가 작업한 것을 날려버릴 위험이 있는데 lockpoint 를 사용하면 한 명의 작업자만 첨부 파일을 수정할 수 있도록 첨부 파일 락을 걸수 있다.

confluence 와 함께 오피스 파일을 많이 사용한다면 추천하는 플러그인이다. Confluence 25 User 까지는 무료이므로 작은 규모의 회사나 팀이라면 도입에도 비용 부담이 없다.

특히 Balsamiq mock 이나 gliffy 같이 별도의 첨부 파일을 생성하는 confluence 플러그인을 사용한다면 작업자간의 충돌을 방지하기 위해 반드시 사용하는 것이 좋다.

Features

Arsenale Lockpoint directly integrates with the following Confluence plugins and features:

(tick) Atlassian Office Connector - automatically lock/unlock documents when using the "Edit in Office" link
(tick) WebDAV - turn Confluence into a real desktop-mounted, lockable repository for attachments
(tick) Balsamiq Mockups - inline lock/unlock links for your Mockups drawings
(tick) Gliffy - inline lock/unlock links for your Gliffy diagrams
(tick) Atlassian Drag-and-Drop file attachment - attach files using the standard Confluence drag-and-drop mechanism

The following screenshots demonstrate the formatting of attachments when they are locked:


All attachments in their normal states


One attachment locked by the current user, showing the pop-up tooltip


One attachment locked by another user, showing Notify Me link and the pop-up tooltip

Locking Attachments

Arsenale Lockpoint supports a simple lock and unlock workflow. After installing Lockpoint, Confluence will display Lock to Edit links next to attachments on the View Attachments page (and also in the {attachments} macro).

After clicking Lock to Edit to lock the document, a user can edit or modify the document properties and then upload a new version of the document back into to Confluence. When the user is all done, the Unlock link makes the document available again for other users.

If an attachment is locked by another user, or if an attachment is not locked at all, the user will be unable to upload a new version of that attachment or edit the file properties.

For already-locked attachments, Confluence will display a small lock icon next to the file. The current user's locks are shown with a blue lock icon, while files locked by any other user are shown with a gray lock icon. If the user mouses over a lock icon, Lockpoint will display a pop-up tooltip containing the name of the file, the name of the user who owns the lock, and the date that the file was checked out. If the file's owner has an email address, the user can click on the owner's name to send an email to the file owner.

For Microsoft Office documents, the Edit in Office link will always be available unless another user has locked the file. Editing documents with the Edit in Office link will automatically lock the document via WebDAV, allow the user to edit the document, and unlock the document when the user has finished.

Arsenale Lockpoint does not automatically force the user to download a file after a lock. After locking one or more files, the user can decide which files to download, edit the relevant ones directly (possibly using the Edit in Office link), and then re-upload the file.

For Balsamiq Mockup or Gliffy documents, the {gliffy} and {mockup} macros will display inline Lock to Edit and Unlock links, as appropriate. If the document is already locked by another user, Gliffy, Mockup and Office documents will all display an appropriate message and a lock icon.

Attachment Notifications

If the user wishes to work on an attachment that is currently locked by someone else, the user can select the Notify Me link next to the attachment (on either the View Attachments page or in the {attachments} macro). When the file is eventually unlocked by the current owner, Confluence will send an email to the user who requested the notification. If the user requests a notification and later changes his or her mind, the Cancel Notification link can be used to cancel the notification request.\n
The template used for sending notifications can be configured as described in the Email Notifications section.

Attachment Notifications

Users can request notifications of unlocks:


After requesting to be notification about the status of an attachment

Browse » Advanced » View Locked Files

Lockpoint Administrators have access to the View Locked Files page, accessible through Browse » Advanced **» View Locked Files. This page allows Lockpoint Administrators to see a list of all files that are locked across an entire space. The user can unlock one or more files in a batch operation by selecting the Force Unlock checkbox for the relevant files and then clicking Unlock Selected Files. Lockpoint Administrators are able to unlock files that have been locked by any user in the system.

Unlike the time-based automatic unlocks, the system does not send email notifications when attachments are manually unlocked from this page.

Administrators can view all locked files in a space:


Note that the View Locked Files feature is only available in Confluence 3.3 and above.

Browse » Attachments Page

This standard Confluence page continues to display a list of all attachments in a space (locked and unlocked). A new column is shown, "Locked By", which lists the user (if any) who has locked a particular file.

WebDAV Locking

WebDAV file locking is supported automatically by Arsenale Lockpoint for compatible WebDAV clients. Any time a user opens a file using a compatible client, Lockpoint will automatically lock the attachment. When the document is saved, the attachment will be unlocked again.

Administrator-configurable email notifications can be sent for WebDAV attachments that are left locked for too long.

Drag and Drop

The Atlassian drag-and-drop attachment container is fully integrated with Arsenale Lockpoint. To upload a file using drag-and-drop, the user can simply drag the file to the container, just as they do without the Lockpoint Plugin.

If the user tries to drag-and-drop a file that already exists on the page, or if the user tries to access a file that is locked by another user, the user will receive an appropriate error message. (Due to a bug in the underlying Drag and Drop plugin, this error notification may display only a generic error message when used with Internet Explorer.)

The drag-and-drop container is used in the following places:

  • Page » View Attachments
  • the {attachments} macro (when used as {attachments:upload=true})
  • the Rich Text editor "upload image" feature

Rich Text Editor File Insertion

Uploading of files is also supported using the Insert » Attachment or Insert » Picture features in the Rich Text Editor. Lockpoint will automatically deny the upload of any attachment that has not already been locked.

Due to a bug in Confluence (CONF-21709), if a user is accessing the Rich Text Editor and attempts an in-editor upload of a file already locked by someone else, the user may receive an irrelevant download prompt rather than a user-readable error message. This occurs primarily (although not exclusively) when using Internet Explorer. This is only a user interface issue and the old attachment will be properly preserved.

Gliffy and Balsamiq Mockups Integration

When a user is viewing an inline document through the {gliffy} or {mockup} macros, Lockpoint will display inline links that allow the user to lock the file, edit the document, and lock the document when the user is done.

Additionally, if the document is locked by another user, Lockpoint will display a warning message and indicate the name of the user who owns the document.

Lockpoint is fully compatible with the Gliffy and Balsamiq Mockups plugins:


A Gliffy document in its natural state


A Balsamiq Mockups document locked by the current user and waiting to be edite


A Balsamiq Mockups document locked by another user

If you have any questions about Lockpoint, please contact your Confluence administrator. Lockpoint is a product of Arsenale Systems.