From my post yesterday on the Office Communicator Automation API, I can use the API to add presence and communication features to my apps, including:
An Example: Office Communicator Integration into Outlook 2007
The integration of Office Communicator 2007 R2 into Outlook 2007 provides a great example of how the OC API can be used to build compelling presence and communication features into an app.
If you look an an email in Outlook 2007 after Office Communicator 2007 R2 has been installed, you can see two interesting new features. First, the From:, To: and Cc: lines now show the contact presence and a context menu similar to what you see in Office Communicator for everyone on the email thread.
Second, in the email Ribbon you can see that the Respond area of the Message tab now has options for responding with both IM and voice.
I can use these options to start a conversation with the sender of the mail or the entire email thread. For example, if I select the “Call all” menu item the API will use Office Communicator to start a conference call with everyone on the thread.
When each recipient accepts the concall invitation, they get a link back to the email that was used to start the conversation. This is often called the context of the conversation (why Chris is calling). For example, Adam would see the following.
When Adam, or anyone on the concall, clicks that link the email that was used to launch the call is opened so each participant can start the conversation with the same context.
The Outlook 2007 example above provides a concrete example of the features you can build using the Office Communicator Automation API, including:
The WPF Presence Controls Sample
I talk to a lot of developers who want to embed Office Communicator presence and communications into their apps. While you can build a solution from scratch using the Office Communicator Automation API, there’s a great WPF control sample to help you build these features into your apps quickly.
The WPF Presence Controls for Office Communicator 2007 sample provides WPF controls with full source code to allow you to build these features into your apps quickly. The sample provides a number of interesting controls, including:
For example, after downloading and installing the sample, I can build a simple application to show the presence of the local user and a custom contact list.
The Persona control shows a context menu similar to what you see in Office Communicator. Note the custom menu item titled “Inventory Request” at the bottom of the context menu. Custom menu items allow you to extend the control with custom communication features.
The XAML for this Window is pretty straightforward:
Title="WPF Presence Controls" Height="187" Width="300">
<ColumnDefinition Width="*" />
<RowDefinition Height="50" />
<RowDefinition Height="100" />
<presence:MyPersona x:Name="myPersona" Grid.Column="0" Grid.Row="0"/>
<presence:PersonaList x:Name="personaList1" Grid.Column="0" Grid.Row="1"
The MyPersona control uses the API to get the presence information for the local user. The Persona and PersonaList controls need the SIP URIs for a contact to display that same presence information. For example, the following code was used to populate the PersonaList control and create the custom context menu item:
/// Interaction logic for Window1.xaml
public partial class Window1 : Window
// Create a list of contacts specific to your application.
// Note: They don't have to be contacts in the
// local user's contact list.
List<string> sipUris = new List<String>()
// Add the list of contacts to the SipUris property
// to populate the control.
personaList1.SipUris = sipUris;
// Create a new menu item for your application specific
// communication feature.
List<MenuItem> customItems = new List<MenuItem>();
MenuItem customMenuItem1 = new MenuItem();
customMenuItem1.Header = "Inventory Request";
customMenuItem1.Name = "inventoryRequest";
personaList1.CustomMenuItemList = customItems;
void personaList1_CustomMenuItemClicked(object sender, CustomMenuItemClickedEventArgs e)
If I clicked on the “Communicator Call” menu item in the image above, the API would use Office Communicator to place the call between Rebecca and Chris.
In the image above, the sample application and Chris’s conversation window are on the left. On the right, you can see running Rebecca’s desktop including her conversation window from Chris.
Embedding application data into the conversation as context and interpreting that context in your application deserves it’s own post, so I’ll come back to that subject.
There are also sample controls for WinForms and Win32 shipping in the Microsoft Office Communicator 2007 Presence Controls.