Walkthrough: Hello World

This topic demonstrates the basic operations for creating a Microsoft Unified Communications Managed API (UCMA) application:

  • Create a UCMA application

  • Add instant messaging (IM) functionality

  • Add speech functionality

Prerequisites

For a list of prerequisites, see Walkthrough: Debugging a Communications Workflow Application.

Creating the Hello World Speech Application

To create a speech communications workflow application

  1. In Visual Studio, on the File menu select New and then click Project.

  2. In the New Project dialog box within the Project types pane, expand Visual C# or Visual Basic and then click Communications Workflow.

  3. Select .NET Framework 3.5.

  4. In the Templates pane, click Inbound Sequential Workflow Console Application.

  5. In the Name and Location boxes, enter a name and path for the project and then click OK.

  6. In the Select Language dialog box, select a language

  7. In the Visual Studio Toolbox, expand Unified Communications Workflow.

  8. Drag and drop a SpeechStatement activity onto the design surface in communicationsSequenceActivity1 above disconnectCallActivity1.

  9. In the Properties window, enter hello world as the value for the MainPrompt property.

  10. Create a debugging environment. For information about creating a debugging environment, see Provision and Deploy a UCMA Workflow Application.

  11. Update variables in Program.cs. For more information, see "Update Template Code" later in this topic.

To build and debug the application

Creating the Hello World IM Application

To create a IM communications workflow application

  1. In Visual Studio, on the File menu select New and then click Project.

  2. In the New Project dialog box within the Project types pane, expand Visual C# or Visual Basic and then click Communications Workflow.

  3. Select .NET Framework 3.5.

  4. In the Templates pane click Inbound Sequential Workflow Console Application.

  5. In the Name and Location boxes, enter a name and path for the project and then click OK.

  6. In the Visual Studio Toolbox, expand Unified Communications Workflow.

  7. Drag and drop an InstantMessagingStatement activity onto the design surface in communicationsSequenceActivity1 above disconnectCallActivity1.

  8. In the Properties window, enter hello world as the value for the MainPrompt property.

  9. Create a debugging environment. For information about creating a debugging environment, see Provision and Deploy a UCMA Workflow Application.

  10. Update variables in Program.cs. For more information, see "Update Template Code" later in this topic.

To build and debug the application

Update Template Code

An Initialize method is included in Program.cs, added to communications workflow projects by the new project template. The default Initialize method:

  • Initializes the WorkflowRuntime run time

  • Starts the CollaborationPlatform platform

  • Establishes an ApplicationEndpoint endpoint

Use the ApplicationProvisioner sample application to create Active Directory objects and display the settings needed to make the following changes to the default Initialize method in Program.cs. For information about using the ApplicationProvisioner sample application, see Using ApplicationProvisioner in the UCMACore3.0.chm Help file.

  • Set the value of the gruu string variable to match the Gruu value displayed in the View Server dialog box.

  • Set the value of the first empty string parameter in the GetLocalCertificate method to match the Server Fqdn value displayed in the View Server dialog box.

  • Set the value of the second empty string parameter in the GetLocalCertificate method to match the name of the local certificate issuer.

  • Set the value of the port number parameter in the ServerPlatformSettings method to match the Listening port value displayed in the View Server dialog box.

  • Set the value of the applicationUri string variable to match the Contact Uri value displayed in the Edit Contact dialog box.

  • Set the value of the ocsFqdn string variable to match the Application pool value displayed in the Application Provisioner window.

  • Set the value of the ocsTlsPort string variable to the port number on which Microsoft Lync Server 2010 listens for TLS messages.

See Also

Other Resources

Unified Communications Managed API 3.0 Workflow SDK Documentation

Unified Communications Workflow Sample Applications