Manuel : Mise en place et déploiement de la solution

Transcription

1 Manuel : Mise en place et déploiement de la solution Type de document : Technique Etat du document : Clos Nombre de pages : 61 Version 1.2 Date 04/06/2009 Référence du document : MAN_09_06_04_V1.2 Auteurs : VB Destinataires et domaine de diffusion : Équipe et Client Remarques HISTORIQUE DU DOCUMENT Version Rédacteur et date Descriptif 0.1 VB (05/03/2009) Création du document 0.2 MB (18/05/2009) Corrections 0.3 LLC (26/05/2009) Corrections 1.0 VB, LLC, MB Validation du document (28/05/2009) 1.1 LLC (29/05/2009) Corrections 1.2 LLC (04/05/2009) Corrections

2 Sommaire 1. Introduction Schéma de l architecture Préparation du serveur Pré-requis Matériels Système d exploitation Réseau Partitionnement Configuration de la date et de la langue Paquets de base nécessaires Installation de la solution Installation des librairies requises Database Berkeley OpenLDAP Installation de Plone Installation des paquets Pré-requis Installation du produit Informations et structure Lancement/arrêt de l instance Interface de management Modification du mot de passe d administration Déclaration du site Plone Interconnexion avec l annuaire LDAP Configuration fonctionnelle Création des workflow Workflow à 3 états Workflow à deux états Création d un nouveau type d objet Attribution d un workflow Configuration du serveur mail Activation des dossiers personnels Optimisation de l affichage Gestion des utilisateurs et des groupes Gestion des groupes Gestion des utilisateurs Rappel des rôles : Manipulation des types

3 8.1. Les dossiers Les documents Rappel des types de documents Gestion des notifications Personnalisation du site Ajout d un portlet Conclusion

4 1. Introduction Ce document décrit la mise en place de la solution de plateforme collaborative sous Plone. Il couvre l installation du produit et sa configuration dans le cadre du projet «Plone» initié au sein de l UTEC. Il est nécessaire d avoir un minimum de connaissances techniques sur l administration d un système linux et des bases concernant les normes employées au sein d un réseau informatique. Ce document est conçu pour être suivi étape par étape. Certaines parties font référence à des éléments évoqués précédemment dans le manuel. Vous pouvez cependant utiliser le sommaire pour accéder à la description d un point particulier de la configuration. Ce document se concentre essentiellement sur le déploiement de la solution Plone et sur sa configuration de base. Il s agit d un manuel à destination des administrateurs ou des responsables informatiques. L utilisateur final n est pas concerné. L aspect visuel de la plateforme sera évoqué rapidement en dernière partie mais n est pas développé au sein de ce manuel Schéma de l architecture Ce manuel se concentre sur la mise en place du serveur accueillant la solution de plateforme collaborative. Ce dernier s intègre dans le réseau en place au sein de l UTEC. Il s interconnecte avec l annuaire de l établissement hébergé sous SambaEdu. Ce manuel ne traite pas de l administration de ce dernier. Ce manuel traite des fonctionnalités décrites dans le cahier des charges issu du projet. Tout autre paramétrage ne sera pas décrit dans ce document. 4

5 2. Préparation du serveur 2.1. Pré-requis Matériels Il est fortement conseillé d utiliser un serveur dédié pour l hébergement de la plateforme. Le moteur de workflow, Zope, sur lequel se repose la couche de gestion de contenu Plone est consommatrice de ressources. Pour le stockage des documents, la solution utilise une base de données dans un format spécifique propre à Zope. La configuration matérielle minimale est la suivante : CPU : >1GHZ RAM : >1024 Mo Espace Disque : >80Go (RAID 1 ou 5 conseillé) Carte Réseau RJ Système d exploitation Le choix du système d exploitation est libre. Plone est compatible Windows, Linux et Mac OS X. Cependant ce manuel décrira l installation de la plateforme sous Linux Debian bits. Cette distribution a l avantage d être gratuite, fiable, sécurisée et maintenue par une grande communauté de développeurs. Ce manuel ne traitera pas de l installation de Plone sous un autre système d exploitation Réseau Le serveur doit impérativement être correctement configuré pour accéder aux ressources réseau de l établissement. Un accès Internet est obligatoire le temps de l installation afin de pouvoir télécharger les différents éléments. Dans le cadre de l authentification des utilisateurs, il est nécessaire que le serveur puisse dialoguer avec le serveur SambaEdu hébergeant l annuaire (Connexion autorisée sur le port 389 coté annuaire) Partitionnement Il est possible de configurer le chemin d installation de la solution. Cependant, pour faciliter la maintenance et la compatibilité du système, ce manuel s appuiera sur les chemins par défaut. Ainsi, le partitionnement suivant est conseillé (sur la base d un disque de 80Go) : Point de montage Taille et Format de Type de partition Description fichier /boot 800Mo Ext2 primaire Contient les données de boot (noyau) / 15Go Ext3 primaire Partition racine /tmp 2Go Ext3 primaire Stocke les fichiers temporaires /home 10Go Ext3 logique Partition pour stocker les données des utilisateurs locaux au serveur. /usr 50Go Ext3 logique Partition pour stocker l instance de la solution (binaire + base de données) 5

6 Configuration de la date et de la langue Le serveur doit être installé en français. La date doit être paramétrée pour utiliser le même serveur de temps que celui utilisé par le serveur d annuaire SambaEdu. Il est très important que les deux serveurs soient synchronisés. Les commandes suivantes illustrent la configuration NTP sous Debian 5.0 : Installez le paquet NTP : aptitude install ntp Ouvrez le fichier de config ntp.conf nano /etc/ntp.conf Supprimez les serveurs déjà présents et indiquez celui que vous désirez utiliser (le même que pour SambaEdu) comme sur la capture (ici le serveur ntp est «ntp.ac-creteil.fr» (serveur par défaut sous SambaEdu)) Redémarrez le service ntp /etc/init.d/ntp restart Paquets de base nécessaires Avant de commencer l installation de la solution, il est nécessaire de disposer d un certain nombre de paquets de base nécessaires pour la compilation des applications. Mettez à jour la liste de vos dépôts aptitude update Mettez à jour votre distribution aptitude upgrade Installez les librairies et binaires nécessaires pour la compilation d application aptitude install build-essential 6

7 3. Installation de la solution 3.1. Installation des librairies requises Plone est une solution modulable permettant l intégration de nombreux plugins pour proposer différentes fonctionnalités optionnelles. Dans le cadre du projet, il est nécessaire d employer les modules d interconnexion avec un annuaire LDAP. Pour cela, des librairies sont requises afin d assurer l installation correcte des plugins Database Berkeley Il est nécessaire que le système intègre les librairies propres au format de base de données Berkeley. Nous n utiliserons pas les paquets précompilés offerts par Debian. Ces derniers dispatchent les éléments dans des chemins non reconnus par les modules de Plone. Il faut donc compiler les sources à la main. A la rédaction de ce document les dernières sources stables sont les Placez-vous dans le répertoire temporaire cd /tmp Récupérez les sources (nous vous conseillons, par la suite, de sauvegarder l archive récupérée) wget Décompressez les sources tar -xvf db tar.gz Placez-vous dans le répertoire cd db Placez-vous dans build_unix cd build_unix/ Lancez la préparation à la compilation../dist/configure Lancez la préparation à la compilation make Lancez l installation des paquets compilés make install OpenLDAP Il est nécessaire que le système intègre les librairies OpenLDAP. Même si nous n utiliserons pas l annuaire, il est nécessaire de le compiler sur le serveur pour installer les librairies nécessaires au fonctionnement des plugins. Nous n utiliserons pas les paquets précompilés offerts par Debian. Ces derniers dispatchent les éléments dans des chemins non reconnus par les modules de Plone. Il faut donc compiler les sources à la main. A la rédaction de ce document les dernières sources stables sont les Placez-vous dans le répertoire temporaire cd /tmp Récupérez les sources (nous vous conseillons, par la suite, de sauvegarder l archive récupérée) Wget ftp://ftp.openldap.org/pub/openldap/openldap-stable/openldap-stable tgz 7

8 Décompressez les sources tar -xvf openldap-stable tgz Placez-vous dans le répertoire cd openldap / Exportez les variables suivantes nécessaires à la compilation export CPPFLAGS="-I/usr/local/BerkeleyDB.4.7/include" export LDFLAGS="-L/usr/local/BerkeleyDB.4.7/lib" export LD_LIBRARY_PATH=/tmp/db /build_unix/.libs/ Lancez la préparation à la compilation./configure Lancez la préparation à la compilation des dépendances make depend Lancez la compilation des paquets make Lancez l installation des paquets compilés make install 3.2. Installation de Plone Il est possible d installer Plone selon plusieurs méthodes. Celle présentée ici concerne l installation «standalone» en mode root à partir du «buildout». Il s agit de la méthode conseillée par les développeurs de Plone pour un environnement de production. L installation «buildout» est une nouvelle fonctionnalité issue de Plone 3.2. Elle permet une compilation du produit à travers un fichier de configuration unique et des séries de commandes spécifiques. Ainsi, il est très facile d upgrader son installation ou d ajouter de nouveaux éléments (PlugIns). La version de Plone utilisée dans ce manuel est la disponible depuis avril Attention, il n est pas conseillé d utiliser les paquets Plone précompilés disponible dans Debian Installation des paquets Pré-requis Certaines dépendances peuvent être corrigées par l installation des paquets Debian suivants : Installez les paquets suivants aptitude install libsasl2-dev libssl-dev libdb-dev python-ldap Installation du produit Placez-vous dans votre répertoire temporaire cd /tmp Récupérez l installateur de Plone wget UnifiedInstaller.tgz Décompressez l archive tar -xvf Plone UnifiedInstaller.tgz Placez-vous dans le répertoire cd Plone UnifiedInstaller 8

9 Assurez-vous d être en root pour la commande suivante : Lancez l installation du produit./install.sh standalone L option «Standalone» indique que les binaires et la base de données seront hébergés sur la même machine. A la fin de l installation, vous obtenez le login et le mot de passe attribué par défaut pour accéder à l interface de management Si vous avez raté cette étape, vous pouvez retrouver ces identifiants dans le fichier suivant : /usr/local/plone/zinstance/adminpassword.txt A partir de ce point, le serveur dispose de tous les outils, binaires, librairies nécessaires au fonctionnement de Plone. Il reste cependant à créer une instance Plone Création de l instance Plone reprend le principe de Zope sur lequel il est basé. Il est donc nécessaire de créer une instance. Une instance est un environnement spécifique avec une configuration dédiée qui permet d utiliser les fonctionnalités de Plone. Un serveur peut héberger plusieurs instances indépendantes les unes des autres ayant leur propre configuration (Une base de données par instance). Dans le cadre du projet, une seule instance est nécessaire. Chaque instance se configure selon un fichier spécifique buildout.cfg. Ouvrez le fichier de configuration de l instance nano /usr/local/plone/zinstance/buildout.cfg Dans la section eggs rajouter la ligne suivante : plone.app.ldap Cette section du fichier de configuration permet de spécifier les modules (plugin) à récupérer lors de la création de l instance. Dans le cadre du projet, cette ligne permet le support des annuaires LDAP. 9

10 Dans la section ZCML rajoutez la ligne suivante : plone.app.ldap Cette section du fichier de configuration permet de spécifier les paramètres supplémentaires pour certains plugins. Il est possible dans la section «ports» de spécifier le port d écoute pour l instance. Par défaut celui-ci est fixé à Nous conserverons ce port pour la suite du manuel. Placez-vous à l emplacement suivant cd /usr/local/plone/zinstance/ Lancez la création de l instance./bin/buildout Ne tenez pas compte des alertes éventuelles affichées à l écran, si l opération aboutie, l instance a correctement été créée Informations et structure Une fois l instance créée, Plone respecte la structure suivante : /usr/local/plone/zinstance/ : contient l intégralité des données propres à l instance de Plone /usr/local/plone/zinstance/bin : contient les binaires (exécutables) /usr/local/plone/zinstance/products : contient les modules supplémentaires pour les anciennes versions de Plone (n est pas utilisé lors de l installation à partir du fichier de configuration buildout.cf) /usr/local/plone/zinstance/var/log : contient les logs propres à l instance /usr/local/plone/zinstance/var/filestorage : Contient la base de données (Data.fs) Pour ajouter de nouveaux plugins à votre instance, il suffit de mettre à jour votre fichier de configuration buildout.cfg (/usr/local/plone/zinstance/buildout.cfg) puis relancer la commande./bin/buildout Si vous désirez mettre à jour votre version de Plone, il suffit de lancer la commande./bin/buildout n. Les nouveaux binaires seront automatiquement téléchargés depuis le site officiel de Plone et installés. 10

11 Lancement/arrêt de l instance Pour lancer l instance, il suffit de taper la commande suivante : /usr/local/plone/zinstance/bin/plonectl start Pour tester si l instance est correctement lancée, ouvrez un navigateur internet et tapez l adresse suivante : (si le port configuré est celui par défaut) Vous devriez obtenir la capture suivante : Pour stopper l instance, il suffit de taper la commande suivante : /usr/local/plone/zinstance/bin/plonectl stop Interface de management Pour configurer la plateforme, vous devrez utiliser deux interfaces de configuration : L interface de management de Zope : Il s agit de l interface principale. Plone étant une surcouche de Zope, les premiers éléments de configuration devront s effectuer dans l interface de Zope. L interface de votre site : comme nous le verrons plus tard, il est possible de déclarer dans Zope, plusieurs sites Plone. Chaque site possède sa propre interface de configuration. Toute modification au sein de l interface d un site n a d impact que sur le site lui-même. Il est possible de passer d une interface à une autre très facilement. L interface d un site étant hébergée dans Zope, vous pouvez directement configurer votre site depuis l interface de Zope, mais cela s avère moins conviviale. L interface d un site, permet de basculer vers l interface de Zope mais uniquement pour configurer les éléments du site lui-même. 11

12 Modification du mot de passe d administration Il est intéressant de modifier le mot de passe par défaut donné lors de l installation de Plone (/usr/local/plone/zinstance/adminpassword.txt) Connectez-vous à l interface d administration Tapez le mot de passe et le login par défaut Vous pouvez le retrouvez dans le fichier suivant/usr/local/plone/zinstance/adminp assword.txt Cliquez sur «Root Folder» Vous pouvez naviguer dans l arborescence de l interface de Zope. Vous trouverez tous les éléments hébergés par Zope sous la forme d une architecture hiérarchisée comme pour un explorateur de fichier. Tout est objet sous Zope. Chaque élément représente un objet qui peut en contenir d autre. Chaque objet à ses caractéristiques et ses attributs, obligatoires ou non. Vous pouvez copier, couper, coller chaque objet. De même que vous pouvez en créer de nouveau ou en supprimer. Cliquez sur «acl_users» Cliquez sur «users» Dans cette interface vous pouvez configurer de nouveaux utilisateurs et les utilisateurs existants. Attention, ces utilisateurs impactent l ensemble de tous les sites collaboratifs que vous hébergerez. Cliquez sur l utilisateur «admin» 12

13 Changez le login de l utilisateur et cliquez sur «Update User» Cliquez sur «Password» Changez le mot de passe associé à votre utilisateur, puis cliquez sur «Update Password» L interface vous demandera alors de vous réauthentifier en utilisant votre nouveau login et password. Attention, l utilisateur pour lequel vous venez de changer le mot de passe est un compte administrateur. Il a donc plein pouvoir sur Zope et par héritage sur tous les sites Plone hébergés. 13

14 4. Déclaration du site Plone Il est maintenant nécessaire de déclarer votre site de travail collaboratif. Zope est un logiciel reposant sur une base de données dans laquelle on stocke des objets d un type particulier. Un site Plone est considéré comme un objet spécifique qu il faut déclarer dans l interface d administration de Zope. Vous pouvez déclarer plusieurs objets de type Plone correspondant à plusieurs sites de travail collaboratif différents. Dans notre cas, nous déclarerons un seul site. Connectez-vous à l interface d administration Cliquez sur «Root Folder» Chaque objet dans Zope peut être créé, copié, coupé, supprimé. Un site Plone respecte ces règles. Il faut donc commencer par supprimer le site Plone créé par défaut lors de l installation. Cochez la case située à gauche du site «Plone (Portal)» Cliquez sur «delete». Le site de type Plone crée par défaut est maintenant supprimé. Nous allons maintenant déclarer le site associé au projet Dans le menu déroulant «ATContentTypes Tool», sélectionnez «Plone Site» puis cliquez sur «Add» 14

15 Dans la nouvelle fenêtre qui vient d apparaitre tapez l id de votre site. Il s agit du complément à taper dans l adresse internet de votre serveur pour accéder à votre site. Il faut donc respecter la syntaxe d une adresse web (pas d espaces, pas de caractère spéciaux) Par exemple «partage-utec». L accès à votre site se fera donc par l adresse Dans «Title» indiquez le titre de votre site. Dans «Description» décrivez le but de votre site N ajoutez pas d extension Cliquez sur «Add Plone Site» Votre site apparait désormais dans la structure de Zope. Pour tester l accès à votre site, tapez dans votre navigateur 15

16 5. Interconnexion avec l annuaire LDAP Par défaut, les utilisateurs associés à votre site sont stockés localement. Vous avez ainsi plusieurs niveaux d utilisateurs. Les utilisateurs déclarés au niveau de Zope : c est le cas de l administrateur configuré précédemment. Ces utilisateurs ont accès à l ensemble des objets déclarés dans votre instance de Zope (donc votre site). Les utilisateurs déclarés au niveau du site : il s agit d utilisateurs uniquement configurés pour utiliser votre site. Dans le cadre du projet nous souhaitons que les utilisateurs déclarés au niveau du site soient issus de l annuaire LDAP hébergé par la plateforme SambaEdu de l établissement. Il est donc nécessaire d ajouter un nouveau module d authentification basé sur les plugins LDAP déclarés lors de l installation. Connectez-vous à l interface d administration Cliquez sur votre site La fenêtre de droite présente tous les éléments «ou objet» associé à votre site. Recherchez l élément «acl_users». Il contient la configuration d authentification. Cliquez sur l élément. 16

17 Dans l interface suivante, cliquez sur le menu déroulant et sélectionnez «Plone LDAP plugin» La fenêtre suivante permet de configurer les paramètres du plugin ID : Donnez un identifiant simple pour déclarer votre plugin plugin Title : Décrivez rapidement le rôle du LDAP Server : Indiquez le nom ou l adresse IP du serveur qui héberge l annuaire (indiquez le port si celui-ci n est pas standard (389 par défaut)) User Base DN : Indiquez l emplacement LDAP où sont stockés les utilisateurs (donnez son nom absolu Distinguished Name) Group storage : Choisissez «Groups not stored on LDAP server». Les groupes seront stockés localement et non dans l annuaire. Groups Base DN : Indiquez l emplacement LDAP où sont stockés les groupes (si les besoins futurs seraient de stocker les groupes dans LDAP) (donnez son nom absolu Distinguished Name) 17

18 Manager DN : Indiquez l utilisateur autorisé à se connecter à l annuaire (donnez son nom absolu Distinguished Name) Précisez le password associé (Dans le cadre du projet, il n est pas nécessaire de configurer un compte autorisé en écriture sur l annuaire. Il a été convenu dans le cahier des charges, que Plone utiliserait uniquement le plugin LDAP pour de la consultation. Si par la suite vous souhaitez pratiquer des opérations d écriture dans votre annuaire depuis Plone (création, suppression d un utilisateur ), indiquez un compte autorisé en écriture) User Password encryption : Sélectionnez le cryptage utilisé pour le stockage des mots de passe (crypt pour SambaEdu) Laissez les options non décrites par défaut Défault user role : Indiquez le rôle par défaut attribué aux utilisateurs inscrits dans l annuaire (ici nous décidons que chaque utilisateur sera au moins membre du site) Cliquez sur «Add» La fenêtre suivante permet de choisir les fonctionnalités prises en charge par le plugin. Nous vous conseillons de cocher les cases de la capture En effet, il faut uniquement cocher les fonctions nécessaires. Authentification : Le plugin sera utilisé pour authentifier les utilisateurs sur le site Properties : Le plugin sera utilisé pour récupérer des informations sur l utilisateur (adresse mail, prénom, nom..) User_Enumeration : Va de paire avec l authentification Etant donné que les groupes seront gérés en interne par Plone, le plugin LDAP ne sera pas utilisé pour ces derniers. Puis cliquez sur Update 18

19 Cliquez sur l onglet content Cliquez sur votre plugin Dans la nouvelle fenêtre, repérez la ligne «User object classes» Indiquez les attributs à récupérer pour les utilisateurs Pour SambaEdu : top,person Cliquez sur «Apply change» Cliquez sur l onglet «LDAP Schema» Il s agit ici de mapper les attributs LDAP avec les attributs utilisés en interne par Plone. Par défaut, Plone cherche à récupérer les mails des utilisateurs au mauvais endroit. Il faut donc cocher la case «mail» puis cliquez sur «delete» Dans «Add LDAP schéma item» Mapper l attribut ldap «uid» au «Friendly Name» «login», comme sur la capture ci-jointe. Cliquez sur «Add» 19

20 Faites de même pour l attribut mail. Rajoutez dans «Map to Name» . Cliquez sur «Add» Vous pouvez revenir à cette fenêtre de configuration si vous désirez mappez d autres attributs de l annuaire à des attributs Plone. Il faut désormais mettre à jour la configuration du plug-in Cliquez sur l onglet «Configure» Dans le menu déroulant «Login Name Attribute», sélectionnez «login(uid)». Il s agit d indiquez à Plone que le login correspond à l attribut uid que vous avez mappez précédemment. Faites de même pour «User ID attribute» et «RDN Attribute» N oubliez pas de cliquez sur «Apply Changes» Plone utilise un système hiérarchique dans l utilisation de ses plugins. Si plusieurs plugins remplissent les mêmes fonctionnalités, Plone utilise celui qui est placé en premier dans la liste des plugins disponibles. Afin d être certains d utiliser le plugin LDAP que vous avez définis, il est nécessaire de le placer en première position. Cliquez sur votre site Cliquez sur «acl_user» 20

21 Cliquez sur «plugins» Cliquez sur l onglet «Active» Dans la nouvelle fenêtre, vous trouverez les plugins disponibles («Available plugins») par fonction («plugin type»). La colonne «Active plugins» vous indique le plugin actuellement actif. Certaines lignes présentent plusieurs plugins comme étant actifs. Le plugin indiqué en premier est celui utilisé prioritairement Repérez les lignes pour lesquelles votre plugin LDAP n est pas indiqué comme prioritaire. Cliquez sur l onglet «Plugins» Cliquez sur «Properties Plugins» Dans la nouvelle fenêtre, repérez la case «Active Plugins». Sélectionnez votre plugin LDAP puis cliquez sur la flèche du haut pour faire remonter votre plugin en première position. Une fois l opération précédente terminée, cliquez à nouveau sur «Plugins». Renouvelez l opération précédente avec les autres fonctionnalités pour lesquelles votre plugin n était pas prioritaire (notamment : ) 21

22 Le plugin LDAP créé est désormais correctement configuré et votre site prêt à l utiliser. Si vous cliquez à nouveau sur l onglet «Active», vous observerez le même tableau que précédemment. Mais votre plugin LDAP apparait désormais en première position. Pour certaines fonctionnalités, votre plugin LDAP n est pas utilisé et reste donc dans «Available plugins» Vous pouvez tester le fonctionnement de vos manipulations en vous rendant sur votre site : Connectez-vous sur votre site Connectez-vous avec l administrateur de la plateforme Zope. (Définit au niveau de Zope) Cliquez sur «Configuration du site» Cliquez sur «Utilisateur et Groupes» Cliquez sur «tous» 22

23 Vous devez voir apparaitre les utilisateurs définis dans l annuaire avec les adresses mail associés. 23

24 6. Configuration fonctionnelle 6.1. Création des workflow Plone repose sur Zope qui permet de gérer des workflows. Un workflow représente le traitement et le chemin emprunté par une ressource documentaire pour gérer sa phase d exploitation. Plone fournit un certain nombre de workflows préconfigurés. Nous allons créer deux autres workflows personnalisés Workflow à 3 états Connectez-vous à l interface d administration Cliquez sur votre site Cliquez sur «portal_workflow» (En bas de page) Cliquez sur «Contents» La fenêtre suivante vous présente les différents workflows déclarés pour votre site. «Simpl_publication_workflow» est le workflow par défaut. Il comporte trois états. Nous allons copier ce dernier pour le modifier et créer un nouveau workflow. Cochez le workflow à copier. Cliquez sur «copy» Cliquez sur «paste» 24

25 Cochez le workflow copié «copy_...» Puis cliquez sur «Rename» Renommer le workflow. Attention, n employez pas d accents ou d espaces. Cliquez sur OK Cliquez sur votre workflow Vous pouvez préciser des informations sur votre workflow. Evitez les accents et les caractères spéciaux Cliquez sur l onglet «State» Vous retrouvez ici les trois états possibles d un document soumis à ce workflow. Pour chaque état est associé plusieurs transitions possibles Pending : En attente de publication Transitions possibles depuis cet état : publish : publié (accepter par le modérateur) rejeté : reject (rejeter par le modérateur) retiré : retract (demande de publication annulée) 25

26 Private : Privé Transitions possibles depuis cet état Publish : publié (le modérateur publie directement) Submit : demande de publication (l auteur demande à être publié) Published : Publié Transitions possibles depuis cet état retract : le document est retiré et rebasculé en privé reject: la demande de publication est rejetée et le document revient à sont état d origine. Vous pouvez décider d agir sur un état précis ou une transition en cliquant directement sur l élément souhaité. Cliquez sur «Pending» Cliquez sur «Permission» Le tableau vous présente les actions possibles sur le document pour cet état par les différents rôles possibles donnés à vos utilisateurs. Nous allons modifier les permissions comme sur la capture. Dans ce cas, si le document est dans l état en attente de publication (pending) : Le manager (Administrateur) peut supprimer, ajouter, modifier le document et la structure associée. Le propriétaire (Owner) peut accéder à son document mais plus le modifier. Le modérateur (Reviewer) peut supprimer, ajouter, modifier le document et la structure associée et le publier. Cliquez sur «Save Change» 26

27 Cliquez sur «states» pour revenir sur le choix d état. Nous allons maintenant modifier les droits pour l état privé (private) Cliquez sur «private» Cliquez sur «Permissions» Nous allons placer les permissions suivantes pour empêcher la lecture du contenu en anonyme. Cliquez sur «Save Change» Dans l état privé, seul le propriétaire et l administrateur peuvent modifier le contenu de l objet. Le Modérateur (reviewer) n a qu un accès en lecture. Enfin, on peut également préciser l état publié Ici, les éditeurs (editor) peuvent modifier le contenu de l objet en plus du propriétaire (Owner) et du modérateur (Reviewer). Pour résumer, ce workflow permet la gestion à trois états décrits dans le cahier des charges issu du projet. Quand l objet est crée il est dans l état privé. Seul son propriétaire peut le modifier. Le modérateur n aura qu un droit de lecture. Quand l auteur le décide, il peut demander une publication de son document. Dans cet état, le modérateur obtient les droits de modification et reste la seule personne avec l administrateur à pouvoir passer l objet dans l état publié. Une fois publié, chaque membre éditeur peut accéder et modifier le document (l éditeur et le contributeur sont identiques dans ce cas) Workflow à deux états Connectez-vous à l interface d administration 27

28 Cliquez sur votre site Cliquez sur «portal_workflow» (En bas de page) Cliquez sur «Contents» La fenêtre suivante vous présente les différents workflow déclarés pour votre site. «Simple_publication_workflow» est le workflow par défault. Il comporte trois états. Nous allons copier ce dernier pour le modifier et créer un nouveau workflow. Cochez le workflow à copier. Cliquez sur «copy» Cliquez sur «paste» Cochez le workflow copié «copy_...» Puis cliquez sur «Rename» 28

29 Renommez votre workflow et cliquez sur «Ok» Cliquez sur votre workflow Cliquez sur «States» Nous allons supprimer l état «pending» (en attente de publication). Cochez la case «Pending» puis cliquez sur «Delete». Nous allons supprimer les transitions qui permettent de passer d un état à un autre qui ne servent plus. Cliquez sur «Transitions» Sélectionnez la transition «retract (permet de refuser une publication)» et «submit (permet de demander une publication» Puis cliquez sur «Delete» 29

30 Comme pour le workflow à trois états, nous allons modifier les permissions associées. Cliquez sur «States», puis sur l onglet «private» Cliquez sur «Permissions» Lorsque le dossier est dans l état privé, nous souhaitons que seul son propriétaire, l administrateur et le modérateur puissent y avoir accès Faites de même pour l état «published», mais autorisez en lecture les membres «Reader» Ce workflow à deux états sera associé à un type de dossier. Il permettra de placer un dossier soit dans l état privé et rendre son contenu invisible aux membres avec des droits limités, soit dans l état publié et rendre son contenu visible Création d un nouveau type d objet Chaque workflow est associé à un objet documentaire (nouvelle, agenda, document ). Il est possible de définir de nouveaux objets. Nous vous conseillons de ne jamais modifier les objets par défaut. Afin d utiliser les nouveaux workflows définis précédemment, nous allons créer deux nouveaux objets. Cliquez sur votre site Cliquez sur «Portal_types» 30

31 Vous retrouvez ici tous les types de documents disponibles sous Plone. Document : Type de contenu rédigeable en ligne. Ce type permet de rédiger du texte directement depuis le site Event : Agenda File : Désigne tous type de contenu que l on peut déposer et récupérer depuis le site (.doc, fichiers divers ) Folder : Dossier : permet de contenir des objets News Item : Correspond à une «news» postée sur le site Topic : Collection Cochez «Folder» puis cliquez sur copy Cliquez sur «Paste» Cliquez sur la copie effectuée Donnez un titre et une description. N utilisez aucun caractère accentué, ni de caractères spéciaux. Ne mettez pas d espace dans le titre (utilisez _) Cliquez sur «Save Changes» 31

32 Cliquez sur «portal_types» pour revenir en arrière Cliquez sur le type créé, cochez la case correspondante et cliquez sur «Rename» Renommez le type (pas d accent ni d espace) Cliquez sur «Ok» Cochez la case correspondante à «Document» Puis cliquez sur «Copy» Cliquez sur «Paste» Cliquez sur l objet copié Donnez un titre et une description. N utilisez aucun caractère accentué, ni de caractères spéciaux. Ne mettez pas d espace dans le titre (utilisez underscore : _) Cliquez sur «Save Changes» Cliquez sur «portal_types» pour revenir en arrière. Cliquez sur le type créé, cochez la case correspondante et cliquez sur «Rename» 32

33 Renommez le type (pas d accent ni d espace) Cliquez sur «Ok» 6.3. Attribution d un workflow Il s agit maintenant d attribuer les workflows créés précédemment aux nouveaux types d objets que nous avons construits. A partir de cette partie, il n est plus nécessaire d utiliser l interface de management général de Zope. Nous utiliserons directement, l interface d administration assistée intégrée dans votre site. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Types» Ce menu permet d attribuer un workflow à un type d objet 33

34 Dans le menu déroulant, vous devriez voir apparaitre les deux types précédemment créés Sélectionnez le nouveau type de dossier Laissez les options par défaut Chaque nouveau type se voit attribuer un workflow par défaut (Simple workflow). Sélectionnez dans le menu déroulant «Processus documentaire», le workflow à deux états que vous avez créé. 34

35 Cliquez sur «Appliquer les changements» Faites de même avec le type «Document» que vous avez généré précédemment. Attribuez une politique de «versioning» Sélectionnez le workflow à trois états. Puis appliquez les changements 35

36 6.4. Configuration du serveur mail Il est nécessaire de déclarer votre serveur mail pour que les notifications puissent fonctionner. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Puis sur «Envoi de courriels» Déclarez votre passerelle SMTP ainsi que le numéro de port (25 par défaut) Si votre serveur SMTP nécessite une authentification, indiquez les informations nécessaires. Choisissez le nom d expéditeur ainsi que l adresse de ce dernier utilisée pour envoyer des mails à vos utilisateurs. 36

37 6.5. Activation des dossiers personnels Il est possible d attribuer à chaque utilisateur un dossier personnel. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Sécurité» Cochez la case «Activer les dossier d utilisateur» 6.6. Optimisation de l affichage Dans le cas ou le nombre d utilisateur est important, il est conseillé d activer l optimisation de l affichage. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Utilisateur et groupe» Cliquez sur «Paramétrage» 37

38 Cochez les deux cases affichées, puis cliquez sur «Enregistrer» 7. Gestion des utilisateurs et des groupes 7.1. Gestion des groupes Il a été décidé pour le projet de stocker les groupes localement et non dans l annuaire. Nous avons configuré le plugin LDAP en conséquence. Il faut donc déclarer les groupes dans Plone. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Utilisateurs et groupes» Cliquez sur «Groupes» Certains groupes sont définis par défaut. Il n est pas conseillé d y toucher. Cliquez sur ajoutez un nouveau groupe 38

39 Donnez un identifiant unique à votre groupe. Le titre servira de repère. Vous pouvez donner une description et associer une adresse . Puis cliquez sur «Enregistrer» Vous pouvez associer des rôles à un groupe. Par défaut, nous conseillons de donner au moins le rôle «Membre» Attention, il est possible d appliquer des rôles au niveau utilisateur pour augmenter ou diminuer les droits. Créer autant de groupe que nécessaire. Il est conseillé faire un schéma au préalable de vos groupes sur papier afin de bien identifier vos besoins. 39

40 La maquette repose sur le schéma suivant : 40

41 Pour respecter ce schéma nous devrons réutiliser l interface de Zope. Un bug subsiste depuis la version 2.5 de Plone ( Le placement d un groupe dans un autre n est pas visible depuis l interface de Plone. Bien qu identifié, ce problème ne sera pas corrigé avant les versions post 3.2. Connectez-vous à l interface de zope (utilisez le compte administrateur général pour vous authentifier): Sélectionnez votre site Cliquez sur «acl_users» Cliquez sur «source_groups» Vous retrouvez l ensemble des groupes créés précédemment Cliquez sur le point d interrogation situé en face du groupe dans lequel vous souhaitez placer un autre groupe Dans l emplacement de recherche, indiquez le groupe que vous souhaitez inclure, puis cliquez sur «Search». Dans la fenêtre «Available», sélectionnez le groupe trouvé puis cliquez sur la flèche vers la droite. Vous retrouvez dans la fenêtre «Active» les membres (utilisateurs ou groupes) incluent dans votre groupe principal. Pour sortir un groupe ou un utilisateur, il suffit de cliquer sur la flèche de gauche. 41

42 Reproduisez l opération pour tous vos groupes Gestion des utilisateurs Connectez-vous à l interface de Plone (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Utilisateurs et groupes» Cliquez sur «Groupes» Recherchez le groupe dans lequel vous voulez placer des utilisateurs. Cliquez sur le groupe Cliquez sur l onglet «Membres du groupe» Tapez le nom du membre à inclure. Cochez l utilisateur à inclure et cliquez sur «Ajouter les groupes et utilisateurs..» Répétez l opération pour tous les utilisateurs que vous voulez inclure dans votre groupe. 42

43 Les membres inscrits dans le groupe apparaissent immédiatement. Comme pour les groupes, il est possible d attribuer un rôle spécifique à un utilisateur. Par défaut nous avons configuré le Plugin LDAP pour qu il place chaque utilisateur dans l annuaire en tant que membre. Si vous souhaitez attribuer un rôle pour un utilisateur impactant l ensemble du site, vous devez donner les droits suffisants. Connectez-vous à l interface de Plone (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Utilisateurs et groupes» Assurez-vous d être dans l onglet «Utilisateurs» Recherchez souhaité l utilisateur Cochez le rôle que vous souhaitez attribuer à votre utilisateur. Puis appliquez les changements Attention, le rôle définit au niveau utilisateur supplante le rôle définit au niveau du groupe. 43

44 1.1.1 Rappel des rôles : Plone définit six rôles par défaut : Contributeur (Contribuor) : Utilisateur habilité à ajouter du contenu, il peut modifier les documents qu il a créé et édité ceux des autres. Il peut copier et coller des objets dans les répertoires pour lesquelles il est déclaré. Editeur (Editor) : Un éditeur peut uniquement éditer les documents des autres, mais ne pas en créer. Il peut bénéficier du droit de soumettre à publication un document. Lecteur (Reader) : Peut uniquement lire du contenu Modérateur (Reviewer) : Peut publier des documents lors qu ils sont en attente de publication. Il dispose d une vue particulière qui lui permet de voir les documents en attente de publication. Ne peut pas voir les documents privés. Administrateur (Manager) : Possède tous les droits sur le site Membre (member) : N a pas de droit pas défaut, dispose simplement d un accès au site Un dernier rôle est disponible «anonyme», il concerne tous les utilisateurs non authentifiés du site. Ces rôles définissent des droits pour les utilisateurs. Ces droits n ont de valeur que par rapport aux workflows associés aux types d objets que vos utilisateurs sont amenés à manipuler. Dans les étapes précédentes, nous avons vu comment créer un workflow et modifier les permissions. Il devient alors tout à fait possible de donner des droits d écriture à un membre lecteur si nous définissons les droits associés dans un nouveau workflow. Le lecteur pourra alors éditer uniquement les types d objets associés à ce workflow. 44

45 8. Manipulation des types Une fois vos groupes et utilisateurs correctement configurés, vous pouvez débuter la création des objets sur votre site Les dossiers Un dossier va permettre de contenir différents types de documents. Dans le cadre du projet, nous avons convenu de définir des dossiers qui respectent l organisation des groupes. Les dossiers associés aux projets seront hébergés dans les dossiers des sections concernées. Nous allons traiter l exemple de l architecture suivante : Eleves (Dossier vu par tous les utilisateurs du groupe «Elèves») Master (Dossier vu par les élèves de Master ASR (Dossier vu par tous les élèves en master du «groupe ASR») Plone (Dossier vu par tous les élèves en master section ASR associé au projet «Plone») Connectez-vous à l interface de Plone (utilisez le compte administrateur général pour vous authentifier): Ouvrez le menu déroulant «Ajout d un élément» Sélectionnez le nouveau type de dossier que vous avez créé précédemment pour lequel vous avez associé un workflow à deux états. 45

46 Donnez un titre à votre dossier et une description puis cliquez sur «Enregistrer» Cliquez sur l onglet «Partage» de votre dossier C est ici que vous allez définir les droits locaux applicables au dossier. Le contenu du dossier héritera de ces droits. Dans la case de recherche tapez les groupes ou les utilisateurs pour lesquelles vous souhaitez appliquer des droits. Cochez les droits que vous souhaitez donner à vos groupes ou utilisateurs Dans la capture ci-dessous, les groupes ASR, licence, GSITR auront un accès en lecture au contenu du dossier. Attention, nous ne pouvons pas directement déclarer le groupe «Elèves». En raison du bug évoqué précédemment, Plone n est pas capable de rechercher un utilisateur dans un sous groupe. Ce problème sera corrigé dans les versions suivantes du produit. L utilisateur Raphael Rispoli possédera lui tous les droits. Afin de casser l héritage des droits appliqué au site global. Décochez la case «Hériter des rôles des dossiers parents» 46

47 Cliquez sur votre dossier Nous allons maintenant créer les sous dossiers. Dans l onglet «Etat» passez votre dossier en «publié» afin de le rendre accessible aux groupes et utilisateurs définis. (seul les administrateurs pourront rebasculer le dossier en privée) Cliquer sur votre dossier principal Dans le menu déroulant «Ajout d un élément» sélectionnez «Dossier_Utec» 47

48 Donnez un titre et une description à votre sous dossier. Cliquez sur «Partage» Vous retrouvez dans les droits locaux hérités du dossier de niveau supérieur. Nous souhaitons restreindre le dossier au groupe ASR. Il va donc falloir casser l héritage. Décochez la case «Hériter des rôles des dossiers parents» 48

49 Attribuez comme précédemment les droits locaux que vous désirez. Vous pouvez désigner un membre comme ayant plus de droit sur le dossier. Vous pouvez ainsi créer toute une arborescence en fonction de vos besoins. Vous pouvez décider de conserver ou non les droits locaux lorsque vous descendez dans la structure d un dossier. Attention, si un utilisateur n a pas les droits sur un dossier de rang supérieur, il ne pourra accéder aux dossiers enfants même s il dispose des droits sur ces derniers. Pour un dossier dédié à un projet on peut imaginer les rôles suivants : Les membres du groupe associés au projet peuvent ajouter et voir les documents. Le chef de projet est modérateur du dossier Les documents Nous avons défini dans les étapes précédentes, un nouveau type d objet basé sur un document rédactionnel en ligne. Ce type d objet permet de poster un document directement modifiable depuis l interface du site sans recourir à un éditeur externe. Connectez-vous à l interface de Plone (utilisez un compte utilisateur standard): 49

50 Naviguez dans la structure autorisée pour l utilisateur connecté. Placez-vous dans le dossier ou vous désirez créer votre document. Cliquez dans le menu déroulant et sélectionnez le nouveau type de document que vous avez créé précédemment. Vous pouvez débuter la rédaction de votre document et bénéficier d un outil de rédaction. Le traitement de texte intégré dans Plone se nomme «Kupu». Son utilisation ne sera pas traitée dans ce manuel, mais le site officiel de Plone met à disposition un guide dédié à «Kupu» en français. Une fois votre document rédigé, vous pouvez l enregistrer. Nous avons associé le type de document créé à un workflow à trois états. La ressource documentaire est donc par défaut dans l état privé. Seul l utilisateur propriétaire du document est pour le moment autorisé à le modifier. Vous pouvez décider de publier le document pour le rendre accessible à vos collaborateurs. 50

51 Sous l identité de l utilisateur propriétaire, cliquez dans l onglet «Etat» du document. Cliquez sur «Soumettre à la publication» Le document est désormais en attente de validation, seul un modérateur peut valider la publication. Connectez-vous à l interface de Plone (utilisez un compte modérateur): Un modérateur dispose d une fenêtre supplémentaire dans laquelle il peut voir les documents en attente de publication. On retrouve donc logiquement le document soumis à publication précédemment. Cliquez sur l onglet «Etat» du document. Sélectionnez «Publier» pour valider la demande ou «Renvoyer» si vous refusez la publication. Si la publication est refusée, le document repasse dans l état privé. Si le document est publié, l ensemble des collaborateurs déclarés pour le dossier dans lequel est placé le document ont un accès à la ressource. Les utilisateurs avec des rôles définis pour l ensemble du site ont également la possibilité d accéder au document Rappel des types de documents Plone propose différentes ressources documentaires par défaut. Actualité : Permet de poster une «news» Document : Ressource rédigeable en ligne Fichier : Permet de poster un fichier (doc, PDF, avi.) Image : Permet de poster une image (jpg, gif, png) Lien : Permet de renvoyer vers une autre ressource Evénement : Permet de publier une tache dans l agenda partagé. Un autre type d objet existe. Il s agit d une «Collection». C est un «dossier virtuel», il permet de regrouper des ressources selon des critères de filtrage. 51

52 Par exemple, on peut imaginer une collection nommée «Cahier des charges» qui permet d accéder à tous les cahiers des charges de tous les projets. Ainsi, les documents ne sont pas physiquement hébergés dans la collection mais l utilisateur y accède comme si c était le cas. Ce manuel n a pas pour vocation de traiter spécifiquement les différents types disponibles dans Plone. Comme déjà vu dans les parties précédentes, il est possible de déclarer de nouveaux types, ou d en supprimer. Chaque type de document est associé à des workflows. Le traitement d un document peut donc être différent selon son type. Libre aux administrateurs du site d adapter les types et les workflows associés pour répondre aux besoins. 52

53 9. Gestion des notifications Plone permet de définir des règles spécifiques associées à chaque action effectuée sur le site. Ce système inclût la configuration de notification par mail et ceci à chaque niveau du site. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Cliquez sur «Configuration du site» Cliquez sur «Règles» Ce menu vous permet de définir des règles. Il s agit de déclencher des actions en fonction d événements. Cliquez sur «Ajouter une règle» 53

54 Donnez un titre et une description pour la règle Dans «Evénement déclencheurs» vous pouvez sélectionner le type d événement qui déclenchera les actions. - Object added to this container : Ajout d un objet dans un dossier - Object modified : Objet modifié - Object removed from. Objet supprimé - Workflow state changed Changement d état d un objet Pour l exemple, choisissez «Workflow state changed» Cliquez sur «Enregistrer» Cliquez sur votre règle 54

55 Vous pouvez affinez la condition dans le menu déroulant «Ajouter une condition» Pour respecter l exemple, nous allons affiner sur un état particulier du workflow Dans la fenêtre suivante on précise qu on ne considère que les états «En attente de modération» Dans le menu déroulant «Ajouter une action», nous configurons les actions à effectuer. Sélectionnez «Send » pour provoquer un envoi d . Renseignez les informations qui seront incluses dans le mail, ainsi que l adresse de l expéditeur et du destinataire (chef de projet). Cliquez sur «Enregistrer» Une fois la règle déclarée et configurée, il faut maintenant l appliquer à un conteneur utilisé sur le site. En tant qu administrateur, rendez vous dans le dossier pour lequel vous voulez appliquer la règle. Cliquez sur l onglet «Règles» 55

56 Dans le menu déroulant «Affecter une règle ici», vous pouvez sélectionner les règles disponibles. On retrouve la règle créée précédemment. Sélectionnez la règle souhaitée Si vous voulez que la règle soit héritée dans les sous dossier cliquez sur la case «Appliquer aux sous dossier» Vous retrouvez dans le panneau de contrôle, l ensemble des règles appliquées à votre dossier. Vous pouvez désactiver une règle ou réduire son héritage. 56

57 10. Personnalisation du site Plone offre la possibilité de personnaliser l interface du site. Ce manuel n a pas pour objectif de traiter ce point de façon détaillée mais simplement d introduire quelques concepts Ajout d un portlet Un portlet est un cadre affiché dans l interface du site qui permet d accéder à certaines fonctionnalités. Il peut être intéressant d utiliser ce concept pour offrir des options supplémentaires aux utilisateurs. Dans l exemple suivant nous allons configurer un portlet qui permet d accéder au moteur de recherche de google et de wikipedia. Connectez-vous à votre site (utilisez le compte administrateur général pour vous authentifier): Repérez sur la page d accueil, le bouton «Gérer les portlets» Dans le menu déroulant «Ajouter un portlet», sélectionnez «Static text portlet» Donnez un titre à votre portlet Cliquez sur le carré «html» comme sur la capture Supprimez tout le contenu déjà existant dans le champ «texte» 57

58 <form id="searchbox_demo" action=" method="get" name="cse" enctype="application/x-www-form-urlencoded"> <input type="hidden" name="cref" size="20" maxlength=" " /> <input type="hidden" name="ie" value="utf-8" size="20" maxlength="2048" /> <input type="hidden" name="hl" value="fr" size="20" maxlength="2048" /> <input title="recherche Google" type="text" name="q" size="33" maxlength="2048" /> <br /> <input type="submit" name="sa" value="recherche Google " size="10" maxlength=" " /> </form> <script type="text/javascript" src=" </script> <form action=" method="get" enctype="application/x-www-form-urlencoded"> <input title="recherche Wikipedia" type="text" name="q" size="33" maxlength="2048" /> <br /> <input type="submit" name="sa" value="recherche Wikipedia" size="10" maxlength=" " /> </form> Copiez le texte présenté ici dans le corps de texte du portlet. Il s agit du code qui va permettre d interagir avec le moteur de recherche de Google. Tapez le texte suivant si vous désirez implémenter le moteur de recherche de wikipedia Puis cliquez sur «Enregistrer» logo. Personnalisation du logo Il est possible de personnaliser le graphisme du site. L exemple suivant vous présente comment changer le Connectez-vous à l interface d administration Cliquez sur votre site Repérez l élément «Portal_skins» Vous y trouverez l ensemble des objets en rapport avec l aspect visuel de votre site. 58

59 Repérez le dossier «plone_images» Vous y trouverez toutes les ressources de type images utilisées pour la présentation de votre site. Cliquez sur «logo.jpg (Plone)» La fenêtre suivante vous indique la source du fichier image utilisée pour votre site. Cliquez sur «Customize» pour importer votre propre logo 59