`prcla`
Anterior | Documentación de referencia de formatos | Siguiente

## Nombre de referencia

`prcla` — Formato de archivo: progreso en estudio de clasificaciones

## Descripción y ejemplos

El progreso que un estudiante hace al estudiar clasificaciones, puede registrarse con este formato. De cada clasificación puede registrarse progreso en ejercicios y una valoración en algún periodo. Por ejemplo suponiendo que el archivo de clasificaciones (ver clasif(5)) defina los indicadores `contexto.geografía`, `contexto.historia` y `establece.reflexiona` el archivo de progreso podría ser:

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <!DOCTYPE prcla PUBLIC "-//Structio//DTD progreso en clasificaciones 1.0" "prcla.dtd">

    <prcla conceptos=":(g='S' || g='B' || g='A' || g='D' || g='I');Indicador:(g='E' || g='B' || g='I')">
      <progcla idcla="ejsimple.cla:contexto.historia" tipo="Indicador">
        <val concepto="I" periodo="p2004-1"/>
        <val concepto="B" periodo="p2004-2"/>
      </progcla>
      <progcla idcla="ejsimple.cla:contexto.geografía" tipo="Indicador">
        <val concepto="I" periodo="p2004-1"/>
        <val concepto="I" periodo="p2004-2"/>
      </progcla>
      <progcla idcla="ejsimple.cla:establece.reflexiona" tipo="Indicador">
        <val concepto="I" periodo="p2004-2"></val>
        <progejer idejer="establece.reflexiona.e1" fecha="1/1/2004" concepto="I"/>
        <progejer idejer="establece.reflexiona.e1" fecha="10/3/2004" concepto="I"/>
      </progcla>
      <anota valor="p2004-1" tipo="Fallas">3</anota>
      <anota valor="p2004-2" tipo="Fallas">10</anota>
      <val concepto="D" periodo="p2004-3"></val>
    </prcla>

Note que:

- Los conceptos posibles se indican en el atributo `conceptos` del elemento `prcla`, para indicadores pueden ser `E`, `B` e `I`, mientras que los generales pueden ser `S`, `B`, `A`, `D`, `I`

- Los indicadores `contexto.historia` y `contexto.geografía` se valoran en los dos periodos (con el elemento `val`), mientras que el indicador `establece.reflexiona` se valora en un periodo (`p2004-2`).

- Hay una valoración general no asociado a Indicador alguno, para el periodo `p2004-3`

Un archivo de progreso en clasificaciones puede chequearse con el programa sigchq.

## Descripción detallada de cada elemento

### `prcla` - Raíz de progreso en clasificaciones

El elemento raíz `prcla` puede emplear los siguientes atributos

`periodos`

  que define los periodos posibles, se especifican como un predicado (ver sobre predicados a continuación) en la variable `p`.

`conceptos`

  que define los conceptos posibles, los cuales se especifican con un predicado en la variable `c`

`formato` y `longitud`

  que especifica el formato en el que se escriben anotaciones (ver ,clasif(5)).

Como subelementos puede tener anotaciones (`anota`, ver página man elementos-comunes(5)), valoraciones generales (`val`) y progreso en clasificaciones (`progcla`). De haber anotaciones deben emplear el atributo valor con el periodo al cual aplican.

#### Predicados para especificar conceptos y periodos

Un predicado es una expresión que debe evaluar a verdadero o falso. La expresión puede incluir constantes (números o cadenas), una variable (por ejemplo `p` en el caso de periodos o `c` en el caso de conceptos), operadores de relación o operadores booleanos. A continuación se ejemplifican las constantes y los operadores de relación operando con la variable `c`:

Tabla 1. Operadores de relación

Operador | Descripción
--- | ---
`c='I'` | Es verdadero si el concepto (i.e la variable `c`) es `I`
`c<5` | Verdadero si `c` es menor al entero 5.
c>2.3 | Verdadero si `c` es mayor a 2.3
`c>='Agua'` | Verdadero si `c` es lexicográficamente mayor o igual a la cadena `Agua`2.3
`c<=5` | Verdadero si `c` es menor o igual al entero 5.
`c!=0` | Verdadero si `c` es diferente a 0.
`c~='p[0-9]+-[0-9]'` | Verdadero si `c` concuerda con la expresión regular dada. Por ejemplo la cadena 'p2001-2' concuerda, pero 'p-1' no. La expresión regular tiene la sintaxis de las expresiones regulares de Ocaml. De acuerdo a la documentación del módulo Str, puede emplear los caracteres especiales `$^.*+?[]` así: `.` concuerda con todo caracter, `*` posfijo concuerda con la expresión que lo precede cero o más veces, `+` posfijo concuerda con la expresión que lo precede más de una vez, `?` posfijo concuerda con la expresión que lo precede cero o una vez, `[...]` concuerda con un conjunto de caracteres pueden especificarse rangos con - o complementos comenzando con `^`, `^` concuerda con el comienzo, `%` concuerda con el final, `|` infijo representa alternativa entre dos expresiones.

Los operadores booleanos se ejemplifican a continuación:

Tabla 2. Operadores booleanos

Operador | Descripción
--- | ---
!(c=='x') | Negación.
c<2 || c>4 | Disyunción (operador 'o').
c!=2 && c!=3 | Conjunción (operador 'y').

Además de una sintaxis correcta, un predicado debe ser bien tipado, es decir el uso de la variable siempre se da con un sólo tipo de datos (bien enteros o bien sólo flotantes o bien sólo cadenas).

### `progcla` - Progreso en una clasificación

La clasificación debe especificarse en los atributos `idcla` y `tipo` con la respectiva identificación y tipo. La identificación debe comenzar con el nombre del archivo seguida de ':' y de la identificación de la clasificación (no hay archivo de clasificación por defecto en el caso de archivos de progreso en clasificaciones).

Sus subelementos pueden ser valoraciones (elemento `val`), ejercicios de la clasificación (elemento `progejer`), otras referencias a clasificaciones anidadas dentro de la clasificación que este clasifica o anotaciones.

### `progejer` - Progreso en un ejercicio

Con este elemento se registra un concepto (atributo `concepto`) para un ejercicio desarrollado en una fecha (atributo `fecha`). El ejercicio referenciado debe ser un ejercicio de la clasificación en la que aparece. La identificación del ejercicio debe estar en el atributo `idejer`, puede ser de la forma `archivo`:`id` y en tal caso el archivo debe corresponder al archivo de la clasificación en la que está, o de la forma `id` con lo que se supone que el archivo es el mismo de la clasificación en la que está.

### `val` - Valoración

Este elemento registra una valoración en un periodo para la clasificación en la que está o si no está en clasificación alguna, se trata de una valoración global. Sus atributos son `periodo` y `concepto`. En caso de haber especificado predicados para periodos o conceptos (ver elemento `prcla`), el valor de estos atributos debe cumplir el predicado.

## Ver también

sigchq(1),

## Historia

Las valoraciones en referencias a clasificaciones se introdujeron para permitir valoración de indicadores, las referencias anidadas para permitir valoración tanto de logros como de indicadores, las valoraciones generales para permitir valoración general de una materia.

Anterior | Subir | Siguiente
`grupo` | Inicio | `planest`