Report.cfg 參數

上次更新: 2022-10-05
  • 建立對象:
  • User
    Admin
重要

深入了解Data Workbench 終止公告.

Report.cfg參數的相關資訊。

範例 Report.cfg 顯示於 設定報表集 僅包含 Report.cfg 檔案。 下表提供所有可用 Report.cfg 檔案參數。

如果您需要新增其他參數至 Report.cfg 檔案時,必須使用文本編輯器執行此操作。 有關執行此操作的步驟,包括如何定義每個參數條目的示例,請參見 編輯現有的Report.cfg檔案.

注意

此表中的參數按字母順序列出。 當您開啟 Report.cfg Data Workbench中,向量會以字母順序列出,接著以字母順序列出個別參數。

參數 說明
警報閾值

可選. 此參數僅適用於具有量度指標的報表。 在傳送警報報表之前,必須出現在工作表中的量度指標數。

如果量度指標工作表中只監控一個量度,請將臨界值設為1。 當工作表中的度量評估為向上/向下箭頭或X時,即會生成報告。如果報告中監視了多個度量,則可以選擇在生成報告之前必須評估為向上/向下箭頭或X的度量指標數。 例如,如果正在監控兩個量度:

  • 如果臨界值設為1,則當工作表中的其中一個量度評估為向上/向下箭頭或X時,即會產生報表。
  • 如果臨界值設為2,在產生報表之前,這兩個量度都必須評估為向上/向下箭頭或X。

如需量度指標的詳細資訊,請參閱 Data Workbench使用手冊.

允許重新產生報表

指出 報表伺服器 在您建立或修改這些報表時,會自動產生或重新產生特定報表。 選項為true或false。 如果設為true,建立或修改報表工作區會造成 報表伺服器 以重新產生該報表以供最近執行。

注意:變更 Report.cfg 檔案原因 報表伺服器 重新產生由 Report.cfg 檔案。

附件

可選. 任何附件的名稱和內容類型的節標識符,這些附件與通過電子郵件分發的報告一起發出,包括附件數。

添加新附件:

  1. 開啟 Report.cfg 檔案Data Workbench。
  2. 按一下右鍵 附件 按一下 添加新子項 > 附件 .

內容類型

要附加的檔案的內容類型。

範例:影像/jpeg

檔案名

要附加的檔案的位置和名稱。

範例: c:\myimage.jpg

色彩集 識別要用於的色彩配置 .png 檔案。 0代表黑色背景;1代表白色背景;2用於灰度影像。
要執行的命令 可選. 生成報告集後運行的批處理命令或執行檔。 如果需要啟動命令shell解釋器,請在命令前面加上cmd /c。
預設Excel範本

可選. 通用Excel模板檔案的檔案名( .xls .xlsx ),以Excel檔案產生報表時要使用的欄位。 此參數支援完整的檔案路徑,例如 c:\templates\mytemplate.xls .

除非已針對特定報表專門定義範本,否則所有Excel報表都會使用此檔案。 請參閱 使用範本檔案 .

維度名稱 可選. 您要動態產生報表的維度名稱。 如果在此參數中輸入維度名稱,則必須在「查閱檔案」參數或「前N個量度」和「前N個值」參數中輸入值。 此參數中命名的維度必須存在於要建立報表的資料集中。
只有在完美時才發送電子郵件 可選. 讓使用者指定只有在執行期間未發生錯誤時,才應傳送報表集。 選項為true和false。 預設值為 false。
結束日期

可選. 您希望報表集執行的最後日期和時間。 這次是根據資料集的截止時間。

格式:MM/DD/YYYY hh:mm時區,使用24小時時間語法

範例:08/01/2007美國東部夏令時12時01分

如需時區設定的詳細資訊,請參閱 資料集組態指南.

每個 報表集產生頻率:日、周或月。
Excel監視程式超時(秒)

可選. 您想要的秒數 報表伺服器 在之前以Excel檔案產生報表時,等待Microsoft Excel回應 報表伺服器 決定Excel未回應,並終止程式。 使用此參數可啟用 報表伺服器 在Excel停止回應時終止,並繼續處理您的非Excel報表。 預設值為300.0。若要禁用此功能,請將此參數設定為0.0。

請確定您定義的值夠長,足以將報表匯出至Excel。 否則, 報表伺服器 可能會提前終止Excel,而您的報表將不會產生。

篩選公式

可選. 套用至報表集中每個工作區的篩選。

如需詳細資訊,請參閱 建立篩選器的語法 .

Gamma校正

Gamma設定 .png 檔案輸出。 預設值為 1.6。

注意:Adobe建議您不要變更此值。

隱藏徽標 指出報表伺服器在產生您的報表時是否隱藏標誌。 選項包括 true false . 若設為 false ,則報表會以「報表」標誌產生。 預設為 false .
查閱檔案

可選. 填入此參數時,報表伺服器會以動態模式執行,並為「Dimension名稱」參數中指定的維度的每個元素產生報表。 此檔案必須包含兩個以Tab分隔的欄,不含標題列。

  • 第1欄包含維度元素清單。
  • 第2欄包含報表收件者的電子郵件地址。 第1欄中特定元素的報表會傳送至第2欄中同一列的電子郵件地址。 您可以用逗號分隔多個電子郵件地址(不含空格)。 如果不要以電子郵件傳送報表,此欄可以是空白的,但必須存在。

注意:如果在此參數中輸入值,則必須在「Dimension名稱」參數中輸入值。

僅通知 報表伺服器 設定可讓您設定data workbench,以在產生報表時傳送電子郵件。 將此值設定為 true 不會傳送報表,而會傳送電子郵件,通知訂閱的使用者報表已產生。
郵件報告

透過電子郵件分送報表的區段識別碼。 若要透過電子郵件分發報表,請完成下列參數 郵件報告 的下界。 報表集中的所有報表都會以一則訊息傳送至Recipients參數中指定的電子郵件地址。

注意:報表伺服器僅在產生至少一個報表時才會傳送電子郵件。

若要啟用報表的電子郵件傳送,您至少必須為此項目完成下列參數:

  • SMTP伺服器
  • 收件者
  • 寄件者地址
  • 僅通知

注意:若要在重新產生報表集後以電子郵件傳送報表,請參閱 編輯現有的Report.cfg檔案 .

5.4x和5.5x版本提供「僅通知」值。

若要通知大量收件者(超過20個),強烈建議您使用電子郵件通訊組清單。

內文XSL範本

可選. 要應用到的XSL模板檔案的路徑 reports.xml 檔案。 使用此參數可讓報表伺服器在分佈式電子郵件中傳送您的報表,而非以附件的形式傳送。 產生的文字會作為電子郵件訊息的內文。

請參閱 報表範例檔案 ,以取得範例檔案。

有關可擴展樣式表語言(XSLT)的資訊,請參見 可擴展樣式表語言系列 .

收件者 您要傳送報表之對象的電子郵件地址。
寄件者地址 寄件者的電子郵件地址。
寄件者名稱 選填。寄件者的名稱。
SMTP伺服器 SMTP伺服器電腦的地址以及驗證所需的密碼和用戶名。
主旨 可選. 說明要傳送之電子郵件的主旨行。
僅通知 可讓您設定Data Workbench,以在產生背景報表時傳送電子郵件。 將此值設為True不會傳送報表,而是傳送電子郵件,將訂閱的使用者連結至報表位置。
輸出根

可選. 產生的報表集的輸出位置。 預設為 <profile name="">\報告伺服器安裝目錄中的報告資料夾。

配置 報表伺服器 若要將報表輸出至入口網站,請設定 輸出根 指向用於入口的web伺服器的文檔根目錄。

預先載入查詢篩選器

可選. 此參數僅適用於 排名在前的Dimension元素 報表類型。

您要套用至查詢的篩選器名稱,必須執行該篩選器以決定前N個維度元素,才能產生報表。 預設為 Broken_Session_Filter . 如需 中斷的工作階段篩選 ,請參閱 Data Workbench使用手冊.

報告類型

要生成輸出的格式。 您可以使用下列任一或所有選項,一次以多種格式輸出報表集:

  • Excel會建立一個Excel活頁簿,每個工作表各顯示一個視覺效果。 一般而言,請使用Excel檔案進行電子郵件分送。 請參閱 以Microsoft Excel檔案產生報表 . 如需使用範本檔案的詳細資訊,請參閱 使用範本檔案 .
  • png會建立可移植網路圖形檔案。 一般規則是使用 .png 要在網頁瀏覽器(入口網站)中顯示的檔案。
  • 縮圖會建立縮圖( .jpg 檔案)。 預設大小為240x180。 要更改預設大小,請編輯「縮圖X」和「縮圖Y」參數。

編輯時新增報表類型的方式 Report.cfg 在data workbench中,按一下滑鼠右鍵 報表類型 ,按一下 添加新子項 ,然後選取所需的報表類型。

開始日期

您要報表集執行的第一個日期和時間。 這次是根據資料集的截止時間。

格式:MM/DD/YYY hh:mm時區,使用24小時語法表示時間。

如需時區設定的詳細資訊,請參閱 資料集組態指南.

注意:當設定檔中資料的時間戳記符合指定的日期和時間時,報表就會開始執行。

範例:

如果開始日期是東部標準08/08/2006 12:00 ,報表會針對時間戳記為08/08/2006 12:00(東部標準時間)及更新版本的資料執行。

  • 每日報表會持續執行08/08/2006次,之後每天執行hh:mm = 12:00的資料。
  • 對於東部標準時間為hh:mm = 12:00的資料,每週報告將運行08/08/2006,之後每7天運行一次。
  • 每月報表的執行時間為08/08/2006,其後為每月的第8天,適用於東部標準時間hh:mm = 12:00的資料。

報表時間 量度會影響「最近N」報表維度,例如「最近7天」、「昨天」和「3週前」。 若是報表伺服器中的查詢, 報表時間 量度( 報表時間.metric )識別報表執行的日期和時間。 這最初是在「開始日期」參數中指定的日期和時間,然後以Every參數指定的期間為單位遞增。 若是Data Workbench中的查詢, 報表時間 量度以「截止」量度的午夜為基礎( As Of.metric )。 由於「報表時間」量度的定義不同,如果您查詢使用「最後N」維度的工作區,則可在Data Workbench和 報表伺服器 的URL區段。

縮圖X 可選. 控製作為輸出生成的縮圖X軸的大小(以像素為單位)的整數。
縮圖Y 可選. 控製作為輸出生成的縮圖Y軸大小(以像素為單位)的整數。
前N個量度

可選. 請參閱前N個值參數的說明。

注意:如果在此參數中輸入值,則必須在「Dimension名稱」參數和「前N個值」參數中輸入值。

前N個值

可選. 填入此參數時, 報表伺服器 以動態模式執行,並針對「Dimension名稱」參數中指定的維度,產生元素排名最前(在此參數中指定)的報表,依「排名最前的N個量度」參數中指定的量度計算。

範例:如果您在「Dimension名稱」參數中輸入「頁面」,在「前N個量度」參數中輸入「工作階段」,在此參數中輸入5,則產生的報表會列出工作階段數最多的前5個頁面。

注意:如果您在此參數中輸入值,則必須在「Dimension名稱」參數和「前N個量度」參數中輸入值。

僅使用本地示例 可選. 指出您是否 報表伺服器 僅使用資料集的本機範例產生報表。 將此參數設為true,可讓您檢視報表集的範例(而不需在Data Workbench伺服器上載入),以查看輸出的外觀,而不需花費完全處理資料所需的所有時間。 這可作為測試函式運作。 選項為true或false。 預設值為false。
工作區路徑

可選. 指定報表集的工作區集合位置。 對於維護需要以多種方式生成和分發的單個工作區副本,此功能非常有用,使用 Report.cfg 檔案。 此路徑的根目錄可以是任何配置檔案資料夾。 請勿在路徑字串的開頭輸入斜線(\)。

範例:可以為「設定A」和「設定B」儲存公共工作區,位於 報告\常見 ,然後定義 Report.cfg 兩個不同報表集的檔案,每個報表集具有不同的層代和分發設定。 兩者皆適用 Report.cfg 檔案時,可將「工作區路徑」參數設定為 設定檔名稱\報告\常見。

XSL輸出檔案 可選. 輸出檔案的路徑,此路徑是在 XSL範本 會套用至報表索引。
XSL範本

可選. 要應用到報表索引的XSL模板檔案的路徑。 所得的轉化 .xml 寫入指定 XSL輸出檔案 . 請參閱 報表範例檔案 ,以取得範例檔案。

注意:除非您使用 .xsl 範本產生報表時,所有報表都會以電子郵件附件形式分發。

此頁面上的