Manual de Usuario
De MorfeoWiki
Tabla de contenidos |
Autenticación y cambio de usuario
 |  |
Para acceder a la Plataforma EzWeb, utilice un navegador Web (recomendamos Firefox) e indique la URL correspondiente donde se haya instalado la plataforma (p.e. http://host:port). Sí desconoce cual es la URL, ésta se habrá configurado durante el proceso de instalación (ver Instalación), revise su configuración de Apache o indique una URL válida en el arranque del servidor de Django (ver Arranque del Servidor Web de Django), dependiendo del servidor Web utilizado. Para más información, hable con el administrador.
En primer lugar deberá autenticarse en el correspondiente cuadro de autenticación que aparecerá en la interfaz. Puede utilizar el usuario por defecto: usuario admin y clave admin. Aunque si lo desea, puede crearse un usuario propio para EzWeb. Para ello, acceda a la parte de administración (se accede añadiendo admin a la URL, p.e. http://host:port/admin/), y en la sección usuarios agregue uno nuevo con su login y password, otorgándole permisos de staff y superusuario.
Descripción de la Interfaz de Usuario
Una vez autenticado, aparecerá la pantalla principal de la Plataforma EzWeb. Ésta se corresponde con el entorno operacional del usuario, donde más adelante se ubicarán los gadgets. En un primer momento aparecerá vacío, sin embargo a lo largo de este manual se mostrará cómo ir añadiendo gadget paso a paso para construir su propio entorno operativo.
La funcionalidad de la Plataforma EzWeb se distribuye en tres módulos principales: Mi Entorno, Mi Catálogo y Mis Conexiones. Podrá acceder a cada uno de ellos a través de las correspondientes pestañas ubicadas en la esquina superior derecha de la interfaz. Esta sección de la interfaz siempre estará visible, de manera que pueda cambiar fácilmente de módulo en cualquier momento.
A parte de las pestañas, encontrará algunos enlaces interesante, como los utilizados para cambiar el idioma por defecto de la plataforma (por ahora sólo se encuentra disponible la traducción a los idiomas español, inglés y portugués) así cómo el de salida de la sesión actual o logout.
Mi Entorno
Esta sección es la que aparece al principio tras la autenticación. Como ya se comentó anteriormente, se corresponde con el entorno operacional del usuario. Es aquí donde el usuario agregará los gadgets que compondrán su propia interfaz con el sistema.
Cuando más adelante se establezcan las conexiones entre gadgets, se podrá ver como los eventos producidos por el usuario sobre un gadget, se propagan hacia otros gadgets produciendo que éstos entren en ejecución, componiendo así la operativa de la interfaz.
 |  |
Reubicación de Gadgets
La plataforma ofrece una gran flexibilidad a la hora de ubicar los gadget en el entorno operacional. Puede modificar su distribución libremente en busca de una mayor optimización del espacio disponible, o simplemente por adaptarlos mejor a sus necesidades.
Para mover un gadget determinado a una nueva ubicación, simplemente hay que pinchar sobre la barra superior del mismo, y arrastrarlo hacia el lugar donde quiere reubicarlo.
Propiedades de Gadgets
Cada uno de los gadget desplegado en el entorno operacional cuenta con una barra en su parte superior. Desde esta barra se puede tener acceso a tres operaciones básicas como son:
- Minimizar el gadget
- Establecer propiedades de usuario (en caso de tenerlas)
- Eliminar el gadget del entorno operacional
Las propiedades de usuario aparecen en un cuadro al pulsar el botón con la letra p, como se puede observar en la imagen.
Para establecer el valor de una propiedad, simplemente indique el nuevo valor en el cuadro de texto y pulse sobre el botón salvar. Si lo prefiere también puede establecer los valores por defecto con el correspondiente botón.
Mi Catálogo
En esta sección se encuentra el catálogo con todos los gadgets disponibles que pueden agregarse al entorno operacional. En caso de que todos los gadgets no puedan visualizarse en una única pantalla, el catálogo se auto-pagina. Existen enlaces en la parte superior para poder navegar por las posibles páginas.
Búsqueda
Si no desea ver todos los gadget que se muestran en el catálogo, o sí desea buscar alguno en concreto, puede filtrarlos a través de la sección de búsqueda indicando un criterio en el correspondiente cuadro de texto. Si desea realizar búsquedas más avanzadas, pulse sobre el correspondiente enlace y podrá realizar búsquedas en las que intervengan más criterios, como nombre, etiquetas, eventos que genera el gadget, etc.
 |  |
Acceso a la información del Gadget
 |  |
Cada gadget aparece en un recuadro individual junto con una imagen descriptiva y el correspondiente botón para añadir el gadget al entorno operacional. Desde estos recuadros puede accederse a toda la información relativa al gadget. En la parte superior encontramos una barra con tres botones (aparecen al desplazar el cursor sobre ella) con los cuales se puede acceder a la siguiente información:
- Una breve descripción del gadget (D)
- La entrada a una wiki con una descripción más extensa del gadget (W)
- El template correspondiente (T)
En la parte inferior del recuadro también puede observare una lista con las etiquetas asociadas al gadget. Existe otra manera de visualizar las etiquetas del gadget en formato de nube, a la que puede acceder pulsando el botón (>) que aparece junto a las etiquetas. Sí desea realizar una búsqueda usando como criterio alguna de estas etiquetas, puede realizarla de la manera antes indicada, o bien pinchando sobre una etiqueta determinada, el efecto es idéntico.
 |  |
Añadir nuevos gadgets al catálogo
Puede añadir nuevos gadget al catálogo desde Internet (o alguno que usted mismo haya desarrollado). Para ello, simplemente debe dirigirse hacia la correspondiente sección ubicada en la esquina superior izquierda de la interfaz, indicar la ruta hacia su correspondiente template en el cuadro de texto, y pinchar sobre el botón crear recurso.
Asegúrese de que la ruta tanto hacia el template, como hacia el código del gadget sea accesible (es un fallo muy común). Sí el proceso ha ido bien y el gadget es válido, éste aparecerá automáticamente en la primera posición del catálogo, en su correspondiente recuadro. En caso de no aparecer, puede que el template contenga algún tipo de error o que no sea un gadget de EzWeb (asegúrese de que el template cumple el formato descrito en la Guía de desarrollo de gadgets#Template)
Mis Conexiones
Desde este módulo el usuario puede gestionar las conexiones entre los distintos gadgets instanciados en el entorno operacional.
Estas conexiones se basan en canales de información, de manera que un canal se asocia a un dato (dirección de usuario, modelo de coche seleccionado, etc) y nunca a los propios gadgets.
Los canales utilizan las variables de tipo Event y Slot de los gadgets como entrada y salida de datos, respectivamente. A la izquierda de la interfaz puede observarse una lista con los gadget instanciados ese momento en el entorno operacional, junto con sus variables de tipo Event, y a la derecha una lista similar pero las variables de tipo Slot. Ambas listas sirven para seleccionar las entradas y salidas que se quieren conectar al canal.
Creación y conexión de canales
La parte central de la interfaz esta destinada a la gestión de canales. Para crear un canal simplemente introduzca el nombre en el cuadro de texto y pulse el botón de la derecha. Una vez creado, el canal aparecerá justo debajo junto con su valor (en un primer momento aparecerá como undefined).
Para conectar el canal con sus correspondientes variables, no tiene más que seleccionar el canal, elegir el Event que quiere conectar de la lista que aparece en la parte izquierda de la interfaz, y la propia plataforma le sugerirá el Slot correspondiente que puede conectar mediante un código de colores, el cual posteriormente deberá seleccionar.
Caso Práctico: Cómo construir mi entorno operacional
Mediante este caso práctico podrá observar cómo construir fácilmente, y en unos sencillos pasos, su propia interfaz con una serie de gadgets.
Primer Paso: Agregar Gadgets al entorno operacional
Partiendo de un entorno operacional vacío, para incorporar nuevos gadgets simplemente debe acceder al módulo Mi Catálogo, seleccionar los gadgets que desee añadir, y pinchar sobre el correspondiente botón Añadir Instancia. Cada vez que añada un nuevo gadget será redireccionado automáticamente al módulo Mi Entorno para comprobar que realmente ha sido añadido correctamente.
 |  |  |  |
Nota: Es posible añadir varias instancias de un mismo gadget al entorno operacional.
Segundo Paso: Establecer las conexiones
Una vez añadidos todos los gadgets deseados al entorno operacional, sólo falta establecer los canales de comunicación entre los gadgets para tener el entorno operativo. Para ellos vamos al módulo Mis Conexiones, y en la parte central de la interfaz creamos los canales necesarios, indicando su nombre en el cuadro de texto y pinchando después en el botón de la derecha.
Una vez creados los canales, sólo queda conectarlos. Para ello nos dirigimos a la lista de eventos que aparece en la parte izquierda de la interfaz, y seleccionamos el evento (o los eventos) que queremos que actúen como entrada de datos. Luego nos dirigimos a la parte derecha y seleccionamos los correspondientes slots.
Cómo habrá podido observar, al pasar el cursor sobre un evento o un slot, la plataforma nos sugiere, mediante un código de colores, los eventos y slots que están relacionados y que por tanto, pueden ir conectados al mismo canal.
 |  |  |
Nota: Un canal puede estar conectado simultáneamente a varios eventos y a varios slots.
Tercer Paso: ¡Listo!
Una vez establecida la comunicación entre los distintos gadgets, ya tenemos lista nuestra interfaz para ser utilizada. Ya podemos volver al módulo "Mi Entorno" y comenzar a trabajar normalmente con nuestra nueva interfaz.
Para comprobar su correcto funcionamiento, intentamos generar una reacción en un gadget con la propagación de un evento. Para ello seleccionamos un elemento en un gadget (seleccionamos un video de la lista de videos de YouTube, por ejemplo) y deberíamos ver cómo otro gadget reacciona ante esto (el reproductor de YouTube muestra el video).
