Extraer datos mediante filtros nativos

Puede utilizar filtros nativos con todos los orígenes de datos soportados. .

Antes de empezar

Si está integrando Rational Publishing Engine con un producto que no da soporte a los orígenes de datos de Reportable REST, se capta el conjunto de datos completo y no puede filtrarse. Para verificar que el producto da soporte a orígenes de datos Reportable REST, puede probar la condición de filtro en el origen de datos nativo antes de utilizarla en Rational Publishing Engine.

Revise el documento Reportable Rest v1 para obtener más información sobre la definición de requisitos de servicios de Reportable REST v1.

Acerca de esta tarea

Los filtros nativos están soportados en orígenes de datos Reportable REST, que permiten el filtrado, clasificación y soporte selectivo de propiedades. El filtro nativo solicita de un conjunto de datos del origen de datos y, a continuación, los filtra y refina para la salida de una plantilla de Rational Publishing Engine. No es necesario crear filtros en el producto del que proceden los datos, a menos que desee probar la exactitud de los filtros, pero puede crear filtros exclusivamente para su uso en plantillas de Rational Publishing Engine desde dentro de Rational Publishing Engine.

En releases anteriores de Rational Publishing Engine, sólo podían definirse filtros estáticos. Era necesario saber cómo eran los filtros al diseñar la plantilla, y no podían modificarse en tiempo de ejecución.

Procedimiento

  1. En Document Studio, seleccione el elemento de la plantilla que contiene la consulta que se va a filtrar.
  2. En la vista Propiedades, seleccione la pestaña Datos.
  3. En el campo Filtrar, pulse el botón de puntos suspensivos.
  4. En la pestaña Filtro nativo, expanda Variables.
    Nota: las variables utilizadas en filtros pueden modificarse antes de utilizar la primera consulta sobre ese origen de datos.
  5. Seleccione una variable en la que basar el filtro.
  6. Especifique la sintaxis ${} para definir la consulta que debe filtrarse. Por ejemplo, puede filtrar por un nombre de producto. Varios equipos de producto pueden utilizar esta plantilla y especificar un nombre de producto en la especificación de documento en tiempo de ejecución.
    cq:Product{cq:Product"${productName}"
    Nota:
    • No pueden utilizarse atributos personalizados en filtros nativos.
    • Si renombra una variable, el nombre no se actualizará en una expresión de script o filtro nativo y creará un error de referencia. Al renombrar una variable, asegúrese de revisar el nombre en las expresiones de script y también en los filtros nativos.
    • Para extraer datos de Rational DOORS, utilice el script DXL como condición de filtro nativo. Para extraer datos de REST, utilice la condición de filtro XPath.
  7. Pulse Aceptar.

Orígenes de datos que admiten la sintaxis de Reportable Rest v1

En los filtros de Reportable Rest v1, sólo es necesario especificar el texto entre corchetes []. Rational Publishing Engine genera el resto del filtro.

Design Management

Design Management da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. Para obtener más información, consulte Reportable Rest v1.

IBM Rational ClearCase

El adaptador de Rational ClearCase da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. Consulte Reportable Rest v1 para obtener más información.

IBM Rational ClearQuest

El adaptador de Rational ClearQuest da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. Consulte Reportable Rest v1 para obtener más información.

IBM Rational DOORS Next Generation

Rational DOORS Next Generation da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. Consulte Orígenes de datos de Rational Requirements Composer para obtener más información. Esta información se aplica a los orígenes de datos de Rational DOORS Next Generation y Rational Requirements Composer.

IBM Rational Quality Manager

Rational Quality Manager da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. Consulte API de Reportable REST de Rational Quality Manager para obtener más información.

IBM Rational RequisitePro

El ejemplo siguiente de filtro nativo de Reportable Rest v1 extrae el esquema PRRequirements de Rational RequisitePro utilizando Stability='High'.

Ejemplo

Añada una expresión de filtro al nodo bajo Appliances, de modo que sólo se seleccionen los dispositivos fabricados por un fabricante específico.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)

IBM Rational Rhapsody

Rational Rhapsody da soporte a orígenes de datos Reportable Rest v1 para su uso en filtros nativos. Para obtener más información, consulte Reportable Rest v1.

IBM Rational Team Concert

Rational Team Concert da soporte a orígenes de datos Reportable Rest v1 para su uso en filtros nativos. Consulte API REST de informes en Jazz.net para obtener más información.

Ejemplo

[projectArea/name="JKESample"]/*
Solicitud resuelta:
https://servidor:puerto/ccm/rpt/repository/workitem?fields=workitem/workItem[projectArea/name="JKESample"]/(@href|summary)

Aplicación Gestión de requisitos

La aplicación Gestión de requisitos admite el filtrado nativo de orígenes de datos Reportable Rest v1. Las prestaciones proporcionadas por la aplicación Gestión de requisitos (RM) se licencian como IBM® Rational DOORS Next Generation. La información sobre la integración de la aplicación RM se aplica a Rational DOORS Next Generation y a versiones específicas de IBM Rational Requirements Composer. Consulte Orígenes de datos de Rational Requirements Composer para obtener más información.

Orígenes de datos que admiten la sintaxis de Reportable Rest v2

Acerca de esta tarea

Nota:
  • Las solicitudes se realizan a un origen de datos sólo cuando es necesario. Por ejemplo, puede utilizar condiciones para que un elemento se visualice en la salida sólo cuando contenga datos. La condición en un elemento de contenedor podría ser variable == "true". Si esta condición no se cumple y no hay datos que cumplan la condición de la variable, no se efectúan solicitudes al origen de datos.
  • Puede calcular los filtros nativos antes de realizar la petición. El filtro nativo se calcula en el punto donde se encuentra la consulta y utiliza los valores de variable de ese punto. Por tanto, puede realizar cálculos en la plantilla, que afectarán a los filtros nativos.

IBM Rational ClearQuest

Rational ClearQuest versión 8 da soporte al filtrado nativo de orígenes de datos Reportable Rest v2. Para obtener más información, consulte API REST OSLC CM de Rational ClearQuest.

Ejemplo

Ejemplo de filtro de variable:
cq:Product{cq:Product="${productName}") 
Ejemplo de filtro resuelto, donde productName es Rational Publishing Engine:
cq:Product{cq:Product="Rational Publishing Engine")

Orígenes de datos que admiten la sintaxis de API propietaria

IBM Rational DOORS

Rational DOORS da soporte a una API propietaria y el filtro se expresa mediante la sintaxis de vista de Rational DOORS.

Ejemplo

El ejemplo siguiente de filtro nativo de Rational DOORS filtra los objetos que contienen la palabra "Documentation" en el atributo de texto de objeto.
Attribute 'Object Text' contains 'Documentation' (case sensitive)
Para generar el texto de filtro nativo para un origen de datos de Rational DOORS:
  1. Abra un módulo de Rational DOORS y pulse Herramientas > Filtrar > Definir entrada de menú.
  2. Cree la sintaxis de filtro:
    1. Seleccione la pestaña Atributos.
    2. Para atributo, seleccione Texto de objeto.
    3. Para Condición, seleccione Contiene.
    4. Para Valor, escriba un valor específico de filtro. Por ejemplo, para filtrar sólo los objetos que contienen la palabra Documentación en el atributo Texto de objeto, especifique: Documentación
    5. Pulse Añadir. En la sección Opciones avanzadas, se crea la sintaxis de reglas.
  3. Pulse Descripción y copie la descripción completa. Ahora tiene el filtro de Rational DOORS, que es un script DXL.
Para añadir el filtro de Rational DOORS al elemento de plantilla de Rational Publishing Engine:
  1. Seleccione el elemento de plantilla que contiene la consulta que se va a filtrar.
  2. En la pestaña Propiedades, expanda Datos.
  3. En el campo Filtrar, pulse el botón de puntos suspensivos. Se abrirá la ventana Editor de filtros.
  4. En la pestaña Filtro nativo, pegue el filtro de Rational DOORS (script DXL) y pulse Aceptar.