Live commenting sessions can be managed using Wrench Viewer and Bluebeam. Since there are organizations that use Bluebeam application for online commenting, online commenting procedure using Bluebeam and Wrenchviewer is explained. The IDC process of commenting is done after uploading the physical file into Bluebeam cloud and opening a session for commenting by inviting the users.
Live commenting using Bluebeam
An integration gateway is created from WRENCH. After creating the gateway, the following activities can be carried out.
Creating a Live Commenting Session
A Live Commenting session can be created from Document Smart Folders, Task Smart Folders and Transmittals.
To create a session from document/task smart folder
- Open the document/task smart folder.
- Select single or multiple documents or tasks.
- In the list of operations click Live Commenting.
- In the pop-up menu click Create Session.
Figure: Opening Live Commenting Session
Create Bluebeam Session window is displayed. In the window. Session name will be generated automatically based on a common logic, that contains Login Name, Discipline/Origin Name, Server date and time. The session name can be edited by a user.
By default, all specter files are selected for creating the session and all the current stage users are selected for inviting them to the session. Apart from the current stage users, option to add external or internal (WRENCH) users is also available. External Users can be added by entering the emaild and clicking the Add button.
NOTE: The option for adding external users is available only if the setting is enabled while creating integration gateway from Administrative Settings>>Plug In Configuration.
Figure: Creating a Live Commenting Session
- Enter an Expiry Date.
The expiry date is passed to Bluebeam session properties, and based on this date the Bluebeam session expires automatically.
In the Add Users section, two option Internal and External will be available. The option can be selected by clicking the radio button next to it. By default, radio button next to Internal will be selected.
To add internal users
- Select the radio button next to the option Internal.
- Type in the required user name in the text box User Name. Matching names will be listed.
- Select the user name from the list.
- Press enter key or click Add to add the user to the invitee list.
To add external users
- Select the radio button next to the option External.
NOTE: This button will be enabled only when the option ‘Allow addition of external users’ is checked in the Plug-in Configuration of Administrative settings.
Figure: Adding External Resources
- Type in the complete email address of the person in the text box.
- Press the enter key or click ‘Add’ to add the person to the list. If a valid email address is not available in the text box when pressing enter, it will not be added.
To grant manage permission to users
- A column, Manage will be available in the User List section.
- Click the checkbox under the column Manage, corresponding to the user who is to be assigned manage rights.
To remove users
- Select the required row from the list of users.
- Click on the ‘Delete’ icon or press DEL key to remove the selected row. An alert message is displayed.
- Click OK to continue the operation and click Cancel to abort the operation.
- After entering the details click Create Session.
All the specter files are uploaded to Bluebeam cloud and selected users are invited through a default notification mail from WRENCH. For the external users, the URL to join the session will be automatically inserted in the invitation email. For internal users, this will be inserted based on the control setting ‘‘Allow sending session invitation link through default mail’ (See configuration for details).
After creating the session and sending the emails, a message “Session created successfully” is displayed.
In the Create Bluebeam Session an option to set reminder prior to expiry date is available. Here number of days can be set. A reminder is send to the session users based on the set days.
To create a session from the transmittal window
- In the document transmittal window select the documents.
- In the tool bar click Live Commenting.
Figure: Creating Live Commenting session from transmittal window
Create Bluebeam Session window is displayed.
Transmittal documents PDF (Specter) are picked up for creating the session. Transmittal ‘To’ and ‘Cc’, ‘Distribution’ users are picked up for creating the session in Bluebeam.
When a user clicks the option Create Session for the first time from Smart Folder or Transmittal for the first time, Bluebeam Gateway window is displayed.
- Enter the Email Id and Password of the user and Click LOG IN.
Following window is displayed.
- Click Allow to complete the configuration.
This is a onetime activity for a user to configure the BDN user and password, to show the configured id while creating session. This will expire in 80 days and the activity has to be done once again after 80 days by following the preceding steps.
Joining a Live Commenting Session
A user can join a Live Commenting session from Smart Folders, Task and Document details window and Transmittal window.
To join a live commenting session
- In the options menu click Live Commenting>>Join Session.
Bluebeam Sessions window is displayed. In the window list of Bluebeam sessions to which current user is invited is displayed.
Figure: Bluebeam Sessions window
- Select a session from the list and click Join Session.
Documents under that session are opened in Bluebeam for commenting.
NOTE: If there is only one open session for the user, instead of displaying an intermediate window to show the open sessions, directly Bluebeam application would be launched with the selected document ready for commenting.
Closing a Live Commenting Session
After completing the commenting, Live Commenting session is closed.
To close a live commenting session
- Click Live Commenting>>Close Session. Close Bluebeam Sessions window is displayed.
The system will raise a request to Bluebeam for closing the selected session, generating the Consolidated file and Comment Summary File.
Once the request to close session is issued successfully, several activities are performed by Bluebeam as part of session closure such as creation of a consolidated comment file and a comment summary file.
Status of the snapshot will be checked in an interval of 3 seconds.
Once the status is Complete for all files, Attach button is enabled and user is allowed to close the session.
- Select a association type from the drop-down list.
- Click the ‘Attach’ button to attach the consolidated files to the respective document. When all files are successfully completed, they are attached to the respective documents.
Figure: Attaching comment files
In case of any failure, Attach button will not be enabled and user will not be able to attach the consolidated file.
- Select the association type from a drop-down list.
- After selecting the association type, click ‘Attach’ button.
Files are attached to the main document in WRENCH under the specified attachment type.
After attaching the files, Live Commenting session is closed automatically.
NOTE: In the case of IDC (Approve by All) using blue beam session, only the final user will be able to view Close Session option. When the administrator or originator close a blue beam session, if all the current stage users have not closed the document from their stage, a pop up message indicating the same is displayed.
Re-sending invitations
In case the email notification fails, there is an option to re-send the invitation mail from smart folders.
To re-send invitation
- In the smart folder, under Live Commenting options click Live Commenting>>Re-Send Invitation.
If there is no open session for the selected document, a message “There are no active sessions for the selected documents, please try again” is displayed.
Once the invitation mail is send, “Mail Sent Successfully” message is displayed.
Viewing an active blue beam session
Active blue beam sessions can be viewed from smart folders and document details window.
In the smart folder grid a column Commenting Session Status is available.
On clicking the hyperlink Active, Bluebeam Sessions window is displayed.
Figure: Active Bluebeam session
Here details related to active sessions are displayed.
To view an active session from document details window
- In the list of options click Live Commenting Status.
- On clicking this option Bluebeam Sessions window is displayed.
Figure: Bluebeam Sessions window
In the window sessions that are currently live are displayed. Following options are available in the window.
Extend Expiry: After selecting a session on clicking this option date picker is displayed. You can select a future date and extend the expiry date of the session.
Restart Session: Click this option to restart an inactive session.
NOTE: When user tries to extend or restart the Blue Beam session, if the creator of the session is disabled in WRENCH, an alert message indicating the creator of the session is disabled in WRENCH is displayed. User can proceed after changing the session owner in blue beam and WRENCH.
Modifying details of active sessions
Session invitees with ‘MANAGE’ permission can add and remove invitees in the active commenting session.
To modify details of active commenting sessions
- Select one document from the smart folder and select the ‘Session Details’ option from the live commenting menu Or, click on the ‘Session Details’ menu without selecting any documents.
When a single document is selected and the option Session Details is clicked, its active session name and session details is displayed in the window.
When no documents are selected, list of active sessions where the current user has ‘Manage’ permission is displayed in the ‘combo box.
If all selected documents have active commenting sessions, window same as ‘Create Bluebeam Studio Session’ will be displayed. In the window, instead of the button Create Session, Save button will be available.
Figure: Bluebeam Session Details window
The list of session invitee's of the selected document will be displayed in the list on the right to the documents list. User may add or remove invitee's as required (procedure is specified in the preceding sections). Details like expiry date, remarks and the reminder period can be edited as required.
- Click ‘Save’ to store the altered session information. Email notifications will be sent to the new invitees. When session detail such as the ‘Expiry date’ is changed, email notifications will be sent to all invitee's.
NOTE: In the Commenting Session Status Column, if the displayed status is Active, on clicking the displayed status, Bluebeam Session Details window is displayed.
Live Commenting using Wrench Viewer
Live commenting sessions can be created from the following areas,
- Document Smart folder
- Task Smart Folder
- Transmittal Window
- Document Search
- Task Search
- Document Details
- Task Details
In the document smart folder and task smart folder the menu items shown in the following figure are available in Live Commenting menu.
To create a live commenting session
- Open the document or task smart folder.
- Select the documents or tasks for live commenting session and in the menu click Create Session.
Live Commenting Session Details window is displayed.
Figure: Live Commenting Session Details window
Session name will be generated automatically based on a common logic, that contains Login Name, Discipline/Origin Name, Server date and time. The session name can be edited by a user.
By default, all specter files are selected for creating the session and all the current stage users are selected for inviting them to the session. Apart from the current stage users, option to add external or internal (WRENCH) users is also available. External Users can be added by entering the Email Id and clicking the Add button.
- Enter an Expiry Date and Time for the session.
An option to set reminder prior to expiry date is available. Here number of days can be set. A reminder is send to the session users based on the set days.
- After entering the values click Create Session.
All the specter files are uploaded to Bluebeam cloud and selected users are invited through a default notification mail from WRENCH. For the external users, the URL to join the session will be automatically inserted in the invitation email. For internal users, this will be inserted based on the control setting ‘‘Allow sending session invitation link through default mail’ (See configuration for details).
After creating the session and sending the emails, a message “Session created successfully” is displayed.
Joining Live Commenting Session
A user can join a Live Commenting session from Smart Folders, Task and Document details window, Transmittal window and global menu.
To join a live commenting session
- In the options menu click Live Commenting>>Join Session.
Live Commenting window is opened.
Figure: Live Commenting window
The list of attachments to the session will be listed in the ‘Files’ table in ascending order of the file name. The first file is opened in the viewer
The list of people who have commented on the selected file will be listed in the table below the list of files. The list will be in ascending order of the names. Active users will be displayed in blue letters and inactive users will be displayed in grey colour.
If there are any comments made by the current user on the selected file already in the current session, it will be displayed in the viewer.
NOTE: If the current version of the document is different from the document for which Live Commenting has been created for, a warning message is displayed. However live commenting session can be continued.
- After entering the comments click Save to save new comments or modified comments.
NOTE: User may select one or multiple users from the list displayed below the files table to display the comments made by the selected users. In case the current user changes or remove such comments, such changes will not be saved. However, current user may copy a comment created by another user and paste it as new. Such copies will be treated as new comments created by the current user.
A live commenting session can be joined from the global menu.
To join a live commenting session from global menu
- In the global menu click Live Commenting.
Live Commenting Sessions window is displayed.
Figure: Live Commenting Sessions window
In the window different sessions are displayed. Details like Session Name, Created By, Created On and Status of the session are displayed here.
- Click Session Details to view the details about a session.
- Click Join session to join the selected active session.
- Click Cancel to close the window.
Consolidating and closing comments
Comment Consolidation is a process that can be done before or after session expiry or closure.
Different options are available in the Live Commenting window.
Importing Comments
Comments of other users can be imported and edited. It is not possible to edit comments inserted by other users directly until they are imported.
To import comments
- Select single or multiple users from the list.
- In the menu click Import Comments.
The comments will be displayed in the viewer.
- Deselect the users other than the current user.
- Edit the imported comments, change the position of the comment, or delete the comment as required.
NOTE: Editing of comments is not mandatory. Comments can be consolidated without editing.
- Click Save to save the modifications.
NOTE: The imported comments will remain as commented by the original user but can be edited by the current user (with MANAGE permission). Thus, there will not be comment duplication when importing comments, there exists only one set of comments made by the selected user, but it will be open for modification.
Consolidating Comments
Comments marked by different users in the file in the current session can be consolidated.
To consolidate comments
- In the menu click Consolidate Comments.
Consolidated Files window is displayed. Here consolidated comment file for the selected document in the session is displayed.
Figure: Consolidated File window
- Select an Association Type from a drop-down list.
The consolidated file is attached to the main document in SmartProject under the specified attachment type.
- Select a type for the consolidated file. Options available are Private, Public and Shared.
- Click Attach to consolidate the comments to a single file. The file is attached to the main document as a Consolidated comment file.
Saving to CRS
The comments can be exported to CRS.
To save to CRS
- In the menu click Save to CRS.
Import Comments window is displayed.
- Here Comments and details like Comment Type, Created On and Created By are displayed.
- Select the required comments and click Import. Comments imported successfully message is displayed.
Comments available in the current view (not for all documents) will be exported to the CRS of the current version of the document.
Closing a Session
Participants with manage permission can close the session.
To close a session
- In the menu click Close Session.
Close Session window is displayed.
Figure: Close Session window
In the window Session Name is displayed.
- Select the session for closing and click Close.
Session Closed Successfully message is displayed.
Viewing Session Details
Details of a session can be viewed and user with Manage rights can make modification to the session details.
To view session details
- In the menu click Session Details.
Live Commenting Session Details window is displayed.
Figure: Live Commenting Session Details window
Here details of the live commenting session are displayed. Since the session is inactive, status is displayed as Inactive. User with manage permission in the session can add new users, send invitation to users, and restart the session.
Creating Link
When the session participants missed the invitation or failed to join the link, a link can be created for the live commenting session and forwarded to the participant, so that the participant can join the session by opening the link.
To create link
- In the menu click Create Link.
Create Link window is displayed.
In the window Internal and External links are available.
- Copy the required link and forward it to the session participant.