BUG: "This Page Is Entered with Invalid Parameters" Error Message When You Use the Document Tracking Interface

When you try to use the Microsoft BizTalk Document Tracking interface, you may receive the following error message: When you click OK, you may receive the following error message: When you click OK in the second error message box, a blank query results window appears.

The Document Tracking interface builds a query string that uses the organization names as parameters. If an organization name contains an ampersand character (&), the query string is not valid. Therefore, any ampersand characters that appear in the organization names must be escaped.

To work around this problem, you must modify the Utils.vbs file that is located in the Program Files\Microsoft BizTalk Server\BizTalkTracking\VBScripts folder. To do this, follow these steps:

1. In a text editor such as Notepad, open the Utils.vbs file for editing.
2. Locate the DecodeData function. Add the following line of code to the end of this function, directly before the line "DecodeData = sData":

   sData = Replace(sData, "%38", "&")    ' <--- modified to correct ampersand issue
   

3. Locate the EncodeData function. Add the following line of code to the end of this function, directly before the line "EncodeData = sData":

   sData = Replace(sData, "&", "%38")    ' <--- modified to correct ampersand issue
   

4. Save the file, and then quit the text editor.

Microsoft has confirmed that this is a bug in the Microsoft products that are listed at the beginning of this article.

Steps to Reproduce the Behavior

1. Create an organization that has a name that contains an ampersand character (such as org&test).
2. Create a messaging port to file. Use org&test for the destination organization.
3. Create a channel that is bound to the port that you created in step 2. Use org&test for the source organization.
4. In a blank document specification, enable tracking.
5. Use a simple XML file (for example, <root></root>) to send a message by using either a receive function or the DirectIntegration tool that is included with the Microsoft BizTalk Server Software Development Kit (SDK). The DirectIntegration tool is located in the Microsoft BizTalk Server\SDK folder of your computer that is running BizTalk Server.
6. Open the Document Tracking interface.
7. Under Source Organizations, click only the org&test organization.
8. Click Show documents.
9. Click the document (if you use the example that appears in step 5, the document is root), and then click Query.