.
PhonSoft Technical Library
Subject:Installing Buttons for Desktop Playback of Voice Messages
Category:Installation, PhoneServer, Unified MailCall

Buttons for Desktop Playback of Voice Messages

PhoneSoft Unified Messaging can be configured to provide your users with a simple set of buttons within Notes to listen to voice messages from the desktop. Below are instructions for inserting these buttons into the Notes "Memo" form and the Notes "Inbox" view.

Note that these buttons are not required to use the PhoneSoft product. Since voice objects are simply WAV files, just double clicking on any WAV file (voice message) from within Notes can launch a player and play a voice message. However, the "Play Multimedia" button makes this process simpler for the user, and the "Play by Phone button adds the capability for users without multimedia PCs (and those users wishing more privacy) to listen to voice messages from their desktop as well.

You can follow the steps below to add these buttons to a user's mail file. If you wish to enable these buttons for all your users, the process below should be done instead to the user's mailbox template. Then the design of your user's mail files can be refreshed from your template to incorporate these enchacements. Making the changes using your mailbox file template is faster than making the changes to each of your user's mail files individually.


ADDING BUTTONS TO THE MEMO FORM

The following steps will add the "Play Multimedia" and "Play By Phone" buttons to the Memo Form. These steps can also be used to add these buttons to any Lotus Notes form.

1) Open Lotus Domino Designer. You can do this by any of the following:
- Click on Start/Programs/Lotus Application/Lotus Domino Designer.
- Click on the Domino Designer icon on the left side of the Lotus Notes window.
- Select a database, go to File/View/Design
- Right-click on a database and click on "Open In Designer"

2) Open PSMail.nsf. This is the example mail file which was installed with the PhoneSoft Unified Messaging product. Go to File/Database/Open. If you have moved this file to the Notes Data Directory, for the filename, you can just type in "PSMail.nsf". Otherwise, type in the path in the filename box.

3) Open the mail database that needs the buttons. This is done just like you opened the PSMail.nsf database. Go to File/Database/Open and type in the database name or path in the filename box.

4) Open the Memo Form for PSMail.nsf. In the left pane of the Domino Designer screen, you will see "Recent Databases". Look for the "PS Sample Mail Database R5". Under the title should be the filename path and a list of the design elements; Outlines, Framesets, Pages, Forms, etc (If you don't see this list, click on the title of the database to hide or unhide the list). Click on the "Forms" design element. In the right pane is a list of the forms in this database. There should be a form called "Memo". Double-click on the "Memo" Form to open it.

5) Make sure that the "Action Pane" is visible. Go to View/Action pane. Make sure it is checked. You'll see the action pane to the far right in the Domino Designer window.

6) Copy the Play Multimedia Action from the PSMail.nsf database. Click on the "Play Multimedia" action once. Then go to Edit/Copy.

7) Open the Memo Form in your mail database. This is done the same way that you opened the Memo Form in the PSMail.nsf database earlier. Find your database in the Recent Databases. Make sure it is the correct database by checking the path under the title of the database. Click on the "Forms" design element. In the right pane, double-click on the "Memo" Form to open it.


8) Open the Action Pane in your database. The "Action Pane" should be visible in your database if you have already checked it in View/Action Pane earlier.

9) Paste the "Play Multimedia" action from PSMail.nsf into your mail database. Select the top action in the action pane. Then go to Edit/Paste. The "Play Multimedia" action will be pasted below the top Action and the button will end up to the right of that top action button when viewing this form from the Notes Client. To move the Play Multimedia to the first position, select the "Play Multimedia" action and go to Edit/Properties. From the first tab, in the "Position" box, either select using the arrows or type in the number "1".

10) Copy the "Play By Phone" action from the PSMail.nsf database. Go back to the PSMail.nsf database in the Recent Databases pane on the left side of the Designer window. Find the PSMail.nsf database and click on the "Forms" design element. In the right pane, double-click the "Memo" Form. From the Action pane on the right, select the "Play By Phone" Action by clicking on it once. Go to Edit/Copy.

11) Open the Memo Form in your mail database. Find your database in the Recent Databases. Make sure it is the correct database by checking the path under the title of the database. Click on the "Forms" Design Element. In the right pane, double-click on the "Memo" Form to open it.

12) Paste the "Play By Phone" action from PSMail.nsf into your mail database. Click on the newly added "Play Multimedia" action. Then go to Edit/Paste. This should add the "Play By Phone" action just after the "Play Multimedia" action. If you want to change the order of your action buttons, select an action, go to Edit/Properties and adjust the positions.

13) Save and close your form.



ADDING BUTTONS TO THE $INBOX FOLDER

The following steps will add the "Play Multimedia" and "Play By Phone" buttons to the Inbox. These steps can also be used to add these buttons to any Lotus Notes folder or view. These steps are identical to the steps for adding the buttons to the Memo Form except that the buttons are being added to the "$Inbox Folder" instead of the "Memo Form".

1) Open Lotus Domino Designer. You can do this by any of the following:
- Click on Start/Programs/Lotus Application/Lotus Domino Designer.
- Click on the Domino Designer icon on the left side of the Lotus Notes window.
- Select a database, go to File/View/Design
- Right-click on a database and click on "Open In Designer"

2) Open PSMail.nsf. Go to File/Database/Open. If you have moved this file to the Notes Data Directory, for the filename, you can just type in "PSMail.nsf". Otherwise, type in the path in the filename box.

3) Open the database that needs the buttons. This is done just like you opened the PSMail.nsf database. Go to File/Database/Open and type in the database name or path in the filename box.

4) Open the $Inbox Folder for PSMail.nsf. In the left pane of the Domino Designer screen, you will see "Recent Databases". Look for the "PS Sample Mail Database R5". Under the title should be the filename path and a list of the design elements; Outlines, Framesets, Pages, Forms, etc (If you don't see this list, click on the title of the database to hide or unhide the list). Click on the "Folders" design element. In the right pane is a list of the folders in this database. There should be a folder called "$Inbox". Double-click on the "$Inbox" Folder to open it.

5) Make sure that the "Action Pane" is visible. Go to View/Action pane. Make sure it is checked. You'll see the action pane to the far right in the Domino Designer window.

6) Copy the Play Multimedia Action from the PSMail.nsf database. Click on the "Play Multimedia" action once. Then go to Edit/Copy.

7) Open the $Inbox Folder in your database. This is done the same way that you opened the $Inbox Folder in the PSMail.nsf database earlier. Find your database in the Recent Databases. Make sure it is the correct database by checking the path under the title of the database. Click on the "Folders" design element. In the right pane, double-click on the "$Inbox" Folder to open it.

8) Open the Action Pane in your database. The "Action Pane" should be visible in your database if you've already checked it in View/Action Pane earlier.

9) Paste the "Play Multimedia" action from PSMail.nsf into your mail database. Select the top action in the action pane. Then go to Edit/Paste. The "Play Multimedia" action will be pasted below the top Action and the button will end up to the right of that top action button when viewing this folder from the Notes Client. To move the Play Multimedia to the first position, select the "Play Multimedia" action and go to Edit/Properties. From the first tab, in the "Position" box, either select using the arrows or type in the number "1".

10) Copy the "Play By Phone" action from the PSMail.nsf database. Go back to the PSMail.nsf database in the Recent Databases pane on the left side of the Domino Designer window. Find the PSMail.nsf database and click on the "Folders" design element. In the right pane, double-click the "$Inbox" Folder. From the Action pane on the right, select the "Play By Phone" Action by clicking on it once. Go to Edit/Copy.

11) Open the $Inbox Folder in your database. Find your database in the Recent Databases. Make sure it is the correct database by checking the path under the title of the database. Click on the "Folders" Design Element. In the right pane, double-click on the "$Inbox" Folder to open it.

12) Paste the "Play By Phone" action from PSMail.nsf into your mail database. Click on the newly added "Play Multimedia" action. Then go to Edit/Paste. This should add the "Play By Phone" action just after the "Play Multimedia" action. If you want to change the order of your action buttons, select an action, go to Edit/Properties and adjust the positions.

13) Save and close your Folder.



ADDING AGENTS

The following steps will add the "PS Multimedia Playback" and "PS Telephone Playback" agents to your database. These are Notes macros that will run when the "Play Multimedia" or "Play By Phone" buttons are pressed.

1) Open Lotus Domino Designer. You can do this by any of the following:
- Click on Start/Programs/Lotus Application/Lotus Domino Designer.
- Click on the Domino Designer icon on the left side of the Lotus Notes window.
- Select a database, go to File/View/Design
- Right-click on a database and click on "Open In Designer"

2) Open PSMail.nsf. Go to File/Database/Open. If you have moved this file to the Notes Data Directory, for the filename, you can just type in "PSMail.nsf". Otherwise, type in the path in the filename box.

3) Open the mail database that needs the agents. This is done just like you opened the PSMail.nsf database. Go to File/Database/Open and type in the database name or path in the filename box.

4) Copy the agents from PSMail.nsf database. In the left pane of the Domino Designer screen, you will see "Recent Databases". Look for the "PS Sample Mail Database R5". Under the title should be the filename path and a list of the design elements; Outlines, Framesets, Pages, Forms, etc (If you don't see this list, click on the title of the database to hide or unhide the list). Click on the "Agents" design element. In the right pane is a list of the Agents in this database. Click on the "PS Multimedia Playback" agent to select it. Hold the [Ctrl] Key down and while holding it, click on the "PS Telephone Playback" agent to select that one as well. Go to Edit/Copy.

5) Paste the agents into your mail database. Find your database in the Recent Databases. Make sure it is the correct database by checking the path under the title of the database. Click on the "Agents" Design Element. Click somewhere in the Right Pane to make sure you are pasting into the correct place. Go to Edit/Paste. You should be able to see the newly pasted "PS Multimedia Playback" and "PS Telephone Playback" agents in your list of agents.
.