Servidor de Peticiones

 

            El comando /RUN=SERVIDOR[:instancia] ejecuta el sistema en modo servidor, donde distintos servicios pueden ejecutarse. Una instancia es la ejecución del sistema en modo servidor en una máquina determinada. Diferentes instancias pueden ejecutarse en la misma o diferente máquina, pero una misma instancia solo puede ser ejecutada una vez. Para configurar instancias, se ingresa en Herramientas -> Servidor -> Instancias y se crea una o mas instancias. Si no se incluye nombre de instancia, se toma la DEFECTO. En la instancia puede indicarse la máquina en la que se ejecuta (se impide su ejecución en otras) y el usuario con el cual se loguea automáticamente el sistema. Este usuario debe ser Supervisor o al menos tener permiso sobre "Comando /RUN"

 

            Al ejecutar el sistema con /RUN=SERVIDOR, el sistema se minimiza a un ícono al lado de la hora. Con botón derecho sobre ese ícono ofrece activar o cerrar. Al darle cerrar, se cierra esa instancia del servidor de peticiones. Si se ofrece activar, se puede cerrar manualmente con la tecla Suprimir. Puede ejecutarse el servidor de peticiones en cualquier máquina que tenga acceso al sistema, no es necesario ni recomendable por razones de seguridad que sea el propio servidor Web.

 

            Se recomienda programar el servidor de peticiones en un tarea programada de Windows que se lanze cada 5 o 10 minutos. Si la instancia está activa, la nueva instancia se cierra automáticamente. Si la instancia está activa pero colgada, sin responder, la cierra y activa la nueva instancia. Esto permite asegurar de que la instancia va a correr en todas las circunstanacias, porque si se bajó la instancia a causa de una actualización del sistema, un error, un mantenimiento de la base, etc, en 5 o 10 minutos se recupera automáticamente.

 

            Uno de estos servicios que atiende el servidor es el servicio de Peticiones Web, donde atiende peticiones cargadas a la tabla PETICIONESSERVIDOR. El objetivo de este comando es atender requerimientos de programas externos, tales como un servidor Web, ejecutando comandos y devolviendo datos en formato XML. La elección de utilizar una tabla SQL y el formato XML fue tomada para mantener la máxima compatibilidad y velocidad en la interfaz, ya que virtualmente todo lenguaje de programación en cualquier S.O. (Linux, Windows) tienen mecanismos para consultar e insertar datos en tablas SQL. Si se emplearan otros mecanismos, tales como OLE o Servicios Web, sería incompatible con lenguajes fuera de Windows en el primer caso o que no tengan un soporte nativo de http y sockets en el segundo. Por otro lado, los tiempos de respuesta son mucho mas rápidos que en cualquiera de los otros mecanismos, por cuanto un servidor SQL es el producto de años de desarrollo buscando la máxima perfomance en las consultas y respuestas.

 

            La tabla PETICIONESERVIDOR tiene los siguientes campos:

 

Campo

SQL Server

Descripción

PETICION

Int

Código de Petición. Pueden consultarse los distintos códigos en Herramientas->Servidor->Tipos de Peticiones

INSTANCIA

VarChar(20)

Nombre de Instancia que se desea que procese al petición. Si se deja en blanco lo procesa cualquier instancia. Luego de procesada se graba el nombre de la instancia que la procesó.

IDPETICIÓN

Int identity

Código interno. No debe insertarse en la tabla SQL. Puede utilizarse para identificar la petición si el lenguaje del cliente de la petición. tiene forma de obtener la última identidad insertada

IDEXTERNA

VarChar(20)

Código externo, puede obviarse, pero normalmente se utiliza para identificar la petición

ESTADO

TinyInt

Los valores posibles son 0=En espera, 1= Procesando, 2= Procesamiento completado exitosamente, 3= Procesado con error. STATUSSALIDA contiene la cadena de error

STATUSSALIDA

Text

Cadena de descripción del error, si ESTADO=3. En ciertas peticiones, si está antecedido de la palabra WARNING: se indica que la petición se llevó a cabo pero hubieron problemas

FECHA

Datetime

Es utilizado por el servidor para indicar la hora de comienzo del procesamiento de la petición

PARAMETRO1

Text

Parámetro de entrada en formato XML. Todos los campos indicados en cada petición deben estar presentes, aunque no sean necesarios. Si el campo es numérico y de una sola cifra, agréguese 0 delante de manera de poner dos cifras (00), porque los valores 0 y 1 son traducidos en XML como Logical y producen un error de Parámetro inválido.

PARAMETRO2

Text

Si existe, es un parámetro de salida en formato XML

PARAMETRO3

Text

Si existe, es un parámetro de salida en formato XML

 

 

            El proceso cliente que desee efectuar una petición debe insertar un registro en esta tabla, cargando los campos PETICION, ESTADO=0, IDEXTERNA y PARAMETRO1 e ingresar entonces en un loop de espera testeando el estado de la petición hasta que se haga 2 o 3. Ejemplo

 

INSERT INTO PETICIONESSERVIDOR(PETICION, ESTADO, IDEXTERNA, PARAMETRO1) VALUES      (300,0,”test”,"<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?> <VFPData> <_parametro1> <legajo>48544</legajo> <dni>25459658</dni> <password>1526</password> <tipologueo>02</tipologueo> </_parametro1></VFPData>")

 

_tiempo=seconds()+10   /* <------ Tomando un timeout razonable

do while seconds()<_tiempo

    SELECT * FROM PETICIONESSERVIDOR WHERE IDEXTERNA=”test”

    IF ESTADO>1

       …. Procesando la petición

       EXIT

    END

   WAIT(0.2)     /* <----- Esperando un tiempo razonable para no sobrecargar el servidor

END

.... procesando el timeout

 

            Una vez procesada la petición puede optarse por borrarla o dejarla en la tabla como una auditoria de todas las peticiones procesadas.

 

Ejemplos XML de parámetros para distintas peticiones:

 

            Los siguientes ejemplos muestran ejemplos de XML de parámetros. Recuérdese cargar ESTADO=0 en todas ellas y solo el PARAMETRO1. Los parámetros 2 y 3 muestran ejemplos de respuesta.

 

 

PET

PARAMETRO1

PARAMETRO2

PARAMETRO3

100

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><peticion>

<anoacademico>2002</anoacademico>

<especialidad>05</especialidad>

<plan>95</plan>

<materia>228</materia>

<comision>08</comision>

<directorio>n:\bajar</directorio>

</peticion></VFPData>

 

 

101

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><peticion>

<archivo>n:\subir\Notas comision 2002-5-95-228-8.xls</archivo>

</peticion></VFPData>

 

 

200

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData>

<_parametro1>

<legajo>42152</legajo>

<especialidad>24</especialidad>

<plan>95</plan>

<materia>309</materia>

<mesaespecial>00</mesaespecial>

<tribunal>00</tribunal>

<horario>01</horario>

<fecha>0000-00-00</fecha>

<turno>10</turno>

</_parametro1></VFPData>

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro2>

<checksum>16MWIF</checksum>

<fecha>2002-12-05</fecha>

<horarioteorico>0:00</horarioteorico>

<horariopractico>0:00</horariopractico>

<aula>301</aula>

<inscripto>jueves 5 de diciembre - Mañana</inscripto>

</_parametro2></VFPData>

 

202

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><peticion>

<legajo>42152</legajo>

<mesaespecial>00</mesaespecial>

</peticion></VFPData>

 

 

203

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro1>

<legajo>42152</legajo>

<especialidad>24</especialidad>

<plan>95</plan>

<materia>343</materia>

<mesaespecial>00</mesaespecial>

<fecha>0000-00-00</fecha>

</_parametro1></VFPData>

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro2>

<fecha>2002-12-06</fecha>

<tribunal>0</tribunal>

<nombre/>

<mañana>1</mañana>

<tarde/>

<noche/>

<turno>10</turno>

</_parametro2></VFPData>

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro3>

<condicion>No aprobó Física II</condicion>

</_parametro3></VFPData>

300

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro1>

<legajo>42152</legajo>

<dni>24510422</dni>

<tipologueo>02</tipologueo>

<password>pepe<password/>

</_parametro1></VFPData>

<?xml version = "1.0" encoding="Windows-1252" standalone="yes"?>

<VFPData><_parametro2>

<nuevo/>

<nombre>Oviedo, Pablo Sebastian</nombre>

<especialidad>Ingeniería Industrial</especialidad>

<plan>95</plan>

</_parametro2></VFPData>

 

 

Peticiones soportadas

T. Pet. Nombre Petición Ayuda
1 Consulta de instancias de servidor

Devuelve las instancias que actualmente están corriendo el servidor de peticiones. Estos datos se refrescan cada un minuto aproximandamente.

ENTRADA

Parámetro 1:
ACTIVAS: Si se indica 1, se devuelven solo las instancias activas actualmente. Si se indica 0 se devuelven todas las instancias registradas en Kermet\Servidor\Instancias del registro del sistema.


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.

INSTANCIA: Nombre de la instancia
FECHACARGA: Fecha y hora cuando se cargó por última vez esta instancia.
EJECUCIONES: Cantidad de veces que se cargó esta instancia.
FECHAACTIVA: Fecha y hora en la cual estuvo activa por última vez.
MAQUINA: Máquina donde se la invocó por última vez.
SERVICIO: Lista de peticiones que atiende la instancia, si se le aplica alguna restricción.
PETICIONES: Cantidad de peticiones que atendió desde su última carga

Parámetro 3: Es un cursor con múltiples registros. Contiene la estadística de peticiones de cada instancia. Esta estadística es histórica y no se resetea por cada carga de la instancia.

INSTANCIA: Nombre de la instancia
PETICION: Número de petición
NOMBRE: Nombre de la petición
TRANSACCIONES: Cantidad de veces que se ejecutó esta petición en la instancia.
PROMEDIO: Promedio en segundos del tiempo de ejecución de la instancia.

2 NOP Operación para determinar si el servidor de peticiones (o una determinada instancia a través del campo INSTANCIA) se encuentra activa. No hace nada, simplemente pasa el estado a 2.
3 Cargar nueva instancia

Carga en la máquina donde se ejecuta esta petición, una nueva instancia, ejecutada con el mismo usuario que el de la instancia que resuelve esta petición. Puede utilizarse el campo INSTANCIA de la petición para seleccionar cual instancia se quiere que ejecute esta petición, y por ende, en que máquina se quiere levantar la nueva instancia.

ENTRADA

Parámetro 1:
INSTANCIA: Nuevo nombre de instancia
PETICIONES: Lista de peticiones que se quiere que atienda la nueva instancia. Si no se indica nada se atienden todas las peticiones

4 Cerrar instancia Esta petición cierra y finaliza la instancia indicada en el campo INSTANCIA, el cual debe usarse obligatoriamente
100 Exportación planilla Excel comisión

Exporta las notas de parciales de una comisión a Excel.

ENTRADA:
Parámetro 1:
ANOACADEMICO: El año académico de la comisión a exportar
ESPECIALIDAD: Especialidad de la comisión a exportar
PLAN: Plan de la comisión a exportar
MATERIA: Código de Materia de la comisión a exportar
COMISION: Comisión a Exportar
DIRECTORIO: El directorio a donde va a parar la planilla.

101 Importación planilla Excel comisión

Importa una planilla de Excel con notas de una comisión

ENTRADA:

Parámetro 1:

ARCHIVO: Nombre completo del archivo Excel.

102 Consulta de notas comisión

Devuelve un cursor con las notas de la comisión solicitada

ENTRADA:
Parámetro 1:
ANOACADEMICO: El año académico de la comisión
ESPECIALIDAD: Especialidad de la comisión
PLAN: Plan de la comisión
MATERIA: Código de Materia
COMISION: Comisión de la materia
Optativa
LEGAJO: Legajo del docente para cargar el horario personalizado y para buscar las modificaciones que haya hecho el mismo

SALIDA
Parámetro2
LEGAJO: Legajo del alumno
NOMBRE: Apellido y nombre del alumno. Si está modificado y no confirmado, se le agrega (*)
NOTA1: Notas del alumno
NOTA2
NOTA3
NOTA4
NOTA5
NOTA6
NOTA7
NOTA8
NOTA9
NOTA10
NOTAFINAL: Nota final
ESTADOACADEMICO: Estado académico
ESTADOASISTENCIA: Estado de asistencia


Parámetro3
CHECKSUM: Código de seguridad
HORARIOS: Horarios de dictado
AULA: Aula de dictado
BEDEL: Nombre del bedel asignado a la comisión.
ALUMNOS: Cantidad total de alumnos de la comisión.
VERIFICADA: S si fue marcada como verificada o no se puede regularizar el año academico
NOTA1; Descripciones de las Notas.
NOTA2
NOTA3
NOTA4
NOTA5
NOTA6
NOTA7
NOTA8
NOTA9
ABREV1: Abreviaturas de las notas (Ej P1,R1, etc.)
ABREV1
ABREV2
ABREV3
ABREV4
ABREV5
ABREV6
ABREV7
ABREV8
ABREV9
ABREV10

103 Consulta de Correlatividad

Consulta la correlatividad de la materia indicada, devolviendo todas las reglas que la afectan de la Universidad o de la Facultad según como esté configurado el plan respectivo.


ENTRADA

Parámetro 1:

ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de materia
TIPO: 01 = Correlatividad para cursar, 02 = Correlatividad para rendir, 03 = Equivalencia.

SALIDA:

Parámetro 2: (Pueden ser varios registros)

TIPORESOLUCION: "R" = Resolución, "O" = Ordenanza
AÑORESOLUCION: Año de la resolución
NUMERORESOLUCION: Número de la resolución
ALCANCE: Alcance de la regla
CONDICION: Condición a cumplir

104 Consulta Correlatividad Plan

Consulta la correlatividad de todas las materias del plan indicado, devolviendo todas las reglas que la afectan de la Universidad o de la Facultad según como esté configurado el plan respectivo.


ENTRADA

Parámetro 1:

ESPECIALIDAD: Especialidad a buscar
PLAN: Plan a buscar
TIPO: 01 = Correlatividad para cursar, 02 = Correlatividad para rendir, 03 = Equivalencia.

SALIDA:

Parámetro 2: (Múltiples registros)

CODIGO: Código de la materia
MATERIA: Nombre de la materia
TIPORESOLUCION: "R" = Resolución, "O" = Ordenanza
AÑORESOLUCION: Año de la resolución
NUMERORESOLUCION: Número de la resolución
ALCANCE: Alcance de la regla
CONDICION: Condición a cumplir

105 Consulta Materias del Plan

Consulta las materias del plan indicado, según se cursen o rindan


ENTRADA

Parámetro 1:

ESPECIALIDAD: Especialidad a buscar
PLAN: Plan a buscar

SALIDA:

Parámetro 2: (Múltiples registros)

MATERIA: Código de la materia
AÑO: Año de dictado de la materia
CUATRIMESTRE: Cuatrimestre de dictado de la materia
NOMBRE: Nombre de la materia
SECURSA: Indica si se cursa la materia
SERINDE: Indica si se rinde la materia

106 Carga de notas comisión

Carga la nota o condición indicada a los alumnos indicados en la tabla de notas temporal, y devuelve el mismo resultado de la petición 102. Solo pueden pasarse alumnos perteneciente a una única comisión.

ENTRADA:
Parámetro 1: (Múltiples registros)
LEGAJO: Legajo del docente que carga la nota. Debe pertenecer a la comisión
LEGAJOALUMNO: Legajo del alumno
ANOACADEMICO: El año académico de la comisión
ESPECIALIDAD: Especialidad de la comisión
PLAN: Plan de la comisión
MATERIA: Código de Materia
COMISION: Comisión de la materia.
TIPONOTA: Puede ser 1..10=Nota1..10, 51=Estado Académico, 52=Nota final
NOTA: Valor de la nota modificada

SALIDA
Parámetro2
LEGAJO: Legajo del alumno
NOMBRE: Apellido y nombre del alumno. Si está modificado y no confirmado, se le agrega (*)
NOTA1: Notas del alumno
NOTA2
NOTA3
NOTA4
NOTA5
NOTA6
NOTA7
NOTA8
NOTA9
NOTA10
NOTAFINAL: Nota final
ESTADOACADEMICO: Estado académico
ESTADOASISTENCIA: Estado de asistencia


Parámetro3
CHECKSUM: Código de seguridad
HORARIOS: Horarios de dictado
AULA: Aula de dictado
BEDEL: Nombre del bedel asignado a la comisión.
ALUMNOS: Cantidad total de alumnos de la comisión.
VERIFICADA: S si fue marcada como verificada o no se puede regularizar el año acad.
NOTA1; Descripciones de las Notas.
NOTA2
NOTA3
NOTA4
NOTA5
NOTA6
NOTA7
NOTA8
NOTA9
ABREV1: Abreviaturas de las notas (Ej P1,R1, etc.)
ABREV1
ABREV2
ABREV3
ABREV4
ABREV5
ABREV6
ABREV7
ABREV8
ABREV9
ABREV10

200 Inscribir a Examen

Inscribe a examen al alumno en la materia, turno, horario y tribunal indicado. Esta función verifica el permisos "Inscripción a examen". Solo se verifican los parámetros de turno y horario. No se verifica si el alumno está inhabilitado para inscribirse por otra razón. Para esto utilice la petición 202 y/o 203.

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a inscribir
PLAN: Plan de la materia a inscribir
MATERIA: Código de materia a inscribir
TURNO: Turno a inscribir. 0 para mesa especial
FECHA: Fecha a inscribir mesa especial. Puede omitirse para turno común
TRIBUNAL: Tribunal a inscribir
HORARIO: Horario a inscribir (1 Mañana, 2 Tarde, 3 Noche)

SALIDA:

Parámetro 2:
CHECKSUM: El código de seguridad de la inscripción
FECHA: Fecha del examen. Puede ser en blanco si es a confirmar
HORARIOTEORICO: Horario de teórico
HORARIOPRACTICO: Horario de práctico
AULA: Aula y edificio del examen
INSCRIPTO: Leyenda de la inscripción, similar a la petición 202

201 Eliminar Inscripción a Examen

Borra una inscripción a examen del alumno en la materia y turno indicado. Esta función verifica el permiso "Inscripción a examen'".

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a borrar
PLAN: Plan de la materia a borrar
MATERIA: Código de materia a borrar
TURNO: Turno a borrar. 0 para mesa especial
FECHA: Fecha de mesa especial a borrar. Puede omitirse para turno común

202 Materias Inscripción a Examen

Devuelve las materias que el alumno puede inscribirse a examen. Se controlan los mismos parametros que en el sistema normal y se devuelven las mismas materias. Esta función verifica el permiso "Inscripción a examen"

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
MESAESPECIAL: 01 si se desea inscripción a mesa especial


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
AÑO: Año de la materia
NOMBRE: Nombre de la materia. Si tiene nombre web devuelve ese.
NOMBRELARGO: Nombre de la materia (siempre el largo, aunque tenga web)
INSCRIPTO: Cadena que describe la inscripción actual, si existe.
FECHA: Fecha de examen.
HORARIOTEORICO: Hora teórico
HORARIOPRACTICO: Hora Práctico.
TRIBUNAL: Codigo de tribunal
NOMBRETRIBUNAL: Nombre del tribunal y terna (según preferencia)
EDIFICIO: Nombre del edificio y número de aula
CHECKSUM: Código de seguridad de la inscripción
HORARIO: Horario de inscripción (1=Mañana, 2=Tarde, 3=Noche)
IMPRESO: 'S' si ya fué impreso y no puede ser borrado sin permiso especial
AUDITORIA: Fecha y operador en la que fué ingresada la inscripción.

203 Fechas de inscripción a examen

Devuelve las distintas fechas, horarios y tribunales que un alumno puede inscribirse a una determinada materia, controlando la correlatividad. Si existen violaciones de correlatividad pero el alumno puede inscribirse condicional y se tiene permiso, esto se indica en el parámetro 3. En caso contrario se devuelve un error. Esta función controla los permisos "Inscripción a Exámen" e "Insc. Condicional Examen"

ENTRADA:
Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a inscribir
PLAN: Plan de la materia a inscribir
MATERIA: Código de materia a inscribir
MESAESPECIAL: 01 si se desea inscripción a mesa especial
FECHA: Fecha a inscribir mesa especial. Puede omitirse para turno común


SALIDA:
Parámetro 2:
FECHA: Fecha de la inscripción. Puede ser en blanco si es a confirmar
TRIBUNAL: Código del tribunal
NOMBRE: Nombre del tribunal
MAÑANA: =0 Si no se inscribe. =1 Si se puede inscribir en este turno
TARDE: =0 Si no se inscribe. =1 Si se puede inscribir en este turno
NOCHE: =0 Si no se inscribe. =1 Si se puede inscribir en este turno
TURNO: Código de turno

Parámetro 3:
CONDICION: Condición de correlatividad, en caso de poder inscribirse condicional

204 Impresión de inscripciones

Similar a la petición 202, pero devuelve solo las materias inscriptas, y además las marca como impresas. Esto implica que si se otorga el permiso de borrar inscripción impresa solo los usuarios con dicho permiso pueden borrar la inscripción.

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
MESAESPECIAL: 1 si se desea inscripción a mesa especial


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
AÑO: Año de la materia
NOMBRE: Nombre de la materia
INSCRIPTO: Cadena que describe la inscripción actual, si existe.
FECHA: Fecha de examen.
HORARIOTEORICO: Hora teórico
HORARIOPRACTICO: Hora Práctico.
TRIBUNAL: Nombre del tribunal y terna (según preferencia)
EDIFICIO: Nombre del edificio y número de aula
CHECKSUM: Código de seguridad de la inscripción
HORARIO: Horario de inscripción (1=Mañana, 2=Tarde, 3=Noche)
IMPRESO: Siempre 'S'
AUDITORIA: Fecha y operador en la que fué ingresada la inscripción.

205 Consulta de alumnos para examen

Devuelve la fecha y cantidad de alumnos inscriptos a examen en una materia. Solo se devuelven registros que tienen al menos un alumno

ENTRADA

Parámetro 1:
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia

SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
TRIBUNAL: Nombre del tribunal y terna
FECHA: Fecha de examen.
HORARIO: Horario de inscripción (1=Mañana, 2=Tarde, 3=Noche)
ALUMNOS: Cantidad de alumnos inscriptos.

206 Exámenes del alumno

Consulta todos los exámenes de un alumno


ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno

SALIDA:

Parámetro 2:
FECHA: Fecha de la materia
NOMBRE: Nombre de la materia
NOTA: Nota del examen (en formato caracter, con palabras en caso de notas no nominales, Ej. Ausente, Aprobado, etc.)
ESPECIALIDAD: Especialidad de la materia
ABREVIATURAESPECIALIDAD: Abreviatura de la especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia

300 Logueo Alumno

Verifica las credenciales de un alumno, y retorna un error si no se puede verificar. El password es el mismo de Autogestión, y puede resetearse manualmente desde Alumnos

ENTRADA

Parámetro 1:

LEGAJO: Legajo del alumno
DNI: Número de documento del Alumno.
PASSWORD: Password del alumno
NUEVOPASSWORD: (Solo exigido para TIPOLOGUEO=05): Nuevo password.
TIPOLOGUEO: =01 Compara los tres campos y retorna error si no son iguales. =02 Compara los tres campos, pero si el alumno nunca se logueó le setea el password y no retorna error, pero indica en NUEVO=1 de la salida esta situación para dar un mensaje al respecto. =03 Verifica solo legajo y password. =04 Verifica solo DNI y password. =05 Cambio de password. Verifica DNI y password anterior

Por seguridad se elimina los password del parámetro1 una vez procesada esta petición, a fin de que no queden registros de los password de alumnos que pudieran ser objetivo de hackeo.

SALIDA

Parámetro 2:

NUEVO: =1 si la primera vez que el alumno se loguea. Este parámetro está disponible incluso en caso de error de logueo, para poder utilizar la opción TIPOLOGUEO=2. =2 si el alumno se debe logueó correctamente pero se debe cambiar el password del mismo. Esto puede suceder porque se loguea con el DNI (si se setea la preferencia "Permite utilizar DNI como Password") o porque se cambió el password desde el sistema y se exige el cambio ("Obliga a cambiar pass. seteados desde el sistema"=SI)
NOMBRE: Apellido y nombre del alumno.
CODESPECIALIDAD: Código de la especialidad del alumno.
ESPECIALIDAD: Nombre de la Especialidad del alumno.
DNI: DNI del alumno.
PLAN: Plan del alumno.
BUILD: Build del SYSACAD.
MENSAJES: Indica la cantidad de mensajes que tiene desde la última vez que los revisó.
PERMITEINSCRIPCIONEXAMEN: Devuelve S si está habilitada la preferencia indicada en Archivo->Supervisión->Autogestión.
PERMITEINSCRIPCIONCURSADO: Devuelve S si está habilitada la preferencia indicada en Archivo->Supervisión->Autogestión.
PERMITECAMBIODEPASSWORD: Devuelve S si está habilitada la preferencia indicada en Archivo->Supervisión->Autogestión.

Parámetro 3:
Múltiples registros con encuestas activas:

ENCUESTA: Número de encuesta
NOMBRE: Nombre de la encuestas
FECHA: Fecha límite para contestar la encuesta

302 Logueo Docente

Verifica el legajo y password de un docente, y retorna un error si no se puede verificar. Como el password está en Personas, es el mismo que el del registro de alumno para aquellos docentes que son alumnos. Puede cambiarse desde Docentes, pero se exige volver a cambiarlo al ingresar al Syscad Web.

ENTRADA

Parámetro 1:

LEGAJO: Legajo docente
PASSWORD: Password del docente
NUEVOPASSWORD: (Solo exigido para TIPOLOGUEO=05): Nuevo password.
TIPOLOGUEO: =03 Verifica solo legajo y password. =05 Cambio de password. Verifica DNI y password anterior

Por seguridad se elimina los password del parámetro1 una vez procesada esta petición, a fin de que no queden registros de los password de docente que pudieran ser objetivo de hackeo.

SALIDA

Parámetro 2:

NOMBRE: Apellido y nombre del docente.
DNI: DNI del docente.
BUILD: Build del SYSACAD.
MENSAJES: Indica la cantidad de mensajes que tiene desde la última vez que los revisó.


Parámetro 3:
Múltiples registros con encuestas activas:

ENCUESTA: Número de encuesta
NOMBRE: Nombre de la encuestas
FECHA: Fecha límite para contestar la encuesta

303 Consulta de aviso

Consulta los avisos desde una fecha determinada, o desde la última vez que se los pidió.


ENTRADA

Parámetro 1:

LEGAJO: Legajo del alumno o docente
DOCENTE: =1 o TRUE indica que el legajo es de docente. Caso contrario que es de alumno
FECHA: Si se deja vacía o anterior al 1/1/2000, trae los mensajes agregados desde la última vez que se ejecutó esta petición.
HTML: =1 o TRUE indica que se formatea el texto para HTML, incluyendo cortes de párrafos, links automáticos, etc.

SALIDA:

Parámetro 2: (Múltiples registros)

FECHA: Fecha y hora de cargado
TITULO: Título de la nota (hasta 60 caracteres)
TEXTO: Texto de la nota

304 Leer Encuesta

Consulta las preguntas de una encuesta.


ENTRADA

Parámetro 1:

TIPO: 1= Alumno, 2=Docente
LEGAJO: Legajo del docente o alumno
ENCUESTA: Número de encuesta:
ESPECIALIDAD: Especialidad de la comisión (solo para alumnos y encuestas con comsión)
PLAN: Plan de la materia (solo para alumnos y encuestas con comsión)
MATERIA: Código de la materia (solo para alumnos y encuestas con comsión)
COMISION: Número de comisión de la materia (solo para alumnos y encuestas con comsión)

SALIDA:

Parámetro 2: (Múltiples registros)

ORDEN: Número de pregunta
PREGUNTA: Pregunta
OBLIGATORIA: 'S' si es obligatoria
TITULO: ="S" si es un título
VALORES: Valores posibles, separados por ;

Parámetro 3:

NOMBRE: Nombre de la encuesta
HASTA: Fecha límite para contestar
ANONIMA: Anónima
OBSERVACION: Observación a colocar en la cabecera de la encuesta.

305 Grabar encuesta

Graba las respuestas de una encuesta.


ENTRADA

Parámetro 1: (Múltiples registros)

TIPO: =1 Alumno, =2 Docente
LEGAJO: Legajo del docente o alumno
ENCUESTA: Número de encuesta:
ESPECIALIDAD: Especialidad de la comisión (solo para alumnos y encuestas con comsión)
PLAN: Plan de la materia (solo para alumnos y encuestas con comsión)
MATERIA: Código de la materia (solo para alumnos y encuestas con comsión)
COMISION: Número de comisión de la materia (solo para alumnos y encuestas con comsión)a
ORDEN: Número de pregunta
RESPUESTA: Valor de la respuesta. Este campo se borra luego de procesar si la encuesta es anónima.
OBSERVACION: Observación adicional. Este campo se borra luego de procesar si la encuesta es anónima.

Parámetro 2: Solo para el caso de que la encuesta no sea de comisión
Múltiples registros con encuestas activas:

ENCUESTA: Número de encuesta
NOMBRE: Nombre de la encuestas
FECHA: Fecha límite para contestar la encuesta

400 Consulta de Aranceles de un alumno

Consulta los aranceles de un alumno, usados o adquiridos a partir de la fecha indicada

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
FECHADESDE: Fecha a partir de la cual se devuelven los valores adquiridos o usados


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
ARANCEL: Código de arancel
NOMBRE: Nombre del arancel
ADQUIRIDO: Fecha y hora de la adquisición
AÑOACADÉMICO: Año académico
PERIODO: Periodo
USADO: Fecha y hora de su utilización
USO: Descripción de la utilización del arancel
EXTERNO1: Campo externo 1
EXTERNO2: Campo externo 2
EXTERNO3: Campo externo 3

401 Cambio de Datos Personales

Genera un registro de modificación de datos personales

ENTRADA:

Parámetro 1:

TIPODOC : Tipo de documento, numérico con igual codificación al sistema. (01=DNI)
DNI : Número de documento.
????? : Campo o campos del registro de persona a modificar. El nombre y tipo de la variable debe ser el mismo que el de la tabla PERSONAS

SALIDA:

CHECKSUM: Valor alfanumérico de 11 posiciones (XXX-XXX-XXX) que representa un código de seguridad, el cual es verificado al hacer efectiva la modificación, con una operación manual desde el sistema real.

402 Consulta estado académico

Consulta el estado académico de un alumno


ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno

SALIDA:

Parámetro 2:
AÑO: Año de la materia
NOMBRE: Nombre de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
FALTAAP: Problemas de correlatividad para aprobar la materia
FALTAREG: Problemas de correlatividad para cursar la materia

500 Inscribir a cursar

Inscribe a cursar al alumno en la materia y comisión indicada. Esta función verifica el permisos "Inscripción a Cursado". Solo se verifican los parámetros de comisión y horario. No se verifica si el alumno está inhabilitado para inscribirse por otra razón. Para esto utilice la petición 502 y/o 503.

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a inscribir
PLAN: Plan de la materia a inscribir
MATERIA: Código de materia a inscribir
COMISION: Comisión a inscribir
ESPECIALIDADHOMOGENEA: Especialidad de la materia homogénea (solo para inscripción homogénea)
PLANHOMOGENEA: Plan de la materia homogénea a inscribir (solo para inscripción homogénea)
MATERIAHOMOGENEA: Código de materia homogénea a inscribir (solo para inscripción homogénea)

SALIDA:

Parámetro 2:
CHECKSUM: El código de seguridad de la inscripción
HORARIO: Horario a cursar, en formato DIA: Hora_desde - Hora_hasta[,DIA 2....]
EDIFICIO: Edificio y aula donde se cursa

501 Borrar inscripción a cursado

Borra una inscripción a cursado del alumno en la materia y comisión indicada. Esta función verifica el permiso "Inscripción a Cursado".

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a borrar
PLAN: Plan de la materia a borrar
MATERIA: Código de materia a borrar
COMISION: Comisión a borrar
ESPECIALIDADHOMOGENEA: Especialidad de la materia homogénea (solo para inscripción homogénea)
PLANHOMOGENEA: Plan de la materia homogénea a inscribir (solo para inscripción homogénea)
MATERIAHOMOGENEA: Código de materia homogénea a inscribir (solo para inscripción homogénea)

502 Materias de Inscripción a cursar

Devuelve las materias en las que puede inscribirse a cursar. Se controlan los mismos parametros que en el sistema normal y se devuelven las mismas materias. Esta función verifica el permiso "Inscripción a Cursado"

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
NOMBRE: Nombre de la materia. Si tiene nombre web devuelve ese.
NOMBRELARGO: Nombre de la materia (siempre el largo, aunque tenga web)
COMISIÓN: Comisión en la que está inscripto actualmente
CURSO: Curso en el que está inscripto
ESPECIALIDADHOMOGENEA: Especialidad en la que está inscripto actualmente (para homogéneas)
PLANHOMOGENEA: Plan en el que está inscripto actualmente (para homogéneas)
MATERIAHOMOGENEA: Materia en la que está inscripto actualmente (para homogéneas)
AÑO: Año de dictado
HORARIO: Horario de cursado, en formato DIA: Hora_desde - Hora_hasta[,DIA 2....]
EDIFICIO: Nombre del edificio y número de aula
CHECKSUM: Código de seguridad de la inscripción
IMPRESO: 'S' si ya fué impreso y no puede ser borrado sin permiso especial
AUDITORIA: Fecha y operador en la que fué ingresada la inscripción.


503 Comisiones de materia a cursar

Devuelve las comisiones en las que se puede inscribir a cursar una materia determinada. Si existen violaciones de correlatividad pero el alumno puede inscribirse condicional y se tiene permiso, esto se indica en el parámetro 3. En caso contrario se devuelve un error. Esta función controla los permisos "Inscripción a Cursado" , "Insc. Condicional Cursado" e "Insc. Homogéneas Cursado".

ENTRADA:
Parámetro 1:
LEGAJO: Legajo del alumno
ESPECIALIDAD: Especialidad de la materia a inscribir
PLAN: Plan de la materia a inscribir
MATERIA: Código de materia a inscribir


SALIDA:
Parámetro 2: Múltiples registros, uno por cada comisión

COMISION: Comisión a inscribir
CURSO: Curso de la comisión
HORARIO: Horario de cursado, en formato DIA: Hora_desde - Hora_hasta[,DIA 2....]
ESPECIALIDAD: Especialidad de la materia a inscribir (difiere del pedido en caso de homogéneas)
PLAN: Plan de la materia a inscribir (difiere del pedido en caso de para homogéneas)
MATERIA: Código de materia a inscribir (difiere del pedido en caso de para homogéneas)
EDIFICIO: Edificio donde se dicta el curso o la comisión, si esta difiere.

Parámetro 3:
CONDICION: Condición de correlatividad, en caso de poder inscribirse condicional

504 Impresión de cursado

Similar a la petición 502, pero solo devuelve las materias inscriptas, y además las marca como impresas. Esto implica que si se otorga el permiso de borrar inscripción impresa solo los usuarios con dicho permiso pueden borrar la inscripción.

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno


SALIDA:

Parámetro 2: Es un cursor con múltiples registros.
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
NOMBRE: Nombre de la materia
COMISION: Comisión en la que está inscripto actualmente
CURSO: Curso en el que está inscripto
ESPECIALIDADHOMOGENEA: Especialidad en la que está inscripto actualmente (para homogéneas)
PLANHOMOGENEA: Plan en el que está inscripto actualmente (para homogéneas)
MATERIAHOMOGENEA: Materia en la que está inscripto actualmente (para homogéneas)
HORARIO: Horario de cursado, en formato DIA: Hora_desde - Hora_hasta[,DIA 2....]
EDIFICIO: Nombre del edificio y número de aula
CHECKSUM: Código de seguridad de la inscripción
IMPRESO: 'S' si ya fué impreso y no puede ser borrado sin permiso especial
AUDITORIA: Fecha y operador en la que fué ingresada la inscripción.


505 Inscripción cursado a año

Inscribe a cursar al alumno en todas las materias del año y turno indicado, en el mismo número de comisión. Si por alguna causa no puede hacerlo en todas las materias, devuelve error y no inscribe en ninguna. Si lo pudo hacer, retorna el mismo resultado que la petición 502, a efectos de que se pueda mostrar en que está inscripto el alumno.

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
AÑO: Año de dictado
TURNO: Turno de cursado (1=Mañana, 2=Tarde, 3=Noche)

SALIDA:

Parámetro 2:
ESPECIALIDAD: Especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
NOMBRE: Nombre de la materia
COMISIÓN: Comisión en la que está inscripto actualmente
CURSO: Curso en el que está inscripto
ESPECIALIDADHOMOGENEA: Especialidad en la que está inscripto actualmente (para homogéneas)
PLANHOMOGENEA: Plan en el que está inscripto actualmente (para homogéneas)
MATERIAHOMOGENEA: Materia en la que está inscripto actualmente (para homogéneas)
AÑO: Año de dictado
HORARIO: Horario de cursado, en formato DIA: Hora_desde - Hora_hasta[,DIA 2....]
EDIFICIO: Nombre del edificio y número de aula
CHECKSUM: Código de seguridad de la inscripción
IMPRESO: 'S' si ya fué impreso y no puede ser borrado sin permiso especial
AUDITORIA: Fecha y operador en la que fué ingresada la inscripción.

506 Consulta de matrícula

Consulta la matrícula del año indicado (o el actual si se pasa año 0) y devuelve ademas la condición de alumno regular al 1 de Abril de ese año.


ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno
AÑO: Año academico . Si se pasa 00 se toma el año académico actual

SALIDA:

Parámetro 2:
MATRICULA: Puede ser: ' ' no tiene matrícula, 'Implícita' generada por el sistema, ' Explícita' otorgada manualmente, 'Solo Examenes' inscripto solo para examenesmateria
REGULAR: 'S' si cumple con la condición de alumno regular.

507 Consulta de parciales

Consulta las notas registradas de parciales cursando que estén regulares por asistencia

ENTRADA

Parámetro 1:
LEGAJO: Legajo del alumno

SALIDA:

Parámetro 2:
AÑO: Año de la materia
NOMBRE: Nombre de la materia
COMISION: Comisión y curso de la materia
PARCIALES: Notas de parciales
ESPECIALIDAD: Especialidad de la comisión
PLAN: Plan de la materia
MATERIA: Código de la materia
NUMEROCOMISION: Número de comisión de la materia
ENCUESTA: Indica el número de encuesta que le falta completar en la comisión.

600 Materias que dicta el docente

Consulta las materias que dicta o dictó en los últimos cuatro años el docente


ENTRADA

Parámetro 1:

LEGAJO: Legajo del docente

SALIDA:

Parámetro 2: (Múltiples registros)

ESPECIALIDAD: Código de especialidad de la materia
ABREVIATURAESPECIALIDAD: Abreviatura de la especialidad
PLAN: Plan de la materia
MATERIA: Código de la materia
AÑO: Año de dictado de la materia
CUATRIMESTRE: Cuatrimestre de dictado de la materia
NOMBRE: Nombre de la materia
COMISION: Comisión de la materia
AÑOACADEMICO: El año académico de la comisión
CURSO: Curso de la materia
CARGO: Cargo del docente en la comisión
ALUMNOS: Cantidad de alumnos de la comisión

601 Alumnos tribunal

Consulta los alumnos de un tribunal de examen en un determinado horario

ENTRADA

Parámetro 1:

ESPECIALIDAD: Código de especialidad de la materia
PLAN: Plan de la materia
MATERIA: Código de la materia
FECHA: Fecha del examen
CODIGOTRIBUNAL: Código de tribunal
CODIGOHORARIO: 1=Mañana, 2=tarde, 3=noche

SALIDA:

Parámetro 2: (Múltiples registros)

LEGAJO: Legajo del alumno
NOMBRE: Nombre del alumno
NOTA: Nota abreviada del examen (Au, In, 1..10,etc.)

602 Tribunales docente

Consulta los tribunales en los cuales está nominado el docente y las próximas fechas de exámenes habilitadas


ENTRADA

Parámetro 1:

LEGAJO: Legajo del docente

SALIDA:

Parámetro 2: (Múltiples registros)

ESPECIALIDAD: Código de especialidad de la materia
ABREVIATURAESPECIALIDAD: Abreviatura de la especialidad
PLAN: Plan de la materia
MATERIA: Código de la materia
NOMBRE: Nombre de la materia
TRIBUNAL: Nombre del tribunal
CARGO: Titular, Vocal 1, Vocal2
FECHA: Fecha del próximo examen
HORARIO: Mañana, Tarde, Noche <--- estos primeros siete campos son la clave
ALUMNOS: Cantidad de alumnos inscriptos actualmente
HORARIOTEORICO: Hora teórico
HORARIOPRACTICO: Hora Práctico.
AULA: Edificio y aula donde se toma el examen.
CODIGOTRIBUNAL: Código de tribunal
CODIGOHORARIO: 1=Mañana, 2=tarde, 3=noche