How to Configure Filters for a Send Port
This topic describes how to use the BizTalk Server Administration console to configure filters for a send port. You can use filters to create simple messaging or content-based routing (CBR) applications. A filter sets conditions for message properties or fields that determine which messages are routed to the send port. A filter does not filter the messages that an orchestration routes to the send port.
You can create one or more filter expressions, which consist of a message property, an operator, and a value that is validated against the property by using the operator.
For example, you might create an expression like the following:
MSMQ.MsgID = 1
With this filter, the send port group would only subscribe to messages having an MSMQ message ID of 1.
You can create additional expressions and specify that they have an AND or OR relationship with other expressions, for example:
MSMQ.MsgID = 1 OR
SMTP.From = MyServer
In this case, the send port group would subscribe to all messages that have either an MSMQ message ID of 1 or that have been sent from the SMTP server named MyServer.
|If you create a filter for a send port in one application that uses a property schema in another application, and then import the first application into a new BizTalk group, you will not receive a warning that the schema is missing, and filtering will not function when the application is installed and started. You can correct the problem by importing the application that contains the schema before you install the application that does not contain the schema.|
|The application developer can configure filters for a send port during the development process either by using the procedure in this topic or by using BizTalk Explorer, as described in How to Add a Filter to a Send Port for Content-Based Routing Using BizTalk Explorer and How to Add a Filter to a Send Port for Passthrough Using BizTalk Explorer.|
To perform the procedure in this topic, you must be logged on with an account that is a member of the BizTalk Server Administrators group. For more detailed information on permissions, see Permissions Required for Deploying and Managing a BizTalk Application.
Click Start, click Programs, click Microsoft BizTalk Server 2006, and then click BizTalk Server Administration.
In the console tree, expand the BizTalk group and the BizTalk application for which you want to configure send port filters.
Expand Send Ports, right-click the send port, click Properties, and then click Filters.
Configure filters as described in the following table, and then click OK.
Use this To do this
Click to delete the selected filter expression.
Click to move the selected property ahead in the filter expression sequence.
Click to move the selected property down in the filter expression sequence.
In the list, click a message property to use in this filter expression.
Type or select the operator for the expression.
Type the value to validate against the property. The accepted value type varies according to the type of property. To see what type of value is accepted for a property, hover your mouse over the property. Acceptable values are as follows: Int: (Integer) This must be a whole number. String: A character string. dateTime: A date and/or time in .NET-supported format. For more information about .NET-supported time formats, see "DateTimeFormatInfo Class" in .NET Frameworks Help.
Select And or Or to indicate the relationship between this and other filter expressions.