安裝和設定適用於企業應用程式的 Microsoft BizTalk 配接器

發行項
02/13/2024

Microsoft BizTalk Adapters for Enterprise Applications 包含下列配接器：

Microsoft BizTalk Adapter for JD Edwards OneWorld
Microsoft BizTalk Adapter for JD Edwards EnterpriseOne
Microsoft BizTalk Adapter for PeopleSoft Enterprise
Microsoft BizTalk Adapter for TIBCO Rendezvous
Microsoft BizTalk Adapter for TIBCO Enterprise Message Service

重要

在您進行任何設定變更之前，請先備份所有數據。
您必須有使用特定企業應用程式的經驗，才能進行任何組態變更。

支援的版本 & 需求

元件	規格需求
作業系統	配接器支援與 BizTalk Server 相同的 OS： BizTalk Server 2020 需求 BizTalk Server 2016 需求 BizTalk Server 2013 R2 / 2013 需求
支援的企業系統	BizTalk Server 2020 舊版
JD Edwards OneWorld XE	Windows 上的 JD Edwards Enterprise 伺服器 Windows 上的 JD Edwards 部署伺服器
JD Edwards EnterpriseOne	配接器會呼叫使用 JDBC 的 JD Edwards EnterpriseOne API，此 API 需要資料庫的驅動程式。如果您使用 SQL 資料庫安裝 JD Edwards EnterpriseOne，則需要 MS-SQL 驅動程式。同樣地，如果您使用 Oracle 資料庫安裝 JD Edwards EnterpriseOne，則需要 Oracle 驅動程式;或者，如果您使用 DB2 資料庫安裝，則需要 DB2 驅動程式。
PeopleSoft Enterprise	Sun Systems Java Development Kit (JDK) PeopleSoft 工具版本 PeopleSoft 應用程式版本此配接器需要修改 PeopleSoft 應用程式。若要使用元件介面，請將自定義元件介面GET_CI_INFO上傳至 PeopleSoft。 GET_CI_INFO.pc 位於 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise (r) \Config 中。
TIBCO Rendezvous	必須在 BizTalk Adapter for TIBCO Rendezvous 執行所在的電腦上安裝 TIBCO Rendezvous 運行時間元件必須在 BizTalk Adapter for TIBCO Rendezvous 執行所在的電腦上設定 TIBCO Rendezvous 授權。配接器必須能夠看到 TIBCO Rendezvous 二進位檔目錄：在環境變數 PATH 值中，或在 BizTalk Server 中的每個 Rendezvous 連接埠上指定。這對於 Rendezvous 組件尋找其程式庫和可執行檔是必要的。
TIBCO Enterprise Message Service	Enterprise Message Service (EMS) 5.x 及更新版本包括用戶端 SDK (使用 TIBCO EMS C# API)。 BizTalk Adapter for TIBCO EMS 會使用此配接器與伺服器通訊。

JD Edwards OneWorld XE

本節包含搭配使用 Microsoft BizTalk Adapter for JD Edwards OneWorld XE 搭配 BizTalk Server 的重要資訊。

建立 JAR 檔案

本節說明 JD Edwards OneWorld 搭配 Microsoft BizTalk Adapter for JD Edwards OneWorld 使用的需求。

JAR 檔案和 CLASSPATH

JD Edwards OneWorld JAR 檔案必須可供配接器使用。例如，若要連線到 B7.3.3.3 版本，則需要下列 jar 檔案。視您連線的伺服器而定，jar 檔案清單可能會變更：

Connector.jar
Kernel.jar

這些檔案位於 JD Edwards OneWorld 執行所在的電腦上，位置如下：

JD Edwards OneWorld XE_install_Directory\System\classes\Connector.jar
JD Edwards OneWorld XE_install_Directory\System\classs\Kernel.jar

您可以將這些檔案複製到任何位置；不過，您必須在 CLASSPATH 中指定 JAR 檔案的位置。 CLASSPATH 必須包含 JAR 檔案的完整檔案路徑和名稱 (以分號分隔)。

BizTalk Adapter for JD Edwards OneWorld 提供 JDEJAccess JAR 檔案，以搭配 JD Edwards OneWorld 使用。根據預設，會從 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D 參考JDEJAccess.jar檔案。Edwards OneWorld (r) \classs\JDEJAccess.jar。

注意

您必須確認已註冊 jdeinterop.ini 檔案，才能使用 BizTalk Adapter for JD Edwards OneWorld。當您在 BizTalk Server 中建立傳送埠時，請務必在 JDE 傳輸屬性頁面中包含此檔案的路徑。 For a complete explanation, see "Customize the jdeinterop.ini File."

建立BTSLIBinterop.jar檔案

建立檔案，並確認該檔案可由配接器存取。使用下列範例作為指南：

建立包含下列程式碼的 BTSLIB.cmd 檔案：

define library BTSLIB
login
library BTSLIB
interface JDEAdapter
import B5500900
build
logout

執行以下命令：
```
GenJava  /cmd  .\BTSLIB.cmd
```

確認您的設定

使用支援的版本，包括 Service Pack 號碼 (支援的企業營運 (LOB) 和企業系統) 。 Service Pack (ESU 和 ASU) 更新系統二進位檔。必要的 Service Pack 提供匯入的 ASU/ESU 功能表選項。
如果磁碟驅動器與磁碟驅動器 C 不同，請將 jdeinterop.ini 檔案設定為使用正確的磁碟驅動器進行記錄。例如，如果 TEMP 目錄空間不足，JD Edwards OneWorld 更新可能會失敗。
判斷是否必須針對 JD Edwards OneWorld 欄位的左/右邊框距離加入組態檔。
確認您的 JAVA_HOME 環境變數指向 Java Development Kit (JDK) 安裝，以便從電腦上的任何程式啟用 javac 和 java 命令。
確認已設定 CLASSPATH 環境變數。這可讓 BizTalk Adapter for JD Edwards OneWorld 找出Kernel.jar和Connect.jar檔案。

JAR 檔案的路徑會區分大小寫。
輸入下列區分大小寫的命令來測試環境。
```
javap -s -p com.microsoft.jde.JDEJAccess
```

您提供的命令 javap 是 Java 類別檔案解譯器：

http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javap.html

命令 javap 會反組譯類別檔案。其輸出取決於所使用的選項。如果未使用任何選項，javap 會列印傳遞給它之類別的封裝、受保護和公用欄位和方法。javap 會將其輸出列印至 stdout。

如果沒有任何錯誤，所有 Java 檔案和其相依性會在 CLASSPATH 中。
使用 JD Edwards OneWorld 系統的伺服器名稱，設定本機主機檔案 (C：\WINNT\system32\drivers\etc\hosts) 來設定 DNS 解析。

建立並安裝自定義套件

安裝 BTSREL 自定義套件以使用 BizTalk Adapter for JD Edwards OneWorld。本章節內容：

JD Edwards OneWorld 自定義套件建立程式
如何建立及安裝 BTSREL
在 JD Edwards OneWorld 中建立的 BTSREL 物件

注意

BTSREL.exe 是自訂封裝 (以 JD Edwards OneWorld 術語表示則為自動軟體更新或 ASU)。其中包含可擷取中繼資料的商務功能。您應該針對特定的 JD Edwards OneWorld 組態和版本來建立自訂封裝。

定義自定義套件

自訂封裝是發行後交付項目，針對特定目的提供軟體變更，例如法規變更或增強功能。這些自訂封裝會針對特定功能加以建立。例如，為了擷取中繼資料而建立 BTSREL。安裝 BTSREL 自訂封裝之後，該封裝會更新 JD Edwards OneWorld 環境中所選取的模組。若要更新，您必須將 BTSREL 物件併入適當的 JD Edwards OneWorld 環境中。如需 BTSREL 所更新之模組的詳細清單，請參閱模組清單。

安裝 BTSREL 自定義套件

下載 BTSREL。將其安裝在部署伺服器上，然後將它部署至企業伺服器。

現有的 BTSREL.exe 封裝可直接用於 B7333 版本。若要讓套件與 B7334 版本搭配使用，則：

下載並將 BTSREL.exe 的內容解壓縮到工作資料夾。
將 ReleaseLevelRequired 和 Release 值修改為 Deployment.Inf 檔案中的 B7334。
執行安裝程式。

若要安裝 BTSREL，需要下列專案：
- 部署伺服器安裝
- Workbench 安裝

在部署伺服器上安裝 BTSREL

自定義套件僅適用於 Windows 作業系統，而且會與部署伺服器搭配使用。它必須建置在部署伺服器上，然後部署至企業伺服器。企業伺服器通常是實際執行伺服器，可以位於 Windows 或 UNIX 作業系統上。

注意

將 ASU 套用至 JD Edwards OneWorld 部署伺服器時，請確認您處於更新模式。 Proof 模式會確認 ASU 中沒有任何 Bug，而當您套用 ASU 時，會指定更新模式。

以使用者 JDE 身分登入部署伺服器。
在部署伺服器 (根目錄) 的 /B7 資料夾中，建立新的資料夾 BTSREL。
將 BTSREL.exe 複製到新建立的 BTSREL 資料夾。
從 .../B7/BTSREL 資料夾執行 BTSREL.exe。安裝管理員會自動啟動。
在安裝視窗中，選取 [ 下一步]，然後選取 [ 完成]。如果安裝成功，會顯示一則訊息。
以 JD Edwards OneWorld 部署伺服器上的 JDE 使用者身分登入JDEPLAN 環境。
1. 如果未在系統上安裝包含 SAR #4533357 的電子軟體更新 (ESU) ，請從 [系統安裝工具] 功能選取 [軟體匯報]， (GH9612) 。
2. 在 [ 處理選項 ] 面板中，針對選項 1 輸入 02。
3. 如果系統上已安裝包含 SAR #4533357的 ESU，請從 [系統安裝工具] 選單選取 [應用程式軟體更新]， (GH9612) 。

在 JD Edwards OneWorld WorkBench 上安裝 BTSREL

在 [ 使用應用程式更新] 畫面上，按兩下 BTSREL 更新，然後選取[ 下一步]。
按兩下您要安裝更新的環境，然後選取[ 下一步]。
1. 如果您想要以自動模式執行軟體更新，請檢查自動 工作臺 。
2. 如果您想要備份規格 (，請選取 [ 備份 ]，以便還原原始規格) 。
在 [ 使用安裝方案 ] 畫面上，選取您要安裝的更新計劃，然後 選取 [ 選取]。
安裝完成之後，請查看自動產生的 PDF 是否有任何錯誤。

注意

如果發生錯誤，請參閱「JD Edwards OneWorld 軟體更新指南」中的疑難排解秘訣，或直接連絡 JD Edwards OneWorld。
使用本節中「手動註冊商務函式連結庫」中包含的步驟，手動註冊商務函式連結庫。

卸載自定義套件

解除安裝自訂封裝沒有任何需求。不過，如果您想要清理系統，您可以使用不同的方式來解除安裝。卸載之後，請使用下列其中一種方法重建套件：

使用 JD Edwards OneWorld 部署伺服器 Gh8612 — P96470，在 [數據列 ] 功能表上選取 [ 更新]，然後選取 [ 卸載]。
核取並刪除用戶端電腦上的所有自訂物件 (BTSREL)。
套用先前的資料庫快照集。

在清除期間，確認 JD Edwards OneWorld 的其他物件是否有任何其他修改。

手動註冊商務功能連結庫

由於 JD Edwards OneWorld 產品封裝程序的限制，您必須向 JD Edwards OneWorld 手動註冊 BizTalk Adapter for JD Edwards OneWorld 的自訂商務功能程式庫 DLL。此程式包含下列步驟。

步驟 1：建立自定義商務功能連結庫

使用 JD Edwards OneWorld Object Management Workbench (OMW) 建立自訂商務功能程式庫。必須在初始設定上執行下列程式，並適用於所有平臺。

啟動物件管理 Workbench (快速路徑：「OMW」或選單選取範圍：GH902 物件：P98220) 。
選取 [新增]，然後選取 商務函式連結庫的選項。
輸入新商務功能程式庫物件的下列資訊：
- 名字： ACBLIB
- 描述： Microsoft DLL
- 產品代碼： 55
- 產品系統代碼： 55
選取 [確定]。

步驟 2：從部署伺服器重建連結庫

針對每個平臺的初始設定完成下列步驟。

若要以獨立模式啟動 BusBuild 程式，請選取 [ 開始]、選取 [ 執行]，然後選取 [busbuild.exe]。
在 pathcode (PY7333、PD7333 或 DV7333) 登入 JD Edwards OneWorld。
在 [重建連結庫 ] 列表中，選取 [建置]。

步驟 3：複製自定義 DLL

將自定義 DLL 從 pathcode 目錄複製到 JD Edwards OneWorld 部署伺服器和 JD Edwards OneWorld Enterprise Server 上的父封裝目錄。

在 JD Edwards OneWorld XE 部署伺服器上

將 ACBLIB.dll 從 DV7333\bin32 複製到 DV7333\Packages\DV7333FA\bin32。
將 ACBLIB.def、ACBLIB.dmp 和 ACBLIB.mak 從 DV7333\obj 資料夾複製到 DV7333\Packages\DV7333FA\obj 資料夾。
將 ACBLIB.exp、ACBLIB.lib 和 sACBLIB.lib 從 DV7333\lib32 資料夾複製到 DV7333\Packages\DV7333FA\lib32 資料夾。

在 JD Edwards OneWorld Enterprise Server 上

建立每個目錄和檔案之後，確認授權。

在 DV7333FA\obj\ 下建立目錄 ACBLIB。
在 DV7333FA\source 底下建立目錄 ACBLIB。
將 b5500900.c 從部署伺服器的 DV7333\source 目錄傳送至 DV7333FA\source\ACBLIB 目錄。
FTP b5500900.h 從部署伺服器 DV7333\include 目錄到 DV7333FA\include 目錄。

步驟 4：建置完整套件

由於 JD Edwards 套件建置程式的限制，因此針對套用 BTSREL 更新的環境建置完整套件，或更新套件組建無法正常運作。請參閱 JD Edwards 說明，以了解如何建置完整封裝組建。

注意

當您套用 JD Edwards OneWorld ASU/ESU 時，ASU/ESU 通常不會建立新的程式庫和商務功能。因此，此程式很簡單：不過，BizTalk Adapter for JD Edwards OneWorld 自定義套件會建立新的連結庫。因此，您必須執行額外的步驟，例如手動建立目錄並執行完整套件組建。

模組清單

BTSREL 自定義套件會在 JD Edwards OneWorld 中建立下列物件。 BTSREL 包含可擷取中繼資料的商務功能，以及可測試資料類型的自訂功能。

注意

JD Edwards OneWorld 更新有一個 Bug。如果您沒有所有商務和自定義函式，請確認完整套件組建已完成，而不是更新套件組建。

如果您遺漏清單中的檔案，例如，如果您具有 ACBTEST 下方的所有檔案但遺漏上方的檔案，則可能遺漏「資料字典」(DD) 項目。您可以移至 [使用數據項 ]，並尋找遺漏的檔案。

如果您遺漏其他專案，例如ACBCHAR01、ACBDATE01、ADBINT01、ACBMATH01和ACBSTR01，這些是 主要數據元素。當您合併從規劃到開發的物件時，會在背景執行許多報表。您可以開啟合併報表並尋找是否有任何錯誤。報表應該列出所有項目，並指出已完成且沒有任何錯誤或警告。透過這項驗證，由於所有項目都已計入，因此您可以繼續進行。

ACBCHAR01 - 測試 CHAR 類型 01
ACBCUST - ACB 客戶識別碼
ACBDATE01 - 測試日期類型 01
ACBDEF - ACB 功能類型定義
ACBFCNT - ACB 功能名稱清單計數
ACBFUNC - ACB 函式名稱清單
ACBFUNCN - ACB 函式名稱
ACBINT01 - 測試整數類型 01
ACBLIB - 控制 BROKER 程式庫
ACBMATH01 - 測試數學類型 01
ACBNEWS - ACB 新狀態
ACBORDER - ACB 訂單號碼
ACBPRC - ACB 項目價格
ACBPROD - ACB 產品識別碼
ACBQTY - ACB 項目數量
ACBRES - ACB 結果指標
ACBSTAT - ACB 狀態
ACBSTR01 - 測試字串類型 01
ACBTEST - ACB 測試畫面
ACBTEST2 - ACB 測試畫面 2
ACBTEST3 - ACB 測試畫面 3
B5500900 - 控制 BROKER 支援模組
D5500900 - CONTROL BROKER 數據結構
D5500900A - CONTROL BROKER 數據結構
D5500900B - 擷取價格數據結構
D5500900C - 取得客戶狀態資料結構
D5500900D - 設定客戶狀態數據結構
D5500900E - 更新銷售訂單狀態數據結構
D5500900F - 測試整數
D5500900G - 測試字串
D5500900H - 測試日期
D5500900I - TEST CHAR
D5500900J - 測試數學數值
D5500900K - 測試日期 2

自訂 jdeinterop.ini 檔案

Connector.jar 和 Kernel.jar 中的 JD Edwards OneWorld XE 連接器類別要求您使用 jdeinterop.ini 組態檔。此檔案是由 JD Edwards OneWorld 軟體所定義，並使用其術語。 JD Edwards 互操作性指南 Release OneWorld 可能會提供有關此檔案用途和術語的詳細資訊。中有範例 jdeinterop.ini 檔案 <Adapter_Installation>\config\jde。

更新 jdeinterop.ini，以符合您在 [ 傳輸屬性 ] 畫面中定義的參數值。如果其參數相容，則多個 JD Edwards OneWorld 邏輯系統可以共用同一個 jdeinterop.ini 檔案。一般而言，如果兩個邏輯系統指向兩個不同的 JD Edwards OneWorld 計算機，則需要兩個不同的 jdeinterop.ini 複本。

注意

jdeinterop.ini 中的記錄應該關閉，而且可以安全地忽略各種記錄檔的參數。

下表逐項列出位於 jdeinterop.ini 檔案中的設定，並依區段分組其資訊。例如，[JDENET] 等區段會依其在 JD Edwards OneWorld 軟體中出現的順序列出。

jdeinterop.ini 檔案設定

區段	參數和描述
[JDENET]	EnterpriseServerTimeout。企業伺服器要求的逾時值，以毫秒為單位。默認大小為120000。 maxPoolSize。 JDENET 通訊端連接集區大小。默認大小為 30。
[SERVER]	glossaryTextServer。提供詞彙文字資訊的企業伺服器和連接埠。這是傳回錯誤文字描述的伺服器。通常是與 JD Edwards OneWorld 應用程式伺服器相同的主機和連接埠。為了支援不同的語言編碼，可能會有多個詞彙伺服器。例如，JDED:6010 或 actsrv1:6009。這些值必須符合在 [系統定義] 中設定的值。 codePage。編碼配置。預設值為 1252。 - 1252 英文和西歐 - 932 日文 - 950 繁體中文 - 936 簡體中文 - 949 韓文
[LOGS]	log= c:\jas.log。記錄檔的位置。您可以放心地略過這個參數。 debuglog= c:\jasdebug.log。偵錯記錄檔的位置。您可以放心地略過這個參數。偵錯。判斷是否開啟 JDENET 偵錯功能。預設值為 FALSE。
[DEBUG]	JobFile= c:\Interop.log。錯誤檔的位置。您可以放心地略過這個參數。 DebugFile= c：\InteropDebug.log。偵錯檔案的位置。您可以放心地略過這個參數。 log= c:\net.log。記錄檔的位置。您可以放心地略過這個參數。 debugLevel= 0 - 12。偵錯層級。您可以放心地略過這個參數。這會定義指定記錄檔中 COM 連接器和 Callobject 元件所提供的追蹤層級，僅適用於 COM 伺服器。 - 0 無。關閉記錄功能並僅將錯誤寫入 JobFile。 - 2 錯誤 (錯誤訊息) - 4 (例外狀況訊息的系統錯誤) - 6 警告資訊 - 8 分鐘追蹤 (金鑰作業。例如，Logon、Logoff、Business Function calls.) - 10 疑難解答資訊 (說明) 。 - 12 完成偵錯資訊 (記錄所有專案) - 根據預設，您不需要開啟追蹤，但在偵錯程式代碼時追蹤很有用。 - NetTraceLevel=0。追蹤層級。您可以放心地略過這個參數。僅定義 COM 伺服器中指定之記錄檔中 ThinNet 元件所提供的追蹤層級。奇數值則保留給未來要加入的層級。 - 下列清單更描述偵錯層級： - 0 沒有追蹤 - 1 是指新增連線並搜尋套接字集區時，記錄進程標識碼、線程標識碼和可用的套接字狀態。 - 2 包含追蹤層級 1 中的資訊，也會追蹤連接管理員類別中所做的每個呼叫。 - 3 包含追蹤層級 2 中的所有資訊，以及追蹤 getPort () 呼叫和 getHost () 呼叫。
[INTEROP]	enterpriseServer。這個值是主機伺服器的名稱。請確定此值與您在 [傳輸屬性] 對話框中 [系統定義] 的 [JDE 認證] 區段中的 [主機名] 欄位中輸入的值相同。預設值為 JDED。港口。這個值是用來交換資料的連接埠編號。請確定此值與您在 [傳輸屬性、系統定義] 的 [JD Edwards 認證] 區段中的 [埠號碼] 欄位中輸入的值相同。例如，6010 或 6009。這些值必須符合系統定義中所設定的值。 inactive_timeout。自動認可模式下的交易逾時值，以毫秒為單位。如果使用者在這段時間 (毫秒) 內沒有活動，interop 伺服器會將使用者登出。您可以將這個值變更為更短的時間。預設值為 1200000。 manual_timeout。手動認可模式中交易的逾時值，以毫秒為單位。預設值為 120000。存儲庫。指向包含 Connector.jar 和 Kernel.jar 的目錄位置。在 UNIX 上，這是完整路徑。
[CORBA]	您可以放心地略過這個參數。 Multithread。您可以忽略設定。設定為 1 表示提供多執行緒支援給 CORBA。 Objects= CORBA::Connector;CORBA::OneWorldVersion 為 CORBA 伺服器定義要在啟動時建立的物件。也會取代 -DIORFILENAME = 命令行選項，例如：CORBA：：Connector=connector.ior。

JD Edwards EnterpriseOne

本節包含搭配使用 Microsoft BizTalk Adapter for JD Edwards EnterpriseOne 搭配 BizTalk Server 的重要資訊。

執行 JD Edwards EnterpriseOne 主要商務功能

您可以使用 BizTalk Adapter for JD Edwards EnterpriseOne 來叫用 JD Edwards EnterpriseOne 主要商務功能，例如通訊錄、採購單或銷售訂單。您也可以使用這個配接器來連接 JD Edwards EnterpriseOne 和 BizTalk Server，以進行整合。

存取儲存在 JD Edwards EnterpriseOne 中的數據

配接器接受 XML 訊息，讓 BizTalk Server 應用程式能夠使用下列其中一項與 JD Edwards EnterpriseOne 通訊和交換交易：

傳輸配接器，其使用靜態 Solicit-Response 傳送埠將訊息傳送至 JD Edwards EnterpriseOne，並預期有回應。
接收配接器，其使用靜態 One-Way 接收埠從 JD Edwards EnterpriseOne 接收訊息。

互操作性架構

JD Edwards EnterpriseOne 透過其互通性架構提供與系統的整合。配接器會使用 JD Edwards EnterpriseOne 架構，並利用各種整合存取方法，以提供最大的彈性和功能。

BizTalk Adapter for JD Edwards EnterpriseOne 支援下列整合存取方法：

JD Edwards EnterpriseOne ThinNet API
JD Edwards EnterpriseOne XML
JD Edwards EnterpriseOne 未編輯的交易資料表 (Z 資料表)

這個配接器使用 JD Edwards EnterpriseOne ThinNet API 與 JD Edwards EnterpriseOne 應用程式通訊。透過 ThinNet API，這個配接器可以在單一工作單元 (UOW) 中叫用一個主要商務功能 (MBF)。當 MBF 失敗時，整個 UOW 都會失敗。如此可防止部分更新。 JD Edwards EnterpriseOne 應用程式會處理基礎資料庫的資料、商務規則和通訊的驗證。

JD Edwards 輸出處理架構

在輸出程序中，當特定 MBF 在 JD Edwards EnterpriseOne 環境中執行時，便會啟動這個事件。 MBF 會將事件的必要資訊寫入適當的介面資料表，然後通知子系統批次功能 (BF) 有此事件發生。子系統 BF 接著會在子系統資料佇列中加入該事件的項目。

輸出子系統會擷取資料佇列項目，並查詢「資料匯出控制」資料表中是否有需要通知的外部處理序。輸出子系統接著會呼叫 BizTalk Adapter for JD Edwards EnterpriseOne 接聽程式，並提供通知。接聽程式會將通知傳遞給產生器。產生器接著會使用 JD Edwards EnterpriseOne ThinNet API 來擷取介面資料表中的適當資訊。

在 Jdearglist 中設定字串左右對齊

若要在 J.D 中將特定字串自變數設定為靠右對齊和靠左填補。Edwards EnterpriseOne jdearglist.txt 檔案，您必須知道您想要存取的商務函式;具體而言，您必須知道您想要呼叫之商務函式中的哪些欄位。

您必須先更新 jdearglist.txt，然後才能在協調流程中產生繫結 (結構描述)。更新一節中所述之 jdearglist.txt 檔案的指示。

如果您在記錄檔中收到 jdearglist.txt 警告訊息，其目的是要通知您遺漏 jdearglist.txt。不過，如果您正在執行 SalesOrder 或 PurchaseOrder 商務功能，則必須在 PATH 中擁有該檔案，否則它無法運作。

瞭解 jdeinterop.ini

Connector.jar 和 Kernel.jar 中的 JD Edwards EnterpriseOne 連接器類別會要求您使用名為 jdeinterop.ini 的組態檔。這個檔案是由 JD Edwards EnterpriseOne 軟體所定義，並使用其術語。如需這個檔案之用途和術語的詳細資訊，請參閱 "JD Edwards Interoperability Guide"。有一個範例 jdeinterop.ini 檔案：Program Files\ Microsoft BizTalk Adapters for Enterprise Applications\ J.D.Edwards EnterpriseOne (r) \config。

不建議手動編輯此檔案，因為它會與傳送埠的 [傳輸屬性] 對話框互動，例如，這些字段標示為 <BizTalk> 所設定。

PeopleSoft Enterprise

本節包含搭配使用 Microsoft BizTalk Adapter for PeopleSoft Enterprise 搭配 BizTalk Server 的重要資訊。

接收處理程式 PeopleSoft 需求

PeopleSoft Integration Broker 必須能夠與 BizTalk Server 通訊。現有的 PeopleSoft 環境中可能已發生下列情況，而且您可能會重複使用現有的節點；因此，除了向 PeopleSoft 系統管理員取得 HTTP 規格，您不必執行任何動作。如需詳細資訊，請參閱 PeopleSoft 檔。

下列步驟提供在PeopleSoft中完成的概觀：

設定訊息，並透過應用程式 Designer 加以啟用。
對 PeopleSoft integration.gateway.properties 檔案進行一次性變更。
建立並設定閘道和節點以啟用 HTTP：
- 這個節點必須使用一些觸發方法，例如 LOCATION_SYNC 機制。
- 這個節點必須使用 HTTP。
- 這個節點必須指向傳送事件的目標主機和連接埠。

傳送處理程式 PeopleSoft 需求

BizTalk Adapter for PeopleSoft Enterprise 是由自定義元件介面所組成， (CI) ，可提供透過 Java API 的存取。自定義 CI 物件 GET_CI_INFO會使用 PeopleSoft Tools 部署在 PeopleSoft 系統中，以提供 BizTalk Adapter for PeopleSoft Enterprise 所需的元數據資訊。如需詳細資訊，請參閱 PeopleSoft 檔。

上載自訂元件介面的動作只發生一次。 GET_CI_INFO.pc 這個檔案隨附於產品，必須安裝在 PeopleSoft 系統中，才能使用配接器瀏覽 CI。您必須能夠存取 PeopleSoft 應用程式 Designer;不過，應用程式 Designer 不需要位於 BizTalk Server 電腦附近的任何地方。您可以使用應用程式 Designer 將自訂 CI 上傳至您流覽的 PeopleSoft 電腦。

您必須能夠存取 PeopleSoft 計算機，因為您必須設定環境變數 CLASSPATH (或設定 [ 傳輸屬性 ] 視窗中的資訊，) 以指向 PeopleSoft PSJOA/psjoa.jar 檔案。

設定環境變數並使用元件介面

如需 PeopleSoft 的詳細資訊，請參閱 PeopleSoft 檔。

設定 ClassPath 環境變數

更新JAVA_HOME

請將 JAVA_HOME 變數設定為指向 JDK 安裝，例如：

set JAVA_HOME=C:\j2sdk1.4.2_06

更新 CLASSPATH

若要使用元件介面 (PeopleSoft 8 僅) 您必須更新 CLASSPATH 以包含 PeopleSoft 元件介面 jar 檔案：

在 [控制台] 中，開啟 [系統]。
在 [ 進階] 索引標籤上，選取 [ 環境變數]，然後選取 [CLASSPATH]。
新增路徑。例如，輸入：
```
<PeopleSoft_Home>\web\PSJOA\psjoa.jar
```
BizTalk Adapter for PeopleSoft Enterprise 需要 psjoa.jar 檔案。當您建立傳送埠時會執行這項作業。如需詳細資訊，請參閱配接器文件中的 "Setting Transport Properties in PeopleSoft System"。

注意

僅在您的 PATH 中使用其中一個目錄，以確保 BizTalk Adapter for PeopleSoft Enterprise 選取正確的 DLL。未能正確設定所需 PeopleSoft 版本的環境，可能會導致錯誤很難追蹤。

使用元件介面

將自定義 CI 上傳至 PeopleSoft

BizTalk Adapter for PeopleSoft Enterprise 需要修改 PeopleSoft 應用程式。若要使用元件介面，您必須將自訂元件介面 GET_CI_INFO 上傳至 PeopleSoft。您只需要在初始設定期間匯入 GET_CI_INFO，即可使用配接器。這個配接器使用 GET_CI_INFO 來取得 PeopleSoft 中其他現有元件介面的相關資訊。

本節說明如何手動匯入自定義元件介面，讓您在 PeopleSoft 中瀏覽元件介面。請注意，自定義方法不會使用或修改其安裝所在的元件介面的任何屬性。若要匯入自訂元件介面，您可以使用下列其中一個方法：

建立新的元件以匯入自訂方法。
使用不含索引鍵的現有元件，例如 INSTALLATION_RS。

簡單元件介面不能包含索引鍵。如果您不確定特定元件介面是否包含索引鍵，您可以使用 SQL 查詢工具來執行下列 SQL 語句。它提供應用程式中沒有索引鍵的所有元件介面清單。
```
select distinct BCNAME
from PSBCITEM bc1
where not exists
(select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
```

您可以遵循 PeopleSoft 檔來建立唯一的簡單元件來儲存 BizTalk Adapter for PeopleSoft Enterprise 自定義方法。您也可以複製其中一個已存在的元件介面，並使用它來儲存自訂方法。

若要確認您的 GET_CI_INFO 不含索引鍵，請執行 PeopleTools Application Designer 元件介面測試工具。

建立新的元件介面

請遵循下列步驟，使用 PeopleSoft、Application Designer 建立新的元件介面：

開啟 PeopleSoft 應用程式 Designer。
輸入三層式連線類型，然後按兩下 [ 確定]。例如，從清單中選取 [Application Server]。
在應用程式 Designer 的 [檔案] 選單上，選取 [新增]。
在 [ 新增 ] 對話框中，選取 [ 元件介面]，然後按兩下 [ 確定]。
按一下 [選取]。
從所有元件清單中選取任何簡單的元件。例如，選取 INSTALLATION_RS 或您建立的新 PeopleSoft 元件。

自訂方法不會使用或修改安裝所在之元件介面的任何屬性。

這個簡單的元件介面不能包含索引鍵。如果您不確定特定元件介面是否包含索引鍵，您可以使用 SQL 查詢工具來執行下列 SQL 語句。它提供應用程式中沒有索引鍵的所有元件介面清單：
```
select distinct BCNAME from PSBCITEM bc1 where not exists (select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
```

注意

您也可以遵循 PeopleSoft 文件，建立唯一的簡單元件來儲存 BizTalk Adapter for PeopleSoft Enterprise 的自訂方法。

若要確認您的 GET_CI_INFO 不含索引鍵，請執行 PeopleTools Application Designer 元件介面測試工具。

檢查元件介面

您已完成將 Microsoft BizTalk Adapter for PeopleSoft GET_CI_INFO 上傳至 PeopleSoft 系統。 GET_CI_INFO 是使用者定義的自訂元件介面，它包含用戶定義的方法。 GET_CI_INFO 元件介面可讓您使用 Microsoft Adapter 精靈瀏覽 PeopleSoft 系統中的元件介面。您可以尋找並展開 GET_CI_INFO，以檢視其使用者定義的方法。

注意

For more information about user-defined methods, see "PeopleSoft: Component Interface User-Defined Methods" in the adapter documentation.

設定元件介面安全性

在 PeopleSoft 上安裝自定義GET_CI_INFO PeopleSoft 元件介面之後，請為 BizTalk Adapter for PeopleSoft Enterprise 設定 GetCINamespace、 GetDetails 和 GetCollections 方法的安全性設定。這是建立自訂元件或使用者定義方法時的標準作法。

注意

下列程序說明如何在所有支援的模式下，為所有支援的 PeopleSoft 版本設定安全性。

設定元件介面的安全性

指向 PeopleTools、指向 [安全性]、指向 [許可權 & 角色]，然後選取 [許可權清單]。
在 [ 維護安全性 ] 視窗中，按兩下 [ 搜尋]，選取相關的 [許可權清單]，然後按兩下適當的清單超連結。
在右側的 [ 許可權清單] 窗格中，按兩下 [ 登入時間 ] 索引標籤旁的向右箭號，以顯示 [ 元件介面 ] 索引卷標。
按兩下 [ 元件介面] 索引 標籤。
按兩下加號 (+) ，將新資料列新增至 [元件介面 ] 清單。
選取 GET_CI_INFO 元件介面，然後按兩下 [ 編輯]。
若要將方法設定為 [完整存取]，請按兩下 [ 完整存取] ([所有) ]，然後按兩下 [ 確定]。
捲動至 [ 元件介面 ] 視窗底部，然後按兩下 [ 儲存]。

測試元件介面

您已完成設定 BizTalk Adapter for PeopleSoft Enterprise 所提供之 GET_CI_INFO 元件介面的安全性。您的 PeopleSoft 元件介面已就緒，可供您瀏覽 PeopleSoft 元件介面。

請執行下列步驟，在 Application Designer 中測試元件介面。

測試元件介面

啟動 PeopleSoft 應用程式 Designer。
在 [ 檔案] 功能表上，指向 [ 開啟]，然後選取 [ 定義 = 元件介面]。
從元件介面清單中，選取 [GET_CI_INFO CI]。
開啟GET_CI_INFO之後，以滑鼠右鍵單擊元件介面定義右窗格中的任何位置，然後選取 [ 測試元件介面]。

[ 元件介面測試器 ] 視窗隨即開啟。並且應該不會列出任何索引鍵。如果您的GET_CI_INFO包含索引鍵，或有另一個選項可供選取，請返回 Application Designer，並從GET_CI_INFO排除所有索引鍵。

安裝步驟

安裝之前，請務必先 BizTalk Server，並安裝適配卡的所有軟體必要條件。建議您關閉所有應用程式，再執行安裝程式。

執行 BizTalk Server Setup.exe，然後選取 [安裝 Microsoft BizTalk Adapters for Enterprise Applications]。

針對 BizTalk Server 2016 和更舊版本：
執行 BizTalk Server Setup.exe，選取 [安裝 Microsoft BizTalk 配接器]，然後選取 [安裝 Microsoft BizTalk Adapters for Enterprise Applications]。
注意
- 您也可以使用下列命令執行無訊息安裝： msiexec /i <msi\> /qn /l* <logfile\> -- 其中 <logfile\> 是選擇性的，但在安裝失敗時很有用。
- 安裝會更新 PATH 環境變數。若要確定您使用的變數正確，請關閉安裝命令視窗以更新變數。
接受 許可協議，然後選取 [ 下一步]。
輸入您的 客戶資訊，然後選取 [ 下一步]。
選取 [完成 ] 或 [自訂 安裝]：
- 完成：安裝所有適用於企業應用程式的 Microsoft BizTalk 配接器、所有程式功能，並用於開發和運行時間。
- 自訂：您可以選擇要安裝的適配卡和功能，以及其安裝位置。
若要設定目的地，請選取 [ 流覽]，然後設定安裝路徑。

選取 [下一步] 以繼續操作。
安裝，然後在完成時選取 [ 完成 ]。

重要

安裝期間可能會遇到下列錯誤：

Error 1609. An error occurred while applying security settings. CREATOR OWNER is not a valid user or group

若要解決此問題，請執行下列動作，然後再次執行安裝：

開啟命令提示字元
輸入：net user "CREATOR OWNER" /add。這會建立名為 CREATOR OWNER 的新使用者。
輸入：net localgroup Users /add。這會建立名為Users的新群組。

To add the adapters to BizTalk Server, see "Add adapters to BizTalk Admin" in this topic.

將配接器新增至 BizTalk 管理員

注意

如果您在多計算機環境中安裝 BizTalk， (一部電腦上的僅限運行時間安裝，而另一部電腦上只有管理工具安裝) ，您應該在這兩部計算機上安裝 BizTalk Adapters for Enterprise Applications。

開啟 [BizTalk Server 管理控制台]，展開 [Microsoft BizTalk Server]，然後展開 [平台設定]。
以滑鼠右鍵按兩下 [ 配接器]，選取 [ 新增]，然後選取 [ 配接器]。
輸入名稱，例如 PeopleSoft。
從 [ 配接器 ] 列表中選取您輸入的名稱，然後選取 [ 確定]。

安裝后 - JD Edwards OneWorld

Microsoft BizTalk Adapter for JD Edwards OneWorld 是由支援的資料庫和伺服器系統介面至 Microsoft BizTalk Server 的傳輸配接器所組成。傳輸配接器可讓您從 BizTalk Server 叫用伺服器系統的呼叫。傳輸配接器 (BizTalk Server 管理傳送處理常式) 組態會指定 SQL 資料庫的位置。

如需如何使用 BizTalk Adapter for JD Edwards OneWorld 的相關信息，以及其模型與 BizTalk Server 模型之間的對應，請參閱配接器檔。

單一登入

BizTalk Adapter for JD Edwards OneWorld 支援 Enterprise Single Sign-On (SSO) 。如果您在 [ 傳輸屬性 ] 頁面中選取使用 SSO，則會使用 SSO 認證資料庫中的聯盟應用程式認證。分支機構應用程式代表需要認證的後端應用程式。

已安裝的元件

配接器安裝會在全域程式集緩存中安裝並註冊下列元件， (GAC) 。您可以在總管中開啟元件資料夾， (%WINDIR%>\assembly) <，或使用 gacutil /l Visual Studio 命令提示字元中的來確認註冊：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
btsTask.exe 會將檔案安裝並部署到 Microsoft.BizTalk.Adapters.JDEProperties.dll GAC。 BizTalk Server 部署記錄結果位於 \Program Files\Microsoft BizTalk Adapters for Enterprise Applications\jdeDeploy.html 和 jdeDeploy.xml中。
配接器特定的檔案會安裝在和 Program Files\Common Files中Program Files。
sdk\安裝在中Program Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards OneWorld(r)。
Program Files\Microsoft BizTalk Adapters for Enterprise Applications\JD Edwards OneWorld(r)\ 包含下列檔案：
- classes\JDEJAccess.jar
- Config\ J.D. Edwards OneWorld (r) \BTSREL.exe
- Config\ J.D. Edwards OneWorld (r) \jdearglist.txt
- Config\ J.D. Edwards OneWorld (r) \jdeinterop.ini
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin\ 包含下列檔案：
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- jdecba.dll

安裝后 - JD Edwards EnterpriseOne

Microsoft BizTalk Adapter for JD Edwards EnterpriseOne 包含一個傳輸配接器，該配接器具有支持的資料庫和伺服器系統來 BizTalk Server。傳輸配接器可讓您從 BizTalk Server 叫用伺服器系統的呼叫。

BizTalk Adapter for JD Edwards EnterpriseOne 支援 Enterprise Single Sign-On (SSO) 。如果您在 [ 傳輸屬性 ] 頁面中選取使用 SSO，則會使用 SSO 認證資料庫中的聯盟應用程式認證。分支機構應用程式代表需要認證的後端應用程式。

已安裝的元件

配接器安裝會在全域程式集緩存中安裝並註冊下列元件， (GAC) 。您可以在總管中開啟元件資料夾， (%WINDIR%>\assembly) <，或使用 gacutil /l Visual Studio 命令提示字元中的來確認註冊：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
配接器特定的檔案會安裝在 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin 資料夾中。此資料夾包含下列檔案：
- Jdecba.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
下列檔案會安裝在中 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards EnterpriseOne(r)：
- Bin\BTAJDEEnterpriseOneTrace.cmd
- Classes\JDEDynAccess.jar
- Config\btaJDEEnterpriseOneTrace.mof
- Config\jdearglist.txt
- Config\jdeinterop.ini
- Config\jdelog.properties
- Sdk

安裝后 - PeopleSoft Enterprise

Microsoft BizTalk Adapter for PeopleSoft Enterprise 包含傳輸配接器，可將支援的資料庫和伺服器系統連接到 BizTalk Server。傳輸配接器可讓您從 BizTalk Server 叫用伺服器系統的呼叫。傳輸配接器 (BizTalk Server 管理傳送處理常式) 組態會指定 SQL 資料庫的位置。

BizTalk Adapter for PeopleSoft Enterprise 支援 Enterprise Single Sign-On (SSO) 。如果您在 [ 傳輸屬性 ] 頁面中選取使用 SSO，則會使用 SSO 認證資料庫中的聯盟應用程式認證。分支機構應用程式代表需要認證的後端應用程式。

配接器安裝包含 \sdk 目錄中的範例。

已安裝的元件

配接器安裝會在全域程式集緩存中安裝並註冊下列元件， (GAC) 。您可以在總管中開啟元件資料夾， (%WINDIR%>\assembly) <，或使用 gacutil /l Visual Studio 命令提示字元中的來確認註冊：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
配接器特定的檔案會安裝在 *Program FilesandProgram Files\Common Files. The following files are installed in Program Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise (r) '：
- bin\BTAPeopleSoftTrace.cmd
- config\btaPeopleSoftTrace.mof
- config\GET_CI_INFO.pc
- config\GET_CI_INFO.pc
- Sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications 包含下列檔案：
- bin\psosa.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll

安裝後概觀 - TIBCO Rendezvous

Microsoft BizTalk Adapter for TIBCO Rendezvous 包含接收和傳輸功能，可介面支援的資料庫和伺服器系統來 BizTalk Server。

接收端會接聽來自伺服器系統的輸出呼叫。
傳輸端可讓您從 BizTalk Server 叫用伺服器系統的呼叫。

如需如何使用 Microsoft BizTalk Adapter for TIBCO Rendezvous 及其模型與 BizTalk Server 模型之間的對應相關信息，請參閱配接器檔。

已安裝的元件

配接器安裝會在全域程式集緩存中安裝並註冊下列元件， (GAC) 。您可以在總管中開啟元件資料夾， < (%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示字元中的來確認註冊：
- Microsoft.BizTalk.Adapters.TibcoRV
- Microsoft.BizTalk.Adapters.TibcoRV.Common
- Microsoft.BizTalk.Adapters.TibcoRV.Service
- Microsoft.BizTalk.Adapters.TibRV.Properties
- Microsoft.BizTalk.Adapters.TibcoEMS
- Microsoft.BizTalk.Adapters.TibcoEMS.Properties
- Microsoft.BizTalk.Adapters.TibcoRVManagement
- Microsoft.BizTalk.Adapters.TibcoRVReceiver
- Microsoft.BizTalk.Adapters.TibcoRVTransmitter
配接器特定的檔案會安裝在和 Program Files\Common Files中Program Files。下列檔案會安裝在 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\ TIBCO(r) Rendezvous(r)中：
- bin\BTATibcoRVTrace.cmd
- bin\mbaRV.exe
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Common.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Service.dll
- bin\Microsoft.BizTalk.Adapters.BizUtil.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll
- bin\Microsoft.BizTalk.Adapters.TibRV.Properties.dll
- Config\btaTibcoRVTrace.mof
- Sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications 包含下列檔案：
- bin\tibcorvcba.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll

將 TIBCO.Rendezvous.dll 新增至 GAC

BizTalk Adapter for TIBCO Rendezvous 需要 TIBCO.Rendezvous.dll 檔案。所需的最低版本是 1.0.3036.23330 FileVersion，隨附於產品 8.1 版。如果未安裝此元件，配接器會觸發例外狀況並記錄適當的訊息。

您必須使用晚期系結來載入元件，如此一來，當目標計算機上沒有特定版本的 TIBCO.Rendezvous.dll 和 TIBCO.Rendezvous.net 模組時，TIBCO Rendezvous 元件不會失敗。

執行階段元件

確認您的電腦上已安裝 TIBCO Rendezvous 執行階段元件。執行階段元件是安裝 TIBCO Rendezvous 時唯一必須安裝的元件。

在 Visual Studio 命令提示字元中，將目錄變更為 TIBCO.Rendezvous.dll 檔案的位置。在 TIBCO Rendezvous 的預設安裝中，此 DLL 的路徑 C:\TIBCO\TIBRV\BIN\TIBCO.Rendezvous.dll。
在命令提示字元中，請輸入下列項目：

C:\TIBCO\TIBRV\BIN > gacutil /i TIBCO.Rendezvous.dll

TIBCO.Rendezvous.dll 現在會顯示 GAC 清單。若要檢視清單，請在 [控制台] 中，開啟 [系統管理員工具]，開啟 [Microsoft .NET Framework 組態]，然後開啟 [程式集緩存]。

安裝后 - TIBCO Enterprise Message Service

Microsoft BizTalk Adapter for TIBCO Enterprise Message Service (EMS) 包含接收和傳輸功能，可將支援的資料庫和伺服器系統連接到 BizTalk Server。

接收端會接聽來自伺服器系統的輸出呼叫。
傳輸端可讓您從 BizTalk Server 叫用伺服器系統的呼叫。

如需如何使用 BizTalk Adapter for TIBCO EMS 及其模型與 BizTalk Server 模型之間的對應的相關信息，請參閱配接器檔。

已安裝的元件

配接器安裝會安裝並註冊 Microsoft.BizTalk.Adapters.TibcoEMS.dll 全域程式集緩存中的檔案， (GAC) 。您可以在總管中開啟元件資料夾， (<%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示字元中的來確認註冊。
配接器特定的檔案會安裝在和 Program Files\Common Files中Program Files。下列檔案會安裝在底下 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)：
- bin\BTATibcoEMSTrace.cmd
- Microsoft.BizTalk.Adapters.TibcoEMS.dll
- Config\btaTibcoEMSTrace.mof
- Sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\bin 資料夾包含下列檔案：
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
  
  注意
  
  您必須使用晚期繫結來載入組件，如此一來，當目標電腦上沒有特定版本的 TIBCO.EMS.dll 時，TIBCO EMS 組件才不會失敗。

將 TIBCO.EMS.dll API 新增至 GAC

BizTalk Adapter for TIBCO EMS 會要求您將 TIBCO.EMS.dll 加入 GAC。如果未安裝這個組件，BizTalk Adapter for TIBCO EMS 會觸發例外狀況並記錄適當的訊息。

將 TIBCO EMS C#API 複製到您的 BizTalk 電腦。
在 Visual Studio 命令提示字元中，將目錄變更為 C# API 檔案的位置。
在 Visual Studio 命令提示字元中，輸入下列命令：
```
C:\\<TIBCO EMS Folder\>bin> gacutil /i TIBCO.EMS.dll
```
TIBCO.EMS.dll 現在會顯示在 C:\Windows\assembly 清單中。或者，在控制台中，開啟系統管理員工具>Microsoft .NET Framework>Assembly Cache 以檢視 GAC 清單。

限制

BizTalk Adapter for TIBCO EMS 使用 TIBCO.EMS.dll 與伺服器通訊。以下是使用 TIBCO.EMS.dll 的限制：
無法使用訊息壓縮功能，該功能可讓 TIBCO EMS 用戶端將壓縮格式的訊息傳送給 EMS。
無法加密配接器和伺服器之間的訊息。 TIBCO.EMS.dll 不允許使用 OpenSSL 程式庫進行 SSL 加密，但配接器支援使用 Tibco.EMS.dll 搭配 ProductVersion 5.0 及更新版本的 SLL。
不支援 EMS 的系統管理 API。

配接器追蹤

啟用追縱

系統管理員可決定要使用 Windows 追蹤的檔案名稱。這個應用程式會寫入至作業系統，並在您需要特定後端系統的記錄檔之前，略過所有記錄檔。您可以執行個別適用於企業應用程式的 BizTalk Adapter 命令檔，來執行這項作業。該命令的其中一個自變數是用來擷取追蹤信息的檔名。 For more information, see "Use Windows trace event" (in this topic).

追蹤檔案會安裝至 \Program Files\Microsoft BizTalk Adapters for Enterprise Applications\。

bin\BTATrace.cmd
config\btaTrace.mof

使用 Windows 追蹤事件

配接器會將錯誤、警告和資訊訊息記錄至 Windows 事件檢視器。您可以使用 Windows 事件追蹤 (ETW) 工具來檢視其他追蹤訊息。當 ETW 啟用時，它會建立 *.etl 檔案以接收訊息。這個檔案是二進位格式，必須經過轉換才能讀取。若要這樣做，您必須有取用者應用程式可用來解譯 *.etl 檔案，例如 Windows tracerpt.exe 或 tracedmp.exe。

ETW 元件

「Windows 事件追蹤」有三個元件：

控制器應用程式： 啟動和停用提供者。例如，tracelog.exe 或 logman.exe。

您會將 PATH 環境變數設定成指向 tracelog.exe 的位置。這可確保 BTA< 配接器名稱>追蹤呼叫可以在系統中找到 tracelog.exe。根據預設，BTA<配接器名稱>追蹤會搜尋目前的路徑。

注意

tracelog.exe 可從 Microsoft SDK 取得，並與 Microsoft BizTalk Adapters for Enterprise Applications 所提供的命令相容。如果要使用 logman.exe，請參閱 logman 文件。
取用者應用程式： 讀取記錄的事件。

如果要讓取用者應用程式可讀取 .etl 檔案中的事件，「Windows 事件追蹤」必須將它們傾印到該檔案。此動作通常是在控制器停用追蹤後完成的。

若要使用取用者應用程式而不停用追蹤，控制器必須使用即時選項 <> 即時 = -rt 來啟動追蹤。
供應商： 用來提供事件。

每個配接器包含五個不同的提供者。它們是在 Windows Management Instrumentation (WMI) 中註冊的。若要在 root\WMI\EventTrace 路經中尋找已登錄的提供者，您可以使用諸如 WMI CIM Studio 這類的工具。

這五個提供者可讓您記錄不同的訊息類型：
- 接收者記錄提供者： <追蹤元素> 參數為 - 接收者。
- 接收者 CastDetails 提供者： <Trace 元素> 參數為 - castDetailsReceive。
- 傳輸器記錄提供者： <追蹤元素> 參數為 - 傳輸器。
- 傳輸器 CastDetails 提供者： <Trace 元素> 參數為 - castDetailsTransmit。
- 管理記錄提供者： <追蹤元素> 參數為 - 管理。

若要使用 ETW，請執行特定配接器的命令： BTA<Adapter Name\>Trace.cmd。您可以下列方式使用此命令：

BTA<Adapter Name>Trace <Trace element> -start [-cir <MB>|
    -seq <MB>] [-rt] logfile
BTA<Adapter Name>Trace <Trace element> -stop

其中：

<需要追蹤元素> () 是提供者的類型。選項包括：

-castDetailsTransmit

-發射機

-castDetailsReceive

-接收機

-管理

-start，-stop： 啟動或停用提供者。

-cir <MB>： 檔案的大小和種類。 -cir 是循環檔案。 <MB>： 大小以 MB 為單位。

-seq <MB>： 檔案的大小和種類。 -seq 是循序檔案。 <MB>： 大小以 MB 為單位。

-Rt： 設定開啟的即時模式。

Logfile： c：\rtlog.etl (記錄檔的名稱是預設) 。

例如：

BTAXXXTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAXXXTrace -transmitter -stop

注意

您可以使用 tracerpt.exe 命令來格式化 .etl 檔案。

共用方式為

安裝和設定適用於企業應用程式的 Microsoft BizTalk 配接器

支援的版本 & 需求

JD Edwards OneWorld XE

建立 JAR 檔案

JAR 檔案和 CLASSPATH

建立BTSLIBinterop.jar檔案

確認您的設定

建立並安裝自定義套件

定義自定義套件

安裝 BTSREL 自定義套件

在部署伺服器上安裝 BTSREL

在 JD Edwards OneWorld WorkBench 上安裝 BTSREL

卸載自定義套件

手動註冊商務功能連結庫

步驟 1：建立自定義商務功能連結庫

步驟 2：從部署伺服器重建連結庫

步驟 3：複製自定義 DLL

步驟 4：建置完整套件

模組清單

自訂 jdeinterop.ini 檔案

jdeinterop.ini 檔案設定

JD Edwards EnterpriseOne

執行 JD Edwards EnterpriseOne 主要商務功能

存取儲存在 JD Edwards EnterpriseOne 中的數據

互操作性架構

JD Edwards 輸出處理架構

在 Jdearglist 中設定字串左右對齊

瞭解 jdeinterop.ini

PeopleSoft Enterprise

接收處理程式 PeopleSoft 需求

傳送處理程式 PeopleSoft 需求

設定環境變數並使用元件介面

設定 ClassPath 環境變數

使用元件介面

將自定義 CI 上傳至 PeopleSoft

建立新的元件介面

檢查元件介面

設定元件介面安全性

測試元件介面

安裝步驟

將配接器新增至 BizTalk 管理員

安裝后 - JD Edwards OneWorld

單一登入

已安裝的元件

安裝后 - JD Edwards EnterpriseOne

已安裝的元件

安裝后 - PeopleSoft Enterprise

已安裝的元件

安裝後概觀 - TIBCO Rendezvous

已安裝的元件

將 TIBCO.Rendezvous.dll 新增至 GAC

安裝后 - TIBCO Enterprise Message Service

已安裝的元件

將 TIBCO.EMS.dll API 新增至 GAC

配接器追蹤

啟用追縱

使用 Windows 追蹤事件

ETW 元件

下一步

意見反應

其他資源