Inicio > Business Analytics > Generar documentación con Oracle Data Integrator

Generar documentación con Oracle Data Integrator

DocumentacionLa parte menos divertida del trabajo de un programador es generar la documentación de los proyectos. En los proyectos de ETL, describir cada proceso, las fuentes de datos y las transformaciones aplicadas puede llegar a ser un proceso muy laborioso, sobre todo teniendo en cuenta que,  en la mayoría de las circunstancias, se da más prioridad a desarrollar el software y a producir resultados que a documentar cada paso que nos lleva a la solución final.

Oracle Data Integrator permite generar documentación en formato PDF. Para poder utilizar esta funcionalidad, hay que configurarla en las propiedades de ODI.

En ODI -> Parámetros del Usuario, editar las siguientes opciones:

  • Visor PDF: ruta de acceso completa al Visor PDF (ej. Adobe Acrobat Reader,  C:\Program Files (x86)\Adobe\Reader 10.0\Reader\AcroRd32.exe)
  • Directorio por Defecto de Generación de PDF: ruta local donde se guardan los informes PDF generados

Edición Parametros Usuario

ODI permite generar documentación para los siguientes objectos:

  • Knowledge Modules (módulos de conocimiento): clic derecho en un proyecto y seleccionar Imprimir -> Imprimir Módulos de Conocimiento
  • Packages (paquetes): clic derecho en una carpeta de un proyecto y seleccionar Imprimir -> Imprimir Paquetes
  • Procedures: clic derecho en una carpeta de un proyecto y seleccionar Imprimir -> Procedimientos
  • Interfaces: clic derecho en una carpeta de un proyecto y seleccionar Imprimir -> Interfaces
  • Folders (carpetas): clic derecho en una carpeta de un proyecto y seleccionar Imprimir -> Carpeta

2013_06_19_17_30_19_ODIM_Local_Oracle_Data_Integrator_11g

El resultado es un fichero PDF que contiene información de detalle sobre los objetos seleccionados.

La opción de Imprimir Carpeta es sin duda la más útil a la hora de generar la documentación de un proyecto. Con tan sólo un clic se tiene acceso a documentación para todos los objetos contenidos en la carpeta. Y lo que un desarrollador ETL apreciará más será seguramente la documentación de un interfaz. Además de la descripción física de las tablas orígenes y de la tabla destino, se puede visualizar cada transformación aplicada.

Ejemplo PDF

Resumiendo, ODI ofrece una solución rápida y completa al tedioso problema de la documentación de proyectos ETL. El único defecto es que al ser un archivo PDF no es fácilmente editable, pero tampoco se puede pretender que ODI nos haga todo el trabajo.

  1. Nacho
    marzo 19, 2014 en 11:45

    Estoy teniendo un problema, cuando imprimo una carpeta o interfaces, no me incluye el mapeo que muestras en el pantallazo en el PDF. ¿Hay que hacer algún que otro ajuste?

    • Cristina Abba
      marzo 24, 2014 en 10:05

      En principio no hay que configurar nada más. El mapeo ‘Nombre de la Columna-Expresión’, se encuentra en una tabla en el apartado ‘Asignaciones’ de cada juego de datos de origen de cada interfaz.

  2. Gyllcymar Vieira
    junio 20, 2014 en 17:32

    Hello Cristina, I’m from Brazil and I work with ODI and OBIEE.
    I was looking for Generating Documentation with Oracle Data Integrator (ODI) and your blog was one of the firsts to appear..
    well, my mother language is Portuguese and when I’m trying to export a documentation to pdf, it doesn’t show the stress of portuguese words like “é” or “ã”. (ex. “Cadastro Único”, shows like “Cadastro nico”)
    Did you had the same problem? How can I try to avoid this issue?

    I want to print it with stress like your report: http://2.bp.blogspot.com/-0IgnVX8cQkc/UclsGodidGI/AAAAAAAACXE/73jhRmLVQcA/s1600/2013_06_20_10_11_09_carpeta.pdf_Adobe_Reader.png

    • Cristina Abba
      junio 23, 2014 en 08:39

      Hi Gyllcymar,
      as you can see in the screenshot you linked, I had no issues in printing accents (e.g. ‘Área temporal en el Destino’). I guess it depends on your regional settings. My ODI installation is set in Spanish. Are you using it in English or in Portuguese? Maybe this is the reason why accents are not being printed properly.
      Best regards.
      Cristina

  1. No trackbacks yet.

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

A %d blogueros les gusta esto: