ApplicationManifest class

ApplicationManifest

The ApplicationManifest class defines the application manifest for a SIP application.

An application manifest is required for all Live Communications Server 1.0 applications, and provides the SIP message processing rules needed to correctly handle only those SIP messages of interest to the application. An application uses the ApplicationManifest object to register the application with the Live Communications Server through the ServerAgent object. Most applications will use only one manifest, but multiple manifests are supported.

The application manifest is represented as an XML document available to the application, either within the source or as a separate file. The document structure of the application manifest is as follows:

<?xml version="1.0" ?>
<lc:applicationManifest
   appUri="www.my_server_name_here.com/my_application_name_here"
   xmlns:lc=http://schemas.microsoft.com/lc/2003/05>
   --application attributes here--

   <lc:splScript>
      --message filter script here--
    ]]></lc:splScript>

</lc:applicationManifest>

The application attributes must precede the message filter script. The lc:appUri attribute is a unique string containing the name of the running application, and is used to identify the application manifest to the server. An HTTP-style URI that contains the domain and the application name is required because it guarantees uniqueness. This URI must be registered upon installation with WMI using the MSFT_SIPApplicationSetting WMI class.

The message filter script must be written in the Microsoft SIP Processing Language (MSPL).

For more information on creating and implementing an application manifest, as well as a complete list of application attributes and MSPL instructions, see Application Manifests.

The ApplicationManifest class is derived from the System.Object class.

Public Methods

The ApplicationManifest class has the following public methods.

Public Properties

The ApplicationManifest class has the following public property.

Example Code

The following code sample demonstrates the dynamic creation and compilation of an application manifest.

ServerAgent mySA;
string manifest = @"<?xml version=""1.0""?><lc:applicationManifest appUri=""" + 
    appURI + @""" xmlns:lc=""http://www.my_lc_server_here.com/lc/2003/05"">" +
    "\n" + @"<lc:requestFilter methodNames=""ALL"" strictRoute=""true""/>" +
    "\n" + @"<lc:responseFilter reasonCodes=""ALL"" />" +
    "\n" + @"<lc:proxyByDefault action=""true"" />" +
    "\n" + @"<lc:splScript><![CDATA[" +
    "\n" + @"   if (sipRequest)  {  Dispatch (""OnRequest"");  return; }" +             
    "\n" + @"   if (sipResponse)  {  Dispatch (""OnResponse"");  return; }" +               
    "\n" + @" ]]></lc:splScript>" +
    "\n" + @"</lc:applicationManifest>";

ApplicationManifest myAppManifest = ApplicationManifest.CreateFromString(manifest);
bool success = true;    

try 
{
    myAppManifest.Compile();
    Console.WriteLine("The application manifest was compiled successfully.");
}
catch(CompilerErrorException e)
{
    Console.WriteLine("The application manifest could not be compiled successfully:" + e.Message);
    success = false;
}

if (success)
{
    // Create a new ServerAgent, taking the object instance (presuming it has the dispatch handlers 
    // OnRequest and OnResponse implemented on it) and the application manifest as parameters.
    mySA = new ServerAgent(this, myAppManifest);
}

Requirements

Redistributable: Requires Microsoft Office Live Communications Server 2005 with SP1.
Namespace: Microsoft.Rtc.Sip
Assembly: ServerAgent (in ServerAgent.dll)

See Also

Creating an Application Manifest, Application Manifests