IBM Enterprise Records, Versión 5.1.2    

Añadir un informe a ReportDefinitions.xml

Antes de agregar un informe a ReportDefintions.xml, cree una plantilla de informes en el Crystal Reports Designer.

Procedimiento

Para agregar un informe a ReportDefinitions.xml:

  1. Use un editor XML para abrir ReportDefinitions.xml, en <ier_install_path>\Config.
  2. Localice la matriz del modelo de datos que utilice en su almacén de objetos de plan de archivos (FPOS). El archivo xml contiene una matriz de informes DoD, informes clasificados DoD, informes PRO e informes BASE.
  3. Añada una etiqueta de valor (por ejemplo, <value>42</value>). Este valor es un número entero que identifica el informe que cree en Crystal Reports Designer, y es exclusivo de cada informe. Este número es igual al número de informes existentes más 1.
  4. En <List key="ReportDefinitions">, añada <object key="reportDefinition">, al nuevo informe. Si existe un informe que sea similar al informe que ha creado:
    1. Copie entera la clave de objeto reportDefinition del informe existente en el archivo XML.
    2. Pegue la clave de objeto copiada en otra ubicación del archivo XML.
  5. Modifique la clave de objeto reportDefinition del nuevo informe cambiando o añadiendo valores a las siguientes etiquetas, según resulte necesario.

    n es el número que escribió en el paso 3 anterior.

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

    <setting key="title" localizationKey="server.report_title.n">nombre de informe</setting>, donde nombre de informe es el título del informe que muestra IBM® Enterprise Records.

    <setting key="desc" localizationKey="server.report_desc.n">descripción</setting>, donde descripción representa el texto que muestra IBM Enterprise Records y que describe de forma concisa la finalidad del informe. Por ejemplo, "Este informe incluye los volúmenes que se han abierto/cerrado durante un periodo de tiempo concreto."

    <setting key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>, donde filename representa el nombre de la plantilla de informe creada en Crystal Reports Designer.

    <setting key="img">vía de acceso relativa a archivo de imagen</setting> Este es un valor opcional para insertar un gráfico. Por ejemplo, images/action/report.gif.

  6. Para excluir un informe nuevo de un almacén de objetos de plan de archivos (FPOS) específico, especifique las siguientes etiquetas:

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

    en donde fpos es el nombre del FPOS donde se excluye el nuevo informe. Puede añadir etiquetas de valor adicionales para excluir el informe de varios FPOS.

  7. Añada criterios de informe, como ubicaciones de FPOS, acciones, sucesos, programas y fechas.
    1. En <object key="reportDefinition">, añada <list key="properties">, en caso necesario. Si copió la clave de objeto reportDefinition de un informe existene, entonces <list key="properties:> existe.
    2. En la clave de lista de propiedades, añada o modifique la clave de configuración del nombre simbólico, según lo requieran los criterios de cada informe. Si creó cualquier criterio, añada las claves de configuración del nombre simbólico para los nuevos criterios aquí también.

      Coloque detrás de cada clave de configuración de nombre simbólico esta etiqueta: <setting key="required"> 0 o 1 </setting>, para indicar si se requiere un valor. 0 indica que no es necesario que el usuario haga una selección o que introduzca un valor. 1 indica que se requiere que el usuario haga una selección o introduzca un valor.

      Incluya cada par de nombres simbólicos y claves de valor necesarias en esta etiqueta: <object key="property"> </object>.

    Por ejemplo:

    <object key="property"> <setting key="symbolicname">nombre simbólico</setting> <setting key="required">1</setting> </object>

    donde nombre simbólico representa el nuevo criterio creado, o algunas de las siguientes claves de valor:

    • fileplan_browse - Indica a IBM Enterprise Records que permita al usuario examinar una ubicación en el almacén de objetos de plan de archivos.
    • ros_browse - Indica a IBM Enterprise Records que permita al usuario examinar una ubicación en el almacén de objetos de registros.
    • start_date - La fecha de inicio de los criterios del informe.
    • end_date - La fecha final de los criterios del informe.
    • application_type - El tipo de registro para utilizar como criterio, como PDF, DOC, XLS, y otros.
    • security_category - La marca de seguridad, como clasificado, secreto, confidencial y otros, en función del modelo de datos.
    • review_decision - La decisión de una revisión, como Aprobar o Rechazar.
    • action - La acción respecto a una entidad, como abrir o cerrar.
    • disposal_schedule - El programa de disposición asociado con una entidad.
    • disposal_action - La acción de disposición respecto a una entidad, como transferir, revisar, transferir provisionalmente o destruir.
    • disposal_action_export - La acción de disposición respecto a una entidad después de una exportación.
    • report_type - Indica a IBM Enterprise Records que active los botones de selección Resumen o Detallado.
    • disposal_trigger - El suceso que desencadena la disposición de una entidad, como una fecha, el cierre de un contenedor o un suceso externo.
    Para ros_browse, security_category, disposal_action, disposal_action_export, review_decision y activación de disposición, IBM Enterprise Records recupera los valores predeterminados de Content Engine en el tiempo de ejecución. Los ve en un menú donde puede seleccionar un valor.
  8. Si el informe utiliza tipos de entidad como criterios:
    1. En la clave de lista de propiedades, añada el nombre simbólico entity_type, seguido de la clave de valor "required" (1=required, 0=not required). Por ejemplo:
      <object key="property">
      		<setting key="symbolicname">entity_type</setting>
        	<setting key="required">1</setting>
    2. Añada <list key="values"> donde debe especificar los tipos de entidad que un usuario puede seleccionar para incluir en el informe. Por ejemplo:
      <list key="values">   
      		<object key="value">     
      			<setting key="id">EntityType</setting>
           <setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
         </object>

      donde

      • EntityType es RecordCategory, RecordFolder, o Record. Puede incluir los tres tipos de entidad, pero debe hacerlo en etiquetas <object key="value"> independientes.
      • n es el número que se identifica en el paso 3 anterior.
      • Entity es Record Category, Record Folder, o Record.

      Los entornos localizados requieren "localizationKey."

      Por ejemplo, si su informe incluye estadísticas sobre Categorías de registro y Carpetas de registro, esta sección del archivo XML es similar al siguiente ejemplo:

      <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. Si el informe utiliza acciones de clasificación:
    En la clave de lista de propiedades, añada el nombre simbólico classification_action, seguido de la clave de valor "required" (1=required, 0=not required). Por ejemplo:
    <object key="property">   
    		<setting key="symbolicname">classification_action</setting>
    		<setting key="required">1</setting>
    Añada <list key="values"> donde debe especificar las acciones de clasificación que un usuario puede seleccionar para incluir en un informe. Por ejemplo:
    <list key="values">     
    		<object key="value">     
    			<setting key="id">ClassificationAction</setting>      
    			<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>    
    		</object> 
    donde:
    • ClassificationAction es Upgrading, Downgrading, o Declassification. Puede incluir las tres acciones de clasificación, pero debe hacerlo en etiquetas <object key="value"> independientes.
    • n es el valor "id" de este informe en la matriz del modelo de datos.
    Los entornos localizados requieren "localizationKey."

    Por ejemplo, si su informe incluye estadísticas sobre las acciones de degradación y desclasificación, esta sección del archivo XML es similar al siguiente ejemplo:

    <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. Después de escribir todos los criterios del informe:
    1. Cierre <list key="properties"> con </list>.
    2. Cierre <object key="reportDefinition"> con </object>
    3. Guarde el archivo XML.
  11. Reinicie el servidor de aplicaciones web donde IBM Enterprise Records se ejecuta para que se apliquen los cambios.

Resultados

Cuando haya finalizado con las modificaciones, la sección de clave de objeto reportDefinition se ve como el siguiente ejemplo:

<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>


Comentarios

Última actualización: Noviembre 2013
add_report_definition.htm

© Copyright IBM Corp. 2013