Friday, January 14, 2005
BizTalk Server Web Publishing Tips
Two things I often encounter when giving assistance in BizTalk project that uses the BizTalk Web Services Publishing wizard.
The first is rather simple and more related towards Visual Studio .NET nevertheless it's often not known. Often you don't find the menu item back within the Visual Studio .NET environment to start the BizTalk Web Services Publishing Wizard, this in fact is nothing else than an external tool you can simple add yourself.
1) Go within Visual Studio to the Tools - External Tools menu item.
2) Choose Add
3) Fill in following:
Title: BizTalk &Web Services Publishing Wizard
Command: C:\Program Files\Microsoft BizTalk Server 2004\BTSWebSvcWiz.exe
Arguments: Assembly="$(TargetPath)"
Initial directory: C:\Program Files\Microsoft BizTalk Server 2004
4) Click Apply
From now on you've got the Menu Option beneath the Tools menu.
A second tip is once you've deployed a BizTalk Web Service often it doesn’t work the first time you'll try it out. Unfortunately you get then always a very descriptive error stating "Internal SOAP Error..." with as good as no detail about the real exception. Also HAT doesn’t show more than this often. If you've get a look at the public newsgroups about BizTalk you'll see this error is asked a lot for.
A help for this is that you can adopt the Web.config file of the generated Web Service to provide you more error details.
1) Open the Web.config of the Web Service project that has been generated.
2) At the bottom you’ll find following section:
<appSettings>
<!-- ThrowDetailedError = one of {"False" (default), "True"} -->
<add key="ThrowDetailedError" value="False" />
</appSettings>
3) Put the value on "True"
4) Save the file
If you'll then retry you will see a more detailed description, very often related to the values that are contained within the XML Document you are sending.
The first is rather simple and more related towards Visual Studio .NET nevertheless it's often not known. Often you don't find the menu item back within the Visual Studio .NET environment to start the BizTalk Web Services Publishing Wizard, this in fact is nothing else than an external tool you can simple add yourself.
1) Go within Visual Studio to the Tools - External Tools menu item.
2) Choose Add
3) Fill in following:
Title: BizTalk &Web Services Publishing Wizard
Command: C:\Program Files\Microsoft BizTalk Server 2004\BTSWebSvcWiz.exe
Arguments: Assembly="$(TargetPath)"
Initial directory: C:\Program Files\Microsoft BizTalk Server 2004
4) Click Apply
From now on you've got the Menu Option beneath the Tools menu.
A second tip is once you've deployed a BizTalk Web Service often it doesn’t work the first time you'll try it out. Unfortunately you get then always a very descriptive error stating "Internal SOAP Error..." with as good as no detail about the real exception. Also HAT doesn’t show more than this often. If you've get a look at the public newsgroups about BizTalk you'll see this error is asked a lot for.
A help for this is that you can adopt the Web.config file of the generated Web Service to provide you more error details.
1) Open the Web.config of the Web Service project that has been generated.
2) At the bottom you’ll find following section:
<appSettings>
<!-- ThrowDetailedError = one of {"False" (default), "True"} -->
<add key="ThrowDetailedError" value="False" />
</appSettings>
3) Put the value on "True"
4) Save the file
If you'll then retry you will see a more detailed description, very often related to the values that are contained within the XML Document you are sending.
