| Siguiente >

Lección 1.1: Personalización de los datos de origen utilizados en los trabajos ETL

En esta lección, aprenderá a modificar archivos de configuración de datos XML. El archivo de configuración de datos XML contiene información sobre el origen y la estructura de los datos utilizados para el proceso ETL y el controlador XML ODBC lo utiliza durante el tiempo de ejecución. En esta lección, añadirá atributos y recursos nuevos al archivo de configuración de datos XML.
Requisito previo: Antes de empezar la lección, haga una copia de seguridad del archivo clearquest.xdc, que normalmente se encuentra en el directorio [INSTALLDIR]/dataconfig/configs/configurations directory.

Para esta lección, utilizará el archivo clearquest.xdc como punto de partida y modificará este archivo para cumplir con los objetivos de la lección. Añadirá una entidad componente y la convertirá en una propiedad del registro de defectos.

En esta lección:
  • Modificará la información de conexión del grupo de recursos para que coincida con el servidor de servicios de datos desplegado en su entorno.
  • Modificará la tabla de datos de defectos para añadir atributos y correlaciones de valor nuevos.
  • Añadirá un recurso y una tabla de datos de defecto nuevos para el componente
  • Añadirá varios proyectos a una categoría de recursos
  1. Inicie Configuración de datos XML.
  2. Pulse Archivo > Abrir configuración > clearquest.xdc. Normalmente, el archivo se encuentra en el directorio [INSTALLDIR]/dataconfig/config/configuration.
  3. Expanda el nodo Configuración de datos XML para listar los grupos de recursos. Efectúe una doble pulsación sobre CQEnterprise.
  4. En el editor de grupo de recursos, cambie el URL de Data Services para que coincida con el URL del servidor de servicios de datos desplegado en su entorno y cambie el tipo de autenticación y el nombre de usuario y contraseña para que coincidan con la configuración de la autenticación de su servidor de servicios de datos.
    Nota: Un grupo de recursos debería definir un URL base para un conjunto de documentos XML. El ámbito recomendado para los grupos de recursos por productos es:
    • Rational ClearQuest: URL para una base de datos de usuario
    • Rational RequisitePro: URL para un proyecto de RequisitePro
    • Rational ClearCase: URL para una VOB de ClearCase
    • Microsoft Project: URL para un archivo de proyecto
    • Rational QualityManager: URL raíz para el servicio RQM REST
    • Rational TestManager: URL para un proyecto de TestManager
  5. Guarde la configuración.

    Ha modificado la información de conexión del archivo clearquest.xdc para que coincida con el servidor de servicios de datos desplegado en su entorno.

    A continuación, modificará la tabla de datos de defectos añadiendo atributos y correlaciones de valor nuevos.

  6. Expanda el nodo CQEnterprise > ENTDefect para listar las tablas de datos.
    Nota: El nodo ENTDefect representa el documento XML (recurso) para todos los registros de defectos que se devuelven al unir el URL definido en el grupo de recurso padre con la vía de acceso relativa asignada al recurso.
  7. Efectúe una doble pulsación en la tabla de datos ENTDefect.
  8. Pulse el separador Columnas, seleccione la fila para la columna Prioridad, y pulse el enlace Correlación de valores en la esquina superior derecha del editor.
    Nota: Con una correlación de valores, puede transformar los valores de la instancia original en un valor nuevo durante el proceso de extracción. Este es un método conveniente para estandarizar en una definición común los datos de varios orígenes. Por ejemplo, si su empresa utiliza "Alta", "Media" y "Baja" para definir la prioridad y algunos grupos dentro de la empresa utilizan P1, P2 y P3, puede definir una correlación de valores para estandarizar esta definición.
  9. En el cuadro de diálogo Correlación de valores, especifique los valores siguiente:
    Clave Valor
    P1 Alta
    P2 Media
    P3 Baja
    Guarde la tabla de datos.
  10. Para abrir la plantilla de la tabla de datos asociada, en el separador Columnas, pulse sobre el enlace Modificar en la esquina superior derecha. Seleccione la definición de columna resaltada en rojo Prioridad, seleccione la columna Prioridad empresarial de la sección del esquema XML y pulse Actualizar XPath.
    Nota: La Configuración de datos XML valida automáticamente el esquema devuelto del servicio de datos con correlaciones de columnas existentes. Se resalta cualquier correlación no válida. En esta situación, el esquema personalizado tiene la misma información que la columna Prioridad actual, pero en un atributo diferente. En este paso, ha correlacionado de nuevo el /XPath Prioridad no válido con el /XPath Prioridad empresarial válido.
  11. En la sección Columnas de correlación, expanda el nodo raíz Defecto bajo la sección esquema XML para listar los atributos bajo Defecto.

    En los pasos del 11 al 13, creará una tabla de correlaciones de columnas a partir del origen XML. La estructura de árbol de la izquierda representa los nodos hijos incluidos en el nodo extraíble asociado a la tabla de datos.

  12. Pulse con el botón derecho del ratón sobre Estado y pulse Crear. Asegúrese de que el nombre de la columna de tabla es Estado y que el tipo de SQL es Varchar. Guarde la plantilla de tabla.
  13. En la sección Columnas de correlación, expanda el nodo raíz Defecto bajo la sección esquema XML para listar los atributos bajo Defecto. Seleccione el nodo Defecto > Componente.
  14. Pulse con el botón derecho del ratón sobre ID de BD y pulse Crear. Asegúrese de que el nombre de la columna de tabla es Component_dbid y que el tipo de SQL es Integer. Guarde la plantilla de tabla.
    Nota: En el esquema personalizado Enterprise para esta guía de aprendizaje, necesita dar información suficiente para el proceso ETL para crear una relación desde el registro Defecto hacia el registro Componente. Lo hará exponiendo el atributo ID de BD Componente (la única clave para registros ClearQuest).
  15. Vuelva al editor de la tabla de datos ENTDefect. Cuando se le solicite que actualice, pulse Aceptar.
  16. Seleccione las dos columnas nuevas Estado y Component_dbid, y pulse Cargar.
    Nota: Una definición de tabla de datos puede contener un subconjunto de la correlaciones de columnas en la plantilla de tabla de datos asociada. Con la característica Cargar/Descargar, puede controlar la visibilidad de las columnas para los clientes ODBC.
  17. Guarde la tabla de datos.

    Ha añadido dos columnas nuevas a la tabla de datos.

    A continuación, definirá una tabla de datos nueva para exponer los datos del componente del origen XML. El primer paso es definir un recurso nuevo para representar el documento XML que contiene la información del componente.

  18. Pulse con el botón derecho del ratón sobre el grupo de recursos CQEnterprise, seleccione Nuevo > Recurso, y seleccione Localizar utilizando servicio de datos.
    Nota: Si no sabe el URL del recurso, puede utilizar la función l>Localizar utilizando servicio de datos para definir el recurso.
  19. Especifique el nombre ENTComponent y pulse Siguiente.
  20. Expanda el nodo Base de datos > ConsultasRegistro > Consultas > Consulta y en la sección Propiedades, seleccione el recuadro de selección href.

    Ahora está utilizando el asistente para recuperar el esquema del documento XML que se devolvió del nivel del grupo de recursos. Las carpetas PersonalQueries y PublicQueries contienen las consultas relevantes definidas en la base de datos de usuario ClearQuest. La carpeta RecordQueries contiene consultas generadas dinámicamente del servicio de datos ClearQuest que devolverá todos los registros de un tipo determinado. Con la página del asistente, puede restringir su búsqueda a todos los registros posibles sin tener que consultar los datos reales.

  21. Seleccione un URL que acabe en /Record+Queries/Component. Se visualizan todas las instancias del nodo que se seleccionó mediante la página anterior del asistente.
    • Si aquí es donde se ubica su recurso, ha ubicado el recurso componente. Seleccione el recuadro de selección Definir las propiedades de extracción para este recurso y pulse Finalizar.
    • Si el recurso está ubicado más abajo de la vía de acceso del URL, repita los pasos del 19 al 20 para otros nodos.
  22. Pulse con el botón derecho del ratón sobre el recurso creado recientemente y seleccione Nuevo > Tabla de datos y especifique el nombre ENTComponent. Pulse Siguiente.
  23. Especifique el nodo extraíble /Query/results/Component. Pulse Siguiente.
  24. Seleccione Crear una nueva plantilla. Escriba un nombre y descripción para la tabla de datos y pulse Siguiente.

    En el paso siguiente, seleccionará aquellos nodos del árbol XML que quiere que sean columnas de la tabla.

  25. Seleccione los nodos siguientes:
    • ID de BD como tipo de SQL entero
    • Componente como tipo de SQL VARCHAR
    Pulse Finalizar.

    Ha definido las tablas de datos necesarias en el grupo de recursos CQEnterprise. De momento, sólo es para un único proyecto. Sin embargo, puede extraer datos de varios grupos bajo una única categoría de recursos. Para poder hacer esto, necesita crear grupos de recursos para cada proyecto bajo la categoría de recursos.

    En los próximos pasos, creará un nuevo grupo de recursos bajo la categoría de recursos ClearQuest Enterprise. Para hacerlo, utilizará el grupo de recursos CQEnterprise como punto de partida.

  26. Arrastre el grupo de recursos CQEnterprise y suéltelo en la categoría de recursosClearQuest Enterprise.
  27. Pulse Copiar.
  28. Seleccione el grupo de recursos duplicado y modifíquelo cambiando el URL para que coincida con el URL de los servicios de datos para la base de datos de usuario de ClearQuest para otro proyecto. Consulte el paso 4 para obtener más detalles.
    Nota: En el proceso ETL, puede cargar varios grupos de recursos con configuraciones idénticas en una modalidad de proceso por lotes organizando los grupos de recursos por categorías.
En esta lección: