使用埠系結檔案設定實體埠系結至 SAP
當您使用取用配接器服務 BizTalk 專案增益集來產生 SAP 成品的中繼資料時,除了架構檔案以外,取用配接器服務增益集也會產生埠系結檔案。 您可以將此系結檔案匯入 BizTalk 應用程式,以建立實體傳送或接收埠。 重複使用 SAP 配接器系結 包括匯入系結檔案的步驟。 如果您匯入此系結檔案,就不需要手動建立實體傳送或接收埠。
重要
使用取用配接器服務增益集時,如果您未為字串類型的系結屬性指定值,且其預設值為 null,則系結檔案中將無法使用該系結屬性。 如有必要,您必須在系結檔案中手動新增系結屬性及其值。
使用埠系結檔案建立埠一律會建立雙向傳送或接收埠。 如果您想要建立單向埠,您可以使用 手動設定實體埠系結至 SAP 配接器中的步驟,手動建立它。 或者,您可以遵循本主題中所述的因應措施,修改埠系結檔案以建立單向埠。
重要
使用 [新增配接器中繼資料精靈] 不會建立埠系結檔案,您可以使用該檔案來建立 WCF-SAP 埠。 不過,您可以對取用配接器服務增益集所產生的埠系結檔案進行一些變更,並用它來建立 WCF-SAP 埠。 如需詳細資訊,請參閱 使用取用配接器服務增益集所產生的埠系結檔案來設定 WCF-SAP 埠。
以下是您必須瞭解取用配接器服務增益集所產生的系結檔案的一些重點:
檔案是使用特定的命名慣例所建立。 如果您產生輸出作業的中繼資料,也就是將訊息傳送至 SAP 系統,則檔案名會 WcfSendPort_SAPBinding_Custom.bindinginfo.xml。
如果您為輸入作業產生中繼資料,也就是從 SAP 系統接收訊息,則檔案名會 WcfReceivePort_SAPBinding_Custom.bindinginfo.xml。
檔案包含系結組態、系結類型、端點 URI,以及根據產生中繼資料之作業的埠動作的相關資訊。 當您匯入此系結檔案以建立埠時,會自動在埠上設定實體埠所需的所有相關資訊。
重要
根據預設,傳送埠上的動作會對應至您產生中繼資料的作業名稱。 例如,如果您產生RFC_CUSTOMER_GET的中繼資料,埠上的動作會設定為
<Operation Name="RFC_CUSTOMER_GET" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />
。 不過,您在 BizTalk 協調流程中建立之邏輯傳送埠上的作業名稱可能不相同。 您必須確定 BizTalk 協調流程中的邏輯埠 (中的作業名稱) ,以及 BizTalk Server 管理主控台中的實體傳送埠 (相同) 。 如果沒有,您會在透過傳送埠將訊息傳送至 SAP 系統時收到錯誤。您只需要提供埠的認證,才能連線到 SAP 系統。 雖然系結檔案會保留要連線的使用者名稱,但基於安全性理由,系結檔案不包含密碼。
使用埠系結檔案的主要考慮
當您匯入系結檔案時,可能會收到對話方塊訊息,告知系結檔案中的 BizTalk 應用程式名稱與您要匯入系結檔案的應用程式名稱不符。 您可以放心地忽略此訊息並繼續。
系結檔案也包含埠和接收位置的名稱。 如果您要匯入系結檔的 BizTalk 應用程式會建立埠或接收位置,該位置的名稱與相同 BizTalk 應用程式中已經存在的埠相同,您將會收到錯誤。 您必須手動編輯系結檔案,以指定埠或接收位置的唯一名稱。
系結檔案也包含連線 URI 的相關資訊。 如果系結檔案建立的接收位置與相同 BizTalk 應用程式中已有的現有接收位置具有相同的接收 URI,您會收到錯誤。 您必須手動編輯系結檔案,以指定唯一的 URI。
根據預設,埠系結檔案一律包含雙向埠的定義, (傳送或接收) 。 當您在 BizTalk 應用程式中匯入此檔案時,它會建立雙向傳送或接收埠。 不過,您可能有具有單向傳送或接收埠的協調流程。 因此,當您設定這類協調流程並使用匯入系結檔案所建立的埠時,此埠將無法在清單中使用。 這是因為您在協調流程中建立的邏輯埠是單向埠,而協調流程中建立的實體埠是雙向埠。 在這種情況下,您可以編輯系結檔案以進行下列變更:
針對此 執行方式 編輯埠系結檔案以設定單向傳送埠 1.在下列摘錄中,將 IsTwoWay 屬性的值變更為 false。 最初,這會設定為 true。
<SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
2.將下列摘錄批註化:
<ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/>
<ReceivePipelineData xsi:nil="true" />
編輯埠系結檔案以設定單向接收埠 1.在下列摘錄中,將 IsTwoWay 屬性的值變更為 false。 最初,這會設定為 true。
<ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1">
2.將下列摘錄批註化:
<SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" />
<SendPipelineData xsi:nil="true" />
<SendPipelineData xsi:nil="true" />
使用使用取用配接器服務增益集產生的埠系結檔案來設定 WCF-SAP 埠
取用配接器服務增益集也會建立埠系結檔案,您可以在 BizTalk Server 管理主控台中匯入。 您可以使用相同的埠系結檔案,在 BizTalk Server 管理主控台中建立 BizTalk WCF-SAP 埠。 不過,在建立 WCF-SAP 埠之前,您必須執行下列工作來修改埠系結檔案。
在文字編輯器中開啟埠系結檔案。
搜尋並將 「WCF-Custom」 取代為您在 BizTalk Server 管理主控台中新增 WCF-SAP 配接器的名稱。 例如,如果您將 WCF-SAP 配接器新增為 「SAPAdapter」,請將 「WCF-Custom」 取代為 「SAPAdapter」。
搜尋 「ConfigurationClsid」 屬性,並將屬性的現有值取代為 「A5F15999-8879-472d-8C62-3B5EA9406504」。
儲存並關閉系結檔案。
在 BizTalk Server 管理主控台中匯入系結檔案。 重複使用 SAP 配接器系結 會列出步驟。