Establecer cómo se formatean y calculan los datos

Defina el contenido de un elemento de plantilla o sus valores de propiedad para el formateo y cálculo de los datos.

Acerca de esta tarea

Puede definir el contenido de una plantilla utilizando valores simples, expresiones de datos o expresiones de script.

Tanto las expresiones de datos como las expresiones de script tienen variables internas disponibles para selección.
Tabla 1. Variables internas de Rational Publishing Engine
Variable Descripción
_cell_number El número de celda en una fila actual. Si el elemento no es una celda, el valor es 0. Puede utilizar _cell_number de la pestaña Expresión de datos o Expresión de script.
_element_id El número de elemento dentro de la plantilla. Se mantiene internamente en la plantilla y se utiliza para la depuración. Puede utilizar _element_id de la pestaña Expresión de datos o Expresión de script.
_element_level El nivel recursivo de un elemento. Si no hay un conjunto de valores para el elemento en la propiedad Nivel recursivo de la pestaña Datos, el valor es 1. Puede utilizar _element_level de la pestaña Expresión de datos o Expresión de script.
_row_number El número de fila en una tabla actual. Si el elemento no está contenido en un elemento de fila, el valor es 0. Puede utilizar _row_number de la pestaña Expresión de datos o Expresión de script.
_sessionInfo Información de propiedad de tiempo de ejecución de la plantilla o la especificación de documento. En la pestaña Expresión de script, seleccione la variable _sessionInfo y especifique el script. Utilice marcas de comillas vacías sin ningún valor dentro para generar el valor predeterminado para la propiedad en la salida. Ejemplos de script:

_sessionInfo.getDocspecProperty("propiedad", "");
_sessionInfo.getTemplateProperty("propiedad", "");
_sessionInfo.getDatasourceProperty("nombre_origen_datos","propiedad", "");
_sessionInfo.getOutputProperty("tipo_salida","propiedad", "");
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

Para getDocspecProperty, puede utilizar las propiedades de especificación de documento existentes o las propiedades de Crear metatados personalizados.

_sessionLogger A efectos de depuración, puede visualizar información personalizada y mensajes de error, aviso o depuración en el archivo TEMP\rpe\rpe.log, la vista Consola o la vista Problemas. Los mensajes se visualizan en la ubicación que se ha definido en el archivo log4j.properties.

El valor predeterminado es visualizar mensajes de información en la vista Consola, pero no en el archivo rpe.log.

En la pestaña Expresión de script, seleccione la variable _sessionLogger y especifique el script. Puede generar entradas de registro con uno de los métodos siguientes:
  1. _sessionLogger.debug(mensaje)
  2. _sessionLogger.info(mensaje)
  3. _sessionLogger.error(mensaje)
  4. _sessionLogger.warn(mensaje)

Cuando tenga que decidir qué va a especificar como mensaje en el script, se recomienda utilizar un comentario visual, como sus iniciales o su nombre de usuario, y utilizar variables de la plantilla para que los mensajes sean más significativos.

_sessionUtils En la pestaña Expresión de script, puede utilizar esta variable para ejecutar una función en el script denominada tidyXHTML. Esta variable es muy útil cuando observa bloques de espacio en blanco en la salida que se crea debido a una codificación XHTML incorrecta. Con la variable _sessionUtils, se procesa un argumento de serie y se limpia el XHTML para que el espacio en blanco adicional no aparezca en la salida.

Ejemplo: _sessionUtils.tidyXHTML(texto);

Cuando utilice la variable _sessionUtils, seleccione también las opciones Entrada XHTML y Salida XHTML en la pestaña de Expresión de script.
Nota: Las plantillas que incluyen esta variable puede cargarse en las versiones anteriores de Rational Publishing Engine, pero los scripts no pueden evaluarse correctamente.

Procedimiento

  1. En el editor de contenidos de plantilla, efectúe una doble pulsación en el elemento de texto. Se abrirá la ventana Establecer contenido del elemento actual.
  2. Especifique el contenido utilizando una de las opciones siguientes:
    • Para utilizar un valor simple, pulse la pestaña Valor simple y especifique un valor.
    • Para utilizar una expresión de datos, pulse la pestaña Expresión de datos y:
      • Expanda Variables y seleccione una variable a utilizar.
      • Expanda Atributos y seleccione un atributo de datos a utilizar.
    • Para utilizar una expresión de script, pulse la pestaña Expresión de script.
      • Expanda Variables, seleccione una variable y especifique el código JavaScript que puede utilizar las variables en el contexto actual.
      • Expanda Atributos, seleccione un atributo y especifique el código JavaScript que puede utilizar los atributos de datos en el contexto actual.
      • Si ha copiado el script de XHTML, puede seleccionar la opción Entrada XHTML para permitir la edición de las etiquetas XHTML contenidas en el script.
      • Si está generando la plantilla en salida XHTML, puede seleccionar la opción Salida XHTML para analizar el script y visualizar el script como texto enriquecido.
      Por ejemplo, para seleccionar los atributos como número absoluto, nombre y valor, escriba el código JavaScript con el formato siguiente:
      "objeto:"+Número absoluto+
      "atributo"+nombre+
      "valor"+_valor
      Consejo: si tiene una plantilla bastante compleja, puede describir cada bloque de la plantilla utilizando las propiedades Nombre y Descripción. Los campos de nombre y descripción están vacío de forma predeterminada, el contenido de nombre aparece en la plantilla y el contenido de la descripción puede visualizarse en el campo de pista de elemento de plantilla. Esto puede ayudar a que otros usuarios reutilicen la plantilla.

      También tiene la opción de importar un script existente o trabaje en el editor de JavaScript en lugar de en la pestaña de expresión de script:

    1. Si está incluyendo un nuevo script de otro archivo, pulse Incluir script y seleccione un archivo del sistema, un servidor remoto o del componente Creador de documentos. Pulse Aceptar.
      Consejo: puede reutilizar funciones JavaScript en diferentes partes de la plantilla estableciendo una propiedad Script de biblioteca en el código de script. Para establecer la propiedad Script de biblioteca, vaya a la vista Propiedades del elemento Código JavaScript, seleccione la pestaña Específico y habilite el recuadro de selección Script de biblioteca. Para obtener más información sobre la propiedad de script de biblioteca, consulte la sección Propiedades de elemento de código JavaScript. .

      Para los archivos seleccionados en el sistema o un servidor remoto, se abre una copia del código JavaScript del archivo seleccionado en el editor JavaScript.

      Para los archivos seleccionados desde Creador de documentos, se abre la ventana Utilizar referencia de script. Debe elegir si desea incluir JavaScript como un enlace de referencia en la plantilla:
    • Si selecciona , el enlace al archivo JavaScript (.js) se incorpora dentro de una etiqueta <Script>. Por ejemplo, se añade el enlace de referencia siguiente en el editor JavaScript que no debe modificar:
      <Script src= "library://api/scripts/51"></Script>
      Recuerde: Cuando se ejecuta la generación de documentos desde la plantilla, y tiene un JavaScript como un enlace de referencia en la plantilla, el Creador de documentos debe estar activo y conectado a Document Studio. Si desea más detalles, consulte el tema Conexión al componente Creador de documentos.
    • Si selecciona No, se abre una copia del código JavaScript del archivo seleccionado en el editor JavaScript.
    1. Pulse Abrir en el editor para especificar el script en un editor de Eclipse JavaScript. El script se abre en un nuevo separador de editor como un archivo .js temporal como, por ejemplo, puede editar el JavaScript y gestionar el script a través de las opciones en la vista Esquema. Tras editar el script, guarde los cambios y cierre el separador temporal del editor JavaScript para volver a la ventana Código de entrada para un elemento de código JavaScript.
    2. Pulse Script de prueba para validar el código.
    3. Pulse Aceptar para guardar los cambios y salir de la ventana.
  3. Pulse Aceptar para guardar los cambios.

Ejemplo

Ejemplo de utilización de expresión de datos
Para visualizar los números de fila generados automáticamente en las tablas:
  1. Arrastre un elemento de tabla al editor.
  2. Especifique las 3 filas y 3 columnas para la tabla y pulse Aceptar.
  3. Arrastre un elemento de texto a cada celda.
  4. Seleccione la primera celda de la primera fila.
  5. En la vista Propiedades, seleccione la pestaña Contenido y pulse Icono de configuración. Al efectuar una doble pulsación en el elemento también se abrirá la misma ventana.
  6. Pulse la pestaña Expresión de datos y seleccione _row_number. A continuación, pulse Aceptar.
  7. Repita el proceso para la primera celda de la segunda fila y la tercera fila.
  8. Elimine los bordes de las celdas de número de fila:
    1. Mantenga pulsada la tecla Control y seleccione la primera celda de cada fila. Cuando haya varios elementos seleccionados, puede editar las propiedades de todos ellos simultáneamente.
    2. En la vista de propiedades, seleccione la pestaña Borde.
    3. Para la propiedad Estilo, seleccione ninguno.
  9. Guarde la plantilla.
  10. Pruebe la plantilla generando la salida. La primera celda incluye el número de fila y no tiene bordes:
    Ejemplo de salida
  11. En la plantilla, termino la adición de atributos del esquema de origen de datos a las celdas restantes para completar la tabla.