Report.cfg 參數

Report.cfg參數的相關資訊。

設定報表集中顯示的範例Report.cfg預設僅包含Report.cfg檔案中包含的參數。 下表提供了所有可用Report.cfg檔案參數的說明。

如果需要將其他參數添加到Report.cfg檔案,則必須使用文本編輯器執行此操作。 如需執行此動作的步驟,包括如何定義每個參數項目的範例,請參閱編輯現有的Report.cfg檔案

注意

此表中的參數按字母順序列出。 以Data Workbench開啟Report.cfg檔案時,向量會以字母順序列出,隨後以字母順序列出的個別參數。

參數 說明
警報閾值

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

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

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

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

允許重新產生報表

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

注意: 變更 Report.cfg 檔案會導致報表伺服器重新產生由該 Report.cfg 檔案控制的所有報表。

附件

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

添加新附件:

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

內容類型

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

範例:影像/jpeg

檔案名

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

範例: c:\myimage.jpg

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

可選. 您要在以Excel檔案產生報表時使用的一般Excel範本檔案( .xls .xlsx )的檔案名稱。 此參數支援完整的檔案路徑,例如 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校正

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

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

隱藏徽標 指出報表伺服器在產生您的報表時是否隱藏標誌。 選項為 true false 。 如果設為 false ,則會以Report標誌產生報表。 預設值為 false
查閱檔案

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

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

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

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

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

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

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

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

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

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

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

內文XSL範本

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

如需範例檔案,請參閱報表範例檔案

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

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

可選. 產生的報表集的輸出位置。 預設值為<profile name>\Reports資料夾,位於Report Server安裝目錄中。

要配置報表伺服器以將報表輸出到門戶,請將輸出根設定為用於門戶的Web伺服器的文檔根。

預先載入查詢篩選器

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

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

報告類型

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

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

若要在Data Workbench中編輯 Report.cfg 時新增報表類型,請以滑鼠右鍵按一下報表類型,按一下新增子項,然後選取所需的報表類型。

開始日期

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

格式: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中的查詢,報表時間量度是以「截止」量度的午夜(「截止」.metric )為基礎。 由於「報表時間」量度的定義不同,如果您查詢使用「最後N」維度的工作區,在Data Workbench和相同工作區的報表伺服器中可收到不同的結果。

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

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

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

前N個值

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

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

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

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

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

範例:您可以在 Reports\Common 資料夾中儲存Set A和Set B的公用工作區,然後為兩個不同的報表集定義 Report.cfg 檔案,每個報表集具有不同的層代和分發設定。 在兩個 Report.cfg 檔案中,您可將Workspace路徑參數設定為設定檔名稱\Reports\Common。

XSL輸出檔案 可選. 將 XSL模板應用於報表索引時建立的輸出檔案的路徑。
XSL範本

可選. 要應用到報表索引的XSL模板檔案的路徑。 將生成的轉換後的 .xml 寫入指定的 XSL輸出檔案。 如需範例檔案,請參閱報表範例檔案

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

本頁內容