通过字符串变量引用业务流程中的端口

Question

我正在尝试开发用于配置动态端口的通用BizTalk应用程序。我有一个编排，可以回退每个端口的所有配置设置，我想循环这些设置并配置端口。这些设置保存在MSSQL中，例如，其中两个属性是PortName和Address。所以从业务流程中我想通过字符串变量PortName引用端口。那么是否有一些方法来获取业务流程中所有端口的集合或通过字符串变量引用端口，即Port['MyPortName'](Microsoft.XLANGs.BaseTypes.Address) = "file://c:\test\out\%MessageId%.xml"谢谢

Answer 1

为了在业务流程中动态配置动态逻辑发送端口，必须将设置存储到持久性数据存储区（例如数据库或配置文件）中，并实现在运行时动态分配这些属性的方法。

但首先，我们需要了解配置动态发送端口时发生的情况。

如何配置动态逻辑发送端口

业务流程中的

Configuring the properties of a dynamic logical send port涉及两个步骤：

• 首先，必须在发送端口上指定TransportType和目标Address属性。这通常在 Expression Shape 中完成，代码类似于：

  DynamicSendPort（Microsoft.XLANGs.BaseTypes.TransportType）=“FILE”; DynamicSendPort（Microsoft.XLANGs.BaseTypes.Address）=“C：\ Temp \ Folder \％SourceFileName％”;

• 其次，必须在传出消息本身的上下文中指定任何其他传输属性。实际上所有BizTalk适配器都有additional properties，用于Messaging Engine和XLANG / s Orchestration Engine之间的通信。例如，ReceivedFileName context属性用于动态设置FILE适配器何时将传出消息保存在其目标位置的特定名称。这最好在 Assignment Shape 中执行，作为构造传出消息的一部分：

  OutgoingMessage（FILE.ReceiveFileName）=“HardCodedFileName.xml”

您会注意到必须在传出消息的上下文中指定大多数配置属性，指定名称空间前缀（例如FILE），属性名称（例如ReceiveFileName）以及显然分配给相应的值的值属性。

实际上，所有上下文属性都是在着名的 Microsoft.BizTalk.GlobalPropertySchemas.dll程序集中存在的类。通过在Visual Studio的对象资源管理器中查找此程序集来确认这一点。

即使实际配置动态逻辑发送端口所需的大多数上下文属性都在此特定程序集中，但并非所有这些都可以。例如，MSMQ BizTalk适配器使用单独的程序集来存储其上下文属性。显然，第三方或自定义适配器也带有附加组件。

因此，为了使用如下所述的灵活方法在动态发送端口上设置上下文属性，需要四条信息：

• 包含上下文属性类的程序集的完全限定名称。
• 名称空间前缀。
• 属性名称。
• 物业价值。

在持久媒体中存储端口设置

以下.XSD架构说明了序列化端口设置的一种可能结构。

一旦序列化，指定的上下文属性就可以非常容易地存储在SQL数据库或配置文件中。例如，以下是此帖中用作示例的设置：

配置动态逻辑发送端口的灵活方法

使用简单的帮助程序库，设置动态端口配置非常简单。首先，您必须从持久性介质中检索序列化设置。使用WCF-SQL适配器和简单的存储过程可以很容易地实现这一点。

检索后，可以将这些属性反序列化为强类型C＃对象图。为此，首先使用以下命令行实用程序创建上面显示的ContextProperties模式的C＃表示：

xsd.exe /classes /language:cs /namespace:Helper.Schemas .\ContextProperties.xsd

这会生成一个可以使用以下方法改进的分部类：

namespace Helper.Schemas
{
    public partial class ContextProperties
    {
        public static ContextProperties Deserialize(string text)
        {
            using (MemoryStream stream = new MemoryStream())
            {
                byte[] buffer = Encoding.UTF8.GetBytes(text);
                stream.Write(buffer, 0, buffer.Length);
                stream.Seek(0, SeekOrigin.Begin);
                return (ContextProperties) 
                    Deserialize(
                          stream
                        , typeof(ContextProperties));
            }
        }

        public static Object Deserialize(Stream stream, Type type)
        {
            XmlSerializer xmlSerializer = new XmlSerializer(type);
            return xmlSerializer.Deserialize(stream);
        }
    }
}

其次，应用此配置涉及从代码创建XLANG / s消息并使用反射动态设置上下文属性，具体取决于反序列化的ContextProperties对象图中指定的上下文属性类的描述。

为此，我使用了一种借鉴Paolo Salvatori系列文章regarding dynamic transformations的技术，该文章包括创建一个自定义BTXMessage派生类，由BizTalk XLANG内部使用/引擎。

namespace Helper.Schemas
{
    using Microsoft.BizTalk.XLANGs.BTXEngine; // Found in Microsoft.XLANGs.BizTalk.Engine
    using Microsoft.XLANGs.Core; // Found in Microsoft.XLANGs.Engine

    [Serializable]
    public sealed class CustomBTXMessage : BTXMessage
    {
        public CustomBTXMessage(string messageName, Context context)
            : base(messageName, context)
        {
            context.RefMessage(this);
        }

        public void SetContextProperty(string assembly, string ns, string name, object value)
        {
            if (String.IsNullOrEmpty(ns))
                ns = "Microsoft.XLANGs.BaseTypes";
            if (String.IsNullOrEmpty(assembly))
                assembly = "Microsoft.BizTalk.GlobalPropertySchemas";

            StringBuilder assemblyQualifiedName = new StringBuilder();
            assemblyQualifiedName.AppendFormat("{0}.{1}, {2}", ns, name, assembly);

            Type type = Type.GetType(assemblyQualifiedName.ToString(), true, true);
            SetContextProperty(type, value);
        }

        internal void SetContextProperty(string property, object value)
        {
            int index = property.IndexOf('.');
            if (index != -1)
                SetContextProperty(String.Empty, property.Substring(0, index), property.Substring(index + 1), value);
            else
                SetContextProperty(String.Empty, String.Empty, property, value);
        }

    }
}

现在，最后一个难题是如何在Orchestration中使用这个自定义类。这可以使用以下帮助程序代码在 Assignment Shape 中轻松完成：

namespace Helper.Schemas
{
    using Microsoft.XLANGs.BaseTypes;
    using Microsoft.XLANGs.Core; // Found in Microsoft.XLANGs.Engine

    public static class Message
    {
        public static XLANGMessage SetContext(XLANGMessage message, ContextProperties properties)
        {
            try
            {
                // create a new XLANGMessage

                CustomBTXMessage customBTXMessage = new CustomBTXMessage(message.Name, Service.RootService.XlangStore.OwningContext);

                // add parts of the original message to it

                for (int index = 0; index < message.Count; index++)
                    customBTXMessage.AddPart(message[index]);

                // set the specified context properties

                foreach (ContextPropertiesContextProperty property in properties.ContextProperty)
                    customBTXMessage.SetContextProperty(property.assembly, property.@namespace, property.name, property.Value);

                return customBTXMessage.GetMessageWrapperForUserCode();
            }

            finally
            {
                message.Dispose();
            }
        }
    }
}

您可以在 Assignment Shape 中使用此静态方法，如下文所示的代码，其中OutboundMessage表示您要设置上下文的消息：

OutboundMessage = Helper.Schemas.Message.SetContext(OutboundMessage, contextProperties);

Answer 2

首先，您不应尝试使用Orchestration进行此类配置更改。从技术上讲，做你想做的事情是可行的，但作为一种做法，你不应该把你的业务流程与管理混为一谈。

执行此类操作的最佳方法是编写一些普通脚本或PowerShell。

要回答您的问题，您可以从ExplorerOM中的BtsOrchestration类中获取所需的数据 http://msdn.microsoft.com/en-us/library/microsoft.biztalk.explorerom.btsorchestration_members(v=bts.20)