Différences

Ci-dessous, les différences entre deux révisions de la page.

--- localldapadditionsinstall [2015/09/23 21:15] – [Isolement des cohortes générées / Problématique de passage d'années] admin
+++ localldapadditionsinstall [2025/12/10 16:16] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 10: / Ligne 10: @@
 ==== Configuration ====
-La configuration générale se trouve dans le menu :
+La configuration générale se trouve dans le menu //Administration > Plugins > Authentification// dans la page :
-   Administration > Plugins > Authentification
-dans la page :
    Additions à la synchronisation LDAP
-La page de configuration permet de régler :
+[[LocalLdapAdditionsconfiguration|Détail de la configuration]]
-   * Le protocole d'authentification effectif des comptes créés par la synchronisation
+==== Mise en route de l'alimentation =====
-   * Le filtrage des utilisateurs dans une synchronisation différentielle
-   * L'alimentation des cohortes
-   * L'alimentation des champs de profil
-=== Authentification ===
+Une fois les deux plugins (authentification LDAP et LDAP Additions) configurés, vous pouvez mettre en place la synchronisation en programmant le déclenchement programmé du script CLI :
-^ Réglage ^ Valeurs ^ Commentaire ^
+3 * * * sudo -uwww-data php /<moodlepath>/local/ldap_additions/cli/sync_users.php
-| Authentification | ldap,saml,shibboleth,cas | Permet de choisir le plan d'authentification attribué aux comptes créés par la synchronisation |
+Pour effectuer une mise à jour complète de tous les comptes (même ceux non modifiés entre temps) :
-=== Filtrage de la liste entrante (mise à jour différentielle) ===
-Afin d'optimiser le processus de synchronisation sur des très grandes quantités de comptes, un procédé différentiel peut être activé si le LDAP contient une information permettant de coder la date de dernière mise à jour du profil ldiff de l'utilisateur. Ce champ peut être alors indiqué au module Ldap Additions pour ne requêter que les utilisateurs nouvellement créés ou fraîchement modifiés.
-^ Réglage ^ Valeurs ^ Commentaire ^
-| Champ ldap d'utilisateur modifié | timestamp ou temps interprétable par strtotime() | Indique quel attribut du LDAP contient la date de dernière modification de l'utilisateur |
-| Format du champ de temps | (timestamp, texte) | Si la valeur désigne une forme texte de la date, la fonction strtotime() sera appliquée à la valeur. |
-=== Cohortes ===
-Il faut, pour pouvoir utiiser cette fonction,, qu'un champ du LDAP soit dédié à mentionner la cohorte d'inscription. La valeur de ce champ peut être :
-   * Une valeur texte simple
-   * Une liste de valeurs ou expressions séparées par des virgules
-NON SUPPORTE :
-   * Dans la version actuelle, un attribut mutliple du LDAP (résultant sur un tableau) n'est pas supporté.
-Toutes les cohortes générées le sont dans le contexte "système".
-^ Réglage ^ Valeurs ^ Commentaire ^
-| Champ ldap de cohorte | texte ou liste à virgules | Le nom de l'attribut LDAP qui fournit la ou les cohortes |
-| Champ ldap des identifiants de cohorte | texte ou liste à virgules | Le nom de l'attribut LDAP qui fournit la ou les identifiants externes de cohortes |
-| Préfixe de cohorte | texte | Un préfixe à ajouter devant la valeur extraite de cohorte* |
-| Filtre d'extraction du nom | REGEXP | Cette expression est appliquée à la valeur du champ ou de l'élément de liste de l'attribut porteur des cohortes pour en extraire le nom. Par défaut, la valeur de ce filtre est <nowiki>"^(.*)$"</nowiki> |
-(*) Voir paragraphe : Isolement des cohortes généréres / Passage d'années
-=== champs customisés du profil ===
-champs customisés du profil peut être alimentés à partir du LDAP. chaque champ est défini par un couple de paramètres :
-^ Réglage ^ Valeurs ^ Commentaire ^
-| Attribut ldap du champ de profil | texte | Le nom de l'attribut LDAP qui fournit la donnée pour ce champ de profil |
-| Champ Moodle de profil | texte | Le nom du champ de profil à créer dans Moodle |
-Note 1 : Les champs de profil manquants sont automatiquement créés dans Moodle avec les caractéristiques suivantes :
-   * Pas de catégorie
-   * Champ caché
-   * Vérouillé
-   * Non obligatoire
-   * Non visible sur le formulaire de création de compte
-   * Non unique
-==== Isolement des cohortes générées / Problématique de passage d'années ====
+3 * * * sudo -uwww-data php /<moodlepath>/local/ldap_additions/cli/sync_users.php --force
-Dans des établissements fonctionnant en "sessions académiques" et en inscriptions pluri-annuelles se pose souvent le problème du "passage d'année". En général, le LDAP est remis en jeu chaque année pour être rechargé pour l'alimentation de l'anné en cours, par addition des élèves qui entrent dans l'établissement et ceux qui en sortent. Les élèves qui demeurent dans l'établissement restent dans l'annuaire, mais changent d'affectation (promotion, session). La création automatique des cohortes par le composant LDAP Additions tient compte de ce cas de figure en proposant un préfixe ajouté à tous les noms de cohortes détectées dans les profils utilisateur.
+> **Note spécifiques aux utilisateurs de la virtualisation VMoodle**
+>
+> Le script de synchronisation du plugin LDAP Additions **est compatible** avec la virtualisation VMoodle. Vous pouvez de ce fait expliciter l'hôte cible sur lequel vous voulez faire tourner la synchronisation en écrivant :
-Il est possible par exemple de distribuer ses élèves sur des cohortes de "classe" : BTS1, BTS2, PREPA1, PREPA2, et régler le préfixe "2015_2016" pour la génération des cohortes.
+3 * * * sudo -uwww-data php /<moodlepath>/local/ldap_additions/cli/sync_users.php --host=htp://mon/moodle.fr
-Les cohortes finales seront nommées 2015_2016_BTS1, 2015_2016_BTS2, etc.
-Lors du passage d'année, il suffit, au moment de la reconstruction de l'annuaire pour l'année suivante, de modifier le préfixe à "2016_2017" avant de générer les nouvelles cohortes.
+==== Goodies ====
-[[LocalLdapAdditionsRoadMap|Eléments de Road Map]]
+La mise en oeuvre qui suit n'est pas obligatoire. Elle permet par contre de pouvoir accéder en lecture à la liste des membres d'une cohorte automatique créée par la synchronisation LDAP Additions. En effet, dans sa version standard, Moodle ne permet ni la modification ni la visualisation d'effectifs de cohortes autres que celles créées manuellement par l'administration. La mise en eovre suivant permet d'accéder en lecture à la liste des membres des cohortes automatiques. Elle s'appuie sur la mécanique du "customscripting" de Moodle :
-==== Mise à jour des utilisateurs et cohortes ====
+   - Créez un répertoire "customscripts" à la racine de Moodle.
+   - Copiez le contenu du répertoire __customscripts de la distribution du plugin LDAP Additions dans ce répertoire.
+   - Modifiez votre fichier de configuration config.php comme suit :
-Lors d'une mise à jour d'un utilisateur, l'ensemble de ses appartenances précédentes aux cohortes automatisées par le LDAP Additions est supprimé. Puis les nouvelles assignations sont rénovées.
+   $CFG->customscripts = '{moodleabsroot}/customscripts/';
-Note : Les cohortes vidées par le processus seront supprimées, mais la synchronisation NE détruit PAS les cohortes existantes (en dehors du cas précédent). Ainsi, la cohérence des inscriptions par cohortes est préservée.
+La modification porte sur la liste des cohortes obtenue par le menu //Administration > Utilisateurs > Comptes > Cohortes//.
 [[LocalLdapAdditions|Revenir à l'index du plugin]]