Edit

Share via

Using IntelliSense to Create an Interceptor Configuration File

  • Article

You can use IntelliSense and schema validation in Visual Studio to help you construct interceptor configuration files that are schematically valid. The BAM management utility validates your interceptor configuration file against the base interceptor configuration schema and, if the file is not valid, does not deploy the schema. If the file passes validation against the base interceptor configuration schema, it is validated against technology-specific schemas like the Windows Workflow Foundation (WF) schema or the Windows Communication Foundation (WCF) schema during run time and if errors are encountered, no interception will occur. You can avoid these errors by using schema validation in Visual Studio when constructing your interceptor configuration file.

Note

The sample BAM interceptor configuration XSD files are installed with the SDK files. They can be found at \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\BAM\InterceptorXSDs:

  • CommonInterceptorConfiguration.xsd
    • WcfInterceptorConfiguration.xsd
    • WorkflowInterceptorConfiguration.xsd

To obtain a copy of the interceptor schemas

  1. Open Notepad or another text editor.

  2. Navigate to the Interceptor Configuration Schema topic.

  3. Paste the contents into a new document in the open text editor, and then save the file as a text file using the name CommonInterceptorConfiguration.xsd (or one of your own choosing) to your hard disk.

  4. Repeat these steps for the Windows Workflow Foundation (WF) schema and Windows Communication Foundation (WCF) schema topics using the file names WorkflowInterceptorConfiguration.xsd and WcfInterceptorConfiguration.xsd or names of your own choosing.

To use IntelliSense with your interceptor configuration file

  1. Open Visual Studio.

  2. Click File, click New, and then click File.

  3. In the New File dialog box, select XML File and then click Open.

  4. View the Properties pane by right-clicking the edit pane, and then clicking Properties.

  5. In the Properties pane, click Schemas, and then click the ellipsis (…).

  6. In the XML Schemas dialog box, click Add and then navigate to the location of the schemas and select CommonInterceptorConfiguration.xsd and WcfInterceptorConfiguration.xsd if you are working with a Windows Communication Foundation (WCF) interceptor configuration file, or WorkflowInterceptorConfiguration.xsd if you are working with a Windows Workflow Foundation (WF) interceptor configuration file.

    Note

    If you saved the files using different names, select those files instead.

  7. Visual Studio will now validate your interceptor configuration file when it is opened and supply IntelliSense help as you create and modify the file.

See Also

Windows Workflow Foundation Schema
Windows Communication Foundation Schema