新SAPBW資料集插件

2.1 開啟服務

首先確認 SAP BW 伺服器已經開啟了 XMLA 服務，才能在外部軟體中使用 XMLA 連結。

1）用戶端進入 SAP 系統，點選「TCODE:SICF >default_host> sap>bw」。

2）右擊「bw」，選擇「Deactivate service」，點選「確認」。

3）再次右擊「bw」選擇「Activate service」，點選「確認」。確定所有的服務都已經開啟。

2.2 安裝插件

安裝 新 SAP BW 資料集插件
設計器插件安裝方法請參照 設計器插件管理
伺服器安裝插件方法請參照 伺服器插件管理

注1：更新重裝插件後如果出現連結報錯，可以重啟工程解決。

注2：SAP BW 插件需要購買授權。

注3：請確定工程JDK版本為 1.8 且小版本在 JDK8u102 以上。

2.3 匯入檔案

如需使用 JCO、BICS 連結方式，請根據自身工程的部署環境選取並匯入相應檔案。

如進行遠端設計，需要本地環境和遠端環境都放置相應檔案。

1）下載對應版本並解壓資料夾，獲得sapjco3.jar、sapjco3.dll檔案。

2）登入伺服器，找到/webapps/webroot/WEB-INF/plugins目錄下的SAP插件資料夾。

3）將sapjco3.jar、sapjco3.dll檔案上傳到SAP插件資料夾中即可

4）如需遠端設計，請將sapjco3.jar、sapjco3.dll檔案上傳到本地設計器%FR_HOME%\webapps\webroot\WEB-INF\plugins目錄下的SAP插件資料夾中

5）重啟工程後生效。

注1：Windows Server 2003 和 Windows XP 的系統在連結 SAP 時，需要下載安裝 Microsoft Visual C++ 2005 SP1。

注2：如果同時安裝了 SAP 和 SAP BW 插件，可能會存在衝突導致有某一種資料集預覽報錯的問題。

注3：如果資料連結失敗，可以嘗試將 sapjco3.dll 檔案放置在系統 jre 的 bin 目錄下，例如：%JAVA_HOME%\jre\bin

注4：如果仍連結不了，看報錯資訊，例如驗證 SAPJCO 失敗，缺少依賴包 libstdc++.so「SAPJCO2 才需要，而 SAPJCO3 不需」，則需要安裝共享庫。

注5：MAC OS系統，需要在vmoptions.txt檔案中寫入-Djava.library.path=/放置驅動檔案的路徑

         開啟設計器%FineReport%/bin，右擊「designer」，選擇「顯示包內容」，開啟 vmoptions.txt 檔案

         在檔案中寫入：-Djava.library.path=/Applications/FineReport10.0/lib（放置驅動檔案的路徑）

2.4 補充 BICS 檔案（選做）

V1.5.29 及之後版本的插件，為解決驅動載入問題，刪除了部分 BICS JAR 包。

如需使用 BICS 功能，需手動將以下 JAR 包檔案放置到工程路徑/webapps/webroot/WEB-INF/plugins目錄下的SAP插件資料夾下。

若是進行遠端設計，需要本地環境和遠端環境都要放置。

點選下載並解壓獲取 JAR 包檔案：bics_lib.zip

3.1 定義資料連結

點選「伺服器>定義資料連結」，點選「+」，選擇 「SAPBW Cube」，根據實際環境填寫 URL 、帳號、密碼和資料庫，點選「測試連結」，若連結成功，則會出現彈出框提示，如下圖所示：

XMLA 的 URL 的獲取方法：IP 請訊問 SAP 管理者，埠號有兩種獲取方法：
方法一：
使用者端進入 SAP 系統，按照如下路徑進入：
TCODE:SE37>FUNCTION MODULE>RSBB_URL_PREFIX_GET>Execute single test>Remove the default>Message Sever parameter selection>Execute
進而獲取到埠號 1，然後傳回上一層頁面 ，不刪除預設，按照如下路徑進入：
Message Sever [X] >Execute
進而獲取到埠號 2，嘗試獲取到的兩個埠號，一般是埠 1 。
方法二：
使用者端進入 SAP 系統，按照如下路徑進入: TCODE:SICF, default_host>sap>bw>xml>soap>xmla, 在開啟「bw」服務介面，找到 XMLA 服務並右鍵點選「測試服務」，會自動呼叫瀏覽器，這時輸入「bw」登入的帳號密碼，然後複制 URL 。如下圖所示：

3.2 新增資料集

點選「+」，新增「SAPBW Cube資料集」，如下圖所示：

3.2.1 新增簡單通用查詢資料集

1）資料庫連結選擇建立的 SAPBW Cube 連結，點選「下拉」按鈕，選擇「簡單通用查詢」，並選擇「Cube」類型，設定列軸欄位，如下圖所示：

2）點選「設定」。設定行軸欄位，如下圖所示：

3）點選「設定」。設定過濾條件，如下圖所示：

4）點選右上角「預覽」按鈕，可查看新增的資料集。假設原先有 N 個度量值，M 個維度，那麼列數為 N+2M，如下圖所示：

5） SAP參數，MDX參數文法說明
①變數值，如123456，建議用[]把變數括起來(BW本身的語句美化器也會用[]括起變數)，如[123456]或用雙引號引起來，否則某些變數傳參會報MDX文法錯誤，目前未知原因。
②單值變數如123456，以[變數值]傳遞，如[123456]；
③多值變數用分號分隔，如[123456];[123456]
④區間變數，如年月區間，以冒號分隔，如[201905]:[201907]

3.2.2 新增自訂 MDX 查詢資料集

資料庫連結選擇建立的 SAPBW Cube 連結，點選「下拉」按鈕，選擇 自訂 MDX 查詢 ，輸入查詢語句。點選「確定」即可，如下圖所示：

4.1 使用 Web Service 連結

4.1.1 手動搭建 Web Service

注：這裏是版本 6 的操作步驟。
1）輸入「soamanager」進入配置介面，如下圖所示：

2）選擇 Web 服務配置，如下圖所示：

3）搜尋並選擇 query_view_data ，如下圖所示：

4）點選「建立服務」，如下圖所示：

5）輸入服務資訊和綁定資訊，如下圖所示：

6）選擇傳輸級別安全、訊息級別安全資訊，如下圖所示：

7）soap 協定預設，點選「完成」即可。

4.1.2 定義資料連結

選擇「伺服器>定義資料連結」，點選「+」，選擇「SAPBW Query」，選擇連結方式為「Web Service」，填寫 URL、帳號、密碼以及編碼類型，點選「測試連結」，若連結成功，則會出現彈出框提示，如下圖所示：

URL格式：http://ip地址:埠號加上下圖中  Berechnete Zugriffs-URL 對應的這串字元。

4.2 使用 JCO 連結

4.2.1 建立 Query

建立不帶參數的 Query
1）登入工具 Query Designer，如下圖所示：

2）點選「建立」，選擇資訊提供者建立一個新的 Query ，如下圖所示：

3）點選「確定」後，如下圖所示：

4）切換成行/列的設定介面，分別拖動左側目錄中的關鍵指標進入列面板，維度進入行面板，點選「儲存」，如下圖所示：

注：維度只有展開後，圖示為 的才能拖動。
5）輸入描述和技術名稱，點選「儲存」，如下圖所示：

注：這裏修改的技術名稱才是 Query 的實際名稱。
建立帶參數的 Query
1）切換成過濾器的設定面板，將左側維度中的需要過濾的維度某項拖入特徵限制面板下，比如下圖中的日曆日，右擊該項，點選「限制」，如下圖所示：

2）在彈出的對話框下選擇顯示模式為變數，建立新變數，修改變數名稱，如下圖所示：

3）詳細資訊選項卡可設定參數表示（如：單值，多值，範圍等）和參數的可選性，如下圖所示：

4）點選「OK」，變數建立成功，選中建立成功的變數，將其新增到選擇的選項。點選「確定」，如下圖所示：

4.2.2  預覽 Query

1）在 SAP 輕鬆存取中輸入 rsrt2 ，進入報表預覽，如下圖所示：

2）輸入 Query 技術名稱，點選執行，如下圖所示：

3）出現參數變數選擇介面，如下圖所示：

注：如果沒有必選參數，則無此步驟。
4）點選「執行」，預覽結果如下圖所示：

4.2.3 定義資料連結

點選「伺服器>定義資料連結」，點選「+」，選擇「 SAPBW Query 」，選擇連結方式為 JCO ，填寫相應的主機名、系統編號、語言、使用者端、帳號、密碼、連結池屬性等資訊，如下圖所示：

注1：需參考本文 2.3 節匯入相關 SAP 檔案。

注2：新 SAP BW 資料集插件需要 V1.2 及以上版本。

注：新 SAP BW 資料集插件需要 V1.2 及以上版本。

4.3 新增資料集

1）點選「+」，新增 SAPBW Query 資料集，如下圖所示：

2）設定資料集參數
資料庫連結選擇建立的 SAPBW Query 資料集，根據實際情況填寫參數的值。若建立的 Query 設定了參數，需要新增參數。也可以勾選使用快取、獲取單位，如下圖所示：
注1：這裏資訊提供者、Query 及參數，需要手動輸入，請根據上述 Query 的建立方法，填寫自己實際建立的值。
注2：參數類型僅支援單值、多值和範圍，不支援選項類型。

注：1. 使用快取及在第二次讀取資料時速度會變快，且目前快取時間為 10 分鍾，獲取單位即勾選後顯示欄位的單位。

注：2. 參數名一定要寫鍵值，且只能寫鍵值。
3）點選「預覽」，彈出參數框，選擇「確定」，即可查看預覽資料，如下圖所示：

注：bics 不支援 hierarchy 層級

5.1 定義資料連結

1）放置驅動，驅動的放置和 SAP 資料集相同。參見 SAP 資料連結 。
2）點選「伺服器>定義資料連結」.點選「+」，選擇「SAPBW BICS」。如下圖所示：

3）根據實際環境填寫 主機名、帳號、密碼 等。點選「測試連結」，若連結成功，則會提示連結成功。如下圖所示：

注：SAP BW 重新增 cube 後，需要點選連結介面中的「清除連結快取」，新的cube才會顯示。

5.2 新增資料集

1）點選「+」，選擇「SQPBW BICS資料集」。如下圖所示：

2）選擇「資料庫連結」，選擇「cube」後再選擇行和列，輸入參數值，進行查詢。如下圖所示：

建議使用者從下拉中選擇 cube，而不是手動輸入 cube 名。如果必須手動輸入，請確定在輸入完成後，按下鍵盤上的「Enter」鍵，將輸入內容鍵入 FineReport。

注1：插件使用單執行緒存取，若需要頻繁存取或查詢速度較慢，建議點選介面中的「使用快取」以防止查詢阻擋。
注2：BICS 的參數類型只支援單值、多值、範圍三種。
注3：產品在參數展示介面增加了「*」用於提醒使用者必須輸入參數值。

6.1 連結不上 BW，顯示連結錯誤

1）檢查 bw 中的 XMLA 服務有沒有開啟。
2）使用瀏覽器存取 URL：http://[ip]:[port]/sap/bw/xml/soap/xmla?sap-client=***，看是否可以存取。
3）URL 是否正確，只需要點選獲取預設 URL 之後，修改 IP 和 port，末尾加上客戶號(客戶號的獲取請訊問管理者，一般為 3 位數字如 000,100,800 ) 範例如下：
jdbc:xmla:Server=http://[ip]:[port]/sap/bw/xml/soap/xmla?sap-client=***
4）檢查使用的域名不是 IP 導緻連不上，域名 ping 不通。

6.2 獲取資料出不來

XMLA 協定限制，資料量大就會導緻服務報錯，只能支援到萬級別的行數。

6.3 Query 連結方式支援情況

1）FineReport 中使用 Cube 方式連結時，不支援展示在 Query designer 中所做的應用部分；使用 Query 方式連結則支援。
2）FineReport 中的 Query 不支援自由特性。
3）FineReport 中的 Query 不支援「選擇選項」的參數類型，只支援單值、多值、範圍、層次節點。

6.4 SAP 參數聯動範本參數無效

1）問題描述
建立資料集時，SAP 參數透過公式引用範本參數，聯動無效。
2）解決方案
目前不支援 SAP 參數跟範本參數進行聯動，建立 SAP 參數更換掉範本參數，SAP 參數之間是支援聯動的。

6.5 SAP BW Query 取數顯示為空

1）問題描述
連結 SAP BW Query 可以成功，但無法存取到具體資料，且提示報錯：
SwingWorker-pool-4-thread-10 ERROR [standard] Cannot find Body Info!
AWT-EventQueue-0 ERROR [standard] node has no children‘
2）解決方案
資料連結時不要使用自己連結的 URL ，需要使用 Web Service 的 URL 。如下圖所示：

獲取 Web Service 預設 URL 格式的方法如下：
資料連結方式選擇Web Service，點選獲取預設 URL 按鈕Snag_55f956.png，URL 編輯框中會自動顯示預設 Web Service URL 格式，將其中的某些參數修改成自己環境下的即可。