开篇-BIE入门(如果有点生硬请品评),格式是GOOLE的错,无法排版
benbenbie
本手稿的目的是通过BIE软件系统方便与管理基于E时代的电子文档资料，熟悉BIE的组成结构：
1. 识别BIE的主要组成。
2. 分解BIE的组成：输入、过程和输出。但是输入和输出是简单的文件和参数，过程部分是复杂的。
适用对象
适用与两种读者，一部分章节适用于系统管理员，一部分适用于过程实施人员，他主要是创建过程，建造映射，更新文档资料到系统。
概览
WDI的
业务整合引擎（BIE）是一个基于E时代的业务整合中间件来在两个不同的业务环境中完成传输和转换文档资料格式，允许文档和协议同时进行实时转换。
BIE
允许在不同的业务单元、他的客户、供应商、卖主、之间进行电子文档交换，而屏蔽了底层复杂的的技术。BIE的隐藏了复杂的不同平台、多种协议、多种系统之间不同合作伙伴进行无缝的文档流交换。
BIE的逻辑组成主要有以下组成：
服务器和客户端的窃听器
事务管理（日志和归档）
通知管理
转换
解析
确认和序列化服务
安全级别
全体对象存储仓库
客户初试化一个事务是发送一个文档到本系统，此文档是基于其内部的数据格式（如采购订单），使用客户自己定义的通信传达方法，发给BIE窃听器，来初试化一个事务。
一个窃听代理是一个有能力初试化转换请求的应用程序接口。每一个注册的用户有一个BIE内部的实体来传送和转换文档信息通过路由ID-唯一一个转换信息对独立的请求，BIE服务是基于JAVA的APPLET和SERVLETS运行在JAVA虚拟机上，BIE窃听器在处理之前将转换文档到入站队列的存储中（存放在内存中）。
BIE窃听器组成部分：
FTP协议
基于WEB的服务组成
" WEB SERVICES 客户端
" 简单的SOAP协议，一个基于RPC的跨平台应用到应用通信的的方法，SOAP依赖于XML语言来定义格式在HTTP窃听器上。
" JSP服务页面-基于JSP技术，简单的文件系统通信（基于目录）-客户端发送信息到信息可以打开处理的文件目录。
一个客户根据自己的平台定义，或许使用上面的信息格式来与BIE系统通信，另外除了上述的格式，下面的格式也被计划使用
简单的邮件传送协议（SMTP），允许标准的EMAIL通信
JMS通信
SSH/SCP-安全的登录方法
WEBDAV（扩展的HTTP）
企业级别JAVABEANS（EJB）
传送和转换过程是当一条记录从BIE客户端发送到服务器端时初试化的。这条记录包含了文档和唯一一个路由KEY。一个BIE逻辑读线程队列对象并选中这条记录，BIE引擎内部逻辑执行路由表查询，路由表包含了客户定义的硬编码实体，基于XML解析SCHEMA的转换映射路由ID被存储。（参阅映射和定制映射）。路由表逻辑是选择合适的解析器，一个基于XML转换的SCHEMA，来转换客户文档格式到一般的，正常文本-
映射数据元素适当的位置。
解析器的工作是翻译文档格式到一个简单的XML代码，一个XML字集，XSLT（扩展的样式语言）是用来使XML元素匹配到另一个文档格式的分析连接规则。允许创建合适的定制映射转换规则，采用拖拽的图形化界面，他的输出则是每一个路由寻找过程的结果，解析器存储在一个通用的对象中。
一个通用的对象是一个JAVA对象严密的描述了一个客户定义的文档但是非单独一个文件使用的，是标准的格式。一个通用的对象存放在容器仓库中对最后一次使用的。在这一点上通用的对象能够转换从一个一般的格式到一个文档需要接收的格式。
这个过程有下面两步：
为了合适的协议返回路由表（通常是BIE到BIE分布式架构）或另外一种转换，这种转换过程可以反向最终到了最终客户定义的标准格式。转换状态和错误信息的日志和归档被转换管理控制，它一直写适合的信息到BIE数据库中并可在前台浏览器中查阅。
逻辑流
1. 客户端发送请求到服务端窃听器。
2. 服务端窃听器通过端口接收请求。
3.
服务端应用程序接口窃听器建立服务端请求对象，并包含如下主要信息：
a. 路由KEY
b. 信息ID
4.
服务端请求对象通过服务端应用程序接口传送给BIE。
5.
服务端应用程序接口建立并初试化线程池任务对象：
a. 获取任务的信息ID
b.获取任务的系统信息ID
c. 注册且事务管理任务队列
6.
线程池管理将任务放入线程池队列（在内存）并且采用先进先出的服务逻辑。
执行
7.
运行第一阶段转换（将所有同一种客户A格式的信息转换为一个统一对象）。
8. 转换管理将记录统一对象的日志。
9. 第二阶段转换
(统一对象转换为所有同一种B格式的信息)。
10.转换管理将记录统一对象的日志。
11.建立客户端请求对象并使用客户端API发送到目的地址。
12.传递客户端请求对象到客户端窃听器
a. 客户端对象包含：
i. 路由KEY (用于下一个BIE系统)
ii. 目的地址 (FTP# - -)
iii. 信息ID(系统生成)
iv. 信息 (转换的文档资料)
13.客户端窃听器连接，发送请求，等待回应。
14.建立客户端回应对象。
15.返回到执行。
16.事务管理记录客户端回应。
17.运行第三阶段转换（建立一个统一对象从回应的信息中）。
18.事务管理将记录统一对象。
19.运行第四阶段转换
(统一对象转换为所有的客户A格式)。
20.事务管理将记录统一对象日志。
21.回应信息到服务端API(得到信息或新文档确认)。
22.服务端API返回服务回应对象到FTP窃听器。
23.FTP窃听器返回最初的请求客户端。
24.TCP/IP 协议确认。
例子演示
作为简单的使用BIE，它仍然是是一复杂的系统。开始是很具有挑战性的。在此演示一下BIE的威力，也能快速使用BIE提供可能，在开始前有几个事情需要注意，着并不意味全部理解了该向导，如果您获取了给BIE文档且假定您下载并安装了最新的版本。
熟悉BIE自己
首先先熟悉一下BIE和它的主要组成。
花几分钟熟悉BIE的控制台，主要的关心一下配置和报表标题的导航栏，
不需要知道它怎么用，主要是知道如何快速招找到他们。
过程
为了使用BIE，我们准备了一个业务过程，在这个例子中，我们创建了一个虚拟的采购订单事务在Jones
出版社和Smith 印刷厂. Jones 出版社想发送一个订单给
Smith印刷厂来得到即将来临的发行的书原料。
下面这T个过程最少需要下面的流程:
1. Jones 出版社将生成一采购订单 (PO) 作为逗号分隔的
(CSV) 文件.
2. 这个 PO 将输入到Smith
出版社的BIE的服务器端浏览器上。
3. 这 PO将转换从 Smith 印刷厂的 PO 格式到 Smith
印刷厂的订单格式, 这需要定制XML格式.
4. 这个顺序是处理从内部系统到 Smith 印刷厂来处理.
文档和转换
一旦您知道过程的样子，则需要定义文档的映射在两个格式之间。对于便于理解我们看一下BIE
MAP BUILDER来创建两个格式的映射，在 Windows 您可发现
c:\bie\bin\mapper.exe 在 Linux和UNIX 环境下它在
/usr/local/bie/bin/map.sh.一旦您打开 Map Builder,单击
图标则可看到工具栏. 当提示选择Jones2Smith.xml
和单击打开按钮装载映射.根据系统或许需要几分钟装载映射，装载完后，则显示如下
. ? 注意左边的是 CSV 格式的Jones 出版社的,
它是文本的.右边的是XML文档格式 Smith
印刷厂的，它有很多层次 .
这一行在两边表示各自的字段，映射从一边您可简单的单击这个字段在左边，然后用鼠标拖到右边。做完后可以编译则可生成实际的XSL.
文档解析
BIE
不能转换或处理任何除XML外的东西，因此每一个文档必须转换为XML。幸运的是
BIE
有一定数量的文档解析器内置执行不同格式与XML之间。
打开BIE 控制台，登录并点击开 "Message Formats" 页在
"Configurations" 下。
您会注意到一些信息格式列表（文档解析器）已经配置好，包括PO_CSV。
点击PO_CSV
文档从配置列表中，它出现一个新的页面，注意它有一定数量的配置参数，每一种类型的信息格式有自己的参数集合，一个详细的信息格式和他的参数可以参见
BIE
文档，我们已经配置好一切对于这个例子，我们继续往下做。
映射
我们已经讨论了一些创建映射采用 map
builder，但是为了使用BIE 来映射,
必须有复制件。如果开发映射在服务器端则已经安装了，否则则需要在BIE控制台点击"Configurations"下的
"Manage Maps" 连接中上传。
注意此例中已经上传了映射 "Jones2Smith"。
路由
路由，或业务过程是定义BIE的路由创建器. 点击
"Routes" 连接，在 "Configurations"
可以看到安装在系统中的路由列表,
以及他们是否启用和没有启用，您可看JonesPubPO
路由，点击它您可处理路由创建器。
您看到一个可视的过程，这一些灰色的圆形盒子在左边代表处理过程，独立的圆形的盒子为动作，这右边正方形的的盒子为文档被处理在特定的动作下，并且右边的文档的图标代表实际发生时文档。
来讨论一下例子的路由，首先接收一个叫
"Jones_CSV"的文档,
它初试化或触发路由，下一步记录进来的文档于并有了拷贝便于以后来诊断问题，这时转换
Jones PO 到 Smith Order 使用我们早期讨论的映射
.下一步我们记录一转换后的拷贝，便于我们诊断问题需要.
这时写这个 Jones Order 到文件系统.
最终我们告诉BIE将发送一个原始的文档返回发送者。
在这些步骤中我们写 Jones Order
到系统，我们可替代的插入数据货物发送它通过 web
service
应用或复制通过FTP传输，因系统没有测试外部系统连接，我们可以选择加入动作，当然在最后一个动作，我们也可定义路由返回原始文档给发送者，我们忽略了。
在大多数协议中，我们需要实时地反馈。
启动示例
我们已经覆盖了基本的组成部分，让我们演示一下BIE的动作。首先，假定您还在路由创建器界面，滚动页面，点击
"enable"，这就告诉BIE
期望开始使用该路由接收请求。现在点击"Listeners"在
"Configurations"菜单中。点击Watched Directory listener Enable
，并且设置内部间隔为5秒。类型为自动"Startup Type" 为
Automatic。当然也可设置监控的目录，最后点击保存"save"按钮，在改变设置后，需要重新启动BIE，在Windows上重新启动服务。在
UNIX上需要在命令行上停止并重新启动服务。
运行 Demo
运行 demo 我们首先需要得到 Jones 采购订单文档。
可以在BIE安装的translation/data目录下发现。在 UNIX
风格的系统可以在/usr/local/bie/translation/data/JonesPubPO.csv
发现，在 Windows
环境下可以在c：\bie\translation\data\JonesPubPO.csv发现，将
JonesPO.csv 文件名称修改为
Jones2Smith.csv。我们这样做是为了告诉BIE应该采用
Jones2Smith
路由，如果我们想加入自己的识别符在文件中，我们可以将文件修改为Jones2Smith_foobar.csv(在此例子中为了演示建议不做修改)。
BIE 有能力接收多种协议包括 FTP、web services、
HTTP、HTTPS,
并监控接收的目录。对于这个例子，我们将使用系统监控的目录。更详细窃听器的信息可以在BIE文档中发现，
因此我们将放置我们的文件到监控目录，我们需要告诉BIE那个路由将要运行，路由以文件名称来识别，注意文件的文件名称和路由一样，我们期望这样做会更好一些，
BIE 使用文件名称中点和下划线来识别路由，
JonesPubPO.csv
毜已经包含了路由识别符，我们继续下一步，
现在我们需要拷贝文件到监控目录，并注意最后一步。除非您改变了，否则在
data/filesystem/watch folder 目录下，在UNIX
风格的在/usr/local/bie/data/filesystem/watch目录，在
Windows环境下将在c:\bie\data\filesystem\watch目录下发现，在5秒内（因我们告诉BIE在5秒内检查文档），BIE将捡取文档并处理它。
结果
现在我们使用BIE处理文档，我们最终发现我们的劳动成果，让我们看一下BIE将成功处理后监控目录删除的文档，我们可以data/filesystem/out
目录中结果发现该文档，在 UNIX风格下系统目录为：
/usr/local/bie/data/filesystem/out
在Windows 环境下目录是:
c:\bie\data\filesystem\out
我们打开该文档资料来验证是否是XML格。我们可以打开控制台中"Reports"菜单下的"Transactions"，可以看到BIE已经记录一些事务日志，可以看到一个事务ID为1000的，点击该事务ID，可以看到详细的内容，初始化时进来的文档，应该可以看到逗号分隔的文本字段信息，点击第二阶段可以看到一清楚的XML。
总结
您已经完成了简单的技术了解，您可以重新回顾任何不清楚的一部分，因您已经看到整个动作的过程，您可以通过一个简单的过程，看到BIE的强大的功能。
