|Microsoft Office Live Communications Server 2005 with SP1|
Application attributes precede the message filter script in an application manifest, and contain specific data describing the application to Live Communications Server. They directly follow the
<lc:applicationManifest> tag, as shown in the following example:
<?xml version="1.0" ?> <lc:applicationManifest lc:appUri="http://www.adatum.com/applicationName" xmlns:lc=http://schemas.microsoft.com/lcs/2004/05> application attributes <lc:splScript><![CDATA[ message filter script ]]></lc:splScript> </lc:applicationManifest>
The xmlns attribute specifies the version of Live Communication Server on which an application is intended to run. Applications intended to run on Live Communication Server 2005 with SP1 must match the xmlns attribute value shown in the preceding example (where the alias "lc" can be replaced with whatever string value you assigned to your namespace). Applications intended to run on Live Communications Server 2003 only may use the xmlns attribute value
although any xmlns attribute value that does not match "http://schemas.microsoft.com/lcs/2004/05" causes the application to be treated as a Live Communications Server 2003 application.
The following application attribute tags can be set.
Note The string alias "lc" in the following tags should be replaced with the string value you assigned your namespace in the xmlns attribute of the
|Application attribute tag||Description|
<lc:proxyByDefault action="true|false" />
|Specifies default proxy behavior for the application. If |
A message is considered handled if one of the following happens during the execution of the application’s MSPL script:
|When present, specifies that the application does not have a managed code component, with all functionality provided by the MSPL script in the application manifest. |
Note that calling the Dispatch built-in function will generate a compiler error when an application is script-only.
Script-only applications are also installed with the Microsoft® Management Console (MMC), and not through WMI directly.
<lc:requestFilter methodNames="METHOD_NAMES|NONE|ALL" registrarGenerated="true|false" strictRoute="true|false" domainSupported="true|false" />
|Specifies which requests the server passes to the application. The value of the methodNames attribute is a comma-separated list of the following values:
OTHER indicates that custom request methods defined for the SIP application infrastructure should be filtered. Two alternate values are defined for methodNames:
NONE and ALL are mutually exclusive with each other, and with the specific method types. They must not be present in the comma-separated list of methods. This attribute tag has methodNames set to NONE by default.
If the registrarGenerated attribute is
If the strictRoute attribute is
A request is considered as strictRouted if one or more of the following hold:
Route headers can be deleted by the managed application before proxying. The default value for strictRoute is
If the domainSupported attribute is
Note If a request is filtered by the server, then any responses to that request will likewise be filtered.
<lc:responseFilter reasonCodes="RESPONSE_CLASSES|ALL|NONE" />
|Specifies which classes of response the server passes to the application. The value of the reasonCodes attribute is a comma-separated list of the following values:
Each value corresponds to a class of SIP response codes, as defined in the IETF SIP Protocol specification (RFC 3261). Two alternate values are defined for reasonCodes:
NONE and ALL are mutually exclusive with each other, and with the specific method types. They must not be present in the comma-separated list of methods. This attribute tag has reasonCodes set to NONE by default.
<lc:file path="filePath" keyColumnName=[columName] delimitedBy="comma/tab/whitespace" <column name="columnName"/> <lc:column name="ColumnName"/> </lc:file>
|The name attribute refers to the text file, which must be a valid MSPL identifier.|
The path attribute is the actual path to the file. If the path is relative, it is relative to the path containing the running RTCSRV.EXE process. Required.
The keyColumnName attribute is the name of a column that can be used to access a record directly. Optional. The values in the specified column must be unique, else an error is logged when the file is loaded, causing the application to terminate. Defaults to no column. This attribute enables direct record access by string. Without this attribute, access is by integer.
The delimitedBy attribute specifies how column data is delimited. Acceptable values are "comma", "whitespace", or "tab".Optional. Defaults to "comma". If the value is "whitespace", both the leading and trailing white space on each line, along with the white space separating each column, are stripped. If delimiter characters are to be included within the column data, they must be surrounded by quotation marks.
The static attribute specifies whether the file contents can change while the script is running. Acceptable values are "true" or "false". The default is "false". If "true", the file is loaded into memory when the script is first loaded, and until the script is reloaded, that in-memory copy is the one used. If "false", then each time the script accesses a field in the file, the last write time is compared against what was last loaded into memory. If the file has been modified since it was last loaded, it is reloaded. Any error reloading the file causes the script to be terminated.
|The column node specifies the name of each column to be read. One or more column nodes are required beneath the file tag, and each node must have a corresponding name attribute, which must be a valid MSPL identifier.|
|What did you think of this topic?|
|© 2008 Microsoft Corporation. All rights reserved.|