將報告新增至 ReportDefintions.xml 之前,請先在 Crystal Reports Designer 中建立報告範本。
程序
如果要將報告新增至 ReportDefinitions.xml,請執行下列動作:
- 使用 XML 編輯器開啟 ReportDefinitions.xml,其位於 <ier_install_path>\Config。
- 找出您在檔案計劃物件儲存庫 (FPOS) 中所使用之資料模型的陣列。此 xml 檔包含 DoD 報告、DoD 已分類報告、PRO 報告及 BASE 報告的陣列。
- 新增值標籤(例如,<value>42</value>)。
此值是一個整數,用於識別 Crystal Reports Designer 中建立的報告,且在每一個報告中是唯一的。
此值等於現有報告數加 1。
- 針對您的新報告,在 <List key="ReportDefinitions"> 內新增 <object
key="reportDefinition">。 如果現有報告與您建立的報告類似,請執行下列動作:
- 複製 XML 檔中現有報告的整個 reportDefinition 物件索引鍵。
- 將複製的物件索引鍵貼到 XML 檔的另一個位置。
- 依需要變更或新增下列標籤的值,以修改新報告的 reportDefinition 物件索引鍵。
n 是您之前在步驟 3 中輸入的數字。
<setting key="id">n</setting>。
<setting key="title"
localizationKey="server.report_title.n">report
name</setting>,其中 report name 是
IBM® Enterprise
Records 顯示的報告標題。
<setting
key="desc" localizationKey="server.report_desc.n">description</setting>,其中 description 是 IBM 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。
- 如果要從特定的檔案計劃物件儲存庫 (FPOS) 排除新報告,請輸入下列標籤:
<array key="excludedObjectStores">
<value>fpos</value> </array>
其中 fpos 是排除新報告的 FPOS 名稱。您可以新增其他值標籤,以從多個 FPOS 排除報告。
- 新增報告準則,例如 FPOS 位置、動作、事件、排程及日期。
- 必要的話,可在 <object key="reportDefinition"> 下新增 <list key="properties">。如果您是從現有報告複製
reportDefinition 物件索引鍵,則 <list key="properties:> 已存在。
- 在內容清單索引鍵下,依需要新增或修改每一個報告準則的符號名稱設定索引鍵。如果您有建立任何準則,也請在這裡為新準則新增符號名稱設定索引鍵。
在每一個符號名稱設定索引鍵後面加上這個標籤:<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 擷取預設值。它們會顯示在功能表中,您可以在其中選取值。
- 如果您的報告使用實體類型作為準則,請執行下列動作:
- 在內容清單索引鍵下,新增 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>
其中
- 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>
- 如果您的報告使用分類動作,請執行下列動作:
在內容清單索引鍵下,新增 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>
- 輸入所有報告準則之後,請執行下列動作:
- 以 </list> 結束 <list key="properties">。
- 以 </object> 結束 <object key="reportDefinition">
- 儲存 XML 檔。
- 重新啟動執行 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>