业务集成引擎

这是对布伦瑞克的业务集成引擎 - BIE 的非官方文档，涵盖 6.04 版本。原始团队似乎停止了开发，并开始了一个分支。该分支称为 BIE-gpl，并且可以下载 6.05 的测试版。BIE 现在由 Redberri 出售。

介绍

根据 自由软件基金会 的 GNU 通用公共许可证 授权，布伦瑞克 WDI 的业务集成引擎是 自由（如自由）软件，并且 免费提供。BIE 可以帮助您转换消息，并在没有这些功能的应用程序之间传输消息。

BIE 使用了许多自由（如自由）软件组件作为其基础。对自由软件社区的最初贡献是 Web 应用程序仪表板和 Java 客户端映射构建器。

仪表板允许您使用拖放和进出 BIE 的连接来创建工作流程。映射构建器帮助您设置从一种 XML 架构到另一种 XML 架构的转换。

安装

GNU/Linux

• 从 Sourceforge.net 下载适用于您的平台的 BIE 6.04，网址为 http://sourceforge.net/project/showfiles.php?group_id=79291。选择压缩的归档文件 bie-linux-6.0.4.tar.gz。
• 使用您喜欢的任何方式解压缩归档文件。以下是一种使用控制台窗口的方法

tar xfvz bie-linux-6.0.4.tar.gz

结果是名为 bie-linux-6.0.4 的新子目录。

• 更改为超级用户模式或使用 su 更改为 root，输入 root 的密码。
• 将目录更改为新的子目录并键入

./install.sh

安装 BIE。将打开一个 GUI，只需按照给出的说明操作即可。

• 安装默认在 /usr/local/BIE 中。
• 选中“启动 BIE”复选框
• 默认用户是

admin

默认密码是

123qwe

• 您已完成。

文件和子目录

请参阅 文件树结构。

设置

• 通过将您的 Web 浏览器指向以下地址来打开 BIE 仪表板 Web 应用程序

https://127.0.0.1:5803/

• 使用您的用户名和密码登录。
• 在 BIE 仪表板的欢迎页面上，单击系统设置菜单下的邮件设置，并提供您的 SMTP 服务器和电子邮件地址，然后单击保存按钮。您现在可以测试 BIE 是否能够向您发送电子邮件，方法是在文本字段中输入您的电子邮件地址，然后单击测试按钮，并在您的电子邮件应用程序中查看来自 BIE 的任何新邮件。

仪表板 - Web 应用程序概述

系统

全局设置

全局系统配置

通用设置

• 远程客户端管理可以设置为以下两种之一

Disabled

或

Enabled

来自下拉菜单。禁用是默认设置。

关闭

• 通过单击标记为以下内容的红色按钮来停止所有服务

Shut Down   
  

系统日志设置

• 总体日志记录级别可以从以下下拉菜单中设置为以下之一
  • 全部
  • 调试
  • 信息
  • 警告
  • 错误
  • 致命错误
  • 关闭

• 已声明的 Appenders。可以在 /usr/local/BIE/services/jboss/server/default/conf/log4j.xml 文件中配置日志行为的完全控制。Appender BIE_DETAILS 的属性

 BufferSize:8192
 Class:class org.jboss.logging.appender.DailyRollingFileAppender
 Filter:null
 Append:true
 ErrorHandler:org.apache.log4j.helpers.OnlyOnceErrorHandler@7e80a
 BufferedIO:false
 DatePattern:'.'yyyy-MM-dd
 Name:BIE_DETAILS
 File:/usr/local/BIE/logs/bie-details.log
 ImmediateFlush:true
 Threshold:INFO
 FirstFilter:null
 Layout:org.apache.log4j.PatternLayout@113108b
 Encoding:null

监听器

监听器是 BIE 支持的将消息传递到 BIE 以进行处理或在完成后传递给收件人的方法。版本 6.0.4 支持 HTTP/HTTPS、监视目录、FTP、计划程序、POP 和 FTP 目录监视器。您可以通过点击“编辑”按钮来编辑大多数监听器。要启动监听器，请点击“启用”按钮。要停止监听器，请点击“禁用”按钮。

已注册的监听器

状态	名称	描述
正在运行	JMS 监听器	每个工作流都表示为一个队列。要接收来自工作流的响应，必须定义回复到标头。 -Initial Context Factory: org.jnp.interfaces.NamingContextFactory -Queue Connection Factory: UIL2ConnectionFactory		已启用
正在运行	HTTP/HTTPS	HTTP/HTTPS 监听器运行管理控制台、Web 服务引擎和 HTTP GET/POST 监听器。GET 和 POST 监听器位于 /listener/HTTPGet 和 /listener/HTTPPost，需要指定参数 routeID 和 message。	编辑
已停止	监视目录	监视目录监听器会监视目录以查找新文件并将文件内容传递到 BIE 进行处理。此监听器使用文件名中直到 .(点) 或 _ (下划线) 的所有字符作为路由标识符。	编辑	启用
已停止	FTP	FTP 监听器根据 FTP 请求运行路由。PUT 请求将消息传输到 BIE。GET 请求从 BIE 检索消息。此监听器使用文件名中直到 .(点) 或 _ (下划线) 的所有字符作为路由标识符。	编辑	启用
正在运行	计划程序	计划程序按固定间隔触发路由。每个作业在到达计划间隔时会发出一个运行路由的信号。	编辑	禁用
已停止	POP 监听器	监视 POP3 帐户并下载供 BIE 使用的消息。路由键必须定义为主题（内联文本）或文件名（附件）。	编辑	启用
已停止	FTP 目录监视器	监视远程 FTP 服务器上的目录以查找新文件。路由键将从文件名推断出来。	编辑	启用

邮件设置

这使您可以指定 BIE 通过电子邮件发送系统通知的位置。

邮件配置

邮件服务器

• 邮件服务器主机名 - 在此字段中输入您的 SMTP 服务器
• 最大通知消息大小（字节） - 默认值为 51200
• 系统电子邮件地址 - 在此字段中输入您的电子邮件地址
• 使用电子邮件身份验证 - 如果您的 SMTP 服务器需要身份验证凭据，请选中此框
• 身份验证用户名 - 您的 SMTP 用户名
• 身份验证密码 - 您的 SMTP 密码

在测试之前点击“保存”按钮。

测试邮件配置

运行此测试以查看 BIE 是否可以访问您的邮件服务器

• 输入电子邮件地址 - 在此处输入您的电子邮件地址

点击“运行测试”按钮。

JDBC 驱动程序

您可以使用 JDBC 驱动程序将数据库连接添加到 BIE。BIE 附带 MySQL（不适用于新版本的 MySql，例如：5.0）和 ODBC 驱动程序。如果您使用的是其他驱动程序，则必须添加相应的驱动程序。

Oracle

Oracle driver can be added as follows. 
 1.	Click on the System --> JDBC Drivers menu option
 2.	In the Manage JDBC Connections screen, click on “Register a Driver” link
 3.	In the “Register JDBC Driver” screen enter the parameters as follows
       a)	Driver Name : Oracle
       b)	Driver Class Name : oracle.jdbc.driver.OracleDriver
       c)	Driver Archive : ojdbc.jar 
       Click on the Register button.
 4.	Add a connection to the DUMMY schema as follows, Click on the Add Connection button against the newly registered      
       driver.
 5.	In the “Choose JDBC Driver” screen enter the values 
       a)	Select Driver :  Oracle (The driver that we added in the previous step)
       b)	Connection URL : jdbc:oracle:thin:@<HOSTNAME>:<PORT>:DUMMY
       Click on the continue button.
 6.    Set the connection properties as 
       a)  Connection Name: DUMMY
       b)  URL: jdbc:oracle:thin:@<HOSTNAME>:<PORT>:DUMMY
       c)  Username: username
       d)  Password: password
       Click on the “Save” button.
 7.	In the “Manage JDBC Connections” , we can find the newly added connection listed.
 8.    Click on the Test button next to the newly added connection .

MySQL

BIE 6.04 附带的 MySQL JDBC 驱动程序是 2.014 版，它似乎无法与 MySQL 4.1.7 版或更高版本一起使用。最新的稳定 MySQL JDBC 驱动程序是 3.1.13 版，您可以从 https://www.mysqlserver.cn/products/connector/j/ 下载。最新的驱动程序解决了将 BIE 连接到同一服务器上的 MySQL 的问题，但您可能需要在 MySQL 数据库的用户表中主机列中添加 localhost.localdomain。

PostgreSQL

您可以从 https://jdbc.postgresql.ac.cn/download.html 下载 PostgreSQL 驱动程序。

HSQLDB

BIE 使用内部 Hypersonic 数据库（现在称为 HSQLDB）来保存配置、状态和审计信息。参见

其他 JDBC 驱动程序

Chui's counterpoint 列出了许多 JDBC 驱动程序和 JDBC URL。

某些驱动程序（如 DB2）需要多个 jar 文件。如果是这样，只需为每个额外的 jar 文件创建一个虚拟驱动程序作为上传它的方法。您可能需要重新启动 BIE 服务，才能让它注意到新 jar 文件。

LDAP 连接

轻量级目录访问协议或 LDAP 是用于查询目录的协议。您可以在此处添加您公司的 LDAP 目录服务。

工作流

工作流

尝试运行工作流时常见的错误/问题是未提供启动消息。新添加工作流的默认配置是接收 InputMessage，消息格式为 StandardXML。因此，要启动工作流，您必须至少提供一个最小 xml 标签，例如：<ok/> 将格式更改为 StandardRaw 将解决此问题。

消息格式

BIE 只理解 XML，因此您必须在使用 BIE 之前将任何输入或输出表达为 XML 架构。如果您收到包含逗号分隔值（简称 CSV）的文件，BIE 可以帮助您生成必要的架构。

地图构建器 - 使用 XML 模式在应用程序之间移动数据

XML 模式表达共享词汇，并允许机器执行人们制定的规则。它们提供了一种定义 XML 文档结构、内容和语义的方法。

地图构建器是一个 Java 应用程序，它允许您加载输入模式和输出模式，然后使用拖放来建立从输入模式到输出模式的匹配字段之间的链接。一旦建立了链接，您可以向链接添加处理指令，例如数学运算、逻辑运算、字符串运算等等。

然后将地图保存为 XSLT 转换文件，这意味着它显示了如何将输入文档转换为输出文档。

测试地图

重要：在测试地图时，请不要使用包含逗号分隔值 (CSV) 的文件！将出现一个包含以下消息的错误框

Error
An unexpected error occurred.
Source:
Content is not allowed in prolog.

点击确定按钮关闭该框。

正确方法：使用 CSV 文件的 XML 版本。仪表盘可用于生成给定消息格式的正确解析的 XML 输出。复制并粘贴此解析的输出到一个文件中，并使用此文件在 Map Builder 中测试您的地图。有关详细信息，请参阅下面的教程。

教程

以下教程中做出了一些假设

• 您已阅读整个教程，并理解您自行承担风险遵循这些说明。
• 您对安装 BIE 的服务器拥有管理员或 root 权限。
• BIE 已启动。GNU/Linux 上的标准安装可以通过以下方式启动

/usr/local/BIE/bin/start.sh

• 您已登录仪表盘。无论平台如何，标准安装都会使仪表盘从服务器到您的浏览器在以下位置可用

https://127.0.0.1:5803/

给定用户名

admin

和密码

123qwe

• 您已启动地图构建器。GNU/Linux 上的标准安装可以通过以下方式启动

/usr/local/BIE/bin/map.sh

• 您有一个文本编辑器可用。

课时 1 - 从 CSV 到 XML

• 打开您的文本编辑器
• 输入或复制粘贴以下文本，确保它们之间有一个换行符（在第一行末尾按 Enter 或 Return 键）

MyName,MyAddress,MyPhone,MyCountry
Joe Schmoe,Anywhere Street Number 1,123-456-789,Anyplace on Earth

• 将文件另存为 Lesson1.CSV 到

/usr/local/BIE/translation/data

• 打开仪表盘，从顶部菜单中选择工作流，然后选择菜单项消息格式
• 在“配置”标题下，从下拉菜单中选择类型“分隔”，然后点击“添加新”按钮。
• 在“名称”字段中输入

Lesson1

• 将“处理标题”单选按钮设置为“开”
• 将根标签更改为

Lesson1

• 点击保存按钮。
• 在“配置”下的“格式”列中，您现在将看到一个名为 Lesson1 的链接 - 点击它。
• 现在将提供一个新的表单，名为“格式测试/模式生成”。
• 在“选择本地文件”字段中，输入或通过浏览按钮选择 Lesson1.CSV 的地址

/usr/local/BIE/translation/data/Lesson1.CSV

• 点击“运行格式化程序/生成器”按钮。
• 现在将提供一个新的三部分表单

• 生成的模式。给它命名为

Lesson1.xsd

在文本字段中。现在不要点击“保存到服务器”按钮。

• 解析的输出 - 一个 BIE 错别字，应该是解析的输出。选择解析的 XML 输出，复制并粘贴到文本编辑器中的一个新文件中。将文件另存为

Lesson1.xml

• 现在您可以点击“保存到服务器”按钮。我们这样做是为了避免浏览器的后退按钮问题。

• 打开地图构建器，点击左上角的“创建新地图”按钮。步骤概述在左侧，您可以选择

Lesson1.xsd

作为您的源模式，然后点击“下一步”按钮。

• 选择 Lesson1 作为源模式的根元素，然后点击“下一步”按钮
• 通过点击“下一步”按钮，为源包含/导入选择建议的文件名作为基本路径
• 选择

Lesson1.xsd

作为您的目标模式。是的，它是一样的，但对于本课的目的，它将起作用。点击“下一步”按钮。

• 选择 Lesson1 作为目标模式的根元素，然后点击“下一步”按钮。
• 通过点击“下一步”按钮，为源包含/导入选择建议的文件名作为基本路径
• 将地图文件保存到地图文件夹中，文件名是

Lesson12Lesson1.xml

通过点击“完成”按钮。

• 地图已加载，左侧是源模式的字段，右侧是目标模式的字段。
• 点击源模式的行图标，并在将鼠标按钮移到目标模式的行图标之前按住鼠标按钮，然后放开鼠标按钮。您现在应该在两个模式之间看到一个蓝色链接。
• 重复链接过程 - MyName 到 MyName、MyAddress 到 MyAddress、MyPhone 到 MyPhone、MyCountry 到 MyCountry。
• 从工具栏中点击“编译 XSLT”按钮。
• 点击“测试 XSLT 转换”按钮，选择

Lesson1.xml

• “保存结果”对话框打开，将文件名更改为

Lesson1_transformed.xml

然后点击“保存”按钮。

• 打开您的文本编辑器，加载文件

Lesson1_transformed.xml

您应该看到源字段中的数据已准确地映射到目标字段。

• 右键点击源模式中的 MyName 字段，选择“取消链接”。对 MyAddress 也执行相同的操作。
• 现在将源字段 MyName 链接到目标字段 MyAddress。将源字段 MyAddress 链接到目标字段 MyName。
• 保存新地图。
• 编译新地图。
• 使用

Lesson1.xml

作为源文件测试 XSLT 转换，并将结果保存为 Lesson1_transformed_again.xml

• 打开

Lesson1_transformed_again.xml

在您的文本编辑器中。您应该看到 Joe Schmoe 现在位于 MyAddress 字段中，而他的地址已成为他的姓名。

课时 1 现在结束了。您应该尝试使用 BIE 来找出什么有效或无效。回到这里，创建新的课时。:-)

课时 2 - 创建工作流

在课时 1 中，您学习了如何在 Map Builder 中创建从一个 XML 模式到另一个 XML 模式的映射，以及如何测试转换。BIE 的目的是自动化这些映射，这也是我们在本课时中要做的。这次我们将主要在仪表盘中工作，创建工作流。

待续... 在此期间，请查看 JonesPubPO 工作流。

第 X 课 - 设置加密文档的 EDI

未来课程的想法

医疗保健专业人员使用加密的 XML 模式以电子方式交换敏感的患者信息。转介和报告每天成千上万地运输。本课程将描述 GNU Privacy Guard、也许是 Idealx X.509 证书颁发机构和 BIE 的用途。

参考资料

• http://bie.sf.net/
• http://bie.sourceforge.net/
• http://sf.net/projects/bie
• http://sourceforge.net/projects/bie
• http://www.brunswickwdi.com/bie
• http://www.whitemiceconsulting.com/taxonomy/term/13
• http://www.whitemiceconsulting.com/node/56
• http://www.whitemiceconsulting.com/node/78 - 重置帐户的 BIE 密码
• http://www.redberri.com/redberri/index.do
• http://biewiki.schtuff.com/
• http://www.adaptivedynamics.net/index.pl/faq
• http://ixdb.de/business_integration.html - 一些针对 MAP Builder 的补丁

BIE-gpl 参考资料

• http://www.bie-gpl.org/
• http://sourceforge.net/projects/bie-gpl/