Retour à l'index

Module sameday.so

Auteur

Tomaz Solc, tomaz.solc@tablix.org

Credits

Idées prises d'un patch pour la version 0.0.3 de Tablix 0.0.3 réalisé par Obrador <obrador@espaiweb.net>

Groupes du module

Ce module appartient aux groupes suivants :

Description

Ajoute un poids si une classe (groupe d'étudiants) ou un enseignant (comme spécifié par l'option de module "resourcetype" a la même matière plus de N fois dans la journée.

La valeur par défaut de N est 1. Cette valeur par défaut peut être changée avec l'option de module "default". La valeur par défaut de N peut également être redéfinie pour chaque enseignant, class ou évènement avec des restrictions variées.

Types de ressource requis

Le fichier de configuration doit définir les types de ressources suivants pour pouvoir utiliser ce module :

Restrictions de ressource définies

ignore-sameday (all resource types)

<resourcetype type="class">
	<resource name="example-class">
		<restriction type="ignore-sameday"/>
	</resource>
</resourcetype>

Appliquer cette restriction à une classe ou à un enseignant pour lesquels vous ne souhaitez pas qu'il soit vérifier l'occurrence multiple d'une matière le même jour.

Ce module ignorera alors les classes qui ont cette restriction. Cependant, ce paramétrage peut être modifié pour des évènements, si la restriction "set-sameday" est utilisée sur un évènement pour cette classe ou cet enseignant.

set-sameday (all resource types)

<resourcetype type="class">
	<resource name="example-class">
		<restriction type="set-sameday">2</restriction>
	</resource>
</resourcetype>

Avec cette restriction, vous pouvez fixer un nombre maximum d'évènements identiques qu'une classe ou un enseignant peuvent avoir dans une journée. Cela peut être passé outre pour des évènements singuliers si la restriction "set-sameday" est utilisée pour un évènement de cette classe ou de cet enseignant.

Restrictions de tuple définies

consecutive

C'est un alias pour la restriction "ignore-sameday" (ignorer le même jour). Il est défini par commodité, quand ce module est utilisé conjointement avec le module consecutive.so.

ignore-sameday

Appliquez cette restriction à tous les évènements pour lesquels vous ne voulez pas que la vérification d'occurence multiple par jour se fasse.

Cette restriction outre passe le paramétrage par défaut et les indications données par n'importe quelle autre restriction de ressource.

periods-per-block

C'est un alias pour la restriction "set-sameday-blocksize". Il est défini par commodité, quand ce module est utilisé conjointement avec le module consecutive.so

set-sameday

<event name="example" repeats="5">
		...
		<restriction type="set-sameday">2</restriction>
</resourcetype>

Avec cette restriction, vous pouvez fixer un nombre maximum d'évènements qu'une classe ou un enseignant peuvent avoir une journée.

Cette restriction outre passe le paramétrage par défaut et les indications données par n'importe quelle autre restriction de ressource.

set-sameday-blocksize

Avec cette restriction, vous pouvez dire à ce module que l'évènement courant sera programmé par blocs du nombre indiqué d'évènements consécutifs.

Le module considèrera alors un bloc d'évènements comme un évènement unique lorsqu'il cherchera les occurrences multiples dans la journée.

Par défaut, la taille du bloc est 1.

Options du module

default

Utilisez cette option pour fixer le nombre par défaut d'évènements qu'une classe ou un enseignant peuvent avoir sur une journée.

resourcetype

Utiliser cette option pour spécifier un ou plusieurs types de ressource constantes.Les types de ressource spécifiés auront leur emploi du temps vérifiés par ce module.

Utiliser l'option

<option name="resourcetype">class</option>

pour obtenir de ce module le même comportement qu'il avait avant la version 0.3.1 de Tablix.

Retour à l'index