Reporte Tecnico

Versin 12/Dic/2002
Manual Tcnico del Sistema de Administracin para Ventas Casa por Casa
ndice
Cursos---------------------------------------------------------------------------------------------15
CatCurso---------------------------------------------------------------------------------------------15
MisNotas--------------------------------------------------------------------------------------------15
Alumnos---------------------------------------------------------------------------------------------15
Usuario----------------------------------------------------------------------------------------------15
Salones-----------------------------------------------------------------------------------------------15
Glosario----------------------------------------------------------------------------------------------15
Links-------------------------------------------------------------------------------------------------15
Chats----------------------------------------------------------------------------------------------15
Actividades---------------------------------------------------------------------------------------15
ActResults-------------------------------------------------------------------------------------------15
Actividades------------------------------------------------------------------------------------------15
Chat--------------------------------------------------------------------------------------------------15
ChatUser---------------------------------------------------------------------------------------------15
Tareas------------------------------------------------------------------------------------------------15
Calendario-------------------------------------------------------------------------------------------15
ExamBase-------------------------------------------------------------------------------------------15
ForosPost--------------------------------------------------------------------------------------------15
Examenes--------------------------------------------------------------------------------------------15
Foros-------------------------------------------------------------------------------------------------15
Temas------------------------------------------------------------------------------------------------15
Usuarios------------------------------------------------------------------------------------------15
SubTemas-------------------------------------------------------------------------------------------15
Administradores------------------------------------------------------------------------------------15
Manejo de excepciones-------------------------------------------------------------------------28
Pgina 2
Universidad de Colima, 2015.
Diciembre 03, 2015- Versin 1.0
Introduccin
El Sistema de Administracin para Ventas Casa por Casa, es un software que
permite el registro de clientes y productos as como el seguimiento de ventas
realizadas en un enfoque de ventas casa por casa.
Esta plataforma fue desarrollada como proyecto de titulacin en la Universidad
de Colima por Omar Salvador Gutirrez Zamora con el objetivo de resolver una
problemtica de la vida actual, facilitando as el trabajo de personas que se
dedican a la venta de productos por catlogos y a la vez cuentan con un
conocimiento promedio o bajo sobre el uso de tecnologas.
La plataforma funciona de una manera similar a si se llevaran los registros de
ventas en Excel, manteniendo un registro e informacin de clientes y productos,
as como de las acciones realizadas entre estos.
Cuenta con un solo usuario, que es el administrador de la plataforma el cual
cuenta con total control sobre la informacin, y define valores especficos como
el precio de cada producto o las fechas de pago convenidas con sus clientes.
La aplicacin cuenta con distintos mdulos que generan o muestran diferentes
tipos de informacin en el sistema.
Las siguientes tablas describen brevemente estos mdulos, para una

descripcin mas detallada de su funcionamiento consulte el manual de usuario
de la plataforma:
Mdulos Generales
Descripcin
Herramienta
Clientes
Productos
Ventas
Agregar
Clientes
Permite al usuario acceder a las

informacin de clientes
informacin de productos
informacin de las ventas
Permite agregar clientes nuevos
requerida
pantallas de edicin de
llenando la informacin
Pgina 3
Ver Clientes
Ver
Informacin
del Cliente
Editar Cliente
Ver Productos
Agregar
Producto
Editar
Productos
Ver Abonos
Agregar
Ventas
Ver Ventas
Muestra un listado ordenado de los clientes registrados en el

sistema
Muestra la informacin de un cliente seleccionado as como
todas las ventas realizadas a con este.
Permite editar la informacin de clientes ya existentes
Muestra un listado ordenado de los productos registrados en el
sistema
Permite agregar productos nuevos llenando la informacin
requerida
Permite editar la informacin de productos ya existentes
Muestra un listado ordenado de los abonos a cobrar, el cliente
puede seleccionar la opcin de listar los abonos del da,
semana, quincena o mes actual.
Permite al usuario establecer una relacin entre un cliente y un
producto existente, asignando un valor especfico que el
cliente pagar por cuotas, las cuales son generadas
automticamente a partir de un da de pago seleccionado por
el cliente.
Muestra un listado ordenado de ventas registradas mediante
una bsqueda por fecha de creacin.
En este manual se describen los requerimientos de hardware (servidores y

estaciones de trabajo) y software (bases de datos, navegadores, etc) necesarios
para instalar la aplicacin utilizando como sistema operativo Windows, se
describe su arquitectura y cada uno de sus componentes, por ltimo se
presentan los procesos de mantenimiento sugeridos.
Pgina 4
Requerimientos
El presente manual tiene como finalidad describir tcnicamente los
requerimientos y componentes de la plataforma educativa, para iniciar se listan
los requerimientos mnimos de hardware y software requeridos para la
instalacin y uso de la plataforma.
Servidor
Software
Hardware
Dispositivo Android JellyBean 4.0 o superior

Dada la naturaleza del sistema, cualquier dispositivo Jelly Bean 4.0
o superior es capaz de ejecutar el sistema sin problema alguno
Proceso de Instalacin de la aplicacin

Dada la naturaleza de la aplicacin, y siendo esta para dispositivos Android,
basta con ejecutar el APK provisto y dar los permisos de instalacin necesarios.
Planes futuros incluyen subir la aplicacin a la Play Store de google permitiendo
una instalacin sencilla y donde la aplicacin pueda ser localizada por medio de
la Play Store.
Proceso de instalacin
1. Aplicacin
1. Ejecutar el APK provisto
2. Dar los permisos necesarios para la instalacin de aplicaciones
con origen desconocido.
2. Bases de Datos
1. Ejecutar la aplicacin
2. Abrir el men de clientes, productos o ventas
3. La aplicacin ejecutar automticamente las instrucciones
necesarias que crearn la base de datos VentasCasa
Pgina 5
Software utilizado para el desarrollo

Para el desarrollo de la plataforma se utilizaron diferentes herramientas, las
cuales se listan a continuacin
Funcin
Edicin de
Cdigo
Creacin y
edicin de
imgenes
Bases de datos
Lenguajes de
programacin
utilizado
Herramientas
Android Studio
Adobe Photoshop
SQLite
Java
Pgina 6
Arquitectura de la plataforma
La plataforma esta basada en la arquitectura ejecutada del lado del cliente, pues
siendo instalada en el dispositivo, se ejecuta todo lo necesario desde el mismo.
Modelo orientado al cliente
La Arquitectura de la aplicacin est compuesta por dos grandes aspectos

Servidores
Descripcin
Aplicacin
Maneja toda la entrada y salida de datos del sistema
Bases de datos Se almacena y consulta toda la informacin
Pgina 7
Estructura de directorios de la plataforma

El proyecto est organizado en ocho carpetas, que se encuentran localizadas
dentro de la carpeta cursos y ocupan un espacio aproximado de 2.5 MB. La
carpeta cursos es el directorio raz de la plataforma. Actualmente el software de
la
plataforma
se
encuentra
instalado
en
el
servidor
http://www.educoas.org/cursos.
Directorio
/
/bin
/chat
/css
/curso
/foro
/images
/photousers
/public
Descripcin
En l se encuentran almacenados todos los componentes de
la plataforma, incluyendo los cursos
Almacena los archivos dll y ascx
Contiene los archivos del mdulo de chat
Aqu se encuentran almacenadas las hojas de estilo que
definen las propiedades de los componentes de la
plataforma
Almacena toda la informacin de un curso especfico, as
como las imgenes de las herramientas
Contiene los archivos e imgenes del mdulo de foros
Almacena imgenes utilizadas en la parte de administracin
de cursos de la plataforma
Almacena las fotografas de los usuarios de la plataforma
Contiene pginas de mensajes de error, detectores de
navegadores, imgenes y otras utileras
Pgina 8
La siguiente tabla describe los archivos que se encuentran almacenados en

cada uno de los directorios directorio
Directorio raiz
Archivo
Descripcin
Permite acceder a un curso especfico con los derechos
accesocurso.aspx
asignados por el administrador
actividades.aspx
Permite a los tutores definir actividades para cada curso
Muestra a los usuarios el estado de las actividades
actresults.apsx
asignadas
admin.aspx
Pgina de entrada del administrador de la plataforma
admincalend.aspx
Permite administrar el calendario de eventos
admincursos.aspx
Interfaz utilizada para administrar cursos
adminerrors.aspx
Muestra la bitcora de errores generados por el sistema
Permite administrar los archivos almacenados en un
adminfilebrowser.aspx
curso
admingral.aspx
Muestra la lista de administradores del sistema
Despliega la interfaz para administrar un curso
adminmenu.aspx
especfico
adminlogs.aspx
Administracin de la bitcora de accesos
adminprivilegios.aspx Permite administrar los privilegios de cada usuario
adminuser.aspx
Interfaz para administrar usuarios
browser.aspx
Despliega la pgina inicial del explorador de archivos
Permite bajar archivos de la plataforma a la
browserdwnl.aspx
computadora del usuario
calendario.aspx
Muestra el calendario de eventos
Permite al tutor revisar los exmenes presentados por
checkexamenes.aspx
los alumnos
curso.aspx
Permite al tutor configurar un curso
default.aspx
Pgina de entrada para un usuario registrado
dircontent.aspx
Permite generar el directorio de contenido de un curso
Define propiedades de un documento en el editor de
docpropiedades.aspx
archivos
editor.aspx
Permite editar archivos pertenecientes a algn curso
Permite enviar correos entre si a los alumnos de un
email.aspx
curso
email2.aspx
Permite enviar correo electrnico a tutores
evaluacion.aspx
Aplica la evaluacin de un mdulo
Permite revisar las calificaciones obtenidas por los
evaluados.aspx
alumnos
examenes.aspx
Permite examinar los exmenes
examenesedit.aspx
Permite editar exmenes
getfoto.aspx
Visualiza la foto de un usuario
global.asax
Archivo de configuracin de la aplicacin
Pgina 9
glosario.aspx
Despliega el glosario del curso
Insetherramienta.aspx Permite utilizar herramientas en el editor de documentos
Permite generar enlaces internos dentro de las pginas
InsertLocalLink.aspx
del curso utilizando el editor de archivos
Permite insertar tablas en un documento utilizando el
InertTabla.aspx
editor de archivos
links.aspx
Despliega la lista de sitios de inters para el curso
login.aspx
Inicio de sesin, solicita el nombre de usuario y la clave
Termina la sesin y regresa al usuario a la pgina de
logout.aspx
inicio.
main.aspx
Regresa al usuario a su pgina de inicio
menu.aspx
Despliega el men de lado izquierdo de un curso
misalon.aspx
Muestra la pagina mi saln
misnotas.aspx
Muestra la pgina mis notas
misnotasview.aspx
Permite acceder notas que se guardaron anteriormente
profile.aspx
Despliega el perfil del usuario
selcolor.aspx
Permite seleccionar un color
sendfiles.aspx
Permite enviar documentos a los tutores
stats.aspx
Desplegar los accesos registrados de los usuarios
titulo.aspx
Despliega la barra de herramientas superior derecha
web.config
Archivo de configuracin del servidor de Web
/bin
Directorio
Descripcin
Archivo que contiene funciones de uso global en la
aplicacin
popUpCalendar.ascx Despliega un calendario
Archivo
MADC.dll
/chat
Archivo
chat.aspx
chatwin.aspx
default.aspx
Exit.aspx
Exitwin.aspx
flashchat.aspx
history.aspx
profile.aspx
send.aspx
Sendwin.aspx
Talk.aspx
Directorio
Descripcin
Acceso al Chat
Despliega el Chat en versin HTML en una ventana
Despliega la interfaz del chat
Termina la sesin de chat
Cierra la ventana del chat
Despliega el chat en versin Flash
Permite el acceso al calendario de transcripciones del
chat
Despliega el perfil del usuario seleccionado
Area de envio de mensajes.
Area de envio de mensajes para el chat HTML en
ventana.
Area de despliegue de mensajes del chat
Pgina 10
users.aspx
/css
Archivo
helptip.css
helptip.js
mainsheet.css
style.css
Area de usuarios activos en el chat

Directorio
Descripcin
Despliegan dentro de una ventana flotante el significado
de una palabra dentro de una pgina del curso
Definen las propiedades de los elementos de la plataforma
(colores, tipografa, etc)
/cursox
Archivo
default.html
/cursos/images/
Directorio
Descripcin
Pgina de la portada del curso
Imgenes propias de cada curso
/foro
Archivo
default.aspx
Foro.aspx
getattach.aspx
newpost.aspx
Newreplay.aspx
reply.aspx
/foro/images/
/foro/images/post.gif
/foro/images/responder.gif
/foro/images/respuestas.gif
Archivo
/images
activado.gif
activadoN.gif
activados.gif
ayuda.jpg
bgcolor.gif
biblio.jpg
...
/images/ext
Directorio
Descripcin
Permite acceder la lista de foros de discusin
Da acceso a un foro en particular
Permite bajar un archivo desde la interfaz de un
curso
Permite agregar un nuevo post en el foro
Se utiliza para responder un post dentro de un foro
Permite leer un post dentro de un foro y contestarlo
Imgenes utilizadas en la seccin de foros
Descripcin
Almacena imgenes utilizadas en la parte de
administracin de cursos de la plataforma
Contiene imgenes utilizadas para identificar

formatos de documentos
/images/ext/asax.gif
/images/ext/asf.gif
Pgina 11
/images/ext/asp.gif
/images/ext/aspx.gif
...
/images/home
Contiene las imgenes utilizadas en la pgina de

herramientas administrativas
/images/home/admin.jpg
/
images/home/borrarcurso.gif
/images/home/calendario.gif
/images/home/errors.jpg
...
/images/smiles/
Contiene los archivos de las imgenes utilizadas

en el chat
/images/smiles/smile1.gif
...
Archivo
/photousers/
/public
Archivo
/public/403.html
/public/404.html
/public/500.html
/public/browser.aspx
/public/detcurso.aspx
/public/flashsend.aspx
/public/flashtalk.aspx
/public/flashuser.aspx
/public/images
/public/images/bs.gif
/public/images/dc.gif
...
Descripcin
Flder que almacena las fotografas de los
usuarios de la plataforma (administrador, tutores,
etc).Ej. Idusuario.jpg
Directorio
Descripcin
Despliega el mensaje que el usuario debe estar
registrado para acceder a la plataforma
Despliega un mensaje indicando que la pgina no existe
Despliega un mensaje indicando que se gener un error
y lo reporta al administrador
Detecta las caractersticas del navegador
Muestra la descripcin y tabla de contenido de un curso
Archivos utilizados para desplegar el chat en versin
flash
Imgenes utilizadas cuando se despliegan las
caractersticas de un curso
Pgina 12
/cursox
Archivo
/cursox
/cursox/images/
Descripcin
Almacena toda informacin de un curso
especfico (directorios, archivos, etc)
Almacena las imgenes propias de cada
curso.
/cursos/images/ayuda_off.gif
/
cursos/images/calendario_on.gif
/cursos/images/calendario_off.gif
El nombre de cada una de las
imgenes de las herramientas
debe ser exactamente igual en
todos los cursos (Los nombres,
y tamaos de estas imgenes
se describen ms adelante)
Pgina 13
Descripcin de Tablas
A continuacin se presenta un listado descripcin de las tablas utilizadas en la
base de datos cursos de la plataforma educativa
Tabla
clientes
actividades
actresults
administradores
alumnos
Calendario
Catcurso
Chat
Chatusers
ColoresMenu
Cursos
Errors
Examenes
ExamResp
Examtomados
ForoPosts
Foros
Glosario
Links
misnotas
salones
Temas
subtemas
Tareas
traduccin
Usuario
Descripcin
Bitcora de accesos
Lista de actividades para cada curso
Resultados de las Actividades evaluadas
Lista de administradores y privilegios
Usuarios registrados en los salones
Calendario de eventos para cada curso
Catlogo de tipos de categoras de cursos
Transcripciones del chat
Usuarios actuales en los chats
Configuracin de colores del curso
Define propiedades de cada curso
Bitcora de errores
Exmenes
Respuestas de los usuarios en los exmenes
Usuarios que han realizado un examen
Posts hechos al foro
Catlogo de foros
Glosarios del contenido de los cursos
Lista de enlaces y documentos (materiales)
Almacena las notas de los usuarios
Salones de los cursos
Lista de temas de cada curso
Lista de subtemas de cada curso
Archivos enviados a los tutores
Traduccin de las etiquetas utilizadas en la plataforma
Usuarios
Pgina 14
Diagrama entidad-relacin
Cursos
Relacin 1-1
CatCurso
Relacin 1-m
Usuarios
Salones
Cursos
Alumnos
MisNotas
Usuario
ColoresMenu
Administradores
Temas
SubTemas
Foros
Chats
Actividades
Foros
ChatUser
Actividades
Chat
ActResults
ForosPost
Exmenes
Examenes
ExamBase
ExamTomados
Calendario
Calendario
Tareas
Glosario
Tareas
Glosario
Enlaces y Docs.
Links
Pgina 15
Descripcin de campos de cada tabla

Tabla
Accesos
Descripcin
Bitcora de accesos
Campo
Tipo
id
usuario
curso
salon
pagina
fecha
ip
actividades
Tamao
Descripcin
4
4
4
4
500
8
15
Identificador del evento registrado

Nombre del usuario
Identificador del curso visitado
Identificador del saln visitado
Registro de pginas visitadas
Fecha de la visita
Direccin IP del cliente
Lista de actividades para cada curso

Campo
Tipo
Tamao
id
salonid
cursoid
titulo
descripcion
fecha
Activo
actresults
int
int
int
int
varchar
datetime
varchar
int
int
int
varchar
varchar
datetime
char
4
4
4
500
2000
8
1
Descripcin
Identificador de la actividad
Identificador del saln
Identificador del curso
Ttulo de la actividad
Descripcin de la actividad
Fecha en que se realizar la actividad
Indica si ser visible o no par al usuario
Resultados de las Actividades evaluadas

Campo
Tipo
Tamao
id
actividadid
userid
realizada
valor
comentarios
int
int
int
char
varchar
varchar
4
4
4
1
50
500
Identificador del resultado

Identificador de la actividad
Identificador del usuario
Indica si la actividad ha sido realizada
Calificacin obtenida en la actividad
Comentarios del tutor
administradores Lista de administradores y privilegios

Campo
Tipo
Tamao
id
userid
privilegios
alumnos
4
4
8
Descripcin
Identificador de administradores
Privilegios del usuario
Informacin de los alumnos registrados

Campo
Tipo
Tamao
id
userid
cursoid
salonid
privilegios
administra
Calendario
int
int
char
int
int
int
int
char
char
4
4
4
4
12
1
int
int
datetime
4
4
8
Descripcin
Identificador de alumnos
Privilegios del alumno
Indica si el usuario es un administrador
Calendario de eventos para cada curso

Campo
Tipo
Tamao
id
salonid
fecha
Descripcin
Descripcin
Identificador del calendario

Fecha del evento
Pgina 16
mensaje
cursoid
activo
Catcurso
int
varchar
int
varchar
int
varchar
datetime
int
int
4
4
2
200
Descripcin
Identificador del catlogo

Identificador de idioma
Ttulo del curso
Tamao
Descripcin
4
1000
4
200
4
50
8
4
4
Identificador del mensaje

Texto del mensaje
Identificador del usuario que public
Nombre del usuario que public
Identificador al que respondi
Nombre del usuario al que respondi
Fecha en que publicaron
int
varchar
int
varchar
int
int
datetime
char
char
char
4
100
4
255
4
4
8
1
1
1
Identificador
Nombre del usuario
Identificador de usuario
Estado del mensaje
Fecha de la ltima pltica
Indicar si un usuario esta bloqueado
Indicar si es administrador del chat
Indicar si tiene definido un profile
Configuracin de colores del curso

Campo
Tipo
Tamao
id
cursoid
color
Cursos
Descripcin del evento

Indica si ser visible o no par al usuario
Propiedades de los usuarios actuales en un chat

Campo
Tipo
Tamao
Descripcin
id
username
userid
statusmsg
salonid
cursoid
lasttalk
blocked
admin
profile
ColoresMenu
int
int
char
varchar

Campo
Tipo
id
body
fromuser
fromusername
touser
tousername
curdatetime
salonid
cursoid
Chatusers
1000
4
1
Catlogo de tipos de categoras de cursos

Campo
Tipo
Tamao
ids
id
idioma
titulo
Chat
varchar
int
char
int
int
char
Descripcin
4
4
7
Cursos y sus propiedades

Campo
Tipo
Identificador de la configuracin
Color propio de cada curso
Tamao
Descripcin
id
titulo
descripcion
inicio
fin
activo
int
nvarchar
nvarcar
datetime
datetime
char
4
200
100
8
8
1
foro
char
chat
char
chathistory
char

Nombre del curso
Descripcin del curso
Fecha de inicio
Fecha de terminacin
Indica si estar activo el curso
Indica si estar activa la herramienta
foro
chat
transcripcin del chat
Pgina 17
Errors
Examenes
emails
char
link
char
calendario
colortitulo
frameizquierdo
colortemas
colorsubtemas
fondodir
char
varchar
varchar
varchar
varchar
varchar
1
8
8
8
8
8
glosario
char
misnotas
char
misalon
char
swapsubmenu
categoria
varchar
int
8
4
Bitcora de errores
Campo
Tipo
int
datetime
varchar
varchar
4
8
200
200
ip
varchar
25
id
pertenece
cursoid
salonid
titulo
pregunta
respuesta
correcta
nivel
hierachy
activo
espregunta
ExamResp
Tamao
id
fecha
mensaje
url
Catlogo de exmenes
Campo
Tipo
int
int
int
int
varchar
varchar
varchar
char
int
int
char
char

de envo de correos
Indica si estarn activos los enlaces
de inters
calendario
Define el color del ttulo
Define el color del frame izquierdo
Define el color de los temas
Define el color de los subtemas
Define el color de fondo
glosario de trminos
mis notas
mi saln
Define el color con que se resaltar el
subtema seleccionado
Categora a la que pertenece el curso
Descripcin
Identificador de errores
Fecha en que ocurri el error
Descripcin del error
Url de la pgina donde ocurri el error
Direccin IP de usuario que recibi el
error
Tamao
4
4
4
4
500
500
500
1
4
4
1
1
Descripcin
Identificador de examen
Ttulo del examen
Texto de la pregunta
Texto de la respuesta
Indica si la respuesta es correcta
Identificador de nivel
Identificador de jerarqua
Define si estar activo
Define si es pregunta o respuesta
Respuestas de los usuarios a los exmenes

Campo
Tipo
Tamao
id
examid
preguntaid
respuesta
correcta
usuario
cursoid
salonid
int
int
int
varchar
varchar
int
int
int
4
4
4
500
1
4
4
4
Descripcin
Identificador de respuesta
Identificador de pregunta
Texto de la respuesta
Indica si la respuesta es correcta
Identificador de curso
Identificador de saln
Pgina 18
Examtomados
Lista de usuarios que han realizado un examen

Campo
Tipo
Tamao
Descripcin
id
examid
usuarioid
cursoid
salonid
ForoPosts
Foros
Clave automtica asignada a los

exmenes tomados
Tamao
Descripcin
postid
int
replyto
usuario
usuarioid
asunto
mensaje
fecha
viewx
int
varchar
int
varchar
ntext
datetime
int
4
50
4
500
16
8
4
replies
cursoid
salonid
nivel
hierachy
activo
tipoarchivo
int
int
int
int
varchar
char
varchar
4
4
4
4
900
1
50
nombrearchivo
Archivo
Foroid
varcahr
image
int
500
16
4
Filesize
int
Catlogo de foros
Campo
Tipo
int
int
int
varchar
varchar
char
char
char
Glosarios de cursos
Campo
Tipo
id
cursoid
frase
descripcion
activo
acronimo
Links
4
4
4
4
4
Posts hechos al foro

Campo
Tipo
id
cursoid
salonid
titulo
descripcion
activo
moderado
newpost
Glosario
int
int
int
int
int
int
int
varchar
varchar
char
char
Identificador del post

Identificador del post al que se esta
contestando
Nombre del usuario
asunto del mensaje
Descripcin del mensaje
Fecha del post
Veces que se ha visto este post
Veces que ha sido respondido este
post
Nivel del post
Jerarqua del post
Define si esta activo
Indica el tipo de archivo
Nombre del archivo incluido como
attachment
Archivo
Identificador del foro
Tamao del archivo incluido como
attachment
Tamao
4
4
4
100
2000
1
1
1
Descripcin
Identificador del foro
Ttulo del foro
Descripcin del foro
Define si el foro esta activo
Define si es un foro abierto o moderado
Define si permite agregar un nuevo post
Tamao
4
4
500
4000
1
1
Descripcin
Identificador del glosario
Frase a definir
Definicin de la frase
Indica si aparecer en el glosario
Indica si es un acrnimo
Lista de enlaces y documentos (materiales)

Pgina 19
Campo
misnotas
descripcion
activo
archivo
tipoarchivo
filesize
nombrearchivo
varchar
char
image
varchar
int
varchar
2000
1
16
50
4
500
tipo
char
Identificador del enlace

Ttulo del enlace o documento
url del enlace
Texto que describe el enlace o
documento
Define si el enlace estar activo
Archivo
Define el tipo de archivo
Define el tamao del archivo
Nombre del archivo
Define el tipo de material enlace o
documento
Almacena las notas de los usuarios

Campo
Tipo
Tamao
int
datetime
int
varchar
ntext
Catlogo de salones
Campo
Tipo
int
int
int
char
varchar
4
8
4
200
16
Descripcin
Identificador de la nota
Fecha en que fue escrita la nota
asunto de la nota
contenido de la nota
Tamao
4
4
4
1
50
Descripcin
Identificador
Define si el saln estar activo
Nombre del saln
Lista de subtemas de cada curso

Campo
Tipo
Tamao
id
cursoid
temaid
orden
titulo
url
activo
urlactivo
Tareas
Descripcin
4
4
150
300
id
cursoid
salon
activo
alias
subtemas
Tamao
int
int
varchar
varchar
id
fecha
userid
asunto
nota
salones
Tipo
id
cursoid
link
url
int
int
int
int
varchar
varchar
char
char
4
4
4
4
150
150
1
1
Descripcin
Identificador
Identificador del tema al que pertenece
Orden de aparicin del subtema
Ttulo del subtema
Url de la informacin del subtema
Define si el subtema estar activo
Define si el url estar activo
Archivos enviados a los tutores

Campo
Tipo
Tamao
id
usuario
salonid
cursoid
asunto
comentarios
archivo
tipoarchivo
fecha
username
nombrearchivo
int
int
int
int
varchar
varchar
image
varchar
datetime
varchar
varchar
Descripcin
4
4
4
4
100
500
16
50
8
50
500
Identificador
Ttulo del mensaje
Texto del mensaje
Archivo
Tipo de archivo
Fecha del envo
Nombre del usuario que lo enva
Nombre del archivo enviado
Pgina 20
Temas
Lista de temas de cada curso

Campo
Tipo
Tamao
id
cursoid
orden
titulo
urlactivo
activo
traduccin
int
int
int
varchar
char
char
4
4
4
150
1
1
Descripcin
Identificador
Orden en que aparecern los temas
Ttulo del tema
Define si el url estar activo
Define si el tema estar activo
Traduccin de las etiquetas utilizadas en la plataforma

Campo
Tipo
Tamao
Descripcin
id
idioma
descripcion
int
int
nvarchar
4
4
550
utilizacion
varchar
200
Identificador de la etiqueta
Idioma al que pertenece la traduccin
Contenido de la etiqueta
Indica en que rea, pgina o mdulo se
utiliza la etiqueta
Descripcin de Procedimientos (Store Procedures SP)

La siguiente tabla muestra los procedimientos utilizados, el efecto que causan en
cada una de las tablas y los archivos aspx que los utilizan
Stores
Procedures
Tablas
Efecto
NuevoCurso
Cursos
insert
RemoveSubtree
ForoPosts
delete
RemoveSubtreeExam
Archivos aspx
que lo utilizan
Admincalend
Admincursos
Adminerrors
Adminfilebrowser
Admingral
Adminlogs
Adminprivilegios
Adminusers
Default
Profile
examenes
examenesedit
foro
reply
examenes
examenesedit
Examenes delete
Descripcin
Permite dar de
alta un nuevo
curso
Elimina un post
y todas sus
respuestas
Utilizado para
eliminar un
examen,
incluyendo todas
sus preguntas y
respuestas
Pgina 21
Caractersticas de las Imgenes utilizadas en cada

herramienta
Interfaz de cursos
La interfaz grfica del usuario puede ser diferente para cada curso y la barra de
herramientas puede contener hasta 12 opciones, donde cada una de ellas es
representada por una imagen, a continuacin se presenta un ejemplo de la
pgina titulo.aspx la cual genera la barra de herramientas de los curso.
Para representar cada herramienta se utilizan dos imgenes una de ellas es la

que aparece por default al entrar al curso y la otra es la que se activa cuando se
coloca el cursor sobre la imagen. Estas imgenes deben ser colocadas en el
directorio /cursos/cursox/images/, la siguiente tabla muestra las caractersticas
que deben tener estas imgenes:
Nombre de la imagen imagen Tamao en pixeles
Foro_on.gif
45x42
45x42
Foro_off.gif
Las imgenes utilizadas para la barra de herramientas deben ser del mismo
tamao (XXx42 pixeles). Como se mencin anteriormente, cada curso puede
ser personalizado, el nico requisito es que las imgenes deben conservar el
mismo nombre. Estas imgenes (en su versin _off) tambin se utilizan en el
encabezado de la pgina inicial de cada una de de las herramientas. En la
siguiente tabla se presentan los nombres que deben tener las imgenes que
representarn cada una de las herramientas y las pginas donde se utilizan
como encabezado:
Herramienta
Ayuda
Calendario de eventos
Nombre de las
imgenes
Ayuda_on.gif
Ayuda_off.gif
Calendario_on.gif
Calendario_off.gif
Pgina donde se
utilizan
Titulo.aspx
/Cursox/Ayuda.htm
Titulo.aspx
Calendario.aspx
Pgina 22
Chat
Correo electrnico a tutores
Enlaces de Inters
Foro de discussion
Glosario
Inicio
Mi salon
Mis notas
Cerrar
Chat_on.gif
Chat_off.gif
Correo_on.gif
Correo_off.gif
Enlaces_on.gif
Enlaces_off.gif
Foro_on.gif
Foro_off.gif
Glosario_on.gif
Glosario_off.gif
Home_on.gif
Home_off.gif
Misalon_on.gif
Misalon_off.gif
Misnotas_on.gif
Misnotas_off.gif
Salir_on.gif
Salir_off.gif
Transcripciones_on.gif
Transcripciones_off.gif
Titulo.aspx
/Chat/Default.aspx
Titulo.aspx
Email2.aspx
Titulo.aspx
Links.aspx
Titulo.aspx
/Foro/Default.aspx
Titulo.aspx
Glosario.aspx
Titulo.aspx
Titulo.aspx
Misalon.aspx
Titulo.aspx
Misnotas.aspx
Titulo.aspx
Titulo.aspx
/chat/history.aspx
Tabla de contenido del curso

La pgina /cursos/menu.aspx despliega la tabla de contenido del curso y la
imagen de la esquina superior izquierda de la interfaz de los cursos, la cual est
compuesta por dos imgenes que se complementan, donde la imagen del lado
derecho puede cambiar para cada uno de los mdulos del curso. Estas
imgenes deben estar almacenadas en /cursos/cursox/images. La siguiente
tabla muestra un ejemplo y las caractersticas de las imgenes utilizadas.
Imagen
Nombres
Tamao
Izquierda:
10x166
pixeles
Imagen.jpg
Derecha:
Imagenx.jpg
Izquierda:
Imagen.jpg
Derecha:
Imagenx.jpg
10x166
pixeles
10x166
pixeles
10x166
pixeles
Comentario
La imagen del lado izquierdo
permanece fija para todos los
mdulos
La imagen de lado derecho puede
cambiar
al
seleccionar
determinado mdulo donde x es
un nmero consecutivo de la
cantidad de colores especificados
en la configuracin del curso
Pgina 23
Fotos de los usuarios

Las fotografas de los usuarios se almacenan en la carpeta /cursos/PhotoUsers/
y se deben tener las siguientes caractersticas
Foto
Tamao
Nombre
Utilizada en
misalon.aspx
120x160
pixeles
xxx.jpg
Default.aspx
Profile.aspx
Comentarios
El nombre que se asigna a
la fotografa (xxx.jpg), debe
ser el mismo que el
identificador asignado al
usuario al momento de
registrarlo
Imgenes del Foro

Las imgenes utilizadas en el foro se encuentran almacenadas en la
carpeta /cursos/foro/images. La siguiente tabla muestra las caractersticas
de dichas imgenes
Imagen Tamao en pxeles
15x13
16x13
7x5
12x16
17x17
17x17
Nombre
Pgina donde se utiliza
Folderclosed.gif
/foro/foro.aspx
Folderopend.gif
/foro/foro.aspx
Line.gif
/foro/foro.aspx
Post.gif
/foro/reply.aspx
Respuestas.gif
/foro/reply.aspx
Visto.gif
/foro/reply.aspx
Herramientas administrativas
En la carpeta /cursos/images/home/ se encuentran almacenadas las
imgenes utilizadas en la interfaz administrativa. La tabla siguiente
muestras sus caractersticas.
Imagen Tamao en pxeles
Nombre
33x35
Admin.jpg
33x35
Borrarcurso.jpg
Pgina 24
33x35
Calendario.jpg
33x35
Errors.jpg
33x35
Fileexplorer.jpg
33x35
Logs.jpg
33x35
Nuevocurso.jpg
33x35
Usuarios.jpg
Imgenes de uso general en las herramientas administrativas

La siguiente tabla muestra las imgenes que se utilizan en las pginas de las
herramientas administrativas y se encuentran almacenadas en el directorio
/cursos/images/
Imagen
Nombre
ActivadoN.gif
ActivadoS.gif
Calendar.gif
LinkN.gif
Indica/funcin
Imagen
Desactivar
curso/saln
Activar
curso/saln
Visualizar
calendario
Enlace
desactivado
Imagen
Indica/funcin
Monthleft.gif
Ir al mes anterior
Monthright.gif
Bt_edit.gif
Bt_eliminar.gif
Eliminar usuario
Eliminar
elemento
LinkS.gif
Enlace activado
Delete.gif
Copyfile.gif
Editar
elemento
Docpropieda
des.gif
Portafolio.
gif
Sends.gif
Lista
Actividades
realizadas
Enviar correo
electrnico
Ir al siguiente
ms
Asignar
privilegios
Stats.gif
Link.gif
Ver
propiedades
de un
documento
Estadsticas
de visitas de
usuario
Enlace de
inters
Pgina 25
Imgenes del chat

La siguiente tabla describe las imgenes utilizadas en el chat y sus
caractersticas, estas imgenes se encuentran almacenadas en la carpeta
/images/smiles y son desplegadas en las pginas /chat/Send.aspx y
/chat/Sendwin.aspx
Imagen Tamao en pixeles
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
15x15
Nombre
Smile0
Smile1
Smile10
Smile12
Smile13
Smile15
Smile17
Smile18
Smile2
Smile21
Smile22
Smile5
Smile6
Smile7
Smile8
Smile9
Imgenes del editor de archivos

El editor de archivos editor.aspx cuya utilidad es explicada en el manual de
usuario, utiliza imgenes almacenadas en la carpeta /images las cuales tienen
un tamao de XXx22 pixeles estas imgenes son:
Imagen
Nombre
Bgcolor.gif
Center.gif
DeIndent.gif
Editmode.gif
Herramientas.gi
f
Italic.gif
Locallink.gif
Right.gif
Under.gif
Imagen
Nombre
Imagen
Nombre
Bold.gif
Copy.gif
DirActual.gif
Explorer.gif
Bullist.gif
Cut.gif
docpropiedades.gif
Fgcolor.gif
Image.gif
Inindent.gif
Left.gif
Numlist.gif
Save.gif
Link.gif
Past.gif
Tables.gif
Pgina 26
Imgenes del explorador de archivos

El explorador de archivos cuya funcionalidad es descrita ampliamente en el
manual de usuario es desplegado en la pgina Browser.aspx y las imgenes
utilizadas en esta pgina son:
Imagen
Nombre
Home.gif
Imagen
Nombre
Up.gif
Imagen
Nombre
Directorios.gif
Newfile.gif
Delfile.gif
Copy.gif
UpLoad.gif
DirActual.gif
Folder.gif
View.gif
Dwnl.gif
En esta misma pgina se despliegan las imgenes de los programas con los
cuales esta asociado cada tipo de archivo, se encuentran almacenadas en el
directorio /images/ext estas imgenes son:
Imagen Nombre Imagen Nombre Imagen
asax.gif
asf.gif
aspx.gif
asx.gif
chm.gif
doc.gif
gif.gif
hlp.gif
html.gif
jpg.gif
mdb.gif
mov.gif
mpg.gif
pdf.gif
png.gif
ra.gif
swf.gif
Txt.gif
Wmv.gif
Xml.gif
Nombre
asp.gif
cd.gif
fla.gif
htm.gif
link.gif
Mp3.gif
pdg.gif
ram.gif
Wdl.gif
Zip.gif
Pgina 27
Procesos de Mantenimiento
Manejo de excepciones
Los mensajes de los errores que pueden ocurrir de manera global durante las
transacciones entre el cliente y el servidor pueden ser previamente definidos
en el archivo global.asax.
Al momento de ser interceptado uno de estos errores se despliega un
mensaje de error en la interfaz de usuario, el error es almacenado en la tabla
errors y automticamente es enviado un e-mail al administrador de la
plataforma informndole que ha ocurrido un error, para que tome las medidas
correspondientes.
La siguiente tabla muestra los tres errores ms comunes que pueden
presentase, as como la pgina que presenta el mensaje al usuario al
momento de ocurrir el error
Error
Pgina
403
/
public/403.html
404
500
/
public/404.html
/
public/500.html
Descripcin
Cuando el usuario trata de acceder a alguno de los
recursos
para los cuales es necesario estar
registrado y no lo est.
Cuando se pretende acceder a una pgina que no
existe o que ha cambiado de lugar
Cuando se genera un error y lo reporta al
administrador
Polticas de respaldo sugeridas

En la plataforma educativa al igual que en todos los sistemas de informacin,
es muy importante contar con respaldos de la informacin ya que en
cualquier momento pueden ocurrir fallas tanto en el hardware como en el
software. El contar con respaldos, permite en caso de fallas reestablecer
rpidamente el servicio.
Se recomienda que se consideren las siguientes polticas de respaldo:
1. Contar con una bitcora de respaldos que nos permita saber en todo
momento que informacin podemos recuperar en forma inmediata y que
cantidad de informacin es la que se ha perdido.
2. Tener un servidor de Backup el cual permita en caso de que falle el
servidor de produccin reestablecer el servicio de forma inmediata.
3. Guardar una copia de los respaldos de la informacin en un edificio
diferente a donde se encuentra el servidor de produccin, para que en el
Pgina 28
4. caso de ocurrir un desastre natural tener forma de recuperar la

informacin.
5. Se recomienda respaldar la informacin relativa a un cursox cada vez que
se hagan modificaciones mayores.
6. Las bases de datos de usuarios deben respaldarse peridicamente
dependiendo de la cantidad y volatilidad de usuarios.
Polticas de recuperacin sugeridas

El proceso de recuperacin de informacin es aquel que permite reestablecer
los servicios del sistema en caso de que ocurra alguna falla, utilizando los
respaldos que previamente se haban realizado.
La recuperacin completa del sistema solo es recomendable cuando ocurren
fallas mayores tales como daos fsicos al servidor, al sistema operativo, a
los dispositivos de almacenamiento a las bases de datos, etc.
No obstante que las organizaciones tienen sus propias polticas de respaldo
y recuperacin, se recomienda realizar peridicamente pruebas de
recuperacin de la informacin utilizando los respaldos, para probar que
efectivamente se esta preparado en caso de que falle el sistema.
Polticas de respaldo y recuperacin en los servidores de la OEA

Respaldo diario
El sistema de respaldo de los servidores de la OEA esta diseado para
garantizar que la informacin almacenada mas recientemente pueda ser
recuperada en forma rpida, segura y eficiente en caso de fallas.
El procedimiento para respaldar servidores Windows es el siguiente:
1. Para cada servidor se utilizan 12 cintas de respaldo
2. Las primeras cuatro cintas son utilizadas para respaldos de incremento, el
cual se realiza los primeros cuatro das de la semana (lunes jueves),
cada una de estas cintas se reusa la siguiente semana.
3. Las ocho cintas restantes son utilizadas los viernes para hacer un
respaldo completo semanal del disco duro. En la novena semana la
primera cinta es reusada.
Una vez por semana un conjunto de cintas es tomado del cuarto de servidores y
llevado al edificio administrativo para guardarlo.
Pgina 29
En caso de que falle alguno de los servidores se utilizan las cintas de respaldo
para recuperar la informacin y reestablecer los servicios.
Respaldo histrico de los servidores de la OEA
Este tipo de respaldo es realizado con la finalidad de asegurar que toda la
informacin almacenada en el servidor durante el ao pueda ser consultada o
recuperada por los analistas en caso de ser necesario.
El procedimiento utilizado para realizar el respaldo es el siguiente:
1. Cada servidor tiene 20 cintas de respaldo
2. Los respaldos para el historial son realizados dos veces al ao, por lo
tanto las 20 cintas representan 10 aos de informacin. El primer
respaldo se realiza el 31 de junio y respalda la informacin del 1 de
enero al 31 de junio y la siguiente cinta se utiliza el 31 de diciembre para
guardar la informacin generada entre el 1 de julio y el 31 de diciembre.
Respaldo de servidores de bases de datos de la IACD

Adems de utilizar los procedimientos descritos anteriormente, para el caso
especifico de las bases datos del portal educativo y la plataforma educativa se
tiene un servidor de respaldo, el cual puede reemplazar al servidor de
produccin (servidor que actualmente contiene el portal educativo) en forma
instantnea en caso de alguna falla.
El servidor utilizado como respaldo es OASPORTAL2 y realiza respaldos de las
transacciones realizadas en la base de datos cada 2 minutos, para ello utiliza un
proceso de respaldo automtico de las bases de datos y transacciones del
servidor de produccin SQL, dicho proceso es conocido como Log Shiping, el
cual es parte de Microsoft SQL Server. Este proceso mantiene sincronizados al
servidor de produccin y al de respaldo, de tal forma que si ocurre una falla en el
servidor de produccin lo nico que debe hacerse es sustituirlo por el servidor
de respaldo y en el peor de los caso al ocurrir una falla solo se habr perdido la
informacin de los ltimos dos minutos.
Procedimiento de modificaciones mayores al sistema

Cada vez que se realicen modificaciones al sistema por mnimas que estas sean
deben ser documentadas, es decir deben registrarse en la bitcora de cambios
realizados y tambin esos cambios deben ser realizados en el manual tcnico de
tal forma que siempre refleje el estado actual del sistema. Es importante que
Pgina 30
antes de realizar cualquier modificacin al sistema el programador este

completamente familiarizado con su estructura y se realicen pruebas del
sistema antes de subirlo al servidor de produccin.
Existen dos modificaciones principales que pueden requerirse a futuro: agregar
nuevos idiomas a la interfaz de la plataforma y utilizar un servidor de bases de
datos diferente a Microsoft SQL Server.
1. Actualmente la plataforma solo tiene la interfaz en ingles y en espaol,
para agregar nuevos idiomas es necesario agregar la traduccin de todas
las etiquetas utilizadas en la tabla traducciones y modificar el archivo
/bin/madc.vb para que soporte nuevos tipos de idiomas, ya que por el
momento solo soporta los tipos es=espaol, en=ingls, fr=francs y
pt=portugus.
2. Para utilizar otro servidor de bases que reemplase al MSQL debe
cambiarse la cadena de conexin de la base de datos y el driver
manejador de la base de datos, as mismo deben modificarse los store
procedures de acuerdo a la sintaxis utilizado por el nuevo servidor.
Polticas y procesos de mantenimiento sugeridas

En la plataforma podemos distinguir dos tipos de mantenimiento, uno es
referente a la administracin de los cursos y usuarios y el otro referente a la
administracin del servidor de bases de datos.
Mantenimiento de cursos
Actualmente la persona responsable de cada uno de los cursos puede darle
mantenimiento a sus contenido y actividades, algunas de las tareas mas
comunes son: modificar la estructura del curso agregando temas y subtemas,
definir actividades, generar examenes, crear nuevos chats y foros de
discusin, puede agregar editar o eliminar trminos en el glosario o sitios de
inters, modificar el calendario de eventos, etc.
Es recomendable que al trmino de cada uno de los cursos que se imparten
se depure la base de datos para eliminar cualquier tipo de informacin que ya
no ser requerida en el futuro. Para cada curso puede ser necesario
modificar o actualizar los contenidos de acuerdo a los nuevos
descubrimientos sobre el tema o a la retroalimentacin recibida por los
alumnos al final de cada curso, por lo general en este cas el encargado de
Pgina 31
darle mantenimiento al contenido del curso ser la persona responsable del

mismo.
Por ltimo es recomendable considerar utilizar informacin generada o
recopilada a lo largo del curso como material didctico de apoyo para las
siguientes veces que se ofrezca el curso.
Pgina 32
Mantenimiento del servidor y las de bases de datos

A las bases de datos tambin es necesario darles mantenimiento para asegurar
su optima funcionalidad algunas de las tareas mas comunes de mencionan a
continuacin:
Reorganizar y reconstruir ndices

Compresin de archivos de datos
Actualizacin de estadsticas e ndices
Revisiones internas de consistencia de datos
Respaldos de bases de datos y archivos
Actualmente el administrador de la plataforma es el nico que debe tener los

privilegios para realizar tareas especficas como son:
Crear nuevos cursos y eliminar los no deseados

Crear y eliminar salones
Dar de alta usuarios y asignarles o modificarles los privilegios
Instalacin de componentes o agregar nuevos mdulos a la plataforma
Mantener y monitorear las bitcoras
Establecer y configurar las pginas de error que se presentan en la
interfaz de usuarios
Manipular los contenidos directamente desde la consola del servidor de
base de datos
Pgina 33

Reporte Tecnico

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Reporte Tecnico

Uploaded by

Copyright:

Available Formats

Versin 12/Dic/2002

Diciembre 03, 2015- Versin 1.0

Las siguientes tablas describen brevemente estos mdulos, para una

Permite al usuario acceder a las

Diciembre 03, 2015- Versin 1.0

Muestra un listado ordenado de los clientes registrados en el

En este manual se describen los requerimientos de hardware (servidores y

Diciembre 03, 2015- Versin 1.0

Dispositivo Android JellyBean 4.0 o superior

Proceso de Instalacin de la aplicacin

Diciembre 03, 2015- Versin 1.0

Software utilizado para el desarrollo

Diciembre 03, 2015- Versin 1.0

Modelo orientado al cliente

La Arquitectura de la aplicacin est compuesta por dos grandes aspectos

Diciembre 03, 2015- Versin 1.0

Estructura de directorios de la plataforma

Diciembre 03, 2015- Versin 1.0

La siguiente tabla describe los archivos que se encuentran almacenados en

Diciembre 03, 2015- Versin 1.0

Universidad de Colima, 2015.

Diciembre 03, 2015- Versin 1.0

Area de usuarios activos en el chat

Contiene imgenes utilizadas para identificar

Diciembre 03, 2015- Versin 1.0

Contiene las imgenes utilizadas en la pgina de

Contiene los archivos de las imgenes utilizadas

Diciembre 03, 2015- Versin 1.0

Diciembre 03, 2015- Versin 1.0

Diciembre 03, 2015- Versin 1.0

Universidad de Colima, 2015.

Diciembre 03, 2015- Versin 1.0

Descripcin de campos de cada tabla

Identificador del evento registrado

Lista de actividades para cada curso

Resultados de las Actividades evaluadas

Identificador del resultado

administradores Lista de administradores y privilegios

Informacin de los alumnos registrados

Calendario de eventos para cada curso

Identificador del calendario

Diciembre 03, 2015- Versin 1.0

Identificador del catlogo

Identificador del mensaje

Configuracin de colores del curso

Descripcin del evento

Propiedades de los usuarios actuales en un chat

Transcripciones del chat

Catlogo de tipos de categoras de cursos

Cursos y sus propiedades

Identificador del curso

Diciembre 03, 2015- Versin 1.0

Indica si estar activa la herramienta

Respuestas de los usuarios a los exmenes

Diciembre 03, 2015- Versin 1.0

Lista de usuarios que han realizado un examen

Clave automtica asignada a los

Posts hechos al foro

Identificador del post

Lista de enlaces y documentos (materiales)

Universidad de Colima, 2015.

Diciembre 03, 2015- Versin 1.0

Identificador del enlace

Almacena las notas de los usuarios