ESPAÑOL - ENGLISH

Documentación Técnica

Ecademicus Webs es un módulo del Sistema de Administración de Ecademicus Educational que permite crear una serie de webs temáticas que los docentes pueden utilizar para publicar contenido didáctico e interactivo. Incluye un administrador de páginas web que permite:

• Crear / Editar / Eliminar Webs
• Agregar vínculos a una Web
• Crear un calendario para una Web
• Agregar Novedades en una Web
• Agregar un Calendario de Eventos para una Web
• Crear ejercicios múltiple opción y bajar los resultados en formato Excel.
• Crear y editar páginas web utilizando FckEditor, un editor WYSIWYG
• Crear y administrar directorios y sub-directorios
• Acceder y modificar archivos a través de WebDav (por ejemplo, utilizando Microsoft Web Folders).
• Búsqueda de textos en documentos cargados y en páginas web creadas.

La pantalla del tema principal:

El Calendario:

Hipervinculos:

Crear una web page:

Paso 1:

Paso 2:

Usted puede navegar a traves de los archivos y páginas subidas al systema.

 Webdav alternativo para navegar y actualizar los archivos:

0. Este proyecto utiliza las siguientes tecnologías. Recomendamos familiarizarse con éstas antes de instalar Ecademicus:

• Apache Tomcat
• Apache Jakarta Slide
• Struts
• Hibernate
• Any JDBCcompliant Database Server (MySQL, SQLServer, Oracle,Postgres, etc)
• SQL

1. Configurar Jakarta’s Slide y Tomcat

(la forma más fácil y ya comprobada es bajarlo de Slide-Tomcat )

• Agregar los siguientes contextos al servidor.xml de Tomcat:

 <Context path="/rep"

                   docBase="../slide"

                   debug="9"

                   privileged="true"

                   useNaming="true"/>

 <Context docBase="C:/ecademicus/" path="/ecademicus"

reloadable="true" useNaming="true">

           <ResourceLink global="jdbc/ecwebs" name="jdbc/ecwebs"

 type="javax.sql.DataSource"/>

 </Context>

C:/ecademicus debe ser una carpeta en el servidor que tenga los contenidos de la carpeta WebContent correspondientes al ecademicus-webs-src.zip distribuible.

Utilizar el módulo de single-sign-on de Tomcat para evitar los avisos de login:

<Valve className="org.apache.catalina.authenticator.SingleSignOn" debug="0"/>

Se debe crear una base de datos utilizando la secuencia de comandos SQL de la siguiente sección, y configurar la datasource llamada jdbc/ecwebs a la base de datos JDBC:

<Resource name="UserDatabase" auth="Container"

type="org.apache.catalina.UserDatabase"

description="User database that can be updated and saved">

</Resource>

<Resource name="jdbc/ecwebs" auth="Container" scope="Shareable" type="javax.sql.DataSource"/>

<ResourceParams name="UserDatabase">

<parameter>

<name>factory</name>

<value>org.apache.catalina.users.MemoryUserDatabaseFactory</value>

</parameter>

<parameter>

<name>pathname</name>

<value>conf/tomcat-users.xml</value>

</parameter>

</ResourceParams>

<ResourceParams name="jdbc/ecwebs">

<parameter>

<name>factory</name>

<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

</parameter>

<parameter>

<name>driverClassName</name>

<value>net.sourceforge.jtds.jdbc.Driver</value>

</parameter>

<!-- Maximum number of dB connections in pool. Make sure you

configure your mysqld max_connections large enough to handle

all of your db connections. Set to 0 for no limit.

-->

<parameter>

<name>maxActive</name>

<value>0</value>

</parameter>

<!-- Maximum number of idle dB connections to retain in pool.

Set to -1 for no limit. See also the DBCP documentation on this

and the minEvictableIdleTimeMillis configuration parameter.

-->

<parameter>

<name>maxIdle</name>

<value>50</value>

</parameter>

<!-- Maximum time to wait for a dB connection to become available

in ms, in this example 10 seconds. An Exception is thrown if

this timeout is exceeded. Set to -1 to wait indefinitely.

-->

<parameter>

<name>maxWait</name>

<value>10000</value>

</parameter>

<!-- MySQL dB username and password for dB connections -->

<parameter>

<name>username</name>

<value>webadmin</value>

</parameter>

<parameter>

<name>password</name>

<value>webadmin</value>

</parameter>

<parameter>

<name>url</name>

<value>jdbc:jtds:sqlserver://Maxtoshiba:1433/ecwebs

</value>

</parameter>

<parameter><name>defaultAutoCommit</name><value>true</value></parameter>

<parameter><name>removeAbandoned</name><value>false</value></parameter>

<parameter><name>removeAbandonedTimeout</name><value>300</value></parameter>

<parameter><name>logAbandoned</name><value>true</value></parameter>

</ResourceParams>

En el ejemplo, se configura para Microsoft MSDE, pero puede cambiarse para otros Servidores de Bases de Datos cambiando la configuración arriba descripta y el archivo hibernate.properties.

Los usuarios del sistema son los usuarios slide (utilizando el SlideRealm). De igual forma, la autenticación se efectúa utilizando el esquema de autenticación de slide. Esto se puede configurar cuidadosamente (visitar el sitio slide).

4. Por esta razón, los siguientes archivos que pueden encontrarse en WEB-INF/server/lib libraries necesitan ser copiados a las carpetas de Tomcat: common/lib and server/lib respectivamente:

• EcadSlideRealm_common.jar
• EcadSlideRealm_server.jar

CREATE TABLE Cte_LinksMateria (

cod_webmateria nvarchar (50) NOT NULL ,

etitulo varchar (200) NULL ,

url varchar (300) NULL

)

CREATE TABLE Cte_Plugins (

cod_plugin varchar (16) NOT NULL ,

enombre varchar (100) NULL ,

ecomando varchar (200) NULL ,

comando_key varchar (50) NULL

)

CREATE TABLE Cte_WebMateria (

cod_webmateria char (5) NOT NULL ,

nombre nvarchar (40) NULL ,

nature ntext NULL ,

uri varchar (200) NULL ,

cod_foro int NULL ,

cssfile varchar (50) NULL ,

imagefolder varchar (50) NULL

)

CREATE TABLE Cte_mapadmwebs (

cod_webmateria nvarchar (10) NOT NULL ,

cod_actor nvarchar (20) NOT NULL

)

CREATE TABLE Cte_respuestasQuiz (

code nvarchar (30) NOT NULL ,

cod_alumno nvarchar (25) NOT NULL ,

num_pregunta int NOT NULL ,

fecha_mod datetime NOT NULL ,

opcion nvarchar (25) NULL

)

CREATE TABLE cte_news (

code int IDENTITY (1, 1) NOT NULL ,

calendarFrom datetime NULL ,

calendarTo datetime NULL ,

from datetime NULL ,

to datetime NULL ,

uploadActor varchar (50) NULL ,

url varchar (100) NULL ,

when varchar (50) NULL ,

title char (100) NULL ,

cod_webmateria varchar (50) NULL ,

calendar bit NULL ,

descrip varchar (400) NULL

)

CREATE TABLE cte_numeradores (

id_numerador nvarchar (8) NOT NULL ,

valor int NOT NULL

)

ALTER TABLE Cte_LinksMateria ADD

PRIMARY KEY CLUSTERED

(

cod_webmateria

)

ALTER TABLE Cte_Plugins ADD

PRIMARY KEY CLUSTERED

(

cod_plugin

)

ALTER TABLE Cte_mapadmwebs ADD

CONSTRAINT PK__Cte_mapadmwebs__5C648F78 PRIMARY KEY CLUSTERED

(

cod_webmateria,

cod_actor

)

ALTER TABLE cte_news ADD

CONSTRAINT PK_cte_news PRIMARY KEY CLUSTERED

(

code

)

INSERT INTO Cte_Plugins(cod_plugin, enombre, ecomando, comando_key)

VALUES('quiz','Quiz','Create Quiz,''plugins.quiz.createQuiz')

I Introducción

Los plugins tienen el propósito de brindar flexibilidad a los servicios de navegación del repositorio, sin tener que afectar la aplicación. Ejemplos de plugins pueden ser: creación de encuestas, formularios, galerías de fotos, plantillas de desarrollo de cursos.

Componentes de plugins:

Todo plugin tiene

• Código (ej. "quiz")
• Nombre (ej. Creador de Quiz)
• Comando (ej. "Crear un quiz aquí")
• Comando_key (ej. clave internacional del comando)
• Servicios:
• Creator (ej. página que permite crear el quiz)
• Renderer (ej. página que permite visualizar el quiz)
• Destructor (ej. página que permite eliminar el quiz)

Implementación de plugins

Para crear un plugin se necesita:

• Agregar una tupla a la tabla cte_plugins (mediante la consola) con los datos correspondientes.
• Crear una carpeta en la web /subject/plug-ins/codplugin donde codplugin es el código del plugin.
• Implementar en esa carpeta al menos los siguientes jsps:

renderer.jsp

creator.jsp

destructor.jsp

• Opcionalmente podrá usar clases en el paquete edu.ecademicus.subject.plugins.codplugin para incluir clases auxiliares.

Creator JSP

El archivo creator.jsp recibirá un parámetro con el uri de la carpeta en donde se quiere crear el archivo plugin.

El creador deberá generar un archivo .xmp (en la carpeta indicada) con el siguiente formato:

Nota: La Metadata es opcional. Lo único verdaderamente esencial es el atributo name del plugin.

Renderer JSP

renderer.jsp recibe como parámetro el uri del archivo .xmp y debe mostrar este archivo según el propósito que se desea lograr.

Destructor JSP

destructor.jsp recibe como parámetro el uri del archivo .xmp y elimina ese archivo junto con los archivos auxiliares que usará y las modificaciones en la base que se hubieran generado.

Invocación de servicios

En la navegación de las carpetas en el ecademicus subject module, cuando se encuentra un archivo xmp, el link que se mostrará no es el acceso al archivos xmp sino al renderer del correspondiente plugin pasándole el uri del archivo xmp.

En la opción de administración de carpetas (manage) se muestra una lista de todos los plugins disponibles con el link hacia el creator.jsp?uri=XXX donde XXX es el path al archivo xmp.

En el borrado de archivos, se invoca al destructor.jsp con el uri del archivo xmp. Nota: Éste deberá borrar el archivo.

CONTÁCTENOS

mgurmendez@users.sourceforge.net