Actualización 07/06/2011: Este artículo ha quedado obsoleto, ver detalles en Movilizando aplicaciones con Domino 8.5.3

Continuando con la serie, vamos a ver cómo crear una página para la visualización de un documento en iPhone.

En el primer artículo de la serie vimos como configurar el entorno y para crear la aplicación y los elementos de diseño podéis consultar el segundo artículo de la serie.

El objetivo es mostrar el detalle del documento y definir un mecanismo de retorno a la vista principal



El proceso va a consistir en 2 pasos:

• Crear el control personalizado myDocumentTablet que define el diseño de nuestro documento
• Modificar la XPage creada en el artículo anterior para incluir la visualización de esa página.

Creación de myDocumentTablet

Para seguir los mecanismo ya utilizados en los ejemplos de la base de datos MobileControlsDojo16.nsf, hacemos una copia del control personalizado myDocument y lo renombramos a myDocumentTablet.

Este control contiene 2 secciones:

• data, en la que se instancia la variable global param, en la que previamente se ha incluido el UNID del documento a abrir ( esto se incluye automáticamente ). Adicionálmente, entre las propiedades del control se incluye databaseName  que indica el nombre de la base de datos en la que está el documento a abrir.
• mRectangleHeader y mRectangle, que definen el contenido de la página. En ellos podemos insertar controles de tipo computedField, editBox, label, RichText  para componer el aspecto de nuestra página

Modificación de la XPage para incluir la visualización del documento

En nuestra XPage en la que creamos la lista de registros en el artículo anterior, vamos a crear la página para la visualización del documento. Para ello deberemos insertar otro control mPage en nuestra XPage que se diseñará como sigue:

• Asignamos valores a las propiedades del control mPage: visible para indicar si la página se visualiza por defecto, isDocumentPage para indicar que contiene un documento, name utilizado en la navegación
• Insertamos un control mHeader indicando el título (title), el nombre del mPage de retorno (backPageName) y el nombre de la etiqueta que queremos mostrar (backTitle)
• Insertamos un control mContainerDocument, cuyo atributo pageName ha de coincidir con el indicando anteriormente en name (en mPage).
• Insertaremos el control myDocumentTablet en el area editable de mContainerDocument

Guardamos la XPage, la previsualizamos y ya hemos movilizado la aplicación.

A tener en cuenta

• Podemos incluir tantos controles mPage en nuestra página como queramos, pero sólo uno podrá tener el atributo visible con el valor true en nuestro diseño.
• El valor indicado en la propiedad targetPageName del control mView  ha de coincidir con la propiedad name del control mPage, que determina cómo se va a mostrar el contenido del documento. Así queda definido el mecanismo de navegación entre las distintos bloques mPage