[AX]AX2012 AIF（七）：创建.NET程序集变换器

在增强型AIF端口中可以配置出入站变换器，它的作用是在消息处理过程中（http://msdn.microsoft.com/EN-US/library/gg731873.aspx）对消息做前后置处理，比如来源消息不是很规范，我们需要在正式处理前做数据的整理，这个就可以使用变换器来完成。顺便要说明的是，管道也是用来处理消息的，它与变换器是有区别的：管道可用于同步/异步数据交换，而变换器只能应用于异步交换；调用时机上入站消息在放入到消息队列前应用变换器，从入站消息队列取出消息正式处理前应用管道。

有两种类型的变换器可用，一是使用XSLT对XML格式的消息做处理变换，第二种则是我们使用.NET开发的程序集变换器，它可以处理任何自定义的格式，比如逗号分隔的CSV格式。一个.NET变换器实际上是在.NET的Class library工程中创建一个实现Microsoft.Dynamics.IntegrationFramework.Transform.ITransform接口的类，在目录C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin下可以找到需要引用的程序集Microsoft.Dynamics.IntegrationFramework.dll。

一个.net变换器类是这个样子的：

using System.Text;
using System.IO;
using System.Xml;
using Microsoft.Dynamics.IntegrationFramework.Transform;

namespace AssemblyTransformTest
{
    public class Class1 : ITransform
    {
        public void Transform(System.IO.Stream input, System.IO.Stream output, string config)
        {
            StreamReader sreader = new StreamReader(input);
            XmlTextWriter xwriter = new XmlTextWriter(output, Encoding.UTF8);
            string[] fieldArray;
            string[] dataArray;
            string rootName = "Customers";
            string rowName = "Customer";
            int i;
            
            // Get the element names from the headings
            string lineIn = sreader.ReadLine();
            fieldArray = lineIn.Split(',');

            // Start writing the XML file.
            xwriter.Formatting = Formatting.Indented;
            xwriter.WriteStartDocument();
            xwriter.WriteComment("customers.xml file");
            xwriter.WriteStartElement(rootName);

            lineIn = sreader.ReadLine();
            while (lineIn != null)
            {
                // Loop through each line of data in the file.
                xwriter.WriteStartElement(rowName); 
                dataArray = lineIn.Split(',');
                // Write each element.
                for (i = 0; i <= dataArray.GetUpperBound(0); i++)
                {
                    xwriter.WriteElementString(fieldArray[i], dataArray[i]);
                }
                // Write the </Customer> end element.
                xwriter.WriteEndElement();
                lineIn = sreader.ReadLine();
            }
            sreader.Close();
            // Write the </Customers> end element.
            xwriter.WriteEndElement();
            xwriter.Close();
        }
    }
}

它处理CSV输入格式的数据：

Num,AccountName,CustGroup,Currency
1,Fourth Coffee,20,USD
2,Graphic Design Institute,20,USD
3,Lucerne Publishing,20,EUR

返回XML格式的的结果：

<?xml version="1.0" encoding="utf-8"?>
<!--customers.xml file-->
<Customers>
  <Customer>
    <Num>1</Num>
    <AccountName>Fourth Coffee</AccountName>
    <CustGroup>20</CustGroup>
    <Currency>USD</Currency>
  </Customer>
  <Customer>
    <Num>2</Num>
    <AccountName>Graphic Design Institute</AccountName>
    <CustGroup>20</CustGroup>
    <Currency>USD</Currency>
  </Customer>
  <Customer>
    <Num>3</Num>
    <AccountName>Lucerne Publishing</AccountName>
    <CustGroup>20</CustGroup>
    <Currency>EUR</Currency>
  </Customer>
</Customers>

在AIF端口中使用这个.NET变换器前，我们还需要先将它导入到AX，导入工具在Tools > Application Integration Framework > Manage transforms窗口，在这里创建一个.net程序集类型的变换器，装载相应的程序集文件dll，选择要应用的变换器类，一个程序集是可以包含多个变换器类的。需要注意变换器程序集需要同时拷贝分发到服务器bin目录（C:\Program Files\Microsoft Dynamics AX\60\Server\MicrosoftDynamicsAX\Bin）和客户端bin目录（C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin）。