Report.cfg 參數

有關Report.cfg參數的資訊。

Configure the Report Set中顯示的範例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. 按一下右鍵附件 ,然後按一下添加新子 > 附件

內容類型

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

範例:image/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 ,則會以報表標誌產生報表。 預設值為 false
查閱檔案

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

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

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

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

透過電子郵件分發報表的區段識別碼。 若要透過電子郵件分發報表,請填妥 「郵件報表」項目的下列參數。 報表集中的所有報表都會以電子郵件傳送至「收件者」參數中指定的電子郵件地址。

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

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

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

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

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

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

內文XSL範本

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

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

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

收件者 您要傳送報表之人員的電子郵件地址。
發件人地址 發件人的電子郵件地址。
傳送者名稱 選填。發件人的名稱。
SMTP伺服器 SMTP伺服器電腦的地址以及驗證所需的口令和用戶名。
主旨 可選. 描述要傳送之電子郵件的主旨行。
僅通知 可讓您設定資料工作台,以便在產生背景報表時傳送電子郵件。 將此值設為True不會傳送報表,而是傳送電子郵件,將訂閱的使用者連結至報表位置。
輸出根

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

要配置報告伺服器將報告輸出到入口網站,請將輸出根設定為用於入口網站的Web伺服器的文檔根。

預先載入查詢篩選

可選. 此參數僅適用於 「頂級Dimension元素」報表類型。

您要套用至查詢的篩選器名稱,此篩選器必須執行才能決定前N個維度元素,才能產生報表。 預設值為 Broken_Session_Filter 。 有關中斷會話過濾器的詳細資訊,請參閱Data Workbench使用手冊

報告類型

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

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

若要在資料工作台中編輯 Report.cfg 時新增報表類型,請以滑鼠右鍵按一下「報表類型」,按一下「新增子系」,然後選取所要的報表類型。

開始日期

您希望報表集執行的第一個日期和時間。 此時間以資料集的截止時間為基礎。

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

有關時區設定的詳細資訊,請參閱資料集配置指南

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

範例:

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

  • 每日報告將於08/08/2006執行,其後每天執行hh:mm = 12:00 EST的資料。
  • 每週報告將於2006年8月08日執行,其後每7天執行一次,以取得EST為hh:mm = 12:00的資料。
  • 每月報表將於2006年8月8日執行,其後每月的8日執行,其中hh:mm = 12:00 EST的資料會執行。

報表時間量度會影響「最近7天」、「昨天」和「3週前」等報表維度。 對於報表伺服器中的查詢,報表時間量度(報表時間。metric )會識別報表執行的日期和時間。 這最初是在「開始日期」參數中指定的日期和時間,然後會依「每個」參數指定的期間遞增。 對於資料工作台中的查詢,報表時間量度是以「截止」量度的午夜(截止。metric )為基礎。 由於「報表時間」量度的定義不同,如果您查詢使用「最後一個N」維度的工作區,您可以在相同工作區的資料工作台和報表伺服器中收到不同的結果。

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

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

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

前N個值

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

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

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

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

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

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

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

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

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

本頁內容