匯入 Jaspersoft 進階報告內容

下列程序會匯入網域、報告、輸入控制項、本土化套件、影像、範本、資料來源及角色。也會在 CA Clarity 系統管理 (CSA) 報告子索引標籤中建立組織名稱和指定的使用者。

重要！您必須先在 CSA 報告子索引標籤中指定組織名稱和使用者，才能匯入 Jaspersoft 進階報告內容。此外，PMO Accelerator 14.2 版是 Jaspersoft 進階報告內容的必要先決條件，因為許多報告會參考 PMO Accelerator 中傳送的物件和屬性。

在匯入 Jaspersoft 進階報告內容之前，您必須完成在 Jaspersoft 和 CA Clarity PPM 中設定進階報告的步驟。如需如何設定進階報告的更多資訊，請參閱《CA Clarity PPM 安裝指南》。

匯入會執行下列動作：

建立組織。在匯入之前於 CSA 報告子索引標籤中定義組織名稱。
在組織的存放庫中建立 CA PPM 資料夾及其子資料夾。 CA PPM 資料夾包含所有 Jaspersoft 進階報告內容項目。
建立進階報告角色。如需這些角色的說明，請參閱《CA Clarity PPM 管理指南》。
建立 PMO Accelerator 角色。這些角色會決定內容權限，並且以 “CSK_“ 開頭。
以資料庫專屬的「資料倉儲」結構描述擁有者名稱更新網域。
上傳 UI 主題。
建立「共用」資料夾。
建立 Jaspersoft 系統管理員使用者。預設使用者是 “ppmjasperadmin“。可以在匯入之前於 CSA 報告子索引標籤中變更這名使用者，但是匯入之後，不應該修改該使用者。會動態更新網域的建立及更新 Jaspersoft 使用者工作和載入資料倉儲工作需要此使用者。

請依循下列步驟:

開啟命令提示字元，並導覽至 CA Clarity PPM 執行階段 bin 目錄。
輸入下列命令：
```
admin content-jaspersoft csk -userName superuser -password <password>
```
匯入程序會開始，並在畫面上顯示資訊。資訊不會儲存在記錄檔中。匯入處理需要超級使用者。
匯入完成之後，請檢閱畫面輸出以瞭解重要的資訊。
開啟 [管理]，然後從 Studio 按一下 [內容增益集]。
[內容增益集] 頁面便會出現。
按一下 [加速器：計劃管理組織] 增益集 (ID：csk)。
內容增益集加速器：計劃管理組織 – 特性內容頁面隨即顯示。
檢閱此頁面 [版本] 區段中包含的 [Jaspersoft 內容安裝日期]。

選擇性匯入參數：

如果您要升級或重新匯入內容，請使用升級參數：
```
admin content-jaspersoft csk -userName superuser -password <password> upgrade
```
附註：升級參數前面沒有破折號 (-)。

重要！如果您已匯入進階報告內容，您必須使用升級參數以重新匯入內容。升級參數會進行下列動作：
- 覆寫 CA PPM 資料夾權限。
- 覆寫 CA PPM 資料夾中的立即可用子資料夾 (包括權限在內)。
- 覆寫 CA PPM 資料夾和子資料夾中的立即可用 Jaspersoft 進階報告項目 (包括權限在內)。項目包含網域、輸入控制項等等。
- 刪除 CA PPM/報告子資料夾中的所有項目，並且重新建立立即可用的報告。刪除包括立即可用和客戶特定報告與子資料夾。如果您已在 [報告] 子資料夾中建立報告、儲存報告篩選，或排程報告，則這些項目會在重新匯入之後遭到刪除。
如果您需要匯入 PMO Accelerator 中包含之預設 jaspersoft_csk.zip 檔案以外的檔案，請使用 fileName 參數：
```
admin content-jaspersoft csk -userName superuser -password <password> -fileName jaspersoft_csk.zip
```
網域延遲可能會造成匯入失敗，並且有錯誤訊息，要求增加 –retryCount 的值。使用 -retryCount <count> 參數以增加等待期間，其中 1 個計數相當於 10 秒。例如，以下命令具有計數 50，相當於 500 秒。預設值是 20。
```
admin content-jaspersoft csk -userName superuser -password <password> -fileName jaspersoft_csk.zip –retryCount 50
```