Topic Last Modified: 2013-02-20
You can add custom commands to Lync 2013 menus and pass the SIP Uniform Resource Identifier (URI) of the current user and selected contacts to the application that the custom command starts.
The custom commands that you add can appear on one or more of the following menus:
-
The Tools menu, on the menu bar in the Lync main window
-
The shortcut menu for contacts in the Contacts list
-
The More Options menu, in the Conversation window
-
The shortcut menu for people listed in the Conversation window participant list
-
The options menu in a contact card
You can define custom commands for two types of applications—applications that do either of the following:
-
Apply only to the current user and are started on the local computer.
-
Involve additional users, such as an online collaboration program, and must be started on each user's computer.
The custom command can be invoked in the following ways:
-
Select one or more users, and then choose the custom command.
-
Start a two-party or multiparty conversation, and then choose the custom command.
To add a custom command
Use the registry settings in the following table to add a command to the menus. These entries are placed in the registry at the following location:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\15.0\Lync\CustomCommands
Custom Command Registry Entries
| Name | Type | Data | ||
|---|---|---|---|---|
|
Name |
REG_SZ |
Name of the application as it appears on the menu. |
||
|
ApplicationType |
DWORD |
0 = Executable (default)
1 = Protocol |
||
|
ApplicationInstallPath |
REG_SZ |
Full path of the executable.
|
||
|
Path |
REG_SZ |
Full path to be started along with any parameters, including the default parameters %user-id% and %contact-id%. |
||
|
SessionType |
DWORD |
0 = Local session. The application is started on the local computer. 1 = Two-party session (default). Lync 2013 starts the application locally and then sends a desktop notification to the other user. The other user clicks the notification to start the application on their computer. 2 = Multiparty session. Lync 2013 starts the application locally and then sends desktop notifications to the other users. The other user clicks the notification to start the specified application on their computer. |
||
|
ExtensibleMenu |
REG_SZ |
A list of the menus where this command will appear, separated by semicolons. Possible values are: MainWindowActions MainWindowRightClick ConversationWindowActions ConversationWindowRightClick ContactCardMenu If ExtensibleMenu is not defined, the default values of MainWindowRightClick and ConversationWindowActions are used. |
Note:For example, the following Registry Editor (.REG) file shows the results of adding a Contoso Sales Contact Manager menu item to Actions menu in the Conversation window:
 Copy Code |
|
|---|---|
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\15.0\Lync\CustomCommands\{1F9F07C6-7E0B-462B-AAD7-98C6DBEA8F69}]
"Name"="Contoso Sales Contact Manager"
"HelpMessage"="The Contoso Sales Contact Manager is not installed. Contact the Help Desk for more information."
"ApplicationType"=dword:00000000
"ApplicationInstallPath"="C:\\cscm.exe"
"Path"="C:\\cscm.exe %user-id% %contact-id%"
"SessionType"=dword:00000001
"ExtensibleMenu"="ConversationWindowActions;MainWindowRightClick"
|
|
To access a custom command
To access a custom command after it is added, do one of the following, depending on the ExtensibleMenu values that you define:
-
MainWindowActions In the Lync main window, click Tools, and then click your custom command.
-
MainWindowRightClick In the Lync main window, right-click a contact, and then click your custom command.
-
ConversationWindowActions In the Conversation window, click the More Options icon, and then click your custom command.
-
ConversationWindowRightClick In the Conversation window, right-click a contact name, and then click your custom command.
-
ContactCardMenu In a person’s contact card, click the options icon, and then click your custom command.