Adapter requires static handler configuration?

Discussion:

(too old to reply)

-b

2008-12-12 10:34:05 UTC

Hi,

After installing my custom adapter successfully, i cannot add new handlers.
'Platform Settings | Adapters | select custom adapter | add New | handler'

Message: "This adapter requires static handler configuration. No new send
handlers may be created for this adapter. Existing handlers cannot be
switched to different BizTalk Host.(WinMgmt)"

I want to configure send handlers for my adapter. What have i coded wrong?
Thanks! b

<FullMessage>
===================================

This adapter requires static handler configuration. No new send handlers may
be created for this adapter. Existing handlers cannot be switched to
different BizTalk Host. (WinMgmt)

------------------------------
For help, click:
http://go.microsoft.com/fwlink/?LinkId=47400&ProdName=Microsoft+BizTalk+Server+2006&ProdVer=3.5.1602.0&EvtSrc=BTSAdminMsg&EvtID=9421

------------------------------
Program Location:

at
System.Runtime.InteropServices.Marshal.ThrowExceptionForHRInternal(Int32
errorCode, IntPtr errorInfo)
at System.Management.ManagementObject.Put(PutOptions options)
at
Microsoft.BizTalk.Administration.SnapIn.Forms.AdapterHandler.AdapterHandlerPages.CommitChanges()
at Microsoft.BizTalk.SnapIn.Framework.Forms.PropertyPagesContainer.Store()
at Microsoft.BizTalk.SnapIn.Framework.Forms.SheetFramework.Store()

</FullMessage>

news.microsoft.com

2008-12-15 10:07:36 UTC

Permalink

Hi,

You provide an XML Schema document for the send handler configuration. Check
that the XML is valid and correct.

Also, run DebugView in parallel, there might be enlighting error messages
coming by.

Regards

Joerg Fischer
BizTalk MVP

Post by -b
Hi,
After installing my custom adapter successfully, i cannot add new handlers.
'Platform Settings | Adapters | select custom adapter | add New | handler'
Message: "This adapter requires static handler configuration. No new send
handlers may be created for this adapter. Existing handlers cannot be
switched to different BizTalk Host.(WinMgmt)"
I want to configure send handlers for my adapter. What have i coded wrong?
Thanks! b
<FullMessage>
===================================
This adapter requires static handler configuration. No new send handlers may
be created for this adapter. Existing handlers cannot be switched to
different BizTalk Host. (WinMgmt)
------------------------------
http://go.microsoft.com/fwlink/?LinkId=47400&ProdName=Microsoft+BizTalk+Server+2006&ProdVer=3.5.1602.0&EvtSrc=BTSAdminMsg&EvtID=9421
------------------------------
at
System.Runtime.InteropServices.Marshal.ThrowExceptionForHRInternal(Int32
errorCode, IntPtr errorInfo)
at System.Management.ManagementObject.Put(PutOptions options)
at
Microsoft.BizTalk.Administration.SnapIn.Forms.AdapterHandler.AdapterHandlerPages.CommitChanges()
at
Microsoft.BizTalk.SnapIn.Framework.Forms.PropertyPagesContainer.Store()
at Microsoft.BizTalk.SnapIn.Framework.Forms.SheetFramework.Store()
</FullMessage>

-b

2008-12-16 10:55:01 UTC

Permalink

Hi Joerg,

Thank you for your reply. Unfortunately, your suggestions have not lead me
yet to a solution for 'adding a send handler to my adapter'.

- your suggestion 'check schemas'
I use two schemas: 'TransmitHandler.xsd' and 'TransmitLocation.xsd'. Both
schemata are valid and correct. When i configure my adapter properties in BTS
Admin Console (Platform Settings | Adapters), i see a GUI based on
TransmitHandler.xsd. When i configure adapter properties for a specific port,
i see a GUI based on TransmitLocation.xsd. (meanwhile, DebugView spits no
errors). This leads me to believe that both schema are correct.

- your suggestion 'DebugView'
Indeed, when i try to configure a new handler for my adapter (Platform
Settings | Adapters), DebugView spits an error (see below). However, when
adding a new send handler to the BTS MSMQ adapter, adding the handler
succeeds, but DebugView spits the exact same error (see below, same error
except for the adapter GUID).
I would think this error has to do with the encoding of schema ('data at the
root level is invalid'), and is not related to the issue at hand, namely an
unexpected message saying that my adapter requires static handler
configuration.

I suspect that my custom adapter has not implemented some interface, or
perhaps return specific data that makes BTS think that this adapter has some
specific limitations that it is not supposed to have.

Comments / more suggestions very welcome! Kind regards, Bernard

//// messages when adding a new send handler to my custom BTS adapter:
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid=
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid={FBB76652-AE1F-411A-A7D1-8D78AE7EA322}
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: System.String
ValidateConfiguration(Microsoft.BizTalk.Adapter.Framework.ConfigType,
System.String)
[256] configType=TransmitHandler
[256] configuration=***CONFIDENTIAL***
[256] Suppressed exception: System.Xml.XmlException: Data at the root level
is invalid. Line 1, position 1.
[256] at System.Xml.XmlTextReaderImpl.Throw(Exception e)
[256] at System.Xml.XmlTextReaderImpl.Throw(String res, String arg)
[256] at System.Xml.XmlTextReaderImpl.ParseRootLevelWhitespace()
[256] at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
[256] at System.Xml.XmlTextReaderImpl.Read()
[256] at System.Xml.XmlLoader.Load(XmlDocument doc, XmlReader reader,
Boolean preserveWhitespace)
[256] at System.Xml.XmlDocument.Load(XmlReader reader)
[256] at System.Xml.XmlDocument.LoadXml(String xml)
[256] at
Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy.ValidateConfiguration(ConfigType configType, String configuration)

//// messages when adding a new send handler to BTS MSMQ adapter...
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid={FF5CEE87-FD92-4422-B47D-F7D033311693}
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: System.String
ValidateConfiguration(Microsoft.BizTalk.Adapter.Framework.ConfigType,
System.String)
[256] configType=TransmitHandler
[256] configuration=***CONFIDENTIAL***
[256] Suppressed exception: System.Xml.XmlException: Data at the root level
is invalid. Line 1, position 1.
[256] at System.Xml.XmlTextReaderImpl.Throw(Exception e)
[256] at System.Xml.XmlTextReaderImpl.Throw(String res, String arg)
[256] at System.Xml.XmlTextReaderImpl.ParseRootLevelWhitespace()
[256] at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
[256] at System.Xml.XmlTextReaderImpl.Read()
[256] at System.Xml.XmlLoader.Load(XmlDocument doc, XmlReader reader,
Boolean preserveWhitespace)
[256] at System.Xml.XmlDocument.Load(XmlReader reader)
[256] at System.Xml.XmlDocument.LoadXml(String xml)
[256] at
Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy.ValidateConfiguration(ConfigType configType, String configuration)

Post by news.microsoft.com
Hi,
You provide an XML Schema document for the send handler configuration. Check
that the XML is valid and correct.
Also, run DebugView in parallel, there might be enlighting error messages
coming by.
Regards
Joerg Fischer
BizTalk MVP

Tomas Restrepo [MVP]

2008-12-16 11:12:08 UTC

Permalink

Out of curiosity, what options did you specify on the constraints
setting in the registry when registering the adapter? Did you by any
chance include eProtocolRequireSingleInstancePerServer (0x0004)?

Post by -b
Hi Joerg,
Thank you for your reply. Unfortunately, your suggestions have not lead me
yet to a solution for 'adding a send handler to my adapter'.
- your suggestion 'check schemas'
I use two schemas: 'TransmitHandler.xsd' and 'TransmitLocation.xsd'. Both
schemata are valid and correct. When i configure my adapter properties in BTS
Admin Console (Platform Settings | Adapters), i see a GUI based on
TransmitHandler.xsd. When i configure adapter properties for a specific port,
i see a GUI based on TransmitLocation.xsd. (meanwhile, DebugView spits no
errors). This leads me to believe that both schema are correct.
- your suggestion 'DebugView'
Indeed, when i try to configure a new handler for my adapter (Platform
Settings | Adapters), DebugView spits an error (see below). However, when
adding a new send handler to the BTS MSMQ adapter, adding the handler
succeeds, but DebugView spits the exact same error (see below, same error
except for the adapter GUID).
I would think this error has to do with the encoding of schema ('data at the
root level is invalid'), and is not related to the issue at hand, namely an
unexpected message saying that my adapter requires static handler
configuration.
I suspect that my custom adapter has not implemented some interface, or
perhaps return specific data that makes BTS think that this adapter has some
specific limitations that it is not supposed to have.
Comments / more suggestions very welcome! Kind regards, Bernard
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid=
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid={FBB76652-AE1F-411A-A7D1-8D78AE7EA322}
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: System.String
ValidateConfiguration(Microsoft.BizTalk.Adapter.Framework.ConfigType,
System.String)
[256] configType=TransmitHandler
[256] configuration=***CONFIDENTIAL***
[256] Suppressed exception: System.Xml.XmlException: Data at the root level
is invalid. Line 1, position 1.
[256] at System.Xml.XmlTextReaderImpl.Throw(Exception e)
[256] at System.Xml.XmlTextReaderImpl.Throw(String res, String arg)
[256] at System.Xml.XmlTextReaderImpl.ParseRootLevelWhitespace()
[256] at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
[256] at System.Xml.XmlTextReaderImpl.Read()
[256] at System.Xml.XmlLoader.Load(XmlDocument doc, XmlReader reader,
Boolean preserveWhitespace)
[256] at System.Xml.XmlDocument.Load(XmlReader reader)
[256] at System.Xml.XmlDocument.LoadXml(String xml)
[256] at
Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy.ValidateConfiguration(ConfigType configType, String configuration)
//// messages when adding a new send handler to BTS MSMQ adapter...
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void .ctor()
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: Void
Initialize(System.String)
[256] adapterGuid={FF5CEE87-FD92-4422-B47D-F7D033311693}
[256] Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy: System.String
ValidateConfiguration(Microsoft.BizTalk.Adapter.Framework.ConfigType,
System.String)
[256] configType=TransmitHandler
[256] configuration=***CONFIDENTIAL***
[256] Suppressed exception: System.Xml.XmlException: Data at the root level
is invalid. Line 1, position 1.
[256] at System.Xml.XmlTextReaderImpl.Throw(Exception e)
[256] at System.Xml.XmlTextReaderImpl.Throw(String res, String arg)
[256] at System.Xml.XmlTextReaderImpl.ParseRootLevelWhitespace()
[256] at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
[256] at System.Xml.XmlTextReaderImpl.Read()
[256] at System.Xml.XmlLoader.Load(XmlDocument doc, XmlReader reader,
Boolean preserveWhitespace)
[256] at System.Xml.XmlDocument.Load(XmlReader reader)
[256] at System.Xml.XmlDocument.LoadXml(String xml)
[256] at
Microsoft.BizTalk.Adapter.Framework.Forms.AdapterProxy.ValidateConfiguration(ConfigType configType, String configuration)

--
Tomas Restrepo
http://winterdom.com/

-b

2008-12-16 14:42:15 UTC

Permalink

Hi Tomas,

Thank you for your response! My constraints were wrong indeed: 0x09c6.
I've changed this to 0x2102.
Steps followed & example code below, kind regards, Bernard

-- steps:
BTS Admin Console: terminate suspended messages, removed adapter
changed HKCR\CLSID\{adapter GUID}\BizTalk\Constraints to 2102
reboot
BTS Admin Console: added adapter
deploy BTS app & ports

example code:
#region Copyright
// ============================================================
// Software is provided "as-is", without warranty of any kind.
// Copyleft 2008, www.buddeconsulting.com
// ============================================================
#endregion Copyright

#region Using
using System;
using System.Collections.Generic;
using System.Globalization;
using System.Text;
#endregion Using

namespace BtsConstraints
{
class Program
{
#region Enums
/// <summary>
/// BizTalk adapter constraints define the capabilities of the
adapter's functionality.
/// </summary>
[Flags]
public enum AdapterConstraints
{
/// <summary>
/// Adapter supports receive operations.
/// </summary>
eProtocolSupportsReceive = 0x0001,
/// <summary>
/// Adapter supports send operations.
/// </summary>
eProtocolSupportsTransmit = 0x0002,
/// <summary>
/// Adapter requires a single instance per server.
/// </summary>
eProtocolRequireSingleInstancePerServer = 0x0004,
/// <summary>
/// Receive handler of adapter is hosted in-process.
/// </summary>
eProtocolReceiveIsCreatable = 0x0008,
/// <summary>
/// Adapter is application protocol.
/// </summary>
eProtocolIsApplicationProtocol = 0x0010,
/// <summary>
/// Adapter is delete protected.
/// </summary>
eProtocolDeleteProtected = 0x0020,
/// <summary>
/// Adapter supports static handlers.
/// </summary>
eProtocolStaticHandlers = 0x0040,
/// <summary>
/// Adapter supports request-response operations.
/// </summary>
eProtocolSupportsRequestResponse = 0x0080,
/// <summary>
/// Adapter supports solicit-response operations.
/// </summary>
eProtocolSupportsSolicitResponse = 0x0100,
/// <summary>
/// Adapter supports the SOAP protocol.
/// </summary>
eProtocolSupportsSOAP = 0x0200,
/// <summary>
/// Adapter uses Adapter Framework user interface for send
handler configuration.
/// </summary>
eOutboundProtocolRequiresContextInitialization = 0x0400,
/// <summary>
/// Adapter uses Adapter Framework user interface for receive
handler configuration.
/// </summary>
eInboundProtocolRequiresContextInitialization = 0x0800,
/// <summary>
/// Adapter uses Adapter Framework user interface for receive
location configuration.
/// </summary>
eReceiveLocationRequiresContextInitialization = 0x1000,
/// <summary>
/// Adapter uses Adapter Framework user interface for send port
configuration.
/// </summary>
eTransmitLocationRequiresContextInitialization = 0x2000,
/// <summary>
/// Adapter supports ordered delivery.
/// </summary>
eSupportsOrderedDelivery = 0x4000,
/// <summary>
/// Send adapter starts when the service starts instead of when
it sends the first message.
/// </summary>
eInitTransmitterOnServiceStart = 0x8000
} // AdapterConstraints
#endregion Enums

#region Methods
public static void DumpAdapterConstraints(int constraints)
{
Console.Out.WriteLine(
string.Format("Constraints (dec): {0}.",
constraints.ToString()));

object o = Enum.Parse(typeof(AdapterConstraints),
constraints.ToString());
Console.WriteLine(o.ToString());
}

public static void PrintUsage()
{
StringBuilder msg = new StringBuilder();
msg.AppendLine("");
msg.AppendLine("BtsConstraints lists MS BizTalk Adapter
constraints.");
msg.AppendLine("Usage: BtsConstraints constraints (hex value,
without leading '0x')");
msg.AppendLine("Example: BtsConstraints 09C6");
msg.AppendLine(@"See registry: HKCR\CLSID\{adapter
GUID}\BizTalk\Constraints");
msg.AppendLine("See also:
http://msdn.microsoft.com/en-us/library/ms916220.aspx");
Console.Error.WriteLine(msg.ToString());
}

static int Main(string[] args)
{
if (args.Length != 1)
{
Program.PrintUsage();
return 1;
}

int constraints = -1;
if (!Int32.TryParse(args[0], NumberStyles.HexNumber,
CultureInfo.InvariantCulture, out constraints))
{
Console.Out.WriteLine(
string.Format("Cannot parse '{0}' to an integer.",
args[0]));
Program.PrintUsage();
return 1;
}

Program.DumpAdapterConstraints(constraints);
return 0;
}

#endregion Methods
}
}

Post by Tomas Restrepo [MVP]
Out of curiosity, what options did you specify on the constraints
setting in the registry when registering the adapter? Did you by any
chance include eProtocolRequireSingleInstancePerServer (0x0004)?

--
Tomas Restrepo
http://winterdom.com/