달력

42024  이전 다음

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
북마크가 없어져서... 블로그에 남김.




Microsoft Office Communications Server 2007 R2
Adding Commands to the Communicator 2007 R2 Menus

You can add custom commands to various Communicator menus, and pass the SIP URI of the current user, and selected contacts, to the application launched by your custom command.

The custom commands that you define appear on the following menus:

  • The Tools menu.
  • The Actions menu off the Conversation window.
  • The right-click menu off the Contact List.

See the "Accessing a Custom Command" section, later in this topic.

You can define custom commands for two types of applications:

  • Applications that apply only to the current user and are launched on the local computer.
  • Applications that involve additional users, such as an online collaboration program, and must be launched on each user's computer.

When the application you want to integrate involves other users, the custom command can be invoked by:

  • Selecting one or more users, and then choosing the custom command.
  • Starting a two-party or multi-party conversation, and then choosing the custom command.

For a detailed example, see Integrating a Third-Party Collaboration Program with Communicator in the Client Technical Reference documentation.

Use the registry settings in the table below to add a command to the Office Communicator menus. These entries are placed in the registry at HKEY_LOCAL_MACHINE\Software\Microsoft\Communicator\SessionManager\Apps\[GUID of Application].

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)

Dd819982.note(en-us,office.13).gif Note:
Requires ApplicationInstallPath.

1 = Protocol

ApplicationInstallPath

REG_SZ

Full path of the executable.

Dd819982.note(en-us,office.13).gif Note:
Must be specified if ApplicationType is 0 (Executable).

Path

REG_SZ

Full path to be launched along with any parameters, including the default parameter of %user-id% and %contact-id%.

SessionType

DWORD

0 = Local session. The application is launched on the local computer.

1 = Two-party session (default). Communicator 2007 R2 launches the application locally, and then sends a desktop alert to the other user. The other user clicks the alert and starts the specified application on their computer.

2 = Multi-party session. Communicator 2007 R2 launches the application locally, and then sends desktop alerts to the other users, prompting them to launch the specified application on their own computer.

ExtensibleMenu

REG_SZ

A list of the menus where this command will appear, separated by semi-colons. Possible values are:

MainWindowActions MainWindowRightClick ConversationWindowActions ConversationWindowContextual ConversationWindowRightClick

If ExtensibleMenu is not defined, the default values of MainWindowRightClick and ConversationWindowContextual are used.

For example, executing the following Registry Editor (.REG) file results in the addition of the Contoso Sales Contact Manager menu item to the Actions menu.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\Software\Microsoft\Communicator\SessionManager\Apps\{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"="REG_DWORD:00000000"
"ApplicationInstallPath"="C:\\cltest.exe"
"Path"="C:\\cltest.exe %user-id% %contact-id%"
"SessionType"="REG_DWORD:00000001"
"ExtensibleMenu"="ConversationWindowActions;MainWindowRightClick"
To access a custom command after it is added
  • Do one of the following, depending on the ExtensibleMenu values you define:

    • MainWindowActions: On the Office Communicator Title bar, click the down arrow, point to Tools, and then click your custom command.
    • MainWindowRightClick: Right-click a contact in the Contact List or Search Results pane, and then click your custom command.
    • ConversationWindowActions: In the Conversation window Title bar, click the Menu button, point to Actions, and then click your custom command.
    • ConversationWindowContextual: In the Conversation window, click the contextual actions drop-down arrow in the top right corner, below the Title bar, and then click your custom command.
    • ConversationWindowRightClick: In the Conversation window Participant List, right-click a contact name, and then click your custom command.
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
%contact-id% parameter is not functional in R2      javerlin   |   Edit   |   Show History
Even though documented under "path" and shown in the example, the %contact-id% parameter is not functional in R2. It is not replaced by the actual contact value but is literally passed as "%contact-id%". The %user-id% parameter is functional.

This lack of functionality rendors nearly useless any menu selections when right clicking on a contact since the contact information is not passed to the application.

It would be very valuable to know if this has been intentionally removed for R2 or if it is a bug.
Posted by tornado
|