Logo de Kopernik. La idea era que el sistema sea usado por escolares y por lo tanto, no debia ser tan serio.

Aprovechando la experiencia que adquiri trabajando y estudiando en universidades decidi crear desde cero un sistema que se ajustara a los requerimientos especiales que cada institucion pudiera tener. Como recien estaba empezando pense que mejor seria comenzar con modulos para colegios pero… resulta que he olvide como funcionan!

Cuando estaba en el colegio no pensaba en procesos y en maneras de como mejorarlos como lo hago ahora. Por eso es que los modulos que ya he creado almacenan datos como el valor en creditos de cada asignatura o que permiten a un alumno matricularse en asignaturas distintas que el resto de sus companeros. De hecho el proceso que los administradores deben realizar para matricular de un alumno esta pensado usando los requerimientos universitarios o de institutos.

En los colegios todos los alumnos llevan lo mismo. Solo hay dos opciones:

• No te matriculas un año o…
• Estas matriculado y llevas todas las asignaturas de tu año (con algunas excepciones como no asistir al curso de religion por solicitud de los padres).

Es algo en lo que hay que trabajar.

Por el momento me quedan algunos modulos importantes por desarrollar, como el control de evaluaciones, asistencias y materiales de clase.

A continuacion explico algunos detalles del software y al final puedes encontrar un enlace para que lo puedas ver en accion.

Caracteristicas generales

• Es modular, de tal forma que sea facil reutilizar los modulos comunes y adecuarlos a lo que necesite.
• Permite el trabajo colaborativo (tiempo real).
• Solo hace uso del puerto 80. No es necesario habilitar la salida puertos adicionales en una red controlada.
• El cliente solo necesita tener Adobe Flash instalado.
• No requiere de licencias adicionales.
• Es multiplataforma. Corre en Windows, Mac, Linux y cualquier otro sistema operativo que tenga soporte para Adobe Flash (talvez Android?)
• Es multitarea. Las aplicaciones y modulos son cargados dentro de contenedores visibles como ventanas. Por lo tanto, no es necesario salir de un modulo para entrar a otro. Puedes tener varios modulos abiertos al mismo tiempo compartiendo el escritorio visible o minimizar algunos de ellos para usarlos luego.
• Al instalarlo en un servidor web con un IP publico es accesible desde cualquier parte del mundo.
• Control de acceso, a modulos y acciones, por grupos de usuarios. Se define que grupos tienen acceso a que modulos y las operaciones que realizan estos.
• El sistema cuenta con algunas herramientas como el administrador de tareas (clic secundario sobre el fondo) y un explorador de directorios (del servidor).

Tres aplicaciones abiertas: el explorador de alumnos, el explorador de archivos y el administrador de tareas

Tecnologias usadas

• Flex 4: Empece el proyecto con la version 3 pero las nuevas caracteristicas (en especial la capacidad de trabajar con archivos localmente y el skining) resultaron muy tentadoras y tuve que hacer la migracion ya casi a mitad del proyecto (y acepto que no fue una decision muy inteligente. Me retraso todo el calendario pero espero haya valido la pena).
• Zend Framework: Elegi este framework por la empresa que hay detras (Zend creadora de PHP) y por que ya me encuentro familiarizado con el. Ademas podia usar el paquete Zend_Amf para conectar Flex con el servidor. Tuve que migrar desde AMFPHP por lo que perdi el explorador de servicios y el control de acceso en cada clase. Realmente fue una migracion dura porque las clases del sistema (no academicas) ya estaban empezadas y funcionaban perfecto con AMFPHP. La gran ventaja de usar Zend_Amf es que tienes a tu disposicion todo el framework de Zend y ademas es el unico soporte para AMF que tiene la venia de Adobe sin ser desarrollado por Adobe (y la version actual de AMFPHP se encontraba abandonada en una version beta).
• PHP: Como es obvio, por ser un lenguaje fantastico y porque casi todo servidor Apache lo tiene instalado.
• MySQL: Necesitaba una base de datos transaccional y confiable. Que mejor que MySQL usada en la mayoria de servicios de hosting.

Requisitos

• Del lado del cliente
  • Flash Player 10.0.0 o una version mayor.
• Del lado del servidor
  • PHP 5.2
  • Apache
  • MySQL

Acceso a la demo

Antes de ingresar por favor, lee las siguientes instrucciones:

• Los datos de acceso se encuentran pre-escritos en los campos de texto, solo es cuestion de logearse.
• El usuario de prueba pertenece al grupo de administradores, por lo que tendras acceso sin restriccion sobre los modulos y acciones que puedan estos realizar. Ten cuidado de eliminar aplicaciones, volver a registrarlas te puede resultar complicado si no sabes donde se encuentran almacenadas.
• La falta de acentos se debe a que uso en teclado en ingles. Lo corregire muy pronto. Las fallas ortograficas se deben a mi falta de atencion a las clases de lengua (junto con la eficiencia del corrector ortografico de Word). Cuando tenga tiempo aplicare las correcciones necesarias.
• La primera vez que cada aplicacion es solicitada puede demorarse unos segundos en cargarse (dependiendo de tu velocidad de salida a Internet). La aplicacion queda almacenada en la cache de tu navegador y es cargada de alli en las solicitudes posteriores.
• Y por ultimo, te recuerdo que esta es una version en desarrollo y por ello puede tener errores. Si encuentras alguno, por favor ayudame a corregirlo comentandolo en este post. Gracias.

Eso es todo. La direccion de acceso es la siguiente: http://kopernik.danielzegarra.net/. Espero tus comentarios.

Menu contextual del DataGrid

Se puede implementar en solo una linea de codigo:

new datagridColumnSelector(datagridInstance, [campoignorado1]);

El primer argumento es obligatorio y debe ser una instancia de DataGrid. El segundo argumento es opcional y debe recibir un Array con los nombres de las columnas a ignorar.

Cambiando algunas propiedades por defecto:

datagridColumnSelector.label_hide = "Ocultar";
datagridColumnSelector.label_show = "Mostrar";
var selector:datagridColumnSelector = new datagridColumnSelector(data_dg);
selector.hidden = ["col3"];

En el siguiente ejemplo la columna 4 y 5 estan ocultas por defecto. Tambien se decide ignorar la columna 3 para que el usuario no pueda ocultar todas las columnas.
Nota que el valor del atributo headerText en cada DataGridColumn es usado en el menu contextual para que el usuario pueda identificar la columna.

<?xml version="1.0" encoding="utf-8"?>
<mx:Application layout="vertical" creationComplete="init()"
	xmlns:mx="http://www.adobe.com/2006/mxml"
	backgroundGradientAlphas="[1.0, 1.0]" backgroundGradientColors="[#FFFFFF, #E7E7E7]"
	paddingBottom="8" paddingLeft="8" paddingRight="8" paddingTop="8" horizontalAlign="left" viewSourceURL="srcview/index.html">

	<mx:Script>
		<![CDATA[
			import net.danielzegarra.utils.datagridColumnSelector;

			protected function init():void{
				new datagridColumnSelector(data_dg, ["col3"]);
			}
		]]>
	</mx:Script>

	<mx:Label text="Haga un clic secundario sobre el DataGrid para mostrar u ocultar columnas."/>
	<mx:DataGrid id="data_dg" width="100%" height="100%">
		<mx:columns>
			<mx:DataGridColumn headerText="Columna 1" dataField="col1"/>
			<mx:DataGridColumn headerText="Columna 2" dataField="col2"/>
			<mx:DataGridColumn headerText="Columna 3" dataField="col3"/>
			<mx:DataGridColumn headerText="Columna 4" dataField="col4" visible="false"/>
			<mx:DataGridColumn headerText="Columna 5" dataField="col5" visible="false"/>
		</mx:columns>
	</mx:DataGrid>
</mx:Application>

Y el resultado:

Ver la fuente | Descargar datagridColumnSelector Class

Nota: Funciona tambien con Air aunque es preferible usar las clases nativas de Adobe Air.

Zend AMF mapea por defecto las clases mas comunes como son String, Number, Array, Object, ArrayCollection, etc y tambien permite mapear clases creadas por el usuario. Para lograr el mapeo bidireccional te recomiendo cumplir dos puntos.

• Define la variable $_explicitType con el alias en cada clase deseas mapear o usa el metodo getASClassName() en lugar de registrar cada mapeo con $serveramf->setClassMap(). Dara mas flexibilidad a tu aplicacion.
• Intenta relacionar el alias de la clase con la ruta donde la clase PHP a mapear se encuentra. Esto te ayudara a mapear clases de AS3 a Zend AMF.
  Cuando Zend AMF recibe una solicitud lee los alias de las clases AS3 en el mensaje y busca sus clases PHP homologas en el directorio dado por $serveramf->addDirectory(). Si el alias elegido para las clases es, por dar un ejemplo, VO.Usuario Zend AMF buscara la clase VO_Usuario en la ruta VO/Usuario.php.
  Ten en cuenta esto solo si usas addDirectory() para definir la ubicacion de tus servicios y no deseas usar setClassMap() para registrar cada alias.

Las siguientes dos clases se mapearan correctamente entre PHP y AS3 de forma bidireccional.

Ruta: [ServicesPath]/VO/Usuario.php

<?php
class VO_Usuario{

	/**
	 * Usado por Zend AMF. Devuelve el alias de
	 * esta clase para actionscript.
	 * Devuelve una cadena con el nombre de la
	 * clase actual reemplazando _ por puntos.
	 */
	public function getASClassName(){
		return str_replace("_",".",get_class($this));
	}

	public $id;
	public $username;
	public $firstname;
	public $lastname;
	public $enabled;
}
?>

Nota: En este ejemplo uso getASClassName() para obtener dinamicamente el alias de la clase. Seria muy util que este metodo se encontrara en una clase base y que cada clase a mapear herede de esta. De esta forma no tendras que preocuparte por verificar el alias elegido.

Y por otro lado tenemos su clase homologa en AS3:

Ruta: /net/danielzegarra/VO/UsuarioVO.as

package net.danielzegarra.VO{
	//Recuerde que no es necesario que el alias tenga relacion
	//con el nombre de la clase
	[RemoteClass(alias="VO.Usuario")]
	public class UsuarioVO{
		public var id:uint;
		public var username:String;
		public var firstname:String;
		public var lastname:String;
		public var enabled:Boolean;
	}
}

La version de Zend Framework al escribirse este documento es la 1.10.
Puedes encontrar la documentacion de Zend AMF en http://framework.zend.com/manual/en/zend.amf.server.html

Cuando Zend AMF devuelve una clase con variables nulas AS3 lo recibe asi, pero para AS3 las variables Number no pueden ser null y para salir de este problema convierte el null en 0 (cero). Y es asi como terminas teniendo variables con valores en cero en lugar del esperado NaN.

La manera mas facil de arreglarlo es hacerle un puente al problema utilizando setters para recibir el valor entregado por el servidor, validarlo y decidir si es un aceptarlo o no.

Se puede entender mejor viendo el siguiente ejemplo:

package DTO{
	[RemoteClass(alias="claseDTO")]
	[Bindable]
	public class claseDTO{
		/**
		 * Solo se tiene acceso a esta variable a travez de su getter/setter
		 */
		private var _numero:Number;

		/*
		 * Definiendo el getter/setter para la variable privada _numero.
		 * Recordar que Number es una subclase de Object.
		 */
		public function get numero():Object{
			return _numero;
		}
		public function set numero(val:Object):void{
			//Si el valor dado es un numero
			if(val is Number)
				_numero = val as Number;
		}

	}
}

Los comentarios son bienvenidos.

En si tenemos tres o cuatro candidatos potenciales y estos son: Zend AMF, AMFPHP y WebORB. A continuacion comento las caracteristicas de cada uno.

AMFPHP es creo, sin lugar a dudas, la mejor alternativa si deseas conectar tu aplicacion Flex o Flash con un servidor PHP (y este a su vez con la BD) y no deseas tener que pasar por una larga curva de aprendizaje. AMFPHP es ligero, incluye una gestion de roles bastante simple, no es necesaria su instalacion, soporta mapeo de clases (VOs) y por ultimo, incluye un navegador de servicios para que puedas probar los mismos rapidamente. Ademas, soporta AMF0 y AMF3 (por si usas AS2 o AS3) de forma transparente. Ademas, viene preparado para comsumir Web services. Entre sus desventajas estaba la falta de soporte. La persona detras del proyecto lo abandono dejandolo en una version beta (y sin la nueva documentacion completa) durante un par de años  pero recientemente su desarrollo acaba de ser retomado y gracias a ello, se acaba de lanzar, por fin, la version 1.9 oficial.

El siguente es Zend AMF, desarrollado por Zend (la empresa detras de PHP) es el mas apoyado de todas las alternativas debido a que tiene la venia de Adobe y, obviamente, es desarrollado por Zend. A pesar de esto, carece de caracteristicas que AMFPHP o WebORB ya ofrecen (como seguridad integrada y un navegador de servicios) obligandote a implementarlas tu mismo o, lo que es mas facil, a vivir sin ellas. Pero su gran ventaja es que al ser una parte de Zend Framework (aunque se puede descargar de manera independiente) se acopla perfectamente a su arsenal de herramientas lo que es muy util, creeme. Hoy acabo de enterarme que el problema de la lenta serializacion de datos que Zend AMF tenia en versiones anteriores acaba de ser solucionada de manera oficial en la version 1.10.4.

El tercero es WebORB. Si tuviera que definirlo en una sola palabra esa seria “Completo”. Tiene tantas caracteristicas que impresiona. Un administrador de servicios decente junto con opciones pensadas para ahorrarle al desarrollador la necesidad de escribir codigo, incluye su propio administrador de acceso a servicios y metodos ademas de un administrador centralizado para el mapeo de clases. Sin lugar a dudas es el que ofrece mas opciones a simple vista. El problema de WebORB es justo eso, ofrece tantas opciones que pueden confundir al novato, darle una sensacion de demasiada complejidad.

Escribo este post porque hace poco he pasado de AMFPHP a Zend AMF. Me costo hacer la mudanza debido a que tenia muchas clases que recibian matrices asociativas como parametros (AMFPHP mapeaba los objetos de Flash en arrays asociativos y Zend AMF lo hace como objetos) y basaba casi toda la implementacion de seguridad en el metodo beforeFilter de cada clase/servicio.

Ayer me canse de este problema y decidi solucionar esta molestia de una vez por todas. Descartando que sea un problema de flash (porque antes no tenia este problema con la misma versión) supuse que seria Windows el culpable.

Y asi fue. El culpable es realmente un servicio de Windows llamado Archivos sin conexión el cual almacena archivos localmente para tener acceso a una copia de ellos cuando la PC se encuentre sin conexion a una red. Por alguna razón que no comprendo este servicio estaba cacheando archivos locales también.

Para desactivarlo ve a Panel de Control / Herramientas Administrativas / Servicios. Alli Buscas el servicio Archivos sin conexion y le da sun clic secundario y eliges Propiedades.

Desactivando el servicio archivos sin conexión

En la ventana que aparece dale un clic en el boton Detener y luego elije Deshabilitado en el combo de Tipo de inicio.

Talvez Microsoft ya haya soltado un parche para esto. Yo tengo Windows Vista Enterprise con SP1 pero sin actualizaciones instaladas (porque algunas actualizaciones de microsoft se comportar como un virus).

Google Maps tiene un API que te permite incrustar sus mapas en tu aplicacion Flash (solo ActionScript 3). Imagina una libreta de direcciones online en la que los usuarios puedan definir visualmente el punto exacto donde viven (aunque habria que tomar en cuenta las implicancias de eso) y en tu DB solo almacenar la latitud y longitud de la elección. Incluso podrias medir la distancia entre dos puntos.

El SDK lo puedes encontrar aquí: http://code.google.com/intl/es-ES/apis/maps/documentation/flash/intro.html#SWC_File
Debes solicitar un API Key: http://code.google.com/intl/es-ES/apis/maps/documentation/flash/intro.html#API_Key
Creando tu primera aplicacion: http://code.google.com/intl/es-ES/apis/maps/documentation/flash/tutorial-flash.html
Y la guia de referencia donde pueden encontrar toda la documentacion tecnica: http://code.google.com/intl/es-ES/apis/maps/documentation/flash/reference.html

El Golf de San Isidro

Puedes descargar las fuentes de este ejemplo en el siguiente enlace: Descargar Ejemplo de API de Google Maps

Decidi aprenderlo de una vez y empezar a usarlo en mis proyectos. 

Una de las primeras cosas que busqué fue su compatibilidad con AMF puesto que estoy acostumbrado a usar AMFPHP para casi todo. Zend Framework viene con clases para trabajar con AMF y son clases muy buenas. 

En 15 minutos arme mi gateway AMF en PHP con tan solo 7 lineas de codigo y cree un flash simple para probar mi servidor. 

A este servidor solo le falta agregarle la autenticación y Zend Framework trae clases para eso tambien. 

Puedes descargarte el Gateway + Service y Flash de ejemplo en el siguiente enlace.

Necesita tener las librerìas de Zend Framework junto al ejemplo.

<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
          SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
  <site-control permitted-cross-domain-policies="all" />
  <allow-access-from domain="*" />
</cross-domain-policy>

Esta configuración hará que flash player acepte todas las conexiones. Si deseas realizar una modificación te sugiero leas la documentacion que provee adobe. Como dije antes, no esta del todo actualizada pero lo esencial sigue ahí.

Como dije, es parecido no igual. Me demoraría hallando las diferencias y explicandolas aquí, mejor dejo un ejemplo de la extensión de la clase que maneja los eventos en Flash9. Simple y practica.

En AS2

import mx.events.EventDispatcher;
mx.events.EventDispatcher.initialize(this);
var logEventos:Object = new Object();
logEventos.onNewLog = function(evtobj:Object):Void{
trace("Parametro dato2: "+evtobj.dato2);
}
addEventListener("onNewLog", logEventos);
dispatchEvent("onNewLog", new Object({dato1:"A", dato2:"B", dato3:"C"}));

En AS3
Archivo LogEvts.as

package {
import flash.events.*;
public class LogEvts extends Event{
public var data:Object;
public function LogEvts(logObj:Object, type:String):void {
super(type, true);
this.data = logObj;
}
}
}

En el .Fla

import LogEvts.as
private var logevts:LogEvts = LogEvts();
addChild(logevts);
function logsTrace(evtobj:LogEvts):void{
trace("Parametro dato2: "+evt.data.dato2);
}
addEventListener("onNewLog", logsTrace);
logevts.dispatchEvent(new LogEvts(new Object({dato1:"A", dato2:"B", dato3:"C"}), "onNewLog"));

Y si te preguntas porque coloco el addEventListener en la raiz y no al objeto, es porque el evento es diaparado pasandole como parametro bubble=TRUE (en el as).
Para entenderlo puede visitar el blog de Alberto Alcaraz, post: sobre los eventos en AS3.

Si bien los eventos personalizados en AS3 no son tan simples como en AS2. Sinceramente, me molesta tener que crear una clase para esto, pero la versatilidad es mucho mayor.