IBM Enterprise Records, Версия 5.1.2    

Добавление отчета в ReportDefinitions.xml

Прежде чем добавить отчет в файл ReportDefintions.xml, создайте шаблон отчета в Crystal Reports Designer.

Процедура

Чтобы добавить отчет в файл ReportDefinitions.xml:

  1. В редакторе XML откройте файл ReportDefinitions.xml из каталога <путь_установки_ier>\Config.
  2. Определите местоположение массива для модели данных, которую вы используете на складе объектов плана размещения (file plan object store, FPOS). Файл xml содержит массив для отчетов DoD, отчетов DoD Сlassified, отчетов PRO и отчетов BASE.
  3. Добавьте тег значения (например, <value>42</value>). Это значение - целочисленный идентификатор отчета, который вы создали в Crystal Reports Designer; у каждого отчета это значение уникально. Это значение равно числу существующих отчетов плюс 1.
  4. В ключе <List key="ReportDefinitions"> добавьте ключ <object key="reportDefinition"> для нового отчета. Если есть существующий отчет, который подобен создаваемому отчету:
    1. Скопируйте весь ключ объекта reportDefinition существующего отчета в файле XML.
    2. Вставьте скопированный ключ объекта в другое положение файла XML.
  5. Модифицируйте ключ объекта reportDefinition для своего нового отчета, изменив или добавив значения для указанных ниже тегов, как требуется.

    n - число, введенное вами ранее на шаге 3.

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

    <setting key="title" localizationKey="server.report_title.n">имя отчета</setting>, где имя отчета - заголовок отчета, выводимый в IBM® Enterprise Records.

    <setting key="desc" localizationKey="server.report_desc.n">описание</setting>, где описание - текст, в котором кратко описывается назначение отчета; он выводится в IBM Enterprise Records. Например, "В этом отчете перечислены тома, которые были открыты/закрыты за конкретный период времени".

    <setting key="reportName" localizationKey="server.report_name.n">имя файла.rpt</setting>, где имя файла - имя шаблона отчета, созданного в Crystal Reports Designer.

    <setting key="img">относительный путь к файлу изображения</setting> Это необязательное значение для вставки рисунка. Например, images/action/report.gif.

  6. Чтобы исключить новый отчет из определенного склада объектов плана файла (file plan object store, 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 или 1 </setting>, чтобы указать, обязательное ли это значение. 0 указывает, что пользователь не обязан делать выбор или вводить значение. 1 указывает, что пользователь обязан сделать выбор или ввести значение.

      Окружите каждую пару символическое имя - задающий ключ парой тегов <object key="property"> </object>.

    Например:

    <object key="property"> <setting key="symbolicname">символическое имя</setting> <setting key="required">1</setting> </object>

    где символическое имя - созданный вами новый критерий или любой из следующих задающих ключей:

    • 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 получает значения по умолчанию от механизма содержимого во время выполнения. Вы видите их в меню, где можно выбрать значение.
  8. Если ваш отчет использует как критерии типы объектов:
    1. Под ключом списка свойств добавьте символическое имя entity_type, после которого введите задающий ключ обязательности (1=обязательный, 0=не обязательный). Например:
      <object key="свойство">
      		<setting key="symbolicname">entity_type</setting>
        	<setting key="required">1</setting>
    2. Добавьте ключ <list key="значения"> и введите типы объектов, которые пользователь сможет выбирать для включения в отчет. Например:
      <list key="values">   
      		<object key="value">     
      			<setting key="id">EntityType</setting>
           <setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
         </object>

      где:

      • EntityType - это RecordCategory, RecordFolder или Record. Можно включать все три типа объекта, но каждый надо отдельно окружить парой тегов <object key="значение">.
      • n - число, заданное ранее на шаге 3.
      • Объект - Категория записи, Папка записи или Запись.

      Для сред с локализацией требуется ключ "localizationKey".

      Например, если ваш отчет включает в себя статистику о Категориях записи и Папках записи, этот раздел файла XML подобен следующему:

      <object key="свойство">   
      		<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, после которого введите задающий ключ обязательности (1=обязательный, 0=не обязательный). Например:
    <object key="свойство">   
    		<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 - это Upgrading (повысить уровень), Downgrading (понизить уровень) или Declassification (снять секретность). Можно включать все три действия с уровнем секретности, но каждый надо отдельно окружить парой тегов <object key="значение">.
    • 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 key="properties"> тегом </list>.
    2. Закройте ключ <object key="reportDefinition"> тегом </object>
    3. Сохраните файл XML.
  11. Перезапустите сервер Web-программ, где запущена программа IBM Enterprise Records, чтобы изменения вступили в силу.

Результаты

Когда вы завершите модификации, раздел ключей объектов 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">Этот отчет содержит объекты,
уровень секретности которых изменился за данный период.</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 г.
add_report_definition.htm

© Copyright IBM Corp. 2013