業務整合引擎

這是對布倫瑞克的業務整合引擎 - 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://: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://mysql.com.tw/products/connector/j/ 下載。最新的驅動程式解決了將 BIE 連線到同一伺服器上的 MySQL 的問題，但您可能需要在 MySQL 資料庫的使用者表中主機列中新增 localhost.localdomain。

PostgreSQL

您可以從 http://jdbc.postgresql.org/download.html 下載 PostgreSQL 驅動程式。

HSQLDB

BIE 使用內部 Hypersonic 資料庫（現在稱為 HSQLDB）來儲存配置、狀態和審計資訊。參見

其他 JDBC 驅動程式

Chui's counterpoint 列出了許多 JDBC 驅動程式和 JDBC URL。

某些驅動程式（如 DB2）需要多個 jar 檔案。如果是這樣，只需為每個額外的 jar 檔案建立一個虛擬驅動程式作為上傳它的方法。您可能需要重新啟動 BIE 服務，才能讓它注意到新 jar 檔案。

LDAP 連線

輕量級目錄訪問協議或 LDAP 是用於查詢目錄的協議。您可以在此處新增您公司的 LDAP 目錄服務。

Web 服務

工作流

嘗試執行工作流時常見的錯誤/問題是未提供啟動訊息。新新增工作流的預設配置是接收 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://: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 工作流。

第 3 課 - 驗證輸入是否符合 DTD

第 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 參考資料