BizTalk 2006 - Windows SharePoint Services adapter : Windows SharePoint Services adapter

Is there a way to configure one send port to send a message to a document library based on a parameter?

Adrian Hamza — Thu, 08 Mar 2007 01:59:00 GMT

This question comes up quite often that it deserves its own post. Is there a way to configure one send port to send a message to a variable destination based on a parameter? For instance when using WSS adapter, can you send a message to a different document library based on the message that's being processed?

The answer is yes, it's possible to do this in two ways:

using dynamic send ports, the destination URI and the configuration of the send port can be set programatically in the orchestration for every outgoing message. This method has the advantage that no ports have to be pre-created.
using role-links and parties. For each party you need to pre-create and configure a pyshical send port. You will have pretty much a party per destination. You enlist the parties in the appropriate role. Then, in the orchestration the only thing that you need to do is set the party associated with the role-link. The physical send port of the party associated with the role-link will be used to process the outgoing message.

I included below more information on how to do this using dynamic send ports which is the more simple & frequent approach.

The URL for a WSS adapter dynamic send port will be something like this:
     'wss://ServerName/sites/MySite/MyDocumentLibrary/' if you installed the web service on an HTTP site
     'wsss://ServerName/sites/MySite/MyDocumentLibrary/' if you installed the web service on an HTTPS site (notice the additional s in wsss://).

and you can set it programatically from the orchestration (like below) every time you sent out a message
     dynamicSendPortName(Microsoft.XLANGs.BaseTypes.Address) = "wss://ServerName/sites/MySite/" + lookedupDocLibName;

The rest of the send port configuration information must be set on the outgoing message using the Config* context properties documented here
http://msdn2.microsoft.com/en-us/library/aa547920.aspx

For instance:
    outgoingMsg(WSS.Filename) = "file1.xml";
    outgoingMsg(WSS.ConfigOverwrite) = "yes";
    etc.

Video 04-WSSAdapter-PropsInOrchestration.wmv shared here includes one such dynamic send port example
http://blogs.msdn.com/ahamza/archive/2006/04/18/WssAdapterVideosWebcasts.aspx

%Filename% macro is not replaced with the disk filename

Adrian Hamza — Fri, 30 Jun 2006 20:47:00 GMT

I've seen this issue showing a couple of times on the BizTalk Newsgroups so I thought it's worth posting about this on my blog. The user expectation, which is probably correct from usability point of view, is that the %Filename% macro is replaced with the name of the original file no matter if that file was received from the disk through FILE adapter or from a document library through SharePoint adapter. This doesn't happen like that since the WSS adapter send ports will resolve the %Filename% macro to empty string if the message was originally received from any other adapter than WSS adapter. This is by design.

The %Filename% macro is replaced with the name of the SharePoint file (and not with the name of a file on disk). If the message was received through FILE adapter (or any other adapter than WSS) then the %Filename% macro is probably replaced with empty string. Macros (like %Filename%) and context properties (like WSS.Filename) are implemented by each adapter separately, they are specific to each adapter, and there is no 'framework' that would provide a unified set of macros/context properties accross all adapters. This makes sense since '%Filename%' might not make sense for a POP3 adapter or it could have a slightly different behavior for 3rd party adapters. Coincidently, some adapters have used the same macro name (I would guess %Filename% is a common one) and ocasionally the same context property. However, the %Filename% macro in a WSS adapter send port is totally different from a %Filename% macro in an FTP adapter send port, for instance.

To workaround this you can use an orchestration or a custom pipeline. All you need to do is get the disk file name from FILE.ReceivedFileName property and save it in the WSS.Filename property like below. Make sure that the Filename field in the send port UI dialog box is left empty so that the value supplied through the context property WSS.Filename is used to set the filename.
sharepointOutgoingMsg(WSS.Filename) = diskIncomingMsg(FILE.ReceivedFileName);

http://msdn.microsoft.com/library/en-us/BTS06Operations/html/1ff50fb8-7ba0-47b8-9476-d57413989346.asp?frame=true
http://msdn.microsoft.com/library/en-us/BTS06Operations/html/c5ae5339-67bf-4fde-a721-5b1aa3b9caca.asp?frame=true

You don't have to use dynamic send ports for the workaround above. In the case of WSS adapter, you can define the send port configuration through the WSS.Config*, WSS.Filename context properties of the outgoing message and then configure the WSS send port equivalent properties so that they are either empty (text boxes) or have a value of Orchestration (drop-down boxes) in order to not overwrite the configuration information specified through the context properties.

Custom Pipeline Component for Processing DBF, Excel and other ODBC types

Adrian Hamza — Fri, 23 Jun 2006 21:53:00 GMT

Matt Meleski implemented a custom pipeline component to process Excel or DBF files. I did not test this component myself but it seems that other people have tried and it worked well for them. This looks like a nice component that could complement the WSS adapter very nicely.

WSS Adapter handling of InfoPath forms with attachments

Adrian Hamza — Tue, 20 Jun 2006 23:15:00 GMT

InfoPath supports forms with file attachments by encoding the attachement as base64 and including the following PI

<?mso-infoPath-file-attachment-present ?>

at the top of the XML document to indicate that a file has been attached to the document.

WSS adapter works with InfoPath forms with attachements by making sure that it does not add/remove/update any of the PIs that are related to file attachment. If the files are attached to the form in InfoPath then the PI should be there because InfoPath adds it. If the files are attached by your orchestration or some component other than InfoPath, then the orchestration/component needs to add the PI explicitly. The adapter cannot know if a file attachment is included in the form (unless the PI is present in which case there's nothing to be done) so it will never add the PI. You can add the PI explicitly in your orchestration using a construct like this:

msg(XMLNORM.ProcessingInstructionOption) = 1;
msg(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present ?>";

So, whatever component attaches the files to the form needs to also add the PI. WSS adapter will preserve the PI if it's in the document, but it will never add such a PI to the XML document.

WSS v3 Beta 2 is out - try it with WSS adapter

Adrian Hamza — Tue, 06 Jun 2006 02:17:00 GMT

Windows SharePoint Services V3 Beta 2 is out and you can download it here. WSS v3 does not install a policy file that redirects old SharePoint assembly requests to the new assemblies. For this reason, if you try to use WSS v3 Beta 2 with BizTalk 2006 WSS adapter, you will run into errors. In order to workaround this problem and take WSS v3 Beta 2 for a test drive together with BizTalk 2006 WSS adapter, you will need to write your own policy file or just update the web.config file of the WSS adapter web service. Here's what you need to do:

Open web.config from C:\Program Files\Microsoft BizTalk Server 2006\Business Activity Services\BTSharePointAdapterWS
Paste the following section into the web.config file, configuration section and save the file
<runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.SharePoint"
                          publicKeyToken="71e9bce111e9429c" />
        <bindingRedirect oldVersion="11.0.0.0"
                         newVersion="12.0.0.0"/>
      </dependentAssembly>
    </assemblyBinding>
</runtime>

If you have other apps that were compiled against the old SharePoint assembly and you want to see if they will work with the new SharePoint assemblies, you can paste the snippet above in the configuration section of the machine.config file. That will make the changes global to entire machine.

During my tests, WSS adapter worked nicely with WSS v3 Beta 2. There were a few intermittent issues like [Microsoft.SharePoint.SPException] Unable to complete this operation. Please contact your administrator. or [Microsoft.SharePoint.SPException] The URL '/sites/BASSite/DestinationLibraryFromOrch/tmp-db04abaf-4a12-4e11-93c9-4338c17cc78c.xml' is invalid. It may refer to a nonexistent file or folder, or refer to a valid file or folder that is not in the current Web.

However, the operation was succesful on the second retry performed by the adapter and since this is a beta product some annoyances are expected. If you decide to try WSS v3 Beta 2 yourself and you find worse problems, I would like to hear about them from you.

[Content below added/changed on June 14]

BizTalk 2006 Configuration routine for Windows SharePoint Services BizTalk Adapter Web Service/SharePoint Adapter fails to configure on WSS v3 Beta 2 (SharePoint 2007 Beta 2). In order to workaround this you can install and configure WSS adapter on WSS v2 and then upgrade to WSS v3.

An alternative is to configure the adapter web service manually. I haven't tried this approach but it should work. In this case you need to create a virtual folder on the IIS site hosting SharePoint and name that virtual folder BTSharePointAdapterWS. The virtual folder should point to C:\Program Files\Microsoft BizTalk Server 2006\Business Activity Services\BTSharePointAdapterWS folder. This virtual folder must run in its own application pool and this app pool needs to be a copy of the SharePoint app pool (app pool used by _layouts virtual folder). You also need to update the web.config file like below

These are my own workarounds and they are NOT supported by Microsoft. AFAIK, Microsoft has NOT announced yet if BizTalk 2006 will support WSS v3.

WSS Adapter webcasts/videos

Adrian Hamza — Tue, 18 Apr 2006 21:28:00 GMT

BizTalk 2006 RTMd last month, and the BizTalk Betaplace has been closed for a few weeks now. Many people have asked me for access to the WSS Adapter videos that were shared on the betaplace and finally, here they are.

The videos are shared on this SharePoint site: http://wssadapter.members.winisp.net/default.aspx, in the Shared Documents document library, WSS Adapter Webcasts folder.

This posting is provided "AS IS" with no warranties, and confers no rights.
Use of included videos are subject to the terms specified at http://www.microsoft.com/info/cpyright.htm. Some of the content was developed for the BizTalk Beta builds, but it is still generally applicable to the RTM version.

Upgrading from BT'04 GotDotNet WSS Adapter 1.0 to BT'06 native WSS Adapter

Adrian Hamza — Wed, 29 Mar 2006 09:30:00 GMT

I finally found some time and tried upgrading from BizTalk 2004 and GotDotNet WSS adapter to BizTalk 2006 and the native BT'06 adapter for Windows SharePoint Services. The idea was to start from a BizTalk 2004 installation with version 1.0 of Steve Resnick & Co. WSS Adapter (http://www.gotdotnet.com/workspaces/workspace.aspx?id=0d1aa85c-cf8d-497e-84f4-3ffec8db115f) , setup a simple messaging scenario using SharePoint, upgrade to BizTalk 2006, verify that messaging still works, upgrade to the native BizTalk 2006 WSS Adapter and then verify that messaging works with the new adapter.

I followed the steps below, in order to create a sample messaging test for SharePoint:

Created Source document library, then renamed it SourceDocLib (this trick causes the document library URL and the document library name to be different and this way I can see if WSSLib adapter really expects the URL or the display name of the document library). Created a View named ‘UpgradeDocuments’ that shows only those documents with ID >= 0 (probably all docs).
Created document library named 'Destination', then renamed it to 'DestinationDocLib'. Created folder ‘Dest Folder’. Added columns SharePointColumn1, and SharePointColumn2.
Created document library named 'Archive', then renamed it to 'ArchiveDocLib'. Created ‘My Folder’ folder in the library just created.
Created receive port and receive location for WSSLib adapter. Used all the fields available in order to make sure that similar field exists in native BT'06 adapter.
Created send port for WSSLib adapter, used all the fields.
(See the exported bindings or the UI captures below to see how the ports were configured. If you want to repro my test, after importing the bindings, you will have to update the filter on the send port to process messages received from the receive location by adding BTS.ReceivePortName == WSSLib-Receive condition. Only then start the send port.)
Sent test messages (see attached).
Exported all bindings.

See images below for the receive location and send port settings:

WSSLib - Receive Location	Receive Location XML <Config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <pollingInterval>10</pollingInterval> <errorThreshold>10</errorThreshold> <site>http://demoappserver/Sites/BASSite</site> <folder>Source</folder> <view>UpgradeDocuments</view> <archiveFolder>Archive/My Folder</archiveFolder> <uri>http://demoappserver/Sites/BASSite/Source</uri> <userName /> <userPassword>******</userPassword> <userDomain /> </Config>
WSSLib - Send port (upper and lower part of configuration dialog box)
Send Port XML <Config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <uri>wss://demoappserver/Sites/BASSite/Destination/Dest Folder</uri> <site>http://demoappserver/Sites/BASSite/</site> <folder>Destination/Dest Folder</folder> <overwrite>true</overwrite> <fileName>%GUID%</fileName> <fileExtension>xml</fileExtension> <fileNamespace>po0="http://MyTestNamespace"</fileNamespace> <userName /> <userPassword>******</userPassword> <userDomain /> <propertyName1>SharePointColumn1</propertyName1> <propertySource1>=//po1:PurchaseOrder/po1:Amount</propertySource1> <propertyNamespace1>po1="http://MyTestNamespace"</propertyNamespace1> <propertyName2 /><propertySource2 /> <propertyNamespace2 /> <propertyName3>SharePointColumn2</propertyName3> <propertySource3>=//po3:PurchaseOrder/po3:ChargeTo</propertySource3> <propertyNamespace3>po3="http://MyTestNamespace"</propertyNamespace3> <propertyName4 /> <propertySource4 /> <propertyNamespace4 /> <propertyName5 /> <propertySource5 /> <view/> </Config>

Once I configured the messaging I've sent a couple of messages through (see attached) to make sure that everything is working fine.

UPGRADE

I followed these steps http://geekswithblogs.net/darko/archive/2006/01/24/66866.aspx in order to upgrade to BizTalk 2006. The upgrade went through without problems. Another place where you can find upgrade information is this blog http://blogs.msdn.com/biztalk_upgrade/default.aspx Because my BizTalk 2004 installation had the BAS feature installed, after upgrade, both BAS and Windows SharePoint Services Adapter Web Service features were installed on the machine (even though the latter does not show up as enabled in setup, it's there because BAS requires it). If your BizTalk 2004 installation didn't have BAS, after upgrading your SharePoint box, you will have to start setup, add Windows SharePoint Services Adapter Web Service feature, and configure it. That's easy and straight forward so I won't go into details.

After upgrade, I browsed to the BAS site (SharePoint site) to see if SharePoint was still working fine and it didn't. I received the following error:
This Windows SharePoint Services virtual server has not been configured for use with ASP.NET 2.0.50727.42. For more information, please refer to Knowledge Base article 894903 at http://go.microsoft.com/fwlink/?LinkId=42660.

Troubleshoot issues with Windows SharePoint Services

The KB article just tells you to run one command. I run the command below:

stsadm.exe –o upgrade –forceupgrade –url http://demoappserver/sites/BASSite

restarted IIS and after that the BAS site shown up without problems. I started the BizTalk services that I stopped during upgrade, sent a few SharePoint messages through and everything worked fine.

Updating the ports

So I proceeded to update the receive location and send port in order to change from WSSLib adapter to 'Windows SharePoint Services' adapter. First thing I did, was to stop the BizTalk Host Instances that were used by the WSSLib adapter. This is probably not necessary, but in a couple of cases I noticed that the WSSLib ports don't shutdown appropriately and I didn't want to run into issues. After that, for each of the receive location or send port I changed the 'Transport Type' property from 'WSSLib' to 'Windows SharePoint Services' and then re-configured the send port/receive location like below.

'Windows SharePoint Services' - Receive Location	Receive Location XML <ReceiveLocation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SiteUrl>http://demoappserver/Sites/BASSite/</SiteUrl> <WssLocation>Source</WssLocation> <ViewName>UpgradeDocuments</ViewName> <ArchiveLocation>Archive/My Folder</ArchiveLocation> <NamespaceAliases></NamespaceAliases> <ArchiveFileName></ArchiveFileName> <Overwrite>no</Overwrite> <ErrorThreshold>10</ErrorThreshold> <PollingInterval>10</PollingInterval> <BatchSize>20</BatchSize> <OfficeIntegration>optional</OfficeIntegration> <Timeout>100000</Timeout> <AdapterWSPort>80</AdapterWSPort> <uri>wss://demoappserver:80/Sites/BASSite/Source?ViewName=UpgradeDocuments</uri> </ReceiveLocation>
'Windows SharePoint Services' - Send port (upper and lower part of configuration dialog box)
Send Port XML <SendPort xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SiteUrl>http://demoappserver/sites/BASSite/</SiteUrl> <WssLocation>Destination/Dest Folder</WssLocation> <Overwrite>yes</Overwrite> <NamespaceAliases>po0="http://MyTestNamespace"; po1="http://MyTestNamespace"; po3="http://MyTestNamespace"</NamespaceAliases> <FileName>%MessageID%.xml</FileName> <OfficeIntegration>optional</OfficeIntegration> <TemplatesDocLib></TemplatesDocLib> <TemplatesNamespaceCol></TemplatesNamespaceCol> <CustomTemplatesDocLib></CustomTemplatesDocLib> <CustomTemplatesNamespaceCol></CustomTemplatesNamespaceCol> <PropertyName1>SharePointColumn1</PropertyName1> <PropertySource1>%XPATH=//po1:PurchaseOrder/po1:Amount%</PropertySource1> <PropertyName2></PropertyName2> <PropertySource2 /> <PropertyName3>SharePointColumn2</PropertyName3> <PropertySource3>%XPATH=//po3:PurchaseOrder/po3:ChargeTo%</PropertySource3> <PropertyName4></PropertyName4> <PropertySource4 /> <PropertyName5></PropertyName5> <PropertySource5 /> <PropertyName6></PropertyName6> <PropertySource6 /> <PropertyName7></PropertyName7> <PropertySource7 /> <PropertyName8></PropertyName8> <PropertySource8 /> <PropertyName9></PropertyName9> <PropertySource9 /> <PropertyName10></PropertyName10> <PropertySource10 /> <PropertyName11></PropertyName11> <PropertySource11 /> <PropertyName12></PropertyName12> <PropertySource12 /> <PropertyName13></PropertyName13> <PropertySource13 /> <PropertyName14></PropertyName14> <PropertySource14 /> <PropertyName15></PropertyName15> <PropertySource15 /> <PropertyName16></PropertyName16> <PropertySource16 /> <Timeout>100000</Timeout> <AdapterWSPort>80</AdapterWSPort> <uri>wss://demoappserver:80/sites/BASSite/Destination/Dest%20Folder</uri> </SendPort>

Once I updated all the send ports and receive locations, I re-started the host instances, and sent a few messages through. All the messages were processed correctly in the same manner as before and this concluded my upgrade experience. Please notice that my upgrade test was done using version 1.0 of the WSSLib adapter. On GotDotNet there is an RC for the WSSLib adapter version 2.0. A comparision of that WSSLib2 adapter and BizTalk 2006 native 'Windows SharePoint Services' adapter can be found here http://blogs.msdn.com/ahamza/archive/2005/07/27/BizTalk2006WSSAdapters.aspx The only feature supported by WSSLib2 that is not available in the native BT'06 adapter is storing the Username/Password in SSO per send port/receive location. The native BT'06 adapter uses the identity of the host instance to connect and authenticate with SharePoint. Upgrade from WSSLib2 to BT'06 native WSS Adapter should be just as straight forward.

Regardless of the adapter version from which you are upgrading, if you are using some of the adapter context properties in your orchestrations you will have to update your orchestrations to use the WSS.* context properties and that will require you to recompile and redeploy your orchestrations.

BizTalk Server 2006 has RTM'd

Adrian Hamza — Mon, 27 Mar 2006 20:22:00 GMT

BizTalk Server 2006 has RTM'd today ... best BizTalk ever, shipped on time and a very high quality server product. See the announcement here.

http://www.computerworld.com/softwaretopics/software/story/0,10801,109944,00.html

http://www.crn.com/sections/breakingnews/breakingnews.jhtml?articleId=183702861

Of course, my favorite BT'06 features are are WSS Adapter, BAS and BAM ... because my colleagues and I worked on many of these features ... ;-)

I've been working in BizTalk team for 4 years now, this is my second BizTalk release, and I really like the things that I do here. The product and the people are great, there are MANY great opportunities, the mix of technologies that we use or develop is exciting and challenging. This is one of the best places to be at Microsoft. If you are interested, check this post on how to get your resume posted and join the team http://blogs.msdn.com/biztalk_server_team_blog/archive/2006/03/21/556067.aspx
Normally, I would get borred working on the same product for 4 years, but that was not the case with this product. I decided to stay with the BizTalk team and work on the next version of BizTalk that should be even better. However, I will change teams inside BizTalk, I am moving to the engine/message box team. I have admired the work they've done for quite a while now and that seems to be the right place for me going forward.

If you haven't done this already, take a look at the latest BizTalk release here http://www.microsoft.com/biztalk/default.mspx

Adding a row into a SharePoint List and adding an attachment to it

Adrian Hamza — Mon, 20 Mar 2006 20:43:00 GMT

I recently got this email from a WSS Adapter user

... I saw your 4 last web casts, it helped me a lot to get a good idea about thee WSS adapter.I have a question, Can you help me please and tell me how to add a row into SharePoint list and add an attachment to it? Where can I get more help about WSS adapter other then interrupt you? ...

Unfortunately, the support for lists is not that rich in this release of the adapter. You can send messages to lists (create list row) but you cannot receive messages from lists or add attachments to a list item.

It's very easy to add a row to a SharePoint list using the WSS adapter. The problem is that the adapter does not support adding an attachment to the row that was inserted.

In order to add a row to a list, you just have to send a message to that list the same way you would send the message to a document library. For instance, you can send a message to the Shared Documents document library or you can send a message to the Lists/Tasks list. All lists URLs begin with Lists/ so make sure you use the correct URL for the list. When sending a message to a list, the message will not be saved in the list (as it is saved in the document library) but the property promotion still happens. This means that you can use the Column 01 ... Column 16, Column 01 Value ... Column 16 Value send port properties in order to extract the values from the XML message and save them in the List columns. You can also hard code the SharePoint column values instead of taking them from the message. The Filename field is not used when sending messages to list, instead you will have to update the Title column.

See topic, 'Supported Windows SharePoint Services Column Types ' in the BizTalk 2006 documentation (beta available for download here http://blogs.msdn.com/luke/archive/2006/02/03/524534.aspx ) for info on how to update particular SharePoint column types. You can also take a look at 'Walkthrough: Module 3 - Accessing SharePoint Properties from an Orchestration '. Unfortunately that's a little bit of an overkill because you need to do tutorial 1 and 2 before you can do 3, and also the main goal of the tutorial is to show how to use dynamic send ports. Sending a message to a list is a very small part of that tutorial and it's done using a dynamic send port instead of the easier way which is using a physical send port.

In order to add an attachment to the list item you just created, you will have to write a .Net Component that invokes the Windows SharePoint Services web services and call that component from a BizTalk orchestration. Most likely you will have to use the http://localhost/_vti_bin/Listswsdl.aspx web service. You can take a look at this http://blogs.msdn.com/ahamza/archive/2006/03/15/WssAdapterBrowseUI.aspx project (source code is included) to see how I have used the WSS web services. That projects uses the Lists web service so you can probably even reuse some of the code.

More information on WSS adapter is available in the BizTalk 2006 documentation (pointer listed above), just search for SharePoint. You can also ask me questions anytime or just forward your questions to BizTalk discussion aliases ( http://blogs.msdn.com/kevin_lam/archive/2005/07/11/437590.aspx ).

Adding Browse UI to BT'06 WSS adapter

Adrian Hamza — Wed, 15 Mar 2006 18:57:00 GMT

The WssAdapterBrowseUI.dll modifies the default WSS Adapter UI so that instead of typing the names and URLs of SharePoint document libraries, lists, or columns you will be presented with a list view/tree view from where you can select the appropriate SharePoint object. The friendly names/titles of SharePoint objects are being shown but the UI is filled with the appropriate value (document library relative URL, document library title, column title, etc). This component does not validate that values entered manually are correct.

Left image above is the original WSS UI included in BizTalk 2006. Right image above, is the modified WSS UI that includes browse SharePoint site functionality. The dropdown box (circled in red in image above) is visible only when the cursor is positioned inside the text box.

This functionality is implemented by wrapping the WSS adapter management class (found in Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll) and annotating the returned XSD schemas in order to instruct BizTalk what classes can be used to query and display the SharePoint information. WssAdapterBrowseUI.dll replaces the Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll
assembly, forwards all calls to StaticAdapterManagement classes and it modifies the returned results.
Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll is still needed since WssAdapterBrowseUI.dll uses it.

Setup steps:
- backup registry information
- copy WssAdapterBrowseUI.dll to BizTalk folder
- modify registry information so that BizTalk uses WssAdapterBrowseUI.dll instead of Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll

Disclaimer
Use this code at your own risk. No support is provided and this code has NOT been tested.

Important
If you re-run BizTalk setup, configuration or if you need to apply a BizTalk QFE or future Service Pack, you will have to uninstall this component before doing so. This component is not supported!

Registry Backup
Run command below to make a copy of the default Wss Adapter registration. Open file in notepad to make sure backup worked.
reg export "HKEY_CLASSES_ROOT\CLSID\{BA7DAD66-5FC8-4a24-A27E-D9F68FD67C3A}" OriginalWssAdapterRegistration.reg

Keep this backup since you will need to restore the original Wss Adapter registration before applying any BizTalk SP or QFE.

Copy WssAdapterBrowseUI.dll to BizTalk folder
Copy supplied WssAdapterBrowseUI.dll (or build your own, see How to build WssAdapterBrowseUI.dll) to C:\Program Files\Microsoft BizTalk Server 2006

Update registry
Update Wss Adapter registration to use the new adapter management class
a) open "WssAdapterRegistration-Annotated.reg.RENAMEIT" in notepad and make sure that paths are correct
Notice - if you update any file paths in the registry file make sure you use \\ instead of \
b) Rename "WssAdapterRegistration-Annotated.reg.RENAMEIT" (remove ".RENAMEIT" from the name)
c) import registry settings by opening WssAdapterRegistration-Annotated.reg

How to build WssAdapterBrowseUI.dll
The sources and binaries are included in the attached zip file. Open WssAdapterBrowseUI.csproj in Visual Studio 2005. If references to assemblies
Microsoft.BizTalk.Adapter.Framework.dll
Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll
are not correct update the references.

Referenced assembly Microsoft.BizTalk.Adapter.Framework.dll is found under \Program Files\Microsoft BizTalk Server 2006\Developer Tools
Referenced assembly Microsoft.BizTalk.KwTpm.WssAdapter.StaticAdapterManagement.dll is found under \Program Files\Microsoft BizTalk Server 2006
Build the project.

Problem when configuring WSS 2003 with SP2 to run on top of .Net Framework 1.1 and then upgrading to .Net Framework 2.0

Adrian Hamza — Sat, 11 Mar 2006 03:08:00 GMT

A few users have reported this configuration issue when trying to install and configure BizTalk 2006 with Windows SharePoint Services adapter. BizTalk 2006 native adapter for Windows SharePoint Services requires .Net Framework 2.0 but most of the users don't realize this until they try to configure the Windows SharePoint Services Adapter Web Service feature of BizTalk 2006. At that point, in many cases, Windows SharePoint Services has already been configured to run on top of .Net Framework 1.1 so the following error is visible in BizTalk configuration Web site is not configured to use .Net Framework 2.0

Changing the ASP.NET version on IIS site to be 2.0 instead of 1.1 causes Windows SharePoint Services 2003 to stop working completely.

This is not a BizTalk 2006 configuration issue, but BizTalk requirements combined with the succession of installation and configuration steps makes it pretty likely to run into this configuration issue of WSS 2003 with SP2. This is a known WSS 2003 with SP2 configuration issue and can be fixed easily by running STSADM tool with the force ugprade parameter.

In order to quickly upgrade your IIS site and WSS 2003 with SP2 from .Net Framework 1.1 to .Net Framework 2.0, run the commands below:

"%SystemRoot%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe" -i

"%CommonProgramFiles%\Microsoft Shared\web server extensions\60\BIN\STSADM.exe" -o upgrade -url http://localhost:80 -forceupgrade

BizTalk Server 2006 Beta2 is out - What's new in WSS Adapter?

Adrian Hamza — Tue, 22 Nov 2005 21:15:00 GMT

Microsoft BizTalk Server 2006 Beta2 is now available on Microsoft Beta Place. If you have not signed up already for BizTalk 2006 Beta program you can follow the instructions that I posted in this previous post in order to download the bits. If you have already signed up for BizTalk Beta 1 then you can just go to https://beta.microsoft.com, sign in with your account and download the latest BT 2006 beta.

The setup/configuration is pretty much the same so you can follow the steps from my previous post but now you have to use the RTM version of Visual Studio 2005 and Windows SharePoint Services 2003 with SP2.

BizTalk 2006 Beta 2 is a production-ready build, and of course upgrade from Beta 2 to RTM will be supported.

So, what's new feature wise in Windows SharePoint Services adapter included in BizTalk 2006 Beta 2 when compared to previous Beta 1? See below:

new macros %Filename% and %Extension% are supported in all send port/receive location fields that accept macros. These macros are replaced at runtime with the filename and extension values computed from the WSS.Filename context property of the message being processed. All messages that are received from SharePoint have this property automatically initialized to the filename of the SharePoint file that generated the BT message. As a result these macros will be replaced with the filename and extension of the original SharePoint file (if the message originated from SharePoint), or with the filename and extension defined in the orchestration/custom pipeline if the orchestration/custom pipeline specifies a value for the WSS.Filename context property of the message. Unlike the rest of the WSS adapter macros, these two macros cannot be used in WSS adapter context properties values that are defined in an orchestration/pipeline. This feature addresses a part of Edgardo's well justified complaint that he made a while ago . The other part of the complaint (about Versioning support) was not possible to address in this release but it might be addressed by a future release.
the send port "Microsoft Office Integration" setting now supports an "Yes (InfoPath Form Library)" option. If this option is enabled and the XML message is being sent to a SharePoint InfoPath form library, the XML file being created will automatically be linked to the InfoPath solution attached to the SharePoint form library so that the file will open up in InfoPath. When Microsoft Office Integration is set to "Yes (InfoPath Form Library)", no values are required for the other Microsoft Office Integration fields but the message must be sent to a SharePoint InfoPath Form Library.
The behavior for "Optional" setting of "Microsoft Office Integration" send port property has been changed slightly to accomodate the new value "Yes (InfoPath Form Library)". When Office Integration is set to “Optional”, the adapter will try to use both discovery mechanisms ("Yes" and "Yes (InfoPath Form Library)"). If both mechanisms return a solution, the solution found in the Templates Document Library/Templates Fallback Document Library will be preferred. If no InfoPath solution is found the message will not be suspended, instead it will be saved as-is (no change here).
the send port "Overwrite" setting now supports a Rename option. If a file with the same name exists in SharePoint, the name of the file being created will be made unique by appending the message identifier %MessageID% to it. This option is not supported for receive location 'Archive Ovewrite' property.

Configuring Windows SharePoint Services on 64 bit machines/OS

Adrian Hamza — Mon, 21 Nov 2005 17:01:00 GMT

WSS with SP2 can run in 32-bit emulation mode on a 64-bit machine/OS but there are a few manual steps that need to be done in order to get that working.

Step 1 - First of all, set the IIS application pool to run as 32 bit. On 64 bit machines, SharePoint runs in 32-bit emulation mode. This means that you need to update IIS settings so that the IIS application pool processes run as 32 bit processes. One caveat here is that the setting that controls this applies to all application pool processes. This means that all IIS app pools will run either as 32 bit or as 64 bit but not both. To do that you will have to set the W3SVC/AppPools/Enable32bitAppOnWin64 metabase property to 1. For more details see KB article http://support.microsoft.com/default.aspx?scid=kb;en-us;895976

To do that run the following commands from the command prompt
CScript "%SystemDrive%\InetPub\AdminScripts\adsutil.vbs" set w3svc/AppPools/Enable32bitAppOnWin64 1
iisreset

Step 2 - Enable the ASP.NET extensions for the 32 bit ASP.NET version. To do that you will have to run the commands below from the "Visual Studio 2005 Command Prompt".
%SystemRoot%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis -i -enable
iisreset

Make sure you run this command from the Framework folder and not from the Framework64 folder.

Step 3 - Install the slipstream version of WSS 2003 with SP2 (kit of WSS 2003 containing SP2 instead of kit of WSS 2003 and then separately apply SP2). If you don't install the slipstream version of WSS 2003 with SP2, then I think you need to first install .Net Framework 1.1 as described by step 2 in http://support.microsoft.com/Default.aspx?id=905854.

Troubleshooting and fixing errors
I purposely reproed a few of the errors that I knew you could run into in order to see how these errors manifest themselves and how they can be fixed.

A) Windows SharePoint Services requires a more recent version of Microsoft ASP.Net. To install a more recent version, go to Add or Remove Programs, click Add/Remove Windows Components, click Application Server, click Details, and then select ASP.NET.

This error is raised by Windows SharePoint Services 2003 with SP1 setup when the .Net Framework 1.1 is not installed. This error is also raised when you have installed .Net Framework but it's version 2.0. This error is not raised by Windows SharePoint Services 2003 with SP2 setup. Windows SharePoint Services 2003 with SP2 supports .Net Framework 2.0 and you are going to need it anyway if you want to run WSS on the 64 bit OS. So instead of installing WSS 2003 with SP1, you should download and install WSS 2003 with SP2 from here http://www.microsoft.com/downloads/details.aspx?familyid=B922B28D-806A-427B-A4C5-AB0F1AA0F7F9&displaylang=en.

The .Net Framework installation instructions from the error message do not apply to the 64 bit OS, so you will have to download and install the .Net Framework 2.0 from one of these 2 links
Microsoft .NET Framework Version 2.0 Redistributable Package (x64) - http://www.microsoft.com/downloads/details.aspx?familyid=B44A0000-ACF8-4FA1-AFFB-40E78D788B00&displaylang=en
Microsoft .NET Framework Version 2.0 Redistributable Package (IA64) - http://www.microsoft.com/downloads/details.aspx?familyid=53C2548B-BEC7-4AB4-8CBE-33E07CFC83A7&displaylang=en

B) Windows SharePoint Services requires a more recent version of Microsoft ASP.NET. Go to the Microsoft Web site at www.microsoft.com to download and install a more recent version.
This error is raised by Windows SharePoint Services with SP2 when one of the following is true
       1 - .Net Framework has not been installed on the machine. See bulet A) above on how to download and install .Net Framework.
       2 - .Net Framework has been installed but ASP.NET is not enabled. See step 2 above on how to enable ASP.NET
       3 - ASP.NET has been installed, but IIS application pools are running in 64 bit mode. See step 1 above on how to switch the app pools to 32 bit mode.

C) The Microsoft .Net Framework version 1.1.4322 must be installed before this package can be installed.
WSS 2003 with SP2 does not require .Net Framework 1.1 if 2.0 is installed but somehow I managed to get the machine in this state and after that I couldn't remove or re-install SharePoint. No matter what I did, I got the same error message referring to .Net Framework 1.1.
If your machine is in this state you can remove SharePoint by temporarilly installing .Net Framework 1.1 from here http://www.microsoft.com/downloads/details.aspx?FamilyId=262D25E3-F589-4842-8157-034D1E7CF3A3&displaylang=en.
Then you can re-install and configure WSS 2003 with SP2 and only after that remove .Net Framework 1.1.

D) RpcProxy.dll failed to load
If you get the following 2 errors in the Application Event Log, then you need to uninstall/reinstall RPC Over HTTP Proxy. You will have to do that from Control Panel -> Add Remove Programs -> Add/Remove Windows Components -> Networking Services -> RPC Over HTTP Proxy

Event Type: Error
Event Source: W3SVC-WP
Event Category: None
Event ID: 2214
Date:  11/16/2005
Time:  12:58:23 PM
User:  N/A
Computer: MachineName
Description:
The HTTP Filter DLL C:\WINDOWS\System32\RpcProxy\RpcProxy.dll failed to load. The data is the error.

For more information, see Help and Support Center at http://go.microsoft.com/fwlink/events.asp.
Data:
0000: 7e 00 00 00 ~...

E) Could not load all ISAPI filters for site/service. Therefore startup aborted.
or
ISAPI Filter 'path to filter' could not be loaded due to a configuration problem. The current configuration only supports loading images built for a AMD64 processor architecture. The data field contains the error number. To learn more about this issue, including how to troubleshooting this kind of processor architecture mismatch error, see http://go.microsoft.com/fwlink/?LinkId=29349.

You probably
    1 - skipped step 1)
    2 - you performed step 1) but then some other application has reverted the setting so that the IIS app pools run as 64 bit
    3 - you have 32 bit and 64 bit filters installed on the same machine in which case only one set of the filters will work

Installing SharePoint Portal Server 2003 SP2 on a Windows Server 2003 x64 Edition
For installing SharePoint Portal Server 2003 SP2 on a Windows Server 2003 x64 Edition see the following KB article http://support.microsoft.com/Default.aspx?id=905854

New WSS Adapter videos are available on the Microsoft Beta site, BizTalk Server 2006 program

Adrian Hamza — Tue, 15 Nov 2005 01:30:00 GMT

Hi folks,
Sorry for the long delay since my last post, I just got back from a 3 weeks vacation. My parents visited US for the first time and I took some time off to show them how wonderful Puget Sound is. Originally, I am from Romania but I moved here 5 years ago and this was their first visit.

When I got back from vacation I had the surprise to see that the new WSS Adapter demos that I recorded before going on vacation have been approved and posted online on the BizTalk Beta Place, so here they are ...

WSSAdapter-SetupAndConfig-Short.wmv (9.58 MB) - Windows SharePoint Services 2003 with SP2 and BizTalk Server 2006 Beta 1 setup and configuration
WSSAdapter-SendReceiveCBR.wmv (10.25 MB) - basic send and receive scenario using Content Based Routing feature in BizTalk
WSSAdapter-InfoPathIntegration.wmv (15.11 MB) - using InfoPath integration feature of the adapter
WSSAdapter-PropsInOrchestration.wmv (28.58 MB) - tutorial for BizTalk developers showing how to access SharePoint properties from BizTalk orchestrations, how to configure SharePoint adapter dynamic send ports and how to send messages to SharePoint lists like the Tasks list

The demos included in these videos build one on top of each-other so it makes sense to view them in the order I listed above.

The previous webcast "BTS 2006 Windows SharePoint Services (WSS) Adapter Deep Dive" is also available.

Videos are shared on this SharePoint site http://wssadapter.members.winisp.net/default.aspx, in the Shared Documents document library, WSS Adapter Webcasts folder.

Service Pack 2 for Windows SharePoint Services 2003 has been released

Adrian Hamza — Tue, 04 Oct 2005 23:15:00 GMT

Service Pack 2 for Windows SharePoint Services 2003 has been released last week on September 27.

You can download the SP2 here .
You can download the full version of Windows SharePoint Services with SP2 integrated (slipstream) from here .

From my perspective, most interesting features added by this service pack are:
- Whidbey (.Net Framework 2.0) support: both side-by-side with .Net Framework 1.1 and also support for running against Whidbey
- Support for 64 bit - WSS with SP2 can run in 32-bit emulation mode on a 64-bit machine

Information for BizTalk 2006 Beta 1 Users
WSS adapter and BAS included with BizTalk Beta 1 require the preview build of WSS SP2 which has been made available through the BizTalk 2006 Beta program.
The RTM build of WSS SP2 seems to not work with BizTalk 2006 Beta 1 due to compatibility issues (they are compatible with different builds of .Net Framework 2.0).
BizTalk Beta 1 requires .Net Framework 2.0 Beta 2. WSS SP2 preview build is compatible with Beta 2 build of the .Net Framework where the RTM build of WSS SP2 seems that it's not or at least I wasn't able to get it to work.

BizTalk 2006 Beta 2, probably shipping sometime in November 2005, will most likely work with the RTM bits of WSS SP2 and .Net Framework 2.0.

Information for BAS feature users in BizTalk 2004
If you have installed WSS SP2 build on a SharePoint machine with BizTalk 2004 and BAS feature then you probably have to apply a BizTalk 2004 hotfix, otherwise the SharePoint messaging feature in BAS will be partially broken. For more details see KB article http://support.microsoft.com/kb/908359