Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)

12 September, 2011 11:39:57 Miguel Calvo  Android  Domino 8.5  iPhone  mobile  XPages  |  Comentarios (5)

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

Image:Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)

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


Image:Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)

Image:Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)

Image:Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)


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:

Image:Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
  • 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

Gravatar Image
1) Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
Dani 14.09.2011 08:47:34 http://Http://www.Slug.es

Excelente serie, gracias por compartirlo

Un saludo

Gravatar Image
2) Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
Miguel Angel Calvo 14.09.2011 10:56:48

Gracias Dani, espero disponer de tiempo para ampliarla.

Un saludo

Gravatar Image
3) Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
Dani 14.09.2011 13:14:49 http://www.slug.es

Una cosa que he visto que no has puesto, es que para evitar la carga de DOJO que hay en el servidor hay que modificar el archivo xsp.properties

xsp.client.script.libraries=none

xsp.compress.mode=gzip-nolength

xsp.error.page.default=true

xsp.theme=<empty>

Otra opcion que yo creo que voy a poner es colgar el dojo16 o 17 en el propio servidor, con lo que las xpages cargaran siempre la ultima version que se le indique lo contrario

Por cierto si te animas, creamos una bd para el concurso de openntf que sirva para movilizar el FORO estandar yo estoy trabajando en eso

Saludos

Gravatar Image
4) Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
Miguel Angel Calvo 14.09.2011 16:21:43 http://www.zarazaga.net

Dani,

Incluyo la anotación de dojo, ya que se está descargando 2 veces sin las modificaciones que indicas.

La opción de dojo 1.6 o 1.7 a nivel de servidor es delicada. Si lo instalas, afecta a todas las aplicaciones basadas en XPages de ese servidor y puede haber problemas, por ejemplo, con ciertos controles de XPages Extension Library.

Gracias por el apunte.

Gravatar Image
5) Movilizando aplicaciones en Lotus Domino con XPages Mobile Controls (III)
Dani 14.09.2011 17:35:08

Cierto pero podemos especificar cual queremos cargar con esta propiedad en xsp.properties

xsp.client.script.dojo.version = 1.3.2 o la versión que necesitamos

Dejo un par de referencias

{ Link }

{ Link }

Deja una respuesta


Nota:  (No HTML - Los enlaces serán convertidos si están precedidos por http://)

¿ Recuérdame?