Report Builder 的疑難排解和最佳做法

您可用來最佳化 Report Builder 遞送的方式,以及偶而會發生的錯誤訊息清單。

Report Builder 5.0 用戶和開啟 5.1 活頁簿

Adobe 將維度和分類間的分隔符號從底線字元 (_) 變更為 ||。此項變更是為了讓 Report Builder 5.0 用戶在開啟具有分類請求的 Report Builder v5.1 活頁簿時能夠相容。每次開啟 v5.1 之前版本的活頁簿時,其中的所有序列化分類請求都會轉換為這個格式。

這會造成往後相容問題:轉換為 v5.1 後,如果將活頁簿與 Report Builder v5.0 的用戶共用,該用戶將無法辨識分類請求 (事實上,它會尋找 "_" 而非 v5.1 序列化 "||")。

在開啟具有分類請求的 ARB v5.1 活頁簿時,您會遇到以下副作用:

  • 開啟活頁簿時,畫面出現以下警示訊息:「此活頁簿上次使用 Report Builder v5.1 儲存。此版本的部分功能與本電腦安裝的 Report Builder 版本不相容。強烈建議您升級為最新版 Report Builder,再更新此活頁簿。」
  • 如果您以滑鼠右鍵按一下具分類的 ARB 請求,不會顯示 Report Builder 快顯功能表 (編輯請求、新增相依請求…)。
  • 如果透過按一下第三個按鈕或重新整理「請求管理員」表單中的一組請求,來執行「重新整理所有」,分類請求可以順利執行,不會發生錯誤。但是,無法寫出分類值。
  • 您仍然可以編輯請求,方法是開啟「請求管理員」,接著一列一列往下,直到到達正確的請求。
  • 如果您編輯請求並將所有參數保持不變,接著按一下「完成」,就能正確寫出回應。編輯請求可以解決問題,是因為會重新序列化「回應配置」參數。所以此問題有解決辦法,只是較為耗時。

Report Builder 中的驗證問題

Report Builder 需要驗證身分,才能從您的報表套裝中建立資料請求。視您在 Analytics 內的設定或您的網路而定,登入 Report Builder 有時會發生問題。

  • 無效的登入公司:此錯誤最常起因於輸入的登入公司不正確,或網路活動發生問題。請執行下列動作:
    • 檢查登入公司拼字,確定沒有打錯字或錯誤空格。
    • 請使用相同登入公司來登入 Analytics,以確保登入公司正確無誤。如果無法以這些憑證登入,請聯絡貴公司的管理員以取得正確的登入公司。
  • 防火牆:Report Builder 使用連接埠 80 和 443。請確定已允許這些連接埠通過您組織的防火牆。請參閱 Adobe 的「內部 IP 位址」,了解其他防火牆排除項目。

請求最佳化建議

以下因素可能會增加請求複雜度,並導致處理延遲。

  • 拖慢交付速度的因素:太多書籤、儀表板和 Report Builder 活頁簿排程在數小時內。此外,還將太多 Report Builder 活頁簿排程幾乎同一時間內完成。當這種情況發生時,報表 API 佇列便會積壓下來。

  • 可能會減緩活頁簿執行階段效率的因素:分類大幅增加,或隨著時間增加請求日期範圍。

  • 導致活頁簿傳送失敗的原因:活頁簿中複雜的 Excel 公式,尤其是涉及日期和時間的公式。

  • 傳回 0 (無值) 的儲存格:Excel 工作表名稱具有撇號或單引號,會造成報告 Report Builder 無法傳回數值。(此為 Microsoft Excel 的限制)。

  • 個別請求效能:處理速度可能受下列設定影響:

    設定 較快的效能 較慢的效能
    劃分項目與劃分順序 少數 許多
    範例:若您由 A 到 Z 細分,則 A 的項目數一律少於 Z 的項目數。如果是相反情況,則請求時間可能會大幅增加。
    日期範圍 小範圍 大範圍
    篩選 特定篩選 最受歡迎篩選
    詳細程度 彙總 每小時
    • 每日
    • 每週
    • 每月
    • 每季
    • 每年
    項目數 小量資料集 大量資料集
  • 排程時間:24 小時期間內的交錯排程 (請參見下表)。將現有書籤、儀表板及 Report Builder 活頁簿排得太接近,可能會引發延遲。在凌晨時排定較大、較複雜的請求,以允許在營業日進行手動提取與重新整理作業。

    排程時間 早上 1 點 – 早上 2 點 早上 2 點 – 早上 7 點 早上 7 點 – 下午 6 點 下午 6 點 – 午夜
    Report Builder 使用狀況 安靜 很忙碌 用戶端用法。
    在本機重新整理且請求「立即傳送」的用戶數量較多時。
    此外,請確認當排程的活頁簿逾時之際,API 佇列是否已清除。
    不忙碌
  • 逾時:四小時後,所有排程報告都會逾時。系統會再嘗試排程三次,而且可能導致失敗(一般而言,當資料集越大,所需執行時間就會越久)。Analytics 報表與 Report Builder 會顯示下列項目:

錯誤訊息說明

以下是在使用 Report Builder 時偶爾會顯示的錯誤訊息清單。

注意

以下內容只是錯誤訊息的選集,並非完整清單。如需解決錯誤的詳細資訊,請聯絡管理員。

  • 此功能只適用於已開啟的活頁簿。:如果未在 Excel 中開啟任何活頁簿 (試算表文件),且您按一下報告產生器工具列中的任一個圖示時,此訊息便會出現。此外,工具列將成為停用狀態,直到您開啟試算表為止。然而,在工具列仍為啟用狀態時,您可以按一下線上說明圖示而不致發生此錯誤。
  • 您必須先退出「請求精靈」,才可啟動「請求管理員」。:由於「請求管理員」和「請求精靈」在功能上是相連的,因此在「請求精靈」中執行的動作完成或取消之前,您不能操作「請求管理員」。
  • 無任何請求與此範圍相關聯。:當試算表的儲存格不含任何請求時,如果您按一下「請求管理員」中的「從工作表」按鈕,此錯誤訊息便會出現。若要識別試算表中含有請求的儲存格,請在「請求管理員」中按一下表格列示的個別請求。如果儲存格有相關聯的請求,當您選擇表格中的請求時,系統將會反白顯示儲存格。
  • 選擇的範圍無效。請選擇其他範圍。:當選擇的試算表儲存格已有對應的請求時,此錯誤便會發生。請刪除對應至儲存格的請求,或選擇其他儲存格範圍來進行對應。如果您想要刪除儲存格,請務必先找出含有請求的儲存格並刪除請求,然後再刪除儲存格 (移除列或欄)。
  • 使用此功能之前,請先退出目前所在的 Excel 儲存格。:如果您處於​‭編輯模式,當您按一下任何 Report Builder 圖示時,此錯誤訊息便會出現。要在 Excel 儲存格內使用編輯模式,您必須先選擇儲存格,且游標位在儲存格內。當您直接在 Excel 頂端的「公式」列或「名稱方塊」中輸入文字時,也會處於 Excel 儲存格內的編輯模式。
  • 選擇的範圍與其他請求的範圍相交。請變更您的選擇。:如果將一組儲存格對至試算表時,便會顯示此錯誤。
  • 修復活頁簿 (已移除記錄:公式來自 /xl/calcChain.xml 部分):有時候,在儲存或傳輸活頁簿時,活頁簿的公式會損毀。開啟檔案時,Excel 會嘗試執行這些公式但會失敗。您可以從試算表移除 calcChain.xml,強制 Excel 重新整理其公式計算,即可解決此問題。
    1. 將活頁簿的副檔名從 .xlsx 重新命名為 .zip
    2. 解壓縮內容並開啟 /xl/ 檔案夾。
    3. 刪除 calcChain.xml
    4. 重新壓縮內容,並將副檔名變更回 .xlsx
    5. 在 Excel 中開啟活頁簿,並重新整理所有 Report Builder 請求。
  • 與輸入篩選器或輸出範圍有關聯的 Excel 儲存格可能已刪除:Report Builder 會使用 Excel 名稱將資料請求附加至儲存格。如果從「名稱管理員」刪除 Excel 名稱,您會看到此錯誤。 如果刪除 Excel 名稱,則無法復原請求。 如果活頁簿已排定時間,您可以從「排程管理員」下載副本,或開啟先前傳送的活頁簿副本。

本頁內容