建立或編輯協議
本主題說明如何建立或編輯交易夥伴協議。 交易夥伴協議設定兩個交易夥伴之間的關係，包括其身份識別；交易夥伴介面程序 (PIP)；動作、信號與同步 URL；以及關聯的協定。
交易夥伴協議包含程序組態、主要組織、交易夥伴與協議的設定。 這些皆為協議的必要設定。 您可以根據 RosettaNet PIP 或自訂結構描述來建立程序組態，但無論如何，您必須建立組態。 您也必須定義主組織與合作夥伴組織。 Microsoft BizTalk Accelerator for RosettaNet (BTARN) 不支援未知合作物件之間的訊息交換。
BTARN 會根據所有這些設定來處理並驗證訊息。 例如，若為 CIDX 訊息，BTARN 會根據 RosettaNet 實作架構 (RNIF) 1.1 (版) 、0A1 合約 (No 0A1 僅) 進行驗證，以及 Is Single Action 僅) 屬性 (單一動作。 只有在您將 RNIF 版本設定為 「1.1」、0A1 合約為 「No 0A1」，並將 Is Single Action 屬性設定為 True 時，CIDX 訊息才會驗證。 BTARN 也會驗證任何合約屬性是否與進程組態設定檔設定一致。 例如，它會確認您已將設定檔的 屬性設定 Standard 為 「CIDX」，且合約的 0A1 合約屬性設定為 「No 0A1」。
當程序仍在作用中時，若對協議作任何修改，就可能會發生無法預測的結果。 當您按一下 [ 套 用] 或 [ 確定 ] 接受這些屬性時，合約屬性的變更就會立即套用，但您無法預測進程正在執行的階段。 當您更改了協議之後，目前程序或任何新程序中的任何新活動，都會使用變更過的協議屬性。 但在您變更協議的同時執行的程序，可能會對它正在處理的訊息使用先前的協議屬性。
建立協議後，您必須啟動協議，才能傳送或接收與協議關聯的訊息。 您也可以停用協議以避免傳送或接收任何與協議關聯的訊息。 您必須停用協議後才能編輯協議，並在編輯後重新啟動協議。
BTARN 會將此資訊儲存在 BTARNCONFIG 資料庫的 TPAConfig 資料表中。
交易夥伴合約中的設定如下表所示，依索引標籤排列。預設設定是最常使用的值。 建立與編輯這些設定的程序，列在此表格之後。
| 索引標籤 | 設定 | 使用量 |
|---|---|---|
| 一般 | 名稱 | 協議的唯一名稱，例如，Fabrikam_To_Contoso_3A2。 必要的欄位。 |
| 一般 | 處理設定 | PIP 的識別碼。 此數字可用來識別此協議所關聯的程序組態。 程序組態清單中的第一個值就是預設值。 下拉式清單中包含先前輸入的所有程序組態。 必要的欄位。 |
| 一般 | 我的組織 | 主要組織，可從下拉式清單中選取。 必要的欄位。 |
| 一般 | 合作夥伴組織 | 交易夥伴組織，可從下拉式清單中選取。 必要的欄位。 |
| 一般 | 描述 | 交易夥伴協議的描述。 |
| 一般 | RNIF 版本 | BTARN 將用於合約通訊的 RNIF 版本。 可以是 V01.10.00 或 V02.00.01 ， (預設) 。 必須是 CIDX 的 V01.10.00 。 |
| 一般 | 主角色 | 主要組織的角色。 可能為啟動者角色或回應者角色。 |
| 一般 | 0A1 協議 | 當發生失敗時，BTARN 是否會傳回失敗訊息 (0A1 PIP) 。 可以是 [否 0A1 ] (預設) 或 0A1。 CIDX 必須為 No 0A1 。 |
| 一般 | 使用方式 | 指示協議所用的實例類型。 可以是 測試 (預設) 或 生產環境。 |
| 一般 (應用程式配接 器區域) |
元件名稱 | ApplicationAdapter 的檔案名稱，您可從檔案系統中選取。 預設值為空字串。 |
| 一般 (應用程式配接器區域) |
類別名稱 | BTARN 將從 ApplicationAdapter 使用的類別名稱。 預設值為 < none > 。 |
| 一般 (驗證配接器區域) |
元件名稱 | ValidationAdapter 的檔案名稱，您可從檔案系統中選取。 預設值為空字串。 |
| 一般 (驗證配接器區域) |
類別名稱 | BTARN 將從 ValidationAdapter 使用的類別名稱。 預設值為 < none > 。 |
| 連接埠 | 動作 URL | 主要組織傳輸動作訊息的目標 URL。 例如： http://FabrikamServer/BTARNApp/RNIFReceive.aspx 。若下列情況為真，則此為必要的欄位： - 是同步 進程組態設定為 False 。- 是單一動作 進程組態設定為 True 。- 主角色 合約設定為 啟動器。 如果下欄欄位為 true， (在此情況下，也需要 [ 訊號 URL ] 欄位) ： - 是同步 進程組態設定為 False 。- 是單一動作 進程組態設定為 False 。- 您必須在此欄位中輸入有效的 URI，其開頭為 「 < http://domain> 」 或 「」。 <https://domain> |
| 連接埠 | 訊號 URL | 主要組織傳輸信號訊息的目標 URL。 例如： http://FabrikamServer/BTARNApp/RNIFReceive.aspx 。若下列情況為真，則這是必要欄位： - 是同步 進程組態設定為 False 。- 是單一動作 進程組態設定為 True 。- [主角色 合約] 設定為 [回應程式]。 如果下列專案為 true (，則這是必要欄位，在此情況下，也需要 [ 動作 URL ] 欄位) ： - 是同步 進程組態設定為 False 。- 是單一動作 進程組態設定為 False 。您必須在此欄位中輸入有效的 URI，也就是開頭為 「 < http://domain> 」 或 「 <https://domain> 」 的 URI。 |
| 連接埠 | 同步 URL | 主要組織經由 HTTP 配接器建立連線所用的 URL。 例如： http://FabrikamServer/BTARNApp/RNIFReceive.aspx 。若下列情況為真，則這是必要欄位： - 是同步 進程組態設定為 True 。- 主角色 合約設定為 啟動器。 您必須在此欄位中輸入有效的 URI，也就是開頭為 「 < http://domain> 」 或 「 <https://domain> 」 的 URI。 |
| 通訊協定 | 摘要方法 | 為達到不可否認性目的，用來計算內送訊息摘要的通訊協定。 從 BizTalk Server 2016 和更新版本開始，會自動包含 SHA2 支援。 選項包括： MD5、 SHA-1、 SHA-256 (預設) 、 SHA-384和 SHA-512。 針對舊版BizTalk Server，選項包括MD5或SHA-1 (預設) 。 BTARN 接收管線會接收和解密訊息，即使用來加密訊息的通訊協定以及合約的這個索引標籤上的 編碼 設定不相符。 因此，BTARN 會接收以 RC2-40 或 3DES 加密的訊息。 所有傳出已簽署的訊息都有 SHA-1 的摘要。 |
| 通訊協定 | 編碼所有的部分 | 決定系統是否一起編碼 Multipart 訊息的所有部分。 可以是 True 或 False (預設) 。當時 True ，多部分訊息的所有部分都會使用 屬性所 Encoding 指示的方法一起編碼。當 為 時 False ，系統只會使用 屬性所 Encoding 指示的方法來編碼附件。 (附件一律會使用 property.) 根據預設，使用 property.) 指示的傳送 Encoding 管線來編碼，當您將此屬性 False 設定為 時，BTARN 會將訊息的其他部分編碼 (RNIF 2.01 中的四個部分，RNIF 1.1 中的三個部分) 以引號列印格式。 |
| 通訊協定 | 編碼方式 | 如果 [ 編碼所有元件 ] 方塊) True 或附件 (編碼所有 (元件 方 False 塊) ，則用來將所有元件編碼的通訊協定 (。可以是 8 位、 base 64 (預設) 或 引號可列印。 |
| 通訊協定 | 加密演算法 | 用來加密內送與外寄訊息的演算法。 從 BizTalk Server 2016 和更新版本開始，系統會自動包含 AES 支援。 選項包括 RC2-40、 3DES、 AES128 (預設) 、 AES192和 AES256。 針對舊版BizTalk Server，選項包括RC2-40 (預設) 或3DES。 只有在您已將 屬性設定 Is Persistent Confidentiality Required 為對應進程組態中的 Payload 或 Payload Container 時，加密演算法才會生效。 |
| 通訊協定 | 加密方向 | 決定系統將加密內送訊息或外寄訊息，或是兩者皆加密。 可以是 輸入、 輸出或 輸入/輸出 (預設) 。 只有在您已將 屬性設定 Is Persistent Confidentiality Required 為對應進程組態中的 Payload 或 Payload Container 時，加密方向設定才會生效。 |
| 自訂內容 | 名稱 | 自訂屬性的名稱。 您可以分別為每個協議設定自訂屬性名稱。 若您建立新的自訂私用程序，可使用這些自訂屬性來處理不同的協議。 您可以使用 RuntimeConfig.GetTPACustomConfigValue BTARN SDK 中的 方法，從 BTARN 組態擷取自訂屬性。屬性 Name 必須是唯一的，而且不是空的。您可以輸入以下的自訂值： - AAR。 這是「需要接受通知」(Acceptance Acknowledgment Required) 自訂屬性， 僅適用於 RNIF 1.1。 將此設定為 false (不區分大小寫) 只需要收據通知，而不是接受通知。 如果 AAR 設定為 false以外的任何專案，則回應者公用程式必須傳送接受通知，而啟動器公用程式將會預期接受認可。 若 AAR 設定為 false，公開處理程序在接收通知之後就算完成。 - HPCC。 代表 Home Partner Classification Code (主要夥伴分類代碼)， 僅適用於 RNIF 1.1。 讓您可以將外寄訊息服務標頭中的主要夥伴 GlobalPartnerClassificationCode 項目設定為「值」欄位中的項目。 這個值覆寫了「主要組織」組態中的「主要」組織分類屬性。 當主要組織的分類不只一種時，可以使用這個自訂屬性。 - PPCC。 代表 Partner Profile Classification Code (夥伴設定檔分類代碼)， 僅適用於 RNIF 1.1。 讓您可以將外寄訊息服務標頭中的夥伴 GlobalPartnerClassificationCode 項目設定為「值」欄位中的項目。 這個值覆寫了「夥伴」組態中的「夥伴」分類屬性。 當夥伴的分類不只一種時，可以使用這個自訂屬性。 |
| 自訂內容 | 值 | 自訂屬性的值。 |
建立交易夥伴協議
按一下[開始]，指向[所有程式]，指向[MicrosoftBizTalk Accelerator for RosettaNet]，然後按一下[BizTalk Accelerator for RosettaNet管理主控台]。
在 BTARN 管理主控台中，展開[BizTalk Accelerator for RosettaNet]。
以滑鼠右鍵按一下 [ 合約]，指向 [ 新增]，然後按一下 [ 合約]。
在 [新增合約屬性] 對話方塊的 [ 一般]、[ 埠]、[ 通訊協定] 和 [ 自訂屬性 ] 索引標籤上，輸入設定的值。 如需有關這些設定的詳細資訊，請參閱上表。
按一下 [確定]。
注意
在您啟動協議之前，BTARN 都不會接收與此協議相關的訊息。
以滑鼠右鍵按一下右窗格中的合約名稱，然後按一下 [ 啟用]。
注意
如果您已經啟用合約，您可以在右窗格中以滑鼠右鍵按一下合約的名稱，然後按一下 [ 停用 ] 以防止傳送或接收與合約相關聯的任何訊息。
編輯交易夥伴合約
按一下[開始]，指向[所有程式]，指向[MicrosoftBizTalk Accelerator for RosettaNet]，然後按一下[BizTalk Accelerator for RosettaNet管理主控台]。
在 BTARN 管理主控台中，展開[BizTalk Accelerator for RosettaNet]，然後按一下 [合約]節點。
以滑鼠右鍵按一下您要編輯的合約，然後按一下 [ 屬性]。
在 [ <合約名稱> 屬性] 對話方塊的 [一般] 和 [連絡人內容] 索引標籤上，視需要變更設定。 如需有關這些設定的詳細資訊，請參閱上表。
按一下 [確定] 。