IBM Enterprise Records 5.1.2 版    

新增報告至 ReportDefinitions.xml

將報告新增至 ReportDefintions.xml 之前,請先在 Crystal Reports Designer 中建立報告範本。

程序

如果要將報告新增至 ReportDefinitions.xml,請執行下列動作:

  1. 使用 XML 編輯器開啟 ReportDefinitions.xml,其位於 <ier_install_path>\Config
  2. 找出您在檔案計劃物件儲存庫 (FPOS) 中所使用之資料模型的陣列。此 xml 檔包含 DoD 報告、DoD 已分類報告、PRO 報告及 BASE 報告的陣列。
  3. 新增值標籤(例如,<value>42</value>)。 此值是一個整數,用於識別 Crystal Reports Designer 中建立的報告,且在每一個報告中是唯一的。 此值等於現有報告數加 1。
  4. 針對您的新報告,在 <List key="ReportDefinitions"> 內新增 <object key="reportDefinition"> 如果現有報告與您建立的報告類似,請執行下列動作:
    1. 複製 XML 檔中現有報告的整個 reportDefinition 物件索引鍵。
    2. 將複製的物件索引鍵貼到 XML 檔的另一個位置。
  5. 依需要變更或新增下列標籤的值,以修改新報告的 reportDefinition 物件索引鍵。

    n 是您之前在步驟 3 中輸入的數字。

    <setting key="id">n</setting>。

    <setting key="title" localizationKey="server.report_title.n">report name</setting>,其中 report nameIBM® Enterprise Records 顯示的報告標題。

    <setting key="desc" localizationKey="server.report_desc.n">description</setting>,其中 descriptionIBM Enterprise Records 顯示的文字,其會簡要說明報告的用途。例如,「此報告會列出特定期間內開啟/關閉的磁區」。

    <setting key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>,其中 filename 是在 Crystal Reports Designer 中所建立的報告範本名稱。

    <setting key="img">relative path to image file</setting> 這是用於插入圖形的選用值。例如,images/action/report.gif

  6. 如果要從特定的檔案計劃物件儲存庫 (FPOS) 排除新報告,請輸入下列標籤:

    <array key="excludedObjectStores"> <value>fpos</value> </array>

    其中 fpos 是排除新報告的 FPOS 名稱。您可以新增其他值標籤,以從多個 FPOS 排除報告。

  7. 新增報告準則,例如 FPOS 位置、動作、事件、排程及日期。
    1. 必要的話,可在 <object key="reportDefinition"> 下新增 <list key="properties">。如果您是從現有報告複製 reportDefinition 物件索引鍵,則 <list key="properties:> 已存在。
    2. 在內容清單索引鍵下,依需要新增或修改每一個報告準則的符號名稱設定索引鍵。如果您有建立任何準則,也請在這裡為新準則新增符號名稱設定索引鍵。

      在每一個符號名稱設定索引鍵後面加上這個標籤:<setting key="required"> 0 or 1 </setting>,以指出是否需要值。 0 表示使用者不需要進行選擇或輸入值。1 表示使用者需要進行選擇或輸入值。

      用下列標籤括住每一對符號名稱及所需的設定索引鍵:<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 允許使用者瀏覽至檔案計劃物件儲存庫中的某個位置。
    • ros_browse - 指示 IBM Enterprise Records 允許使用者瀏覽至記錄物件儲存庫中的某個位置。
    • start_date - 報告準則的開始日期。
    • end_date - 報告準則的結束日期。
    • application_type - 作為準則的記錄類型,例如 PDF、DOC、XLS 及其他。
    • security_category - 安全標記,例如已分類、秘密、機密及其他,這會隨資料模型而不同。
    • review_decision - 審查決策,其中包括核准拒絕
    • action - 針對實體的動作,例如開啟或關閉。
    • disposal_schedule - 與實體相關聯的處置排程。
    • disposal_action - 針對實體的處置動作,例如傳送、審查、臨時傳送或毀損。
    • disposal_action_export - 實體匯出之後的處置動作。
    • report_type - 指示 IBM Enterprise Records 啟動「摘要」或「詳細」圓鈕。
    • disposal_trigger - 觸發實體處置的事件,例如日期、儲存器關閉或外部事件。
    對於 ros_browse、security_category、disposal_action、disposal_action_export、review_decision 及 disposal_trigger,IBM Enterprise Records 會在執行時期從 Content Engine 擷取預設值。它們會顯示在功能表中,您可以在其中選取值。
  8. 如果您的報告使用實體類型作為準則,請執行下列動作:
    1. 在內容清單索引鍵下,新增 entity_type 符號名稱,後面接著 "required" 設定索引鍵(1=必要,0=不必要)。 例如:
      <object key="property">
      		<setting key="symbolicname">entity_type</setting>
        	<setting key="required">1</setting>
    2. 新增 <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>

      其中

      • EntityType 是「記錄種類」、「記錄資料夾」或「記錄」。 您可以將這三個實體類型全部併入,但必須以個別的 <object key="value"> 標籤括住每一個實體類型。
      • n 是之前在步驟 3 中識別的數字。
      • Entity 是記錄種類、記錄資料夾或記錄。

      本地化環境需要 "localizationKey"。

      比方說,如果您的報告包括「記錄種類」和「記錄資料夾」的相關統計資料,XML 檔的這個區段會類似下列範例:

      <object key="property">   
      		<setting key="symbolicname">entity_type</setting>
        <setting key="required">1</setting>   
      		<list key="values">
          <object key="value">   
      				<setting key="id">RecordCategory</setting>
        			<setting key="value" localizationKey=serve.report_42.RecordCategory">Record Category</setting>     
      		 </object>      
      		 <object key="value">
        			<setting key="id">RecordFolder</setting>   
      				<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
          </object>
      		</list> 
      </object>
  9. 如果您的報告使用分類動作,請執行下列動作:
    在內容清單索引鍵下,新增 classification_action 符號名稱,後面接著 "required" 設定索引鍵(1=必要,0=不必要)。 例如:
    <object key="property">   
    		<setting key="symbolicname">classification_action</setting>   
    		<setting key="required">1</setting>
    新增 <list key="values">,您可以在其中輸入使用者可選擇併入報告中的分類動作。例如:
    <list key="values">     
    		<object key="value">     
    			<setting key="id">ClassificationAction</setting>      
    			<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>    
    		</object> 
    其中:
    • ClassificationAction 是升級、降級或取消分類。您可以將這三個分類動作全部併入,但必須以個別的 <object key="value"> 標籤括住每一個分類動作。
    • n 是資料模型陣列中這個報告的 "id" 值。
    本地化環境需要 "localizationKey"。

    比方說,如果您的報告包括降級和取消分類動作的相關統計資料,XML 檔的這個區段會類似下列範例:

    <object key="property">   
    		<setting key="symbolicname">classification_action</setting>
      	<setting key="required">1</setting>   
    		<list key="values">
        	<object key="value">   
    				<setting key="id">Downgrading</setting>
      			<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
         	</object>      
    		  <object key="value">   
    				<setting key="id">Declassification</setting>
      			<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
         </object>
    		</list> 
    </object>
  10. 輸入所有報告準則之後,請執行下列動作:
    1. 以 </list> 結束 <list key="properties">。
    2. 以 </object> 結束 <object key="reportDefinition">
    3. 儲存 XML 檔。
  11. 重新啟動執行 IBM Enterprise Records 的 Web 應用程式伺服器,以使變更生效。

結果

完成修改之後,reportDefinition 物件索引鍵區段會類似下列範例:

<object key="reportDefinition">   
	<setting key="id">22</setting>
  <setting key="title" localizationKey="server.report_title.42">Records
Manager Classification Update Report</setting>   
	<setting key="desc" localizationKey="server.report_desc.42">This report lists entities
that have changed classification within a specific period.</setting>
  <setting key="url">RMViewReport.jsp</setting>   
	<setting key="img">images/action/report.gif</setting>   
	<setting key="reportName" localizationKey="server.report_name.42">Classification Update.rpt</setting>
  		<list key="properties">     
		<object key="property">   
			<setting key="symbolicName">fileplan_browse</setting>   
			<setting key="required">0</setting>
    </object>
	  <object key="property">   
			<setting key="symbolicName">start_date</setting>
  			<setting key="required">1</setting>     
	  </object>      
	  <object key="property">   
			<setting key="symbolicName">end_date</setting>
  			<setting key="required">1</setting>     
		</object>      
		<object key="property">   
			<setting key="symbolicName">report_type</setting>
  			<setting key="required">0</setting>     
		</object>      
		<object key="property">   
			<setting key="symbolicname">entity_type</setting>
  			<setting key="required">1</setting>   
			<list key="values">
    			<object key="value">     
					<setting key="id">RecordCategory</setting>
    				<setting key="value" localizationKey=serve.report_42.RecordCategory">Record
Category</setting>     
				</object>      
				<object key="value">
    				<setting key="id">RecordFolder</setting>     
					<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
    			</object>      
				<object key="property">     
					<setting key="symbolicname">classification_action</setting>
    				<setting key="required">1</setting>     
					<list key="values">
    					<object key="value">     
							<setting key="id">Downgrading</setting>
    						<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
     				</object>     
						<object key="value">     
							<setting key="id">Declassification</setting>
    						<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
     				</object>     
					</list>      
				</object>    
			</list> 
    </object>
	</list> 
</object>


意見

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

© Copyright IBM Corp. 2013