Primeros pasos

Esta sección indica como comenzar a desarrollar una DPL mediante el prototipo. Para ello se debe de tener un entorno ya instalado y listo para ejecutar según se indica en Instrucciones de Instalación.

Creación de un nuevo proyecto

Para iniciar una DPL se puede emplear el asistente de creación de nuevo proyecto de DPL. Se puede iniciar mediante el menú File -> New -> Project..., y seleccionando Document Product Line Project dentro de la categoría Document Product Line.

El asistente nos solicitará el nombre del proyecto, así como el nombre del modelo de características asociado a dicho proyecto. Un modelo de características tiene la extensión *.dfm.

Al finalizar el asistente se solicitará permiso para activar la perspectiva para DPL. Se recomienda activar dicha perspectiva para tener las herramientas de DPL más accesibles.

Por defecto, un proyecto de DPL tiene la siguiente estructura de carpetas:

Nombre de Proyecto
  +- configurations
  +- model
  +- out
  +- resources

Donde cada carpeta tiene un propósito:

• model: En esta carpeta se almacena el modelo de características que describe la línea de producto de documentos.
• configurations: En esta carpeta se almacenan cada una de las posible configuraciones (caracterizaciones o selecciones) que se pueden hacer del modelo de características del proyecto.
• resources: En esta carpeta se almacenará una copia local de los recursos (o fragmentos de documentos) que son empleados en el proyecto.
• out: En esta carpeta se almacenarán los documentos finales que son resultado del proceso de DPL (documentos en PDF, HTML, imágenes, etc.)

Creación y edición de InfoElementos

En la perspectiva de Document Product Line está disponible la vista TIPEx Repositories (si la vista no es visible puede abrirse mediante la opción Window -> Show View -> Other...). Mediante esta vista pueden gestionarse los distintos InfoElementos contenidos en un repositorio. Si hemos instalado el servidor CDO con la configuración por defecto y este se encuentra en ejecución (véase Instrucciones de Instalación), podremos añadir un nuevo repositorio. Para ello, en la vista TIPEx Repositories se ha de seleccionar la opción Add and Remove Repositories en la barra de herramienta de la vista (arriba a la derecha). Esto nos abre la ventana de preferencias de Eclipse.

Para añadir un nuevo repositorio se ha de pulsar New..., indicando en la ventana emergente la ruta del repositorio, por defecto: tcp://user:user@localhost:12036/repo. Donde:

protocol://user:password@hostname:port/repositoryname

La lista de acceso al repositorio (usuario y contraseñas) se gestiona mediante el fichero users.db que se encuentra junto al ejecutable del servidor de CDO.

Una vez se ha añadido el repositorio, se pueden aceptar los cambios y cerrar la ventana de preferencias. En este momento en la vista del gestor de repositorio se tendrá una entrada: tcp://user:user@localhost:12036/repo1 (Disconnected). Haciendo click derecho sobre la entrada se puede seleccionar la opción Connect, que nos dará acceso al repositorio.

Una vez tenemos el repositorio accesible (se mostrará en negrita) podremos crear elementos en él mediante el menú contextual. Podemos crear los siguiente tipos de elementos:

• InfoElements: Son fragmentos de documentos que pueden reutilizarse.
• Resources: sirven como contenedores (únicamente) de InfoElements.
• Folders: Actúan como contendores para otros Folders y Resources. No pueden contener InfoElements directamente.

Cuando se crea un nuevo InfoElement (menú contextual sobre el repositorio o sobre un Resource) se abrirá automáticamente el editor para poder modificar los detalles de éste. Los InfoElements que ya existen pueden abrirse en el editor haciendo doble click sobre ellos o mediante el menú contextual (Edit).