Query as a Web Service

Transcription

1 Query as a Web Service BusinessObjects Enterprise XI 3.1 windows

2 版權聲明 2009 SAP BusinessObjects All rights reserved SAP BusinessObjects 及其標誌 BusinessObjects Crystal Reports SAP BusinessObjects Rapid Mart SAP BusinessObjects Data Insight SAP BusinessObjects Desktop Intelligence SAP BusinessObjects Rapid Marts SAP BusinessObjects Watchlist Security SAP BusinessObjects Web Intelligence 和 Xcelsius 均為 SAP 公司 Business Objects 及 / 或關係企業在美國及 / 或其他國家之商標或註冊商標 SAP 為 SAP AG 在德國及 / 或其他國家之註冊商標 在此所提及的其他名稱可能為其個別所有人所擁有的商標

3 目錄 第 1 章 Query as a Web Service 簡介 Web 服務式查詢 是什麼? 以 Web 服務形式查詢能怎麼解決商務上的問題? 以 Web 服務形式查詢的伺服器與用戶端元件架構...8 第 2 章 安裝 Query as a Web Service Web 服務式查詢安裝必要條件 安裝和驗證 Web 服務式查詢 的方法 Web 服務式查詢 安裝疑難排解 確保 CMS 要在 Tomcat 之前啟動 變更預設的 CMS 啟動 Web 服務追蹤 讓 CMS 的可用性最佳化...12 第 3 章 啟動 Query as a Web Service Web 服務式查詢 的啟動先決條件 啟動 Web 服務式查詢 的方法 首次啟動以 Web 服務形式查詢 啟動以 Web 服務形式查詢 以不同登入憑證登入的方法 管理主機的方法 新增主機的方法 編輯主機的方法...18

4 4 Query as a Web Service 3.4 查詢目錄頁面...19 第 4 章 建立新查詢並發佈為 Web 服務 建立新查詢並發佈為 Web 服務 如何利用 發佈為 Web 服務精靈 建立新查詢 啟動 發佈為 Web 服務精靈 的方法 設定查詢名稱與說明屬性的方法 選取查詢的語意層 定義查詢的方法 預覽和發佈查詢的方法 如何以複製已發佈查詢的方式建立新查詢 複製現有已公佈查詢的方法...26 第 5 章 管理 Query as a Web Service 在查詢目錄中建立資料夾 編輯 Web 服務式查詢的方法 重新命名查詢 刪除以 Web 服務形式查詢 複製並貼上以 Web 服務形式查詢 檢視查詢屬性的方法 檢視可用查詢 Web 服務執行個體的方法 如何部署查詢到另一部 Web 伺服器 查詢部署中的 WSDL 檔案更新變更 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 從匯入精靈部署 Query as a Web Service 的方法 從 BIAR 檔部署 Query as a Web Service 的方法...33

5 目錄 將查詢部署到另一部伺服器時更新 WSDL 快取 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 查詢部署中的 WSDL 檔案更新變更 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 從匯入精靈部署 Query as a Web Service 的方法 從 BIAR 檔部署 Query as a Web Service 的方法 將查詢部署到另一部伺服器時更新 WSDL 快取 從匯入精靈部署 Query as a Web Service 的方法 查詢部署中的 WSDL 檔案更新變更 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 從匯入精靈部署 Query as a Web Service 的方法 從 BIAR 檔部署 Query as a Web Service 的方法 將查詢部署到另一部伺服器時更新 WSDL 快取 從 BIAR 檔部署 Query as a Web Service 的方法 查詢部署中的 WSDL 檔案更新變更 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 從匯入精靈部署 Query as a Web Service 的方法 從 BIAR 檔部署 Query as a Web Service 的方法 將查詢部署到另一部伺服器時更新 WSDL 快取 在多個 Web 伺服器上部署 Query as a Web Server 設定 Web 服務式查詢用戶端以連線至反向 Proxy Web 伺服器...44

6 6 Query as a Web Service 第 6 章 以不同應用程式取用 Query as a Web Service 以 WSDL 取用 Web 服務式查詢 在 Crystal Xcelsius 中取用 Web 服務式查詢 跨網域問題 選取 Web 服務的方法 輸入訊息 輸出訊息 Xcelsius 中的驗證 在 Crystal Report 中使用 Query as a Web Service 在 Microsoft Office InfoPath 中使用 Query as a Web Service 第 7 章 Web 服務呼叫 API 描述 52 第 8 章 Query as a Web Service 最佳作法和限制 使用 Query as a Web Service 最佳作法 Query as a Web Service 使用相關限制...55 附錄 A 詳細資訊 56 索引...58

7 第 1 章 Query as a Web Service 簡介 1.1 Web 服務式查詢 是什麼? Web 服務式查詢 是 Business Objects 的一款應用程式, 可讓商務使用者迅速建立查詢, 並當作 Web 服務發佈 Web 服務式查詢是在 BusinessObjects 語意層上建置好的 SQL 陳述式, 並當作 Web 服務發佈到主控 Web 服務的主機伺服器上 使用 Web 服務的所有應用程式都能使用 Web 服務式查詢, 讓使用者能從應用程式中存取查詢傳回的資料 本程式能以安全的方式把 Business Intelligence ( 簡稱 BI) 資訊傳遞到可取用 Web 服務的所有應用程式 Web 服務式查詢 有一個用戶端元件, 可用來從語意層建立查詢, 還有伺服器端 Web 服務, 可讓開發人員從特定的 Business Objects 查詢建立 Web 服務 1.2 以 Web 服務形式查詢能怎麼解決商務上的問題? Query as a Web Service 能把 BI 內容傳遞到可處理 Web 服務的所有使用者介面上, 讓商務使用者可以從語意層定義自己的查詢, 然後將該查詢發佈為獨立的 Web 服務 Query as a Web Service 可用來為公司行號提供新的用戶端解決方案 例如 Crystal Xcelsius 可使用 Query as a Web Service 把多個不同的資料來源, 彙總到受信任的 BI 檢視中 Query as a Web Service 也能讓您在以下工具中使用多種用戶端解決方案 : Microsoft Office Excel 和 InfoPath SAP NetWeaver OpenOffice 商務規則和程序管理應用程式 企業服務匯流技術平台

8 8 Query as a Web Service 附註 : Business Objects 為開發人員提供多種 Web 服務 開發人員會在 IDE 中以 C# and Java 等語言使用這些 Web 服務 如需詳細資訊, 請至 : 以 Web 服務形式查詢的伺服器與用戶端元件架構 Query as a Web Service 在設計上是以和其他 Web 服務相同的方式, 用於所有 Windows 應用程式上 Query as a Web Service 是以 W3C Web 服務規格 SOAP WSDL 和 XML 為基礎 它有兩個主要元件 : 伺服器元件 伺服器元件 ( 包含於 BusinessObjects XI R3) 會儲存 Query as a Web Service 目錄並主控發佈的 Web 服務 用戶端工具 商務使用者也可以在此建立並發佈 Query as a Web Service 您可以將用戶端工具裝在多部電腦上, 以便日後存取和共用伺服器上儲存的相同 Query as a Web Service 目錄 附註 : 在本指南中,Query as a Web Service 這個詞即代表用戶端 如果已知資訊指的是伺服器元件, 則實際上指的是 Query as a Web Service 的伺服器元件 用戶端會利用 Web 服務與伺服器元件進行通訊

9 第 2 章安裝 Query as a Web Service 2.1 Web 服務式查詢安裝必要條件 安裝 Web 服務式查詢 之前, 請閱讀 使用條款 的合約和條件, 並確定是否符合下列的安裝先決條件 : 下列項目必須安裝在伺服器上 : BusinessObjects XI Release 3 Enterprise Edition Web 服務 Tomcat 或其他支援的 Web 應用程式和 JDK 如需更新的支援 Web 應用程式和版本清單, 請參閱 : 下列項目必須在安裝 Web 服務式查詢 前安裝在用戶端上 :.NET 2.0 Framework 這是 Web 服務式查詢 用戶端的要求, 目的是用來建置和發佈查詢 您可在此下載.NET 2.0 Framework: 用戶端平台必須支援與 BusinessObjects XI Release 3 搭配使用 如需更新的支援版本清單, 請參閱 : 安裝和驗證 Web 服務式查詢 的方法 Web 服務式查詢 的伺服器元件會自動於具有 Web Intelligence 的 BusinessObjects Enterprise XI 3.0 安裝時一併安裝

10 10 Query as a Web Service 您必須接著在每部會透過 Web 服務存取伺服器的電腦上, 安裝 Web 服務式查詢 用戶端 您必須具有 Web 服務式查詢 用戶端的個別授權 它並不包含在 BusinessObjects XI 3.0 的一般授權中 1 瀏覽到 BusinessObjects Enterprise 隨附 CD 上的 Add-Ons\Query as a Web Service 資料夾, 或在您的網路上尋找 Query as a Web Service setup.exe 檔案 2 按兩下 setup.exe, 啟動 Web 服務式查詢 精靈 3 依照 Web 服務式查詢安裝精靈 中畫面上的指示, 完成安裝程序 您現在可以驗證安裝 4 要驗證安裝, 請開啟瀏覽器並輸入下列 URL 伺服器 ]:[ 連接埠 ]/dswsbobje, 其中 [ 伺服器 ] 對應到您的 Web 伺服器位址, 而 [ 連接埠 ] 則對應到您在 Web 伺服器中設定的連接埠 使用的預設連接埠為 8080 dswsbobje 是 Web 服務 提供者 Web 應用程式的預設名稱 5 按下 [ 驗證連結 ] 按鈕, 取得安裝狀態資訊 6 向下瀏覽, 確認 Web 服務式查詢 已安裝 您會看見 Found resource:/managequeryasaservice.wsd 7 在瀏覽器中輸入下列 URL: 伺服器 ]:[ 連接埠 ]/dswsbobje/qaawsser vices, 其中 [ 伺服器 ] 對應到您的 Web 伺服器位址, 而 [ 連接埠 ] 則對應到您在 Web 伺服器中設定的連接埠 會顯示您的瀏覽器頁面, 標題為 可用的 QaaWS 服務 本頁包含此系統上已建立之 Query as a Web Service 清單 2.3 Web 服務式查詢 安裝疑難排解 本節內容可協助您排除可能出現的安裝問題 請參閱本節結尾處的連結主題, 以取得以下各個問題的相關資訊 : 確保 CMS 要在 Tomcat 之前啟動 變更預設的 CMS 啟動 Web 服務追蹤 讓 CMS 的可用性最佳化

11 Web 服務式查詢 安裝疑難排解 確保 CMS 要在 Tomcat 之前啟動 確認 CMS 在 Tomcat 之前已啟動 啟動 Tomcat 期間, 在初始化 Servlet 時,QaaWS 快取會讀取 QaaWS 在儲存機制中的定義以建立其快取, 所以必須確保 CMS 要在 Tomcat 之前啟動 如果使用 NT 服務自動啟動 CMS, 就不必手動執行此操作 變更預設的 CMS 根據預設,Web 服務會連線到本機機器名稱的 CMS 如果您要變更為專屬的 CMS, 您必須變更 dsws.properties 檔案的網域屬性 如果使用預設值 (6400) 以外的 CMS 連接埠號碼, 且未變更 dsws.properties 檔案中的網域屬性, 則會收到錯誤訊息 找不到伺服器, 或伺服器可能已關閉 (FWM01003) 解決方案是, 在 dsws.properties 檔案 ( 位於 < 安裝路徑 >\warfiles\webapps\dswsbobje\web-nf\classes\) 中以網域屬性值 ( 網域 =CMSserverName:port) 指定新連接埠 此資訊會補充 中央管理系統 說明文件中的可用內容 為 Web 服務式查詢設定新的預設 CMS 1 停用 Tomcat 2 開啟 BusinessObjects Enterprise XI Release 3 的安裝路徑資料夾 : [InstallationPath]\warfiles\webapps\dswsbobje\WEB-INF\classes 3 開啟檔案 dsws.properties 並找到 : domain= 4 輸入您的 CMS 名稱 5 關閉並儲存 dsws.properties 檔案 6 啟動 Tomcat 啟動 Web 服務追蹤 如果出現組態問題,Business Objects 管理員可能必須設定追蹤, 才能達到更佳的疑難排解效果

12 12 Query as a Web Service Business Objects 強烈建議您僅使用追蹤, 以便在測試環境中進行疑難排解 啟動 Web 服務追蹤的方法 1 在 中央組態管理員 (CCM) 中停止 Apache Tomcat 服務 2 變更追蹤層級 根據預設,Query as a Web Service 只會追蹤錯誤 會要求您提供其他追蹤以取得產品支援 3 編輯位於 [installationpath]\dswsbobje\web-inf\classes\ 的 log4j.properties 4 在屬性檔案中輸入下列內容 :log4j.logger.com.businessobjects=debug, BO1 5 變更追蹤位置 根據預設, 會在輸出主控台中進行追蹤 如果您要追蹤檔案, 請註解 ConsoleAppender 並取消註解 RollingFileAppender 如果將 Tomcat 設為服務, 則會追蹤在檔案路徑 C:\WINDOWS\system32 下找到的 dswsbob je.log : # console appender # log4j.appender.bo1=org.apache.log4j.con soleappender # log4j.appender.axis1=org.apache.log4j.consoleappender #rolling file appender log4j.appender.bo1=org.apache.log4j.rollingfileap pender log4j.appender.bo1.file=dswsbobje.log log4j.appender.bo1.ap pend=false log4j.appender.bo1.maxbackupindex=5 log4j.appender.bo1.max FileSize=10 6 在 CCM 中, 啟動 Apache Tomcat 服務 讓 CMS 的可用性最佳化 CMS 可能只具有一個單獨的 CMS 系統資料庫 CMS 系統資料庫可能會基於下列原因而遺失 : 資料庫已關閉 CMS 和 CMS 系統資料庫之間的網路故障 CMS 電腦或應用程式的軟硬體故障 不管是哪種情況, 部署兩個 CMS 皆能降低兩個 CMS 都無法與 CMS 電腦上 CMS 系統資料庫通訊的可能性 但是如果 CMS 系統資料庫已關閉, 則所有 CMS 無法處理內送要求, 且不會發生任何錯誤, 無論叢集中存在單一 CMS 還是多個 CMS

13 Web 服務式查詢 安裝疑難排解 13 您可以運用資料庫廠商提供的容錯解決方案, 來限制風險 每個資料庫廠商都會提供容錯解決方案, 以將資料庫無法使用的風險降到最低 一個容錯選項可能會設定在次要伺服器上執行次要鏡像資料庫 例如, 如果第一個資料庫在 tns.ora 檔案外部, 則會自動更新以指向次要的資料庫伺服器 可用的容錯計量是資料庫專用計量, 請參閱特定資料庫廠商的文件以取得容錯計量的詳細資訊 附註 : 如果此功能可供使用並已啟用, 則即使遺失系統資料庫連線,CMS 也會自動重新建立資料庫連線, 且不需要管理員介入

14 第 3 章啟動 Query as a Web Service 3.1 Web 服務式查詢 的啟動先決條件 啟動 Web 服務式查詢 之前, 請務必達到下列先決條件 : 啟動先決條件 說明 使用者以 Administrator 身分登入, 或以 QaaWS Group Designer 中定義的身分登入 請在 Central Management Console 中定義使用者群組成員資格 如果您必須加入這個使用者群組, 請洽管理員 3.2 啟動 Web 服務式查詢 的方法 Web 服務式查詢 需與中央管理系統 (Central Management System, 簡稱 CMS) 搭配 CMS 包含的伺服器元件儲存了 Web 服務式查詢 目錄, 並主控發佈的 Web 服務 第一次啟動 Web 服務式查詢 時, 必須在啟動主機伺服器之前先加以定義 之後每次啟動 Web 服務式查詢 時, 都必須選取可用的主機伺服器, 然後登入 CMS 登入後就會出現 Web 服務式查詢 的啟動 [ 查詢目錄 ] 頁面 您可從這個頁面啟動建立與發佈查詢精靈, 以便發佈新查詢, 並編輯現有的已發佈查詢 首次啟動以 Web 服務形式查詢 第一次啟動 Query as a Web Service 時, 必須在安裝 Web 服務的 CMS 中定義主機伺服器 定義主機伺服器後, 下次啟動 Query as a Web Service 時就能自動使用本主機 您可定義多個主機伺服器, 但一次只能連線到其中一個 1 啟動 Query as a Web Service

15 啟動 Web 服務式查詢 的方法 15 此時會出現 [ 管理主機 ] 對話方塊 本對話方塊會列出可用的主機伺服器, 讓您加入新的伺服器和編輯現有伺服器 Query as a Web Service 第一次啟動時, 清單是空的 您必須先定義主機伺服器 2 按一下 [ 新增 ] 會顯示編輯主機對話方塊便 本方塊包含由您定義的參數, 用以建立新的主機伺服器 如需每個參數的說明, 請參閱 < 相關主題 > 中的章節 3 在 [ 編輯主機 ] 對話方塊中輸入必要資訊 4 按一下 [ 確定 ] 此時會出現 [ 管理主機 ] 對話方塊 現在會列出新的主機 5 選取新主機, 然後按一下 [ 關閉 ] 此時會出現 [ 請選取您的憑證 ] 登入方塊 現在可以使用新的主機資訊 6 輸入您的密碼, 然後按 [ 確定 ] 此時會出現 Query as a Web Service 用戶端啟動頁面 啟動以 Web 服務形式查詢 在啟動 Query as a Web Service 之前, 請確保自己符合下列的先決條件 如需詳細資訊, 請參閱 < 相關主題 > 您的使用者名稱必須在 QaaWS Group Designer 使用者群組中, 或是必須以 Administrator 身分登入 您已經定義了伺服器主機, 以儲存 Query as a Web Service 您第一次啟動 Query as a Web Service 時, 或是在 [ 編輯主機 ] 對話方塊中加入主機的其他時間內, 就會執行這個定義動作 如果要啟動 Query as a Web Service, 請選取主機伺服器, 然後在登入方塊中輸入登入資訊 您有下列登入欄位 : 登入資訊主機系統使用者 說明 在 CMS 中儲存查詢 Web 服務的伺服器 您必須先定義主機伺服器才能建立查詢 容納主機伺服器的中央管理伺服器 (CMS) 使用者名稱 必須是 QaaWS Group Designer 使用者群組的成員或 Administrator

16 16 Query as a Web Service 登入資訊 密碼 驗證 說明 使用者密碼, 由管理員指派給使用者 存取 CMS 時必要的驗證服務類型 本資訊是由管理員所提供 可用的通訊協定如下 : Enterprise LDAP Windows AD 啟用 Windows Active Directory 單一登入 介面地區設定 如果驗證通訊協定支援單一登入功能, 則予以選取 此選項只適用於 Windows AD 使用者介面使用的語言 您可從下拉式清單選取可用的語言 本清單包含已安裝且 Business Objects XI Enterprise Suite 支援的語言 1 在 Windows [ 開始 ] 功能表中指向 [ 程式集 ] > [Business Objects XI Release 3] > [BusinessObjects Enterprise] > [Web 服務式查詢 ] 此時會出現登入方塊 2 從 [ 主機 ] 下拉式清單中選取主機伺服器名稱 3 輸入系統 使用者名稱和密碼資訊 4 按一下 [ 選項 ] 登入方塊會顯示 [ 驗證 ] [ 單一登入 ] 和 [ 介面地區設定 ] 選項 5 選取登入資訊 6 按一下 [ 確定 ] 此時會出現 [ 查詢目錄 ] 頁面 您可以從此頁面建立 發佈和管理 Query as a Web Service 以不同登入憑證登入的方法 您可以用新使用者的身分登入 Web 服務式查詢, 而不必結束應用程式 選取 [ 工具 ] > [ 登入身分 ] 此時會出現登入方塊 輸入新使用者的資訊, 然後按一下 [ 確定 ]

17 管理主機的方法 管理主機的方法 主機是 CMS 中的伺服器元件, 可儲存 Web 服務式查詢 目錄, 並儲存發佈的 Web 服務 您可在第一次啟動 Web 服務式查詢 時建立主機 您可把主機加入 CMS, 並在 [ 管理主機 ] 對話方塊中, 設定現有主機的連線參數 您可從 [ 工具 ] 功能表存取 [ 管理主機 ] 對話方塊, 或是在登入 Web 服務式查詢 時從登入方塊存取此對話方塊 [ 管理主機 ] 對話方塊會列出主機伺服器 您可以使用下列主機管理選項 : 管理主機選項加入編輯刪除清除 說明 按一下即可定義新主機 從清單中選取主機名稱, 並按一下以編輯主機定義 選取主機名稱, 接著按一下即可移除清單中的主機 按一下即可清除清單中的所有主機 新增主機的方法 請從 [ 管理主機 ] 對話方塊新增主機 1 選取 [ 工具 ] > [ 管理主機 ] 此時會出現 [ 管理主機 ] 對話方塊 附註 : 您可在登入 Web 服務式查詢 時, 從登入方塊存取 [ 管理主機 ] 對話方塊 2 按一下 [ 新增 ] 按鈕 會顯示編輯主機對話方塊便 3 輸入主機參數資訊, 然後按一下 [ 確定 ] 此時已經把主機加入 [ 管理主機 ] 對話方塊的清單中

18 18 Query as a Web Service 4 按一下關閉 編輯主機的方法 請從 [ 編輯主機 ] 對話方塊編輯主機定義 您可以編輯下列主機參數 : 編輯主機參數名稱 URL CMS 說明 主機伺服器的名稱 此為出現在登入方塊中 [ 主機 ] 欄位內的名稱 主機伺服器的 URL 位址 系統會自動輸入主機的預設 URL 必要時可編輯此 URL 您應該確認 URL 中的連接埠位址是否正確 容納主機的 CMS 名稱 此為出現在登入方塊中 [ 系統 ] 欄位內的名稱 使用者 驗證 啟用 Windows Active Directory 單一登入 < 相關主題 > 中 < 啟動 Web 服務式查詢 的方法 > 一節說明了這些參數 1 選取 [ 工具 ] > [ 管理主機 ] 此時會出現 [ 管理主機 ] 對話方塊 附註 : 您可在登入 Web 服務式查詢 時, 從登入方塊存取 [ 管理主機 ] 對話方塊 2 按一下清單中的任一主機 3 按一下 [ 編輯 ] 按鈕 會顯示編輯主機對話方塊便 其中包含可編輯的主機參數 4 輸入或修改一個以上的值 5 按一下 [ 確定 ], 然後按一下 [ 關閉 ] 此時會出現登入方塊 您對主機所作的修改會立刻套用

19 查詢目錄頁面 查詢目錄頁面 啟動 Web 服務式查詢 時會出現 [ 查詢目錄 ] 頁面 此頁面會列出發佈到主機伺服器的查詢, 以及每個查詢使用的語意層 清單中每個已選取查詢的名稱 語意層名稱 說明和 WSDL 說明的 URL 位址, 都列在右邊的資訊窗格中 您可在 [ 查詢目錄 ] 頁面中建立和發佈新查詢, 並管理已經發佈到主機伺服器的查詢 您可以從 [ 查詢目錄 ] 頁面執行下列動作 : 功能表查詢編輯工具 可用的動作 建立新查詢, 並在目錄清單中建立資料夾, 以儲存並整理查詢 編輯查詢的定義 複製要當作新查詢範本使用的查詢 刪除 重新命名和重新整理清單中的查詢 把查詢部署到其他主機伺服器 您可使用 Windows 的標準編輯動作 : 剪下 複製和貼上 存取 [ 管理主機 ] 對話方塊, 以新增 編輯和刪除主機伺服器 登出後再登入為其他使用者, 或登入其他主機, 而不必結束應用程式 存取進階參數對話方塊, 以設定 Web URL 工作階段逾時限制和查詢的驗證模式

20 第 4 章建立新查詢並發佈為 Web 服務 4.1 建立新查詢並發佈為 Web 服務 您可以用兩種方法建立新的查詢, 以發佈為 Web 服務 : 使用 發佈為 Web 服務精靈 從頭定義查詢 複製現有的查詢當作定義範本, 並且修改定義後建立新查詢 4.2 如何利用 發佈為 Web 服務精靈 建立新查詢 您可使用 發佈為 Web 服務精靈 建立新查詢, 並發佈為 Web 服務 如果您要使用現有的查詢當作範本, 請參閱 < 相關主題 > 中討論複製已發佈查詢一節 您可以遵守此處所述的工作流程來建立和發佈查詢 請參閱本頁主題和結尾處, 以直接連結至對應於精靈步驟的 [ 說明 ] 頁面 每個說明頁面均完整描述您在目前精靈頁面上設定的內容 表格 4-1: 使用精靈建立查詢並發佈工作流程 建立查詢與發佈工作流程啟動 發佈為 Web 服務精靈 設定新查詢的名稱和說明 設定進階屬性選擇語意層當作查詢的資料來源 說明 您可從 [ 查詢目錄 ] 頁面啟動精靈 這就是登入主機時出現的頁面 輸入查詢的名稱和註解 您可設定反向 Proxy 用途 工作階段逾時限制和驗證類型的參數 您可選取語意層, 裡面包含要用於查詢的物件 語意層是查詢的資料來源

21 如何利用 發佈為 Web 服務精靈 建立新查詢 21 建立查詢與發佈工作流程 使用 查詢面板 建置查詢 預覽新查詢並發佈為 Web 服務 說明 您可使用 查詢面板 建置查詢, 以結合維度和計量, 並設定查詢的條件 您可預覽查詢的 SQL, 並把此查詢當成 Web 服務發佈到主機伺服器 啟動 發佈為 Web 服務精靈 的方法 您可使用 發佈為 Web 服務精靈 建立和發佈新查詢 您可從 [ 查詢目錄 ] 頁面啟動精靈 精靈的每一頁都有 [ 說明 ] 頁面 1 啟動 Query as a Web Service 此時會出現 [ 查詢目錄 ] 頁面 其中列出主機伺服器中儲存的目前查詢 Web 服務 2 選取 [ 查詢 ] > [ 新增 ][ 查詢 ] 發佈為 Web 服務精靈 開啟到 [ 描述 ] 頁面 您可在本頁面中輸入名稱 說明和進階參數資訊 設定查詢名稱與說明屬性的方法 在 發佈為 Web 服務精靈 的 [ 描述 ] 頁面上, 指定要發佈為 Web 服務的新查詢名稱與說明 1 輸入查詢的名稱與說明 2 執行下列其中一項動作 : 如果要為了反向 Proxy 用途 工作階段逾時限制或驗證類型等設定參數, 則按一下 [ 進階參數 ] 按鈕 如果不要設定進階參數, 則按 [ 下一步 ] 此時會出現進階參數對話方塊或精靈 [ 選取語意層 ] 頁面的下一頁, 視您的選擇而定 設定 Web 服務進階參數的方法 您可在 [ 進階參數 ] 對話方塊中設定下列參數 : 使用 Web 服務 URL 的反向 Proxy 用途

22 22 Query as a Web Service 工作階段逾時限制 適用於 Web 服務消費者的驗證模式 本設定只在 Web 服務受到取用時才適用於此 Web 服務 本節結尾處所列主題將說明每個選項 1 按一下 發佈為 Web 服務精靈 的 [ 描述 ] 頁面上的 [ 進階 ] 按鈕 此時會出現 [ 進階參數 ] 對話方塊 2 執行下列其中一項動作 : 編輯或鍵入新的 Web 服務 URL 鍵入 ( 或使用向上鍵和向下鍵輸入 ) 工作階段逾時限制的新值 從下拉式清單方塊中選取驗證模式 3 按一下確定 此時會出現 [ 描述 ] 頁面 您可在此頁面中繼續定義查詢 Web 服務 URL 反向 Proxy 是將電腦的網路位址從指定網路 URL 轉譯為另一網路 ( 通常是網際網路之類的外部網路 ) 的 URL 在公司網路內名稱為 myserver.company.com 的伺服器在外部網路中可能稱為 : 要支援這類部署, 您必須設定 Web 服務基礎 URL 基礎 URL 包含您希望可以從該處存取您 Web 服務的外部 URL, 例如 工作階段逾時 為提升 Query as a Web Service 效能 ( 特別是階層式呼叫案例 ), 使用者的伺服器連線會由 Web 服務提供者快取 您可以為每個 Query as a Web Service 連線設定工作階段逾時 ( 單位為秒 ) 預設值是 60 秒 例如, 如果特定使用者登入呼叫服務 1 並於 60 秒內以相同登入 ( 相同使用者名稱和密碼 ) 呼叫服務 2, 伺服器會重新使用相同連線並重新初始化工作階段逾時 驗證模式 驗證模式是目錄類型,BusinessObjects XI 平台會對照此目錄驗證登入 範例包括 Enterprise LDAP Windows AD 和 SAP 您可以設定驗證模式, 使其根據服務或由使用者加以定義 :

23 如何利用 發佈為 Web 服務精靈 建立新查詢 23 服務 您 ( 管理員 ) 可以選擇驗證目錄, 所有後續存取服務的使用者都會於此目錄驗證 ( 除工作階段 ID 選項外 ) 伺服器支援的所有驗證目錄都可以在 [ 驗證模式 ] 下拉式清單中選擇 消費者定義 查詢消費者可以將驗證模式選為 authenticationtype 輸入參數 選取查詢的語意層 發佈為 Web 服務精靈 的 [ 選取語意層 ] 頁面, 列出了 CMS 可使用的語意層 您可選取要當作查詢資料來源的語意層 1 按一下清單中的任一語意層 此時說明方塊中會出現已選取語意層的描述 2 按一下下一步 此時會出現精靈的 [ 查詢 ] 頁面 定義查詢的方法 發佈為 Web 服務精靈 的 [ 查詢 ] 頁面讓您使用查詢面板, 根據語意層定義查詢 查詢面板是以 Web Intelligence HTML 查詢面板 為基礎 查詢面板在本節中有簡短描述, 並說明如何建置查詢, 但查詢面板的完整說明在於 使用 Web Intelligence 查詢 - HTML 建立查詢 指南中 如需詳細資訊, 請參閱本版本說明文件中的本指南 查詢面板包含下列區域 : 語意層窗格 結果物件窗格 查詢面板左邊的窗格, 包含樹狀結構的類別 維度和計量 這些物件可對應到資料庫中的 SQL 結構 您可使用這些物件建置自己的查詢 您可把查詢的物件拖曳到此窗格 如果要排序每個物件的資料, 請以滑鼠右鍵按一下某物件, 然後選取排序類別

24 24 Query as a Web Service 篩選物件窗格 您可拖曳物件以定義篩選器, 限制查詢傳回的資料 您可從清單選取運算子 使用常數套用篩選器 列出數值, 或定義使用者輸入的提示 1 請在 [ 語意層 ] 窗格中執行下列其中一項動作 : 按兩下查詢的物件 選取物件, 然後拖曳到 [ 結果物件 ] 窗格 查詢物件會在 [ 結果物件 ] 窗格中對齊 如果要變更查詢中某物件的順序, 請在選取物件後拖曳到所要的位置 如果要移除任何物件, 請在選取物件後拖曳回 [ 語意層 ] 窗格 2 如果要建立篩選器, 請按兩下篩選物件, 或把篩選物件拖曳到 [ 篩選物件 ] 窗格 此物件會自動與運算子的下拉式清單 常數的文字方塊, 以及數值或提示清單的下拉式清單建立關聯 3 請選取運算子, 然後從下拉式清單選取必要的篩選器 < 相關主題 > 中說明了每個可用的篩選器 4 按一下確定 設定查詢限制的方法 此時會出現精靈的 [ 預覽 ] 頁面 您可設定限制讓查詢效能最佳化 您可以設定下列限制 : 限制重複資料列擷取時間上限擷取的資料列數上限 說明 選取後可傳回重複的資料列 依預設, 查詢不會傳回重複列 所允許的取得資料作業最長時間 預設值 -1 代表停用本選項, 且系統會套用在語意層連線參數中設定的值 查詢要擷取的最大資料列數 預設值 -1 代表停用本選項, 且系統會套用在語意層連線參數中設定的值

25 如何利用 發佈為 Web 服務精靈 建立新查詢 25 限制 範例結果集 說明 在執行查詢之前, 您要傳回的範例結果集資料列數 1 在查詢窗格中按一下頁面左上角的選項圖示 此時會出現具有查詢限制選項的對話方塊 2 在必要的地方設定限制值 3 按一下 [ 確定 ] 定義查詢排序順序的方法 您可定義語意層中每個物件的排序方式 您也可以定義物件的排序優先順序 1 在查詢窗格中按一下 [ 語意層 ] 窗格上方的 [ 管理排序 ] 圖示 此時會出現具有排序選項的對話方塊 2 展開 [ 可用的物件 ] 窗格中的資料夾, 然後選取一個物件 3 按兩下此物件, 或按一下箭頭以便把物件放到 [ 查詢排序 ] 窗格中 4 選取 [ 查詢排序 ] 窗格中的此物件, 然後按一下 [ 遞增 ] 或 [ 遞減 ] 5 必要時選取某物件然後按一下 [ 向上移 ] 或 [ 向下移 ] 按鈕 6 按一下確定 定義值清單的方法 如果要定義值清單, 請在 [ 查詢 ] 頁面中選取物件, 然後在值清單頁面上定義值清單 1 從 [ 查詢 ] 頁面把物件拖曳到 [ 篩選物件 ] 窗格中 此時會出現一個文字方塊, 兩邊各有一個下拉式清單篩選器 2 從文字方塊左邊的下拉式清單中選取 [ 在清單中 ], 然後從文字方塊右邊的下拉式清單中選取 [ 值清單 ] 此時會出現 [ 值清單 ] 對話方塊 3 在清單窗格中要出現在值清單內的每個值上按兩下 此時 [ 選取的值 ] 窗格中會出現值 4 按一下 [ 確定 ] 此時文字方塊中會出現值

26 26 Query as a Web Service 定義提示的方法 如果要定義提示, 請選取 [ 查詢 ] 頁面中的物件, 然後開啟提示頁面以定義提示 1 從 [ 查詢 ] 頁面把提示物件拖曳到 [ 篩選物件 ] 窗格中 此時會出現一個文字方塊, 兩邊各有一個下拉式清單篩選器 2 從文字方塊右邊的下拉式清單中選取 [ 提示 ] 此時會出現提示圖示 3 按一下提示圖示 此時會出現 [ 定義提示 ] 方塊 輸入要讓提示顯示的文字, 然後選取要套用到提示的選項 4 按一下 [ 確定 ] 預覽和發佈查詢的方法 發佈為 Web 服務精靈 的 [ 預覽 ] 頁面讓您預覽查詢中的物件和結果表格 您對預覽滿意後, 即可把 Web 服務式查詢發佈到主機伺服器 1 請確認查詢的語意層 物件和結果都正確 2 按一下發行 系統會把查詢當作 Web 服務發佈到主機伺服器上, 並列在 [ 查詢目錄 ] 頁面中 4.3 如何以複製已發佈查詢的方式建立新查詢 您可複製已發佈的查詢以便建立新查詢, 並將其當作範本建立新的查詢 複製查詢後, 發佈為 Web 服務精靈 就會自動啟動, 讓您以使用此精靈建立新查詢的相同方式修改定義 您必須有適當的使用者權限才能把查詢複製到資料夾中, 並加入新的查詢到其他資料夾 複製現有已公佈查詢的方法 如果要複製查詢以建立新的查詢定義, 方法如下 : 1 執行下列其中一項動作 :

27 如何以複製已發佈查詢的方式建立新查詢 27 在 [ 查詢目錄 ] 頁面中選取所列的查詢, 然後選取 [ 查詢 ] > [ 複製 ] 以滑鼠右鍵按一下 [ 查詢目錄 ] 頁面清單中的查詢, 然後從清單中選取 [ 複製 ] 此時會啟動 發佈為 Web 服務精靈 2 隨著精靈步驟重新命名與修改查詢定義

28 第 5 章管理 Query as a Web Service 5.1 在查詢目錄中建立資料夾 您可在 [ 查詢目錄 ] 頁面中建立資料夾, 以整理清單中的查詢 請在 [ 查詢目錄 ] 頁面上執行下列其中一項動作 : 按一下根資料夾, 然後選取 [ 查詢 ] > [ 新增資料夾 ] 以滑鼠右鍵按一下根資料夾, 然後從清單中選取 [ 新增資料夾 ] 此時清單中已經建立一個新資料夾 您可以在清單中的任何資料夾內建立資料夾 5.2 編輯 Web 服務式查詢的方法 您可隨時針對已經發佈為 Web 服務的查詢修改定義 編輯 Web 服務式查詢可能會變更相關聯的 "WSDL", 這可能會破壞他人用來與 Web 服務通訊的連結 Business Objects 建議您通知使用者有關您執行的任何變更 1 從 [ 查詢目錄 ] 頁面選取您要編輯的查詢 2 執行下列其中一項動作 : 選取 [ 查詢 ] > [ 編輯 ] 按兩下其中一個查詢 以滑鼠右鍵按一下查詢, 然後從目錄清單選取 [ 編輯 ] 此時會啟動 發佈為 Web 服務精靈 3 隨著精靈步驟編輯查詢, 然後重新發佈查詢 5.3 重新命名查詢 您可在 [ 查詢目錄 ] 頁面中重新命名查詢 系統會立刻套用新的名稱 您不需要重新發佈查詢即可套用新名稱, 因為 CMS 是以唯一識別碼 (CUID) 識別 Web 服務, 而不像舊版是以查詢名稱識別

29 刪除以 Web 服務形式查詢 29 1 請在 [ 查詢目錄 ] 頁面上執行下列其中一項動作 : 按兩下清單中的任一查詢 選取清單中的任一查詢, 然後選取 [ 查詢 ] > [ 重新命名 ] 此時會醒目提示此查詢 2 輸入新名稱 系統會立刻套用新的名稱 5.4 刪除以 Web 服務形式查詢 您可刪除 查詢目錄 清單中的查詢 執行下列其中一項操作 : 在 [ 查詢目錄 ] 頁面中選取所列的查詢, 然後選取 [ 編輯 ] > [ 刪除 ] 以滑鼠右鍵按一下 查詢目錄 清單中的查詢, 然後從清單中選取 [ 刪除 ] 如此即可從主機移除此查詢 5.5 複製並貼上以 Web 服務形式查詢 您可複製查詢, 然後在 查詢目錄 中的各個資料夾之間貼上查詢 確保自己有適當的使用者權限, 可執行複製作業 1 執行下列其中一項操作 : 在 查詢目錄 清單中選取查詢, 然後選取 [ 編輯 ] > [ 複製 ] 以滑鼠右鍵按一下 查詢目錄 清單中的查詢, 然後從滑鼠右鍵清單中選取 [ 複製 ] 2 按一下要貼上查詢複本的地方, 然後選取 [ 編輯 ] > [ 貼上 ], 或以滑鼠右鍵按一下並從清單中選取 [ 貼上 ] 所複製的查詢會出現在 查詢目錄 清單中 5.6 檢視查詢屬性的方法 您可以從 [ 查詢目錄 ] 頁面檢視查詢屬性 1 在 [ 查詢目錄 ] 頁面中, 選取清單中的任一查詢 必要時開啟資料夾以瀏覽至查詢

30 30 Query as a Web Service 屬性會顯示在查詢清單右側 2 按一下 URL Web 瀏覽器中會顯示查詢說明的連結 WSDL 定義則會在 Web 瀏覽器中開啟 3 按一下網頁中的 WSDL 連結, 以查看 WSDL 5.7 檢視可用查詢 Web 服務執行個體的方法 您可以在 Web 瀏覽器中檢視 Web 服務式查詢 的可用執行個體 開啟 Web 瀏覽器, 然後移至下列 URL:dswsbobje of server>:<tomcat port number>/dswsbobje/ qaawsservices

31 如何部署查詢到另一部 Web 伺服器 如何部署查詢到另一部 Web 伺服器 本節說明如何部署到另一部伺服器 方法是把一部伺服器上的 Web 服務式查詢 定義, 複製到另一部伺服器 例如, 您可以將查詢定義從程式開發伺服器移至測試或實際執行伺服器 要部署到另一部伺服器, 您可以選擇下列其中一個方法 : Query as a Web Service 您使用 [ 部署到其他伺服器 ] 選項 此方法的優點是查詢會自動在新的應用程式伺服器上更新查詢的 WSDL 快取 如果您未使用此方法, 您必須手動更新 WSDL 快取 匯入精靈 您必須為部署的查詢手動更新 WSDL 快取 BIAR 檔 您必須為部署的查詢手動更新 WSDL 快取 附註 : 開始前, 請確認兩部電腦上的語意層和使用者是相同的 使用匯入精靈或 BIAR 檔案匯入語意層和使用者 在匯入精靈作業期間使用相同的 CUID 是很重要的 相關主題 第 44 頁的 將查詢部署到另一部伺服器時更新 WSDL 快取 查詢部署中的 WSDL 檔案更新變更 此版本的 WSDL 檔案更新已變更 從本版本開始,Servlet 會將所有的 WSDL 檔案以.ZIP 檔格式儲存在應用程式伺服器上 之前每次發行查詢時,Servlet 都會連線至 CMS 查詢的 WSDL 為動態更新 現在, 您不再需要連線至 CMS 每當發行或更新新的 QaaWS 查詢時,WSDL 檔案便會新增至此.ZIP 檔中 其他執行階段參數也儲存在 WSDL 快取中, 例如驗證模式, 以及 Web 服務耗用時使用的地區設定與逾時值 當您使用 [ 部署到其他伺服器 ] 選項, 將查詢部署至另一個應用程式伺服器時, 會自動更新 WSDL 快取 如果您使用 匯入精靈 或 BIAR 檔將查詢部署至其他應用程式伺服器, 則您必須手動更新 WSDL.ZIP 檔 相關主題 一節會加以說明 相關主題 第 44 頁的 將查詢部署到另一部伺服器時更新 WSDL 快取

32 32 Query as a Web Service 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 您可以使用 Query as a Web Service 用戶端, 將查詢一次部署到另一部使用相同服務名稱的伺服器 您可以在兩部安裝相同版本的 Query as a Web Service 的伺服器之間, 使用 [ 部署到另一部伺服器 ] 選項 使用這個選項, 無法將查詢從某一版本移轉至另一版本 1 在查詢目錄中, 選擇要複製其定義的 Query as a Web Service 2 按一下 [ 部署到另一部伺服器 ] 會出現 [ 選取您的憑證 ] 對話方塊 3 為要部署 Web 服務的系統完成資訊, 然後按 [ 確定 ] Query as a Web Service 會出現在 發行 Query as a Web Service 精靈 中 4 將 Query as a Web Service 發行到新系統 將 Query as a Web Service 定義部署到另一個伺服器會自動變更 WSDL 位置和服務執行位置 附註 : 您可以使用精靈自訂此服務架構式 URL 您也可以使用 Web 服務連線的 [ 輸入值 ] 文字方塊, 在 Xcelsius 專案中將其設為動態 使用這個功能, 您只要變更 URL, 即可將儀器板從程式開發切換為實際執行 您無法將相同的查詢服務名稱重複部署到同一部伺服器 從匯入精靈部署 Query as a Web Service 的方法 要使用匯入精靈部署, 請從來源伺服器將 Query as a Web Service 定義匯入目的端伺服器 1 在來源伺服器上啟動匯入精靈 2 在登入來源 CMS 後, 選擇要將定義匯出到哪個目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱

33 如何部署查詢到另一部 Web 伺服器 33 5 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇已匯入定義的來源檔案 8 登入 CMS 9 在 [ 匯入精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 10 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格中, 選取所要的 Query as a Web Service 定義 11 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 從 BIAR 檔部署 Query as a Web Service 的方法 確認匯入精靈已安裝在來源和目的端伺服器上 1 在來源伺服器上開啟 [ 匯入精靈 ] 2 在登入來源 CMS 後, 選擇要匯出定義的目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 繼續完成匯入精靈的剩餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇要匯出定義的 BIAR 檔案 8 登入目的端 CMS 9 在 [ 選取要匯入的物件 ] 對話方塊中, 選擇匯入資料夾和物件 > 匯入應用程式資料夾和物件 10 在 [ 選取應用程式資料夾和物件 ] 對話方塊中, 選擇所要的 Query as a Web Service 定義 11 繼續完成匯入精靈的剩餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器

34 34 Query as a Web Service 將查詢部署到另一部伺服器時更新 WSDL 快取 如果您未使用以 Web 服務形式查詢中的 [ 部署到另一部伺服器 ] 選項來部署另一部伺服器, 則必須手動更新 WSDL 快取, 確保該查詢與 CMS 會同步處理 當您使用匯入精靈, 或使用 BIAR 檔將查詢部署到另一部伺服器時, 請執行此動作 將查詢部署到另一部應用程式伺服器時, 若要手動更新 WDSL, 請執行下列步驟 : 移至下列 URL: 如有需要, 請輸入 CMS 的登入資訊 WSDL 檔會自動更新 5.9 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 您可以使用 Query as a Web Service 用戶端, 將查詢一次部署到另一部使用相同服務名稱的伺服器 您可以在兩部安裝相同版本的 Query as a Web Service 的伺服器之間, 使用 [ 部署到另一部伺服器 ] 選項 使用這個選項, 無法將查詢從某一版本移轉至另一版本 1 在查詢目錄中, 選擇要複製其定義的 Query as a Web Service 2 按一下 [ 部署到另一部伺服器 ] 會出現 [ 選取您的憑證 ] 對話方塊 3 為要部署 Web 服務的系統完成資訊, 然後按 [ 確定 ] Query as a Web Service 會出現在 發行 Query as a Web Service 精靈 中 4 將 Query as a Web Service 發行到新系統 將 Query as a Web Service 定義部署到另一個伺服器會自動變更 WSDL 位置和服務執行位置

35 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 35 附註 : 您可以使用精靈自訂此服務架構式 URL 您也可以使用 Web 服務連線的 [ 輸入值 ] 文字方塊, 在 Xcelsius 專案中將其設為動態 使用這個功能, 您只要變更 URL, 即可將儀器板從程式開發切換為實際執行 您無法將相同的查詢服務名稱重複部署到同一部伺服器 查詢部署中的 WSDL 檔案更新變更 此版本的 WSDL 檔案更新已變更 從本版本開始,Servlet 會將所有的 WSDL 檔案以.ZIP 檔格式儲存在應用程式伺服器上 之前每次發行查詢時,Servlet 都會連線至 CMS 查詢的 WSDL 為動態更新 現在, 您不再需要連線至 CMS 每當發行或更新新的 QaaWS 查詢時,WSDL 檔案便會新增至此.ZIP 檔中 其他執行階段參數也儲存在 WSDL 快取中, 例如驗證模式, 以及 Web 服務耗用時使用的地區設定與逾時值 當您使用 [ 部署到其他伺服器 ] 選項, 將查詢部署至另一個應用程式伺服器時, 會自動更新 WSDL 快取 如果您使用 匯入精靈 或 BIAR 檔將查詢部署至其他應用程式伺服器, 則您必須手動更新 WSDL.ZIP 檔 相關主題 一節會加以說明 相關主題 第 44 頁的 將查詢部署到另一部伺服器時更新 WSDL 快取 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 您可以使用 Query as a Web Service 用戶端, 將查詢一次部署到另一部使用相同服務名稱的伺服器 您可以在兩部安裝相同版本的 Query as a Web Service 的伺服器之間, 使用 [ 部署到另一部伺服器 ] 選項 使用這個選項, 無法將查詢從某一版本移轉至另一版本 1 在查詢目錄中, 選擇要複製其定義的 Query as a Web Service 2 按一下 [ 部署到另一部伺服器 ] 會出現 [ 選取您的憑證 ] 對話方塊 3 為要部署 Web 服務的系統完成資訊, 然後按 [ 確定 ] Query as a Web Service 會出現在 發行 Query as a Web Service 精靈 中

36 36 Query as a Web Service 4 將 Query as a Web Service 發行到新系統 將 Query as a Web Service 定義部署到另一個伺服器會自動變更 WSDL 位置和服務執行位置 附註 : 您可以使用精靈自訂此服務架構式 URL 您也可以使用 Web 服務連線的 [ 輸入值 ] 文字方塊, 在 Xcelsius 專案中將其設為動態 使用這個功能, 您只要變更 URL, 即可將儀器板從程式開發切換為實際執行 您無法將相同的查詢服務名稱重複部署到同一部伺服器 從匯入精靈部署 Query as a Web Service 的方法 要使用匯入精靈部署, 請從來源伺服器將 Query as a Web Service 定義匯入目的端伺服器 1 在來源伺服器上啟動匯入精靈 2 在登入來源 CMS 後, 選擇要將定義匯出到哪個目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇已匯入定義的來源檔案 8 登入 CMS 9 在 [ 匯入精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 10 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格中, 選取所要的 Query as a Web Service 定義 11 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 從 BIAR 檔部署 Query as a Web Service 的方法 確認匯入精靈已安裝在來源和目的端伺服器上 1 在來源伺服器上開啟 [ 匯入精靈 ]

37 從匯入精靈部署 Query as a Web Service 的方法 37 2 在登入來源 CMS 後, 選擇要匯出定義的目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 繼續完成匯入精靈的剩餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇要匯出定義的 BIAR 檔案 8 登入目的端 CMS 9 在 [ 選取要匯入的物件 ] 對話方塊中, 選擇匯入資料夾和物件 > 匯入應用程式資料夾和物件 10 在 [ 選取應用程式資料夾和物件 ] 對話方塊中, 選擇所要的 Query as a Web Service 定義 11 繼續完成匯入精靈的剩餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 將查詢部署到另一部伺服器時更新 WSDL 快取 如果您未使用以 Web 服務形式查詢中的 [ 部署到另一部伺服器 ] 選項來部署另一部伺服器, 則必須手動更新 WSDL 快取, 確保該查詢與 CMS 會同步處理 當您使用匯入精靈, 或使用 BIAR 檔將查詢部署到另一部伺服器時, 請執行此動作 將查詢部署到另一部應用程式伺服器時, 若要手動更新 WDSL, 請執行下列步驟 : 移至下列 URL: 如有需要, 請輸入 CMS 的登入資訊 WSDL 檔會自動更新 5.10 從匯入精靈部署 Query as a Web Service 的方法 要使用匯入精靈部署, 請從來源伺服器將 Query as a Web Service 定義匯入目的端伺服器 1 在來源伺服器上啟動匯入精靈

38 38 Query as a Web Service 2 在登入來源 CMS 後, 選擇要將定義匯出到哪個目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇已匯入定義的來源檔案 8 登入 CMS 9 在 [ 匯入精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 10 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格中, 選取所要的 Query as a Web Service 定義 11 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 查詢部署中的 WSDL 檔案更新變更 此版本的 WSDL 檔案更新已變更 從本版本開始,Servlet 會將所有的 WSDL 檔案以.ZIP 檔格式儲存在應用程式伺服器上 之前每次發行查詢時,Servlet 都會連線至 CMS 查詢的 WSDL 為動態更新 現在, 您不再需要連線至 CMS 每當發行或更新新的 QaaWS 查詢時,WSDL 檔案便會新增至此.ZIP 檔中 其他執行階段參數也儲存在 WSDL 快取中, 例如驗證模式, 以及 Web 服務耗用時使用的地區設定與逾時值 當您使用 [ 部署到其他伺服器 ] 選項, 將查詢部署至另一個應用程式伺服器時, 會自動更新 WSDL 快取 如果您使用 匯入精靈 或 BIAR 檔將查詢部署至其他應用程式伺服器, 則您必須手動更新 WSDL.ZIP 檔 相關主題 一節會加以說明 相關主題 第 44 頁的 將查詢部署到另一部伺服器時更新 WSDL 快取 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 您可以使用 Query as a Web Service 用戶端, 將查詢一次部署到另一部使用相同服務名稱的伺服器

39 從匯入精靈部署 Query as a Web Service 的方法 39 您可以在兩部安裝相同版本的 Query as a Web Service 的伺服器之間, 使用 [ 部署到另一部伺服器 ] 選項 使用這個選項, 無法將查詢從某一版本移轉至另一版本 1 在查詢目錄中, 選擇要複製其定義的 Query as a Web Service 2 按一下 [ 部署到另一部伺服器 ] 會出現 [ 選取您的憑證 ] 對話方塊 3 為要部署 Web 服務的系統完成資訊, 然後按 [ 確定 ] Query as a Web Service 會出現在 發行 Query as a Web Service 精靈 中 4 將 Query as a Web Service 發行到新系統 將 Query as a Web Service 定義部署到另一個伺服器會自動變更 WSDL 位置和服務執行位置 附註 : 您可以使用精靈自訂此服務架構式 URL 您也可以使用 Web 服務連線的 [ 輸入值 ] 文字方塊, 在 Xcelsius 專案中將其設為動態 使用這個功能, 您只要變更 URL, 即可將儀器板從程式開發切換為實際執行 您無法將相同的查詢服務名稱重複部署到同一部伺服器 從匯入精靈部署 Query as a Web Service 的方法 要使用匯入精靈部署, 請從來源伺服器將 Query as a Web Service 定義匯入目的端伺服器 1 在來源伺服器上啟動匯入精靈 2 在登入來源 CMS 後, 選擇要將定義匯出到哪個目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇已匯入定義的來源檔案 8 登入 CMS

40 40 Query as a Web Service 9 在 [ 匯入精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 10 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格中, 選取所要的 Query as a Web Service 定義 11 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 從 BIAR 檔部署 Query as a Web Service 的方法 確認匯入精靈已安裝在來源和目的端伺服器上 1 在來源伺服器上開啟 [ 匯入精靈 ] 2 在登入來源 CMS 後, 選擇要匯出定義的目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 繼續完成匯入精靈的剩餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇要匯出定義的 BIAR 檔案 8 登入目的端 CMS 9 在 [ 選取要匯入的物件 ] 對話方塊中, 選擇匯入資料夾和物件 > 匯入應用程式資料夾和物件 10 在 [ 選取應用程式資料夾和物件 ] 對話方塊中, 選擇所要的 Query as a Web Service 定義 11 繼續完成匯入精靈的剩餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 將查詢部署到另一部伺服器時更新 WSDL 快取 如果您未使用以 Web 服務形式查詢中的 [ 部署到另一部伺服器 ] 選項來部署另一部伺服器, 則必須手動更新 WSDL 快取, 確保該查詢與 CMS 會同步處理 當您使用匯入精靈, 或使用 BIAR 檔將查詢部署到另一部伺服器時, 請執行此動作 將查詢部署到另一部應用程式伺服器時, 若要手動更新 WDSL, 請執行下列步驟 :

41 從 BIAR 檔部署 Query as a Web Service 的方法 41 移至下列 URL: 如有需要, 請輸入 CMS 的登入資訊 WSDL 檔會自動更新 5.11 從 BIAR 檔部署 Query as a Web Service 的方法 確認匯入精靈已安裝在來源和目的端伺服器上 1 在來源伺服器上開啟 [ 匯入精靈 ] 2 在登入來源 CMS 後, 選擇要匯出定義的目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 繼續完成匯入精靈的剩餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇要匯出定義的 BIAR 檔案 8 登入目的端 CMS 9 在 [ 選取要匯入的物件 ] 對話方塊中, 選擇匯入資料夾和物件 > 匯入應用程式資料夾和物件 10 在 [ 選取應用程式資料夾和物件 ] 對話方塊中, 選擇所要的 Query as a Web Service 定義 11 繼續完成匯入精靈的剩餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 查詢部署中的 WSDL 檔案更新變更 此版本的 WSDL 檔案更新已變更 從本版本開始,Servlet 會將所有的 WSDL 檔案以.ZIP 檔格式儲存在應用程式伺服器上 之前每次發行查詢時,Servlet 都會連線至 CMS 查詢的 WSDL 為動態更新 現在, 您不再需要連線至 CMS 每當發行或更新新的 QaaWS 查詢時,WSDL 檔案便會新增至此.ZIP 檔中 其他執行階段參數也儲存在 WSDL 快取中, 例如驗證模式, 以及 Web 服務耗用時使用的地區設定與逾時值

42 42 Query as a Web Service 當您使用 [ 部署到其他伺服器 ] 選項, 將查詢部署至另一個應用程式伺服器時, 會自動更新 WSDL 快取 如果您使用 匯入精靈 或 BIAR 檔將查詢部署至其他應用程式伺服器, 則您必須手動更新 WSDL.ZIP 檔 相關主題 一節會加以說明 相關主題 第 44 頁的 將查詢部署到另一部伺服器時更新 WSDL 快取 使用 Query as a Web Service 用戶端工具部署到另一部伺服器的方法 您可以使用 Query as a Web Service 用戶端, 將查詢一次部署到另一部使用相同服務名稱的伺服器 您可以在兩部安裝相同版本的 Query as a Web Service 的伺服器之間, 使用 [ 部署到另一部伺服器 ] 選項 使用這個選項, 無法將查詢從某一版本移轉至另一版本 1 在查詢目錄中, 選擇要複製其定義的 Query as a Web Service 2 按一下 [ 部署到另一部伺服器 ] 會出現 [ 選取您的憑證 ] 對話方塊 3 為要部署 Web 服務的系統完成資訊, 然後按 [ 確定 ] Query as a Web Service 會出現在 發行 Query as a Web Service 精靈 中 4 將 Query as a Web Service 發行到新系統 將 Query as a Web Service 定義部署到另一個伺服器會自動變更 WSDL 位置和服務執行位置 附註 : 您可以使用精靈自訂此服務架構式 URL 您也可以使用 Web 服務連線的 [ 輸入值 ] 文字方塊, 在 Xcelsius 專案中將其設為動態 使用這個功能, 您只要變更 URL, 即可將儀器板從程式開發切換為實際執行 您無法將相同的查詢服務名稱重複部署到同一部伺服器 從匯入精靈部署 Query as a Web Service 的方法 要使用匯入精靈部署, 請從來源伺服器將 Query as a Web Service 定義匯入目的端伺服器

43 從 BIAR 檔部署 Query as a Web Service 的方法 43 1 在來源伺服器上啟動匯入精靈 2 在登入來源 CMS 後, 選擇要將定義匯出到哪個目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇已匯入定義的來源檔案 8 登入 CMS 9 在 [ 匯入精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 10 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格中, 選取所要的 Query as a Web Service 定義 11 按 [ 下一步 ] 繼續完成匯入精靈的後續其餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 從 BIAR 檔部署 Query as a Web Service 的方法 確認匯入精靈已安裝在來源和目的端伺服器上 1 在來源伺服器上開啟 [ 匯入精靈 ] 2 在登入來源 CMS 後, 選擇要匯出定義的目標 BIAR 檔案 3 在 [ 匯出精靈 ] 對話方塊的 [ 選取要匯入的物件 ] 窗格中, 選取 [ 匯入資料夾和物件 ], 然後選取 [ 匯入應用程式資料夾和物件 ] 4 在 [ 匯入精靈 ] 對話方塊的 [ 選取應用程式資料夾和物件 ] 窗格, 展開 [QaaWS 資料夾 ], 接著展開所要的 Query as a Web Service 定義或服務名稱 5 繼續完成匯入精靈的剩餘步驟 6 在目的端伺服器上開啟匯入精靈 7 在 [ 來源環境 ] 對話方塊中, 選擇要匯出定義的 BIAR 檔案 8 登入目的端 CMS 9 在 [ 選取要匯入的物件 ] 對話方塊中, 選擇匯入資料夾和物件 > 匯入應用程式資料夾和物件 10 在 [ 選取應用程式資料夾和物件 ] 對話方塊中, 選擇所要的 Query as a Web Service 定義

44 44 Query as a Web Service 11 繼續完成匯入精靈的剩餘步驟 12 匯入後, 將新部署的查詢定義指向目的端伺服器上的 Web 伺服器 將查詢部署到另一部伺服器時更新 WSDL 快取 如果您未使用以 Web 服務形式查詢中的 [ 部署到另一部伺服器 ] 選項來部署另一部伺服器, 則必須手動更新 WSDL 快取, 確保該查詢與 CMS 會同步處理 當您使用匯入精靈, 或使用 BIAR 檔將查詢部署到另一部伺服器時, 請執行此動作 將查詢部署到另一部應用程式伺服器時, 若要手動更新 WDSL, 請執行下列步驟 : 移至下列 URL: 如有需要, 請輸入 CMS 的登入資訊 WSDL 檔會自動更新 5.12 在多個 Web 伺服器上部署 Query as a Web Server 設定 Web 服務式查詢用戶端以連線至反向 Proxy Web 伺服器 反向 Proxy 是將電腦的網路位址從指定網路 URL 轉譯為另一外部網路的 URL 因為 Query as a Web Service 用戶端繫結到 報表引擎 查詢 和 BICatalog Web 服務, 所以您必須指定 Web 服務的外部 URL wsresource4=queryservice query web service alone ny.com]/dswsbobje/services/query 1 找出 dsws.properties 檔案 這個檔案位於 dswsbobje Web 應用程式中 2 更新下列屬性 : 屬性名稱 wsresource1 屬性值 ReportEngine reportengine web ser vicealone /dsws bobje/services/reportengine

45 在多個 Web 伺服器上部署 Query as a Web Server 45 屬性名稱 wsresource2 wsresource4 屬性值 BICatalog bicatalog web service alone [myserv er.mycompany.com] dswsbobje/services/bicatalog QueryService query web service alone [myserver.mycompany.com]/dswsbobje/ser vices/query

46 第 6 章以不同應用程式取用 Query as a Web Service 6.1 以 WSDL 取用 Web 服務式查詢 WSDL 是關於如何使用 Web 服務通訊的 XML 架構說明, 亦即與列於其目錄之 Web 服務互動所需之通訊協定繫結和訊息格式 支援的作業和訊息會於高層級描述, 然後繫結至明確網路通訊協定和訊息格式 WSDL 通常會與 SOAP 和 XML 結構描述共同使用, 透過網際網路提供 Web 服務 連線至 Web 服務的用戶端程式可以讀取 WSDL 以判斷伺服器上有哪些可用的功能 要尋找 Query as a Web Service 適用的 WSDL, 請在查詢目錄中加以選擇 6.2 在 Crystal Xcelsius 中取用 Web 服務式查詢 要在 Crystal Xcelsius 內取用 Web 服務式查詢, 請使用 Web 服務連接器 附註 : 在 Crystal Xcelsius 內取用 Web 服務式查詢的相關說明, 適用於 Xcelsius 8 以前的版本 本文件的更新線上版本中, 說明如何使用 Web 服務和 Web 服務式查詢 API Web 服務連接器元件能讓您使用簡單的點按動作, 在 Xcelsius 中建立 Flash 文件, 透過 SOAP 與 Web 服務式查詢 通訊 Xcelsius Flash 文件是獨立式 (self-contained) 的, 且會與 Web 服務通訊以視覺方式顯示資料 唯一的必備條件是需要 SOAP 架構式 Web 服務供 Flash 文件使用 Web 服務連接器元件啟動時, 會建立 SOAP 架構式訊息 ( 基本上為一 XML 文件 ) 並將其傳送給 Web 服務 Web 服務會以其本身的 SOAP 架構式訊息加以回應 Web 服務連接器元件接著會將此資料傳送給所有其他元件, 以視覺化方式展示您的資料

47 在 Crystal Xcelsius 中取用 Web 服務式查詢 47 有許多公用 Web 服務可使用,SOAP 架構式 Web 服務也有許多不同的工具箱和套件 如果要使用公用 Web 服務和已含有 Web 服務的套件, 只需要 Web 服務的 WSDL 文件 對於 Web 服務式查詢, 您可以在 [ 查詢目錄 ] 頁面中選取 Web 服務, 以便在每個 Web 服務的屬性中找到 WSDL 請參閱 Crystal Xcelsius 使用者指南 以取得更多資訊 跨網域問題 從 Web 下載 Xcelsius 裝置後, 如果 Flash 和用戶端工具來自不同的 Web 網域, 您可能會在使用 Web 服務式查詢 擷取資料時遇到問題 這個情況是 Macromedia Flash 相關的安全性理由所造成 瀏覽器中顯示的 Flash 無法存取位於產生 Flash 檔案格式 (SWF) 之網域外的資料 解決方案會視 Xcelsius 伺服器和 Query as a Web Service 用戶端工具位於相同或不同的電腦而有所不同 位於相同電腦 從進階參數按鈕開啟 選擇性參數 對話方塊, 並修改 Web 服務基礎 URL, 使其符合您下載 Xcelsius 的網域 位於不同電腦 如需指示, 請到 : 選取 Web 服務的方法 選擇 Web 服務需要將 Web 服務連接器元件指向 WSDL 文件 1 在 Excel 試算表進行工作時, 按兩下 Web 服務連接器元件以開啟 [ 屬性 ] 面板 2 按一下 [ 選擇 Web 服務 ] 會顯示 [ 選擇 Web 服務 ] 對話方塊 3 在 [WSDL URL] 方塊中, 輸入或貼上 WSDL 文件位置 4 按一下 [ 提交 ]

48 48 Query as a Web Service 如果發生錯誤,WSDL 文件可能無法完整驗證或可能無法符合 Web 服務連接器元件的需要 5 在 [ 方法 ] 清單中, 選擇您要繫結的方法 針對特定的 Web 服務, 您可以將每個元件僅繫結至一個方法 6 按一下 [ 確定 ] 您現在可以在資料上附加輸入和輸出訊息 輸入訊息在輸入訊息中, 僅能將元素附加到資料 使用 [-] 按鈕移除資料夾和元素 這會使得訊息中無法傳送資料夾或欄位 [+] 按鈕可用來加入資料夾或重複的元素 輸出訊息 在輸出訊息中, 元素和資料夾都可以附加到資料 選擇資料夾會顯示該資料夾中的資料行數目 當您將此資料夾附加到資料時, 資料夾中的每個元素都會依照出現的順序指派給資料行 選擇較少資料行可以限制繫結至您所選資料行數目的資料 選擇額外的資料行會插入空白資料行 如果元素在資料夾下重複, 只有第一個元素會對應到資料行 所選取資料夾下的資料夾無法對應 使用 [-] 按鈕移除多餘的元素 這會縮小樹狀結構檢視且可以減少 Flash 文件的處理時間 Xcelsius 中的驗證 Xcelsius 提供驗證機制, 能讓您避免使用相同的工作階段 ID 重複登入 InfoView 自訂驗證時, 請記住以下規則 : 現有的工作階段 ID 僅供使用者名稱和密碼空白時使用 ( 如果它們並非硬式編碼或並未傳遞為對話方塊擷取的輸入值 ) 當 Query as a Web

49 在 Crystal Report 中使用 Query as a Web Service 49 Service 在 InfoView 或 Dashboard Manager 中執行時, 會發生這種情況 如果使用者名稱和密碼並非空白, 請使用這些值驗證使用者 未建立工作階段 這是最具調整性的案例, 且適合大規模使用 如果沒有已存在的工作階段 ( 且使用者名稱和密碼空白 ),Xcelsius 會顯示標準的安全性對話方塊, 建立工作階段 當 Xcelsius 設計者未建立本身的安全性對話方塊時, 會發生這種情況 6.3 在 Crystal Report 中使用 Query as a Web Service 本節說明 Crystal Report 如何能使用 Query as a Web Service 做為資料來源 1 在 Crystal Report 報表建立精靈的 [ 資料 ] 頁面上, 建立新的 XML 連線 2 在 [XML] 對話方塊的 [XML 類型和位置 ] 頁面中, 選擇 [ 使用 Web 伺服器資料來源 ], 然後按 [ 下一步 ] 會出現 [Web 服務位置 ] 頁面 3 在 [HTTP WSDL URL] 欄位中, 輸入所選取 Query as a Web Service 的 WSDL [ 驗證 ] 頁面便會出現 4 設定 [ 基本 ] 驗證 ( 如果尚未設定 ), 然後按 [ 下一步 ] 會出現 [Web 服務 連接埠和方法 ] 頁面 5 完成資訊, 然後按一下 [ 完成 ] [ 輸入值 ] 對話方塊便會出現 6 以登入名稱 密碼和提示設定 Web 服務參數, 然後按 [ 確定 ] 報表建立精靈的 [ 資料 ] 頁面會再次出現 7 選擇下列其中一個選項, 然後按一下 [ 下一步 ] runqueryasserviceresponse runqueryasservicetable runqueryasservicerow [ 欄位 ] 頁面便會出現

50 50 Query as a Web Service 8 選擇要建立您查詢的欄位, 然後按 [ 下一步 ] 會建立報表 9 重新整理報表 正確參數會顯示在報表中 6.4 在 Microsoft Office InfoPath 中使用 Query as a Web Service 本節說明 Microsoft Office InfoPath 如何能使用 Query as a Web Service 做為資料來源 1 在 InfoPath 中, 存取 [ 設計表單 ] 工作清單 2 按下 [ 從資料連線新增 ] [ 資料連線精靈 ] 便會出現 3 選擇 [Web 服務 ], 然後按 [ 下一步 ] 4 選擇 [ 接收和送出資料 ], 然後按 [ 下一步 ] 5 輸入或瀏覽到 WSDL 檔案, 然後按 [ 下一步 ] 6 選擇 Web 服務作業, 然後按 [ 下一步 ] 7 輸入資料連線名稱, 然後按 [ 下一步 ] 8 輸入或瀏覽到您要使用者提交其表單的 Web 服務, 然後按 [ 下一步 ] [ 參數 ] 頁面便會出現

51 在 Microsoft Office InfoPath 中使用 Query as a Web Service 51 9 為每個參數選擇 [ 整份表單 ], 然後按 [ 下一步 ] 10 輸入提交資料的資料連線名稱, 然後按 [ 下一步 ] 資料表單會出現在左側, 資料來源則在右側 11 建立表單, 然後按 [ 執行查詢 ]

52 第 7 章 Web 服務呼叫 API 描述 本節說明由查詢產生的方法 以 Web 服務形式查詢一律產生下列兩種方法 : runqueryasaservice runqueryasaserviceex 這兩種方法都與查詢呼叫對應, 但是產生 runqueryasaserviceex 的目的是供索引認知提示之用, 所以 Enter_value_s_for_Year_ 的輸入參數類型會有差異 說明如下 這兩種方法永遠需要相同的輸入參數集, 並會產生相同的輸出參數集, 但提示輸入值的清單除外, 因為輸入參數會與查詢中的提示一樣多 所產生的第三個方法是 valuesof_year 此名稱 ( 以及提示參數名稱 ) 視查詢中使用的物件名稱而有所不同, 且為動態產生 下表也會加以說明 : 輸入參數 參數登入 password searchlov 類型字串字串字串 描述 登入資訊 密碼資訊 在值清單中設定搜尋模式 您可以在模式字串中使用下列萬用字元 :? 表示 0 或 1 個字元,* 表示 0 或 n 個字元, 例如 "M?Greggor" 所找到的值為 Mc- Greggor,"M*Greggor" 所找到的值為 McGreggor 與 MacGreggor

53 53 參數 類型 描述 Enter_val ue_s_for_year_ 若為 run- QueryAsAService: string[] 若為 run- QueryAsAService- Ex:LovValueIndex[] Year 的提示值 runqueryasaservice 方法需要 Enter_Year_ As 字串做為 Year 的提示值 產生 runqueryasaserviceex 方法以供索引感知提示之用, 因此需要 LovValueIndex 的執行個體 sessionid 字串 BusinessObjects Enterprise 工作階段的識別碼, 可讓 Web 服務連線至 CMS, 而無須登入資訊與密碼 Web 服務會自 getsession- Info 呼叫取得工作階段識別碼 serializedsession 字串 允許 Web 服務使用目前開啟的工作階段連線至 CMS, 而無須登入資訊與密碼 ( 序列化工作階段 ) 使用 getsessioninfo 呼叫, 可自 Web 服務平台工作階段取得序列化工作階段 輸出參數 參數 table 類型 Table 描述 資料輸出是一種表格, 其中包含了一組資料列, 每個資料列即為每個資料行值的 Tuple 這等同於 Web Intelligence 的垂直表格 message 字串 執行查詢時, 伺服器會產生包含錯誤訊息或警告的文字 creatorname 字串 查詢建立者的名稱

54 54 Query as a Web Service 參數 creationdate creationdate formated description 語意層 queryruntime fetchedrows delegated 類型 日期時間 字串 字串 字串 int int 布林值 描述 建立查詢的日期 建立查詢的日期, 該日期格式採用電腦用來建立查詢的地區設定 註解 語意層名稱 語意層中繼資料, 用以指定資料庫查詢執行階段期間 從資料庫與語意層中繼資料傳回的列數 如果該語意層將此 LOV 定義為委派搜尋, 讓資料庫使用指定的使用者輸入模式來解析值清單, 則傳回 True, 否則傳回 False

55 第 8 章 Query as a Web Service 最佳作法和限制 8.1 使用 Query as a Web Service 最佳作法 建立 Query as a Web Service 的更多提示 會定期更新 Query as a Web Service 的說明文件 若要檢視最新的來源, 請移至線上說明文件程式庫並使用 搜尋 欄位, 尋找最新的 Query as a Web Service 最佳作法 Query as a Web Service 使用相關限制 使用 Query as a Web Service 時, 您可能會遇到相關限制 當您建立查詢或執行階段時皆有可能發生這種情形 建立查詢相關限制 不能使用多重多維資料集 不能使用組合查詢和子查詢 不會執行 IndexAware 提示 此外, 請記住, 會對 Web 服務式的名稱及其中繼資料進行編碼以支援各種程式語言 ( 例如,C# Java C++ VB Flash) 查詢執行階段的限制 不能使用物件限制

56 附錄 A 詳細資訊 資訊資源 SAP BusinessObjects 產品資訊 位置 選取 > SAP BusinessObjects SAP 說明入口網站 您可以在 SAP 說明入口網站上存取涵蓋所有 SAP BusinessObjects 產品及其部署的最新說明文件 您可以下載 PDF 版本或可安裝的 HTML 程式庫 某些指南儲存在 SAP Service Marketplace 中, 無法從 SAP 說明入口網站獲取 這些指南會在說明入口網站中列出, 並隨附至 SAP Service Marketplace 的連結 簽署維護合約的客戶可以透過授權的使用者 ID 存取此網站 要獲得 ID, 請與客戶支援代表聯絡 > 說明文件 安裝指南 : guides 版本資訊 : SAP Service Marketplace 用於儲存某些安裝指南 升級和移轉指南 版本資訊以及 支援的平台 說明文件 簽署維護合約的客戶可以透過授權的使用者 ID 存取此網站 請與客戶支援代表聯絡以獲得 ID 如果您從 SAP 說明入口網站重新導向至 SAP Service Marketplace, 請使用左側導覽窗格中的功能表以查找包含所要存取說明文件的類別 開發人員資源 SAP Service Marketplace

57 57 資訊資源 位置 SAP 社群網路上的 SAP BusinessObjects 文章 這些文章原先稱為技術論文 附註 SAP 社群網路上的論壇 這些附註原先稱為知識庫文章 教育訓練 從傳統的教室學習方法, 到目標線上學習的研討會, 我們都可以根據您的學習需求和喜愛的學習方式, 提供一套訓練課程 線上客戶支援 SAP 支援入口網站包含客戶支援方案和服務的相關資訊 它還提供各種技術資訊和下載的連結 簽署維護合約的客戶可以透過授權的使用者 ID 存取此網站 要獲得 ID, 請與客戶支援代表聯絡 jectsconsulting 專業諮詢 諮詢人員會一直陪伴著您, 從最初的分析階段, 直到最後的部署專案交付 提供有關各種主題的專家意見, 例如關聯式和多維度資料庫 連通性 資料庫設計工具以及自訂的嵌入式技術

58 索引 A API 描述 52 C CMS 資料庫防止失敗 12 R runqueryasaservice 52 runqueryasaserviceex 52 V valuesof_year 52 四畫 反向 Proxy 設定 44 文件存取線上程式庫 55 七畫 刪除查詢 29 八畫 使用 Query as a Web Service 了解 7 九畫 架構了解 8 查詢刪除 29 複製 29 十一畫 啟動 15 第一次 14 設定反向 Proxy 44 部署 Web 服務到另一部伺服器, 發行 Web 服務到另一部伺服器 32, 34, 35, 38, 42 十二畫 提示使用 Query as a Web Service 55 登入 14 十四畫 疑難排解容錯選項 12 十五畫 線上說明文件存取 55

59 索引 59 複製作法 29 十七畫 總覽 7