Creación de documentos de rastreabilidad de aplicaciones CLM utilizando el perfil POX

Ahora es más fácil que nunca crear documentos de rastreabilidad desde aplicaciones CLM. Puede configurar URL de OSLC para devolver datos de representación REST notificables, si se incluye una cabecera especial en la solicitud utilizando POX (Plain Old XML).

Antes de empezar

Debe tener Rational Publishing Engine 2.1.0 o posteriores y Rational solution for CLM 6.0.2 o posteriores instalado.

Acerca de esta tarea

Anteriormente, era difícil crear documentos de rastreabilidad porque algunas aplicaciones, por ejemplo, Rational Quality Manager y Rational Team Concert, utilizan URL de OSLC, y Rational Publishing Engine requiere URL REST notificables. Esto complicaba el diseño de plantilla porque los URL tenían que convertirse de OSLC a REST notificable. A veces, la representación de OSLC de un artefacto no contiene suficiente información necesaria para la generación de documentos, por ejemplo, texto enriquecido.

El perfil POX le permite utilizar URL OSLC como si fueran API REST notificables. Puede utilizar el perfil POX en Rational Publishing Engine para solicitar y recibir datos de REST notificable directamente proporcionando una cabecera adicional. Ya no es necesario que convierta los URL o que realice solicitudes duplicadas. El servicio de generación de documentos devolverá el XML adicional en la presencia de la cabecera.

Ejemplo: Creación de un documento de rastreabilidad desde Rational DOORS Next Generation a Design Management

Procedimiento

  1. En Document Studio, añada un esquema de Rational DOORS Next Generation Añadir un esquema de origen de datos.
  2. Cree elementos de plantilla para imprimir la información de un artefacto.
    Elemento DNG
  3. Itere la información de enlace en el requisito.
    Enlace DNG
  4. En Design Management, copie el URL del artefacto pulsando el icono Mostrar enlace permanente en el rastro de navegación.
  5. En Document Studio, abra el asistente Añadir esquema de origen de datos.
  6. (Nuevo) Pegue el URL en el campo Esquema y añada &metadata=schema al final del URL.
  7. (Nuevo) En el campo Cabeceras adicionales, seleccione la cabecera del perfil POX.
    Añadir un esquema DM con el perfil POX
  8. Pulse Siguiente y, después, Finalizar.
  9. En la plantilla, cree elementos de plantilla que sigan el enlace de vuelta a Rational DOORS Next Generation. Abra la configuración de origen de datos en la vista Propiedades y pulse el separador Configuración dinámica:
    1. (Nuevo) En el campo URI , especifique el href de Rational DOORS Next Generation.
    2. (Nuevo) En el campo Cabecera de aceptación, especifique application/xml.
    3. (Nuevo) En el campo Cabeceras adicionales, seleccione el enlace del perfil POX. El campo Cabeceras adicionales indica a la aplicación que responsa con información REST notificable, aunque se utilice un URL OSLC.
      Configuración de origen de datos para perfil POX
  10. Cree elementos de plantilla para imprimir la información de Design Management.
    Elemento DM
  11. Conmute a RPE Launcher para generar el documento.
  12. En la vista Especificación de documento, pulse con el botón derecho del ratón en el origen de datos de Rational DOORS Next Generation y seleccione Configurar origen de datos.
    1. URL: Especifique el URL de enlace permanente desde Rational DOORS Next Generation.
    2. Si es necesario, especifique un nombre de usuario y una contraseña.
    3. Autenticación: Seleccione OAuth.
    4. Cabecera de aceptación: Especifique application/xml.
    5. (Nuevo) Cabeceras adicionales: Seleccione el enlace de perfil POX para solicitar datos REST notificable de Rational DOORS Next Generation.
  13. Desde la barra de herramientas principal, pulse Generar documento. En la vista Consola, puede ver que Rational Publishing Engine solicita datos de Design Management y Rational DOORS Next Generation utilizando los URL OSLC. Design Management y Rational DOORS Next Generation se redirigen a los URL REST notificable. El documento de salida contiene el requisito de Rational DOORS Next Generation y los datos del modelo asociado de Design Management.
    Resultado que muestra datos de DNG y datos de DM