步驟 1:將 Siebel 商務元件作業發佈為 WCF 服務
完成時間: 10 分鐘
目的: 您可以使用 WCF 配接器服務開發精靈來產生可在裝載環境中裝載的 WCF 服務,例如 Internet Information Services (IIS) 或 Windows Process Activation Service (WAS) 。 本主題示範如何使用精靈來產生 WCF 服務檔案。
必要條件
執行精靈之前,請先安裝下列專案:
Microsoft Windows Communication Foundation (WCF) BUSINESS (LOB) Adapter SDK 搭配 [ 完成 ] 選項或 [ 自訂 ] 選項 (並選擇此選項內的 [ 工具 ]) 。 這會安裝 WCF 配接器服務開發精靈的 Visual Studio 範本。
Microsoft BizTalk Adapter for Siebel eBusiness Applications
必要的 Siebel 用戶端。
如需這些必要條件的詳細資訊,請參閱 BizTalk 配接器套件安裝指南。 安裝指南通常會安裝在 < 安裝磁片磁碟機 > :\Program Files\Microsoft BizTalk 配接器套件\Documents。
將 Siebel 商務元件發佈為 WCF 服務
啟動 Visual Studio,然後建立專案。
在 [ 新增專案 ] 對話方塊中,從 [ 專案類型 ] 窗格中,選取 [Visual C#]。 從 [ 範本] 窗格中,選取 [WCF 配接器服務]。
或者,從 [ 專案類型] 窗格展開 [Visual C#],然後選取 [Web]。 從 [ 範本] 窗格中,選取 [WCF 配接器服務]。
注意
如果您使用 Web 開發元件安裝 Visual Studio,則您也可以從[新增網站] 選項取得WCF 配接器服務範本。
指定解決方案的名稱和位置,然後按一下 [ 確定]。 WCF 配接器服務開發精靈隨即啟動。
在 [歡迎] 頁面中按 [下一步] 。
在 [選擇作業] 頁面上,指定要連線到 Siebel 系統的連接字串。 若要這樣做:
在 [ 選取系結 ] 清單中,按一下 [siebelBinding],然後按一下 [ 設定]。
在 [ 設定配接器 ] 對話方塊中,按一下 [ 安全性] 索引 標籤。
在 [用戶端認證類型 ] 清單中,選取 [ 使用者名稱],然後指定要連線到 Siebel 系統的使用者名稱和密碼。
按一下 [ URI 屬性] 索引 標籤,然後指定連接參數的值。 如需 Siebel 配接器連線 URI 的詳細資訊,請參閱 建立 Siebel 系統連線 URI。
注意
如果連接參數包含任何保留字元, (例如 XML 特殊字元) ,您必須在 [URI 屬性 ] 索引標籤中依原樣指定它們,也就是不使用任何逸出字元。 不過,如果您直接在 [ 設定 URI ] 欄位中指定 URI,而連接參數包含保留字元,則必須使用適當的逸出字元來指定連接參數。
按一下 [ 系結屬性] 索引 標籤,然後針對您想要鎖定的作業指定系結屬性的值。
如需系結屬性的詳細資訊,請參閱 閱讀 BizTalk Adapter for Siebel 系結屬性。
按一下 [確定],然後按一下 [ 連線]。 建立連線之後,線上狀態會顯示為 [已連線]。
在 [選擇作業] 頁面上的 [ 選取合約類型 ] 清單中,按一下 [ 用戶端 (輸出作業]) 。
在 [ 選取類別] 方塊中,展開 [Siebel Business Objects] 節點,以查看 Siebel 存放庫中的商務物件清單。 在此範例中,請執行下列動作:
展開 [帳戶 ] 商務物件,然後按一下 [ 帳戶 商務] 元件。
在 [ 可用的類別和作業 ] 方塊中,選取 [查詢 ] 作業,然後按一下 [ 新增]。 選取的作業會列在 [ 新增類別和作業 ] 方塊中。
在 [選擇作業] 頁面上,按 [下一步]。
在 [設定服務和端點行為] 頁面上,指定要設定服務和端點行為的值。
在 [ 服務行為組態] 方塊中,指定下列各項的值:
針對 屬性 指定值 EnableMetadataExchange 將此設定為 True ,以建立中繼資料交換端點。 藉由將此設定為 True,您可以使用標準化通訊協定來提供服務中繼資料,例如 WS-Metadata Exchange (MEX) 和 HTTP/GET 要求。
預設值為 False。IncludeExceptionDetailsinFault 將此設定為 True ,以詳細說明傳回給用戶端以進行偵錯的 SOAP 錯誤,以包含 Managed 例外狀況資訊。 預設值為 False。 名稱 服務行為組態的名稱。 UseServiceCertificate 指定您是否要使用 WCF 的訊息層級安全性模式。 預設值為 True。
在本教學課程中,您必須將此設定為 False。FindValue 字串,指定要在 X.509 憑證存儲中搜尋的值。
注意: 只有當 UseServiceCertificate 設定為 True時,才指定此屬性的值。StoreLocation 值,指定服務可用來驗證用戶端憑證的憑證存放區位置。
注意: 只有當 UseServiceCertificate 設定為 True時,才指定此屬性的值。StoreName 要開啟的 X.509 憑證存儲名稱。
注意: 只有當 UseServiceCertificate 設定為 True時,才指定此屬性的值。X509FindType 要執行之 X.509 搜尋的類型。
注意: 只有當 UseServiceCertificate 設定為 True時,才指定此屬性的值。注意
如需憑證和相關屬性的詳細資訊,請參閱 X509ClientCertificateCredentialsElement 屬性。
在 [ 端點行為設定 ] 方塊中,指定下列各項的值:
針對 屬性 指定值 驗證類型 - 將此設定為 ClientCredentialUserNamePassword ,讓用戶端在取用 WCF 服務時指定使用者名稱和密碼。
- 將此設定為 HTTPUserNamePassword ,讓用戶端能夠將使用者名稱和密碼指定為 HTTP 標頭的一部分。
- 將此設定為 [自動 ] 以先讓用戶端透過 ClientCredential 介面指定認證。 如果失敗,用戶端可以傳遞認證做為 HTTP 標頭的一部分。
預設值為 Auto。若要讓 Microsoft Office SharePoint Server 取用 WCF 服務,您應該將此設定為 HTTPUserNamePassword。名稱 指定端點行為組態的名稱。 UsernameHeader 使用者名稱標頭的名稱。 在此範例中,請指定 MyUserHeader。 For more information about HTTP headers, see "Support for Custom HTTP and SOAP Headers" at https://go.microsoft.com/fwlink/?LinkId=106692.
注意: 如果 驗證類型 設定為 HTTPUserNamePassword,您必須指定此屬性的值。 如果 [驗證類型 ] 設定為 [自動],則此屬性是選擇性的。PasswordHeader 密碼標頭的名稱。 在此範例中,請指定 MyPassHeader。 For more information about HTTP headers, see "Support for Custom HTTP and SOAP Headers" at https://go.microsoft.com/fwlink/?LinkId=106692.
注意: 如果 驗證類型 設定為 HTTPUserNamePassword,您必須指定此屬性的值。 如果 [驗證類型 ] 設定為 [自動],則此屬性是選擇性的。下圖顯示具有指定值的 [設定服務和端點行為] 頁面。
在 [設定服務和端點行為] 頁面上,按 [ 下一步]。
在 [設定服務端點系結和位址] 頁面上,[ 選取合約以設定] 方塊會列出您在 [選擇作業] 頁面上選取作業之 Siebel 商務元件的合約。 [選取合約] 方塊下的 [作業] 會顯示您在 [選擇作業] 頁面上針對每個成品選取的作業。
在 [ 設定合約的位址和系結 ] 方塊中,指定下列值:
針對 屬性 指定值 繫結組態 精靈僅支援基本 HTTP 系結。 因此,系結組態欄位會自動填入 System.ServiceModel.Configuration.BasicHttpBindingElement。
按一下省略號按鈕 (...) 變更 HTTP 系結的屬性。 若要使用安全通道,您必須一律將 Mode 屬性設定為 Transport。 精靈會將 Mode 屬性的預設值設定為 Transport。
如需公開之其他系結的詳細資訊,請參閱 BasicHttpBindingElement 類別。端點名稱 指定合約的端點名稱。 此頁面的其他欄位會根據您在先前頁面中指定的值自動填入。
按一下 [套用]。 針對 [ 選取要設定的合約 ] 方塊底下顯示的所有合約執行此步驟。
注意
如果您未在此頁面上指定任何值,則會接受所有合約的預設值。
下圖顯示具有指定值的 [設定服務端點系結和位址] 頁面。
在 [設定服務端點系結和位址] 頁面上,按 [ 下一步]。 [摘要] 頁面會列出所選 Siebel 商務元件合約的樹狀結構,在該結構下,針對每個商務元件選取的作業。
檢閱摘要,然後按一下 [ 完成]。
精靈會建立 WCF 服務,並將下列檔案新增至 Visual Studio 專案:
.svc 檔案。 這是 WCF 服務檔案。 精靈會為每個合約產生一個檔案。
Web.config 檔案。
服務程式代碼 (.cs 檔案) 。
發佈 WCF 服務。
請確定已針對 Internet Information Services (IIS) 啟用 SSL。 請參閱 如何設定 SSL。
以滑鼠右鍵按一下方案總管中的專案,然後按一下 [發佈]。
在 [ 發佈 Web ] 對話方塊中,指定 WCF 服務的 URL。 例如:
https://<computer_name>/Siebel_Account/
從 [ 複製] 方塊中,按一下 [所有專案檔]。
按一下 [發佈]。
確認 WCF 服務已成功發佈。
啟動 IIS Microsoft Management Console。 按一下 [開始],指向 [ 系統管理工具],然後按一下 [ Internet Information Services]。
流覽至您發佈服務的節點。 針對Siebel_Account服務,流覽至[Internet Information Services>< 電腦名稱稱 >>] [網站>預設網站>] Siebel_Account。
在右窗格中,以滑鼠右鍵按一下 BusinessObjects_Account_Account_Operation.svc 檔案,然後按一下 [ 流覽]。
網頁會顯示用來擷取 WSDL 的 URL。 您可能想要使用 svcutil 命令來測試中繼資料擷取。 例如,擷取Siebel_Account服務的中繼資料的命令為:
svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl
後續步驟
您現在有 Siebel 商務元件的 WCF 服務。 使用商務資料目錄定義編輯器來建立 Siebel 商務元件作業的應用程式定義檔。 如需指示,請參閱 步驟 2:建立 Siebel Business Component Operations 的應用程式定義檔 。 應用程式定義檔會識別 LOB 資料的儲存位置及其儲存格式。