IBM Enterprise Records 5.1.2 版    

建立報告定義

您可以建立報告定義或使用 6 個 IBM® Enterprise Records 隨附定義檔案的其中一個,然後儲存至檔案計劃物件儲存庫。

IBM Enterprise Records 包含 6 個報告定義,可提供不同使用者活動的統計視圖。 這些定義是透過與軟體一同安裝的附加程式,來新增至檔案計劃物件儲存庫 (FPOS)。這些檔案是在 Records Management/Report Definitions,但是需先手動配置才能使用。如需配置的相關資訊,請參閱《IBM Enterprise Records Installation and Upgrade Guide》中的「配置報告定義」主題。報告定義 是 XML 文件,並定義報告的下列 meta 資料:

報告標題

report titleIBM Enterprise Records 顯示的報告標題。

<setting key="title" localizationKey="server.report_title.n">report title</setting>

報告說明

descriptionIBM Enterprise Records 顯示的文字,用以簡要地說明報告的目的。例如,此報告只顯示您在啟用記錄種類、資料夾、磁區或記錄的審核之後完成的動作。

<setting key="desc" localizationKey="server.report_desc.n">description</setting>

報告說明項目

entry helpIBM Enterprise Records 顯示在報告說明項目中的文字。 例如,「產生的報告只列出在啟用審核後完成的動作。」

<setting key="entryhelp" localizationKey="server.entryhelp.n">entry help</setting>

報告資料庫表格名稱

table name 是資料庫表格名稱,可讓 IBM Enterprise Records 報告引擎從 IBM Enterprise Records 儲存庫擷取結果。 此名稱也用來產生可供報告應用程式使用的中介資料庫表格結果。 例如,ActionPerformed。

<setting key="db_table_name">table name</setting>

報告範本名稱

report name 是在報告應用程式中所建立的報告範本名稱。

<setting key="reportName" localizationKey="server.report_name.n">report name</setting>

報告參數

定義報告參數,例如檔案計劃位置、動作、事件、排程、日期和實體類型,以及其他所需參數。如果要定義報告參數,請執行下列動作:
  1. 必要的話,在 <object key="reportDefinition"> 中定義 <list key="report parameters">
  2. 在報告參數清單索引鍵下,依需要為各報告準則定義符號名稱設定索引鍵。
  3. 在各符號名稱設定索引鍵後面加上此標籤:<setting key="required"> 0 或 1 </setting>,以指出是否需要值。 0 表示使用者不需要進行選擇或輸入值。1 表示需要使用者做選擇。
  4. 用下列標籤括住每一對符號名稱及所需的設定索引鍵:<object key="property"></object>
例如:
<object key="property"> <setting key="symbolicname">symbolic name</setting>
		<setting key="required">1</setting> </object>
其中 symbolic name 是您建立的新準則,或下列任何設定索引鍵:
  • fileplan_browse:指示 IBM Enterprise Records 讓使用者瀏覽檔案計劃物件儲存庫中的位置。
  • fileplan_name:檔案計劃物件儲存庫 (FPOS) 中的檔案計劃。
  • ros_name:記錄物件儲存庫 (ROS) 名稱。
  • user_name:完成活動的使用者名稱。
  • start_date:報告準則的開始日期。
  • end_date:報告準則的結束日期。
  • disposal_schedule:與實體相關聯的處置排程。
  • hold_name:與實體相關聯的記錄保留。
報告也會使用實體類型作為準則。如果要使用實體類型:
  1. 在內容清單索引鍵下,新增 entity_type 符號名稱,後面接著 required 設定索引鍵(1=必要,0=不必要)。例如:
<object key="property">
    <setting key="symbolicname">entity_type</setting>
    <setting key="required">1</setting>
新增 <list key="values">,您可以在其中輸入使用者可選擇併入報告中的實體類型。例如:
    <list key="values">
       <object key="value">
           <setting key="id">EntityType</setting> 
           <setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
       </object>
其中: 本地化環境需要 localizationKey。比方說,如果您的報告包括「記錄種類」和「記錄資料夾」的相關統計資料,XML 檔的這個區段必須與下列範例相似:
<object key="property">
  <setting key="symbolicName">rm_entity_type</setting>
  <setting key="required">1</setting>
  <list key="values'>
    <object key="value">
      <setting key="id">RecordCategory</setting> 
      <setting key="value" localization Key="server.report_1.RecordCategory">Record Category</setting>
    </object>
    <object key="value">
       <setting key="id">RecordFolder</setting> 
       <setting key="value" localization Key="server.report_1.RecordFolder">Record Folder</setting>
    </object>
  </list>
</object>

報告查詢

IBM Enterprise Records 隨附的每個報告都定義了一個以上的查詢以查詢不同實體類型,例如「記錄種類」、「記錄資料夾」、「磁區」或「記錄」。如果要定義報告查詢,請執行下列動作:
  1. <object key="reportDefinition"> 下,定義 <list key="report queries">
  2. 在報告查詢清單索引鍵下,依需要為各報告準則定義查詢。
  3. 遵循各查詢設定索引鍵,針對 rm_entity_type 定義設定,以指出查詢要用於某個特定實體類型:「記錄種類」、「記錄資料夾」、「磁區」或「記錄」。當查詢是適用於所有實體類型時,rm_entity_type 是選用的。
  4. 用下列標籤括住各查詢和實體類型設定索引鍵:<object key="query"></object>
例如:
<list key="report queries">
   <object key="query">
     <setting key="sql">SELECT EV.LastModifier, EV.DateCreated, EV.ClassDescription, EV.AuditActionType,RC.RecordCategoryName AS EntityName, RMF.PathName, RC.Aggregation FROM (Event EV INNER JOIN RecordCategory RC ON EV.SourceObjectID = RC.ID)INNER JOIN RMFOLDER RMF on RC.parent=RMF.This WHERE EV.DateCreated >= {?start_date} AND EV.DateCreated <= {?end_date} AND EV.LastModifier = '{?user_name}' AND RC.this INSUBFOLDER '/{?fileplan_name}'</setting>
     <setting key="my_entity_type">RecordCatagory</setting>
   </object>
   <object key="query">
      <setting key="sql">SELECT EV.LastModifier, EV.DateCreated, EV.ClassDescription, EV.AuditActionType,RF.RecordFolderName AS EntityName,RMF.PathName, RF.Aggregation FROM (Event EV INNER JOIN RecordFolder RF ON EV.SourceObjectID = RF.ID)INNER JOIN RMFOLDER RMF on RF.parent=RMF.This WHERE EV.DateCreated >= {?start_date} AND EV.DateCreated <= {?end_date} AND EV.LastModifier = '{?user_name}' AND RF.this INSUBFOLDER '/{?fileplan_name}'</setting>
     <setting key="my_entity_type">RecordFolder</setting>
   </object>
<list>


意見

前次更新: 2013 年 11 月
use_report_definitions.htm

© Copyright IBM Corp. 2013