Le Multi-tenancy (MT) est une architecture logicielle, où une seule instance du logiciel alfresco s’exécute sur un serveur, tout en mettant à disposition des organisations clientes multiples (les locataires) des instances indépendantes. Le Multi-tenancy s’oppose avec une architecture multi-instance, où des logiciels distincts (ou matériels) sont mis en place pour les organisations de clients différents. Avec une architecture multi-tenancy, l’application est conçu pour partitionner ses données et sa configuration, de sorte que chaque organisation cliente travaille avec une instance de l’application virtuelle personnalisée et indépendante.

Alfresco peut être configuré comme une instance unique dans un environnement multi-client. Cela permet à plusieurs clients indépendants d’être hébergés sur une instance installé sur un serveur. L’instance de base d’Alfresco est alors partitionné logiquement de telle manière qu’elle apparaisse pour chaque client comme instance unique.

Mise en place du Multi-Tenancy

Par défaut, Alfresco supporte une instance unique (ST) pour son environnement. La mise en place du Multi-tenancy sur Alfresco permettra l’exécution d’une instance pour chaque client. Toutes ces instances seront mises à disposition à partir d’un seul serveur Alfresco.

Afin de permettre un environnement multi-tenancy, vous devez renommer les trois fichiers suivants en supprimant l’extension .sample. Les fichiers sont disponible dans le répertoire suivant, $Alfresco_Home/tomcat/shared/classes/alfresco/extension/mt:

• Renommer mt-context.xml.sample en mt-context.xml
• Renommer mt-admin-context.xml.sample en mt-admin-context.xml
• Renommer mt-contentstore-context.xml.sample en mt-contentstore-context.xml

Après modification des trois fichiers redémarrer Alfresco pour initialiser le Multi-Tenancy.

Création d’un « espace client » (Tenant)

L’utilisateur administrateur par défaut « admin » d’Alfresco peut être considéré comme le super utilisateur des « espaces clients ». Tous les clients peuvent être administrés par l’utilisateur « admin » à partir de la console d’administration des « espaces clients ».

Pour accéder à la console d’administration des « espaces clients », vous devez vous connectez à l’interface explorer d’Alfresco en utilisant le compte « admin ».

L’URL pour accéder à la console d’administration des « espaces clients » se trouve à l’adresse suivante :

http://<nomduserveur> :<port>/alfresco/faces/jsp/admin/tenantadmin-console.jsp

Voir la capture d’écran suivante :

Illustration 1: Capture de la fenêtre d’administration des « Espaces Clients »

Pour créer un « espaces clients » à partir de la console d’administration des « espaces clients » à titre d’exemple, saisir la commande suivante :

create apie.com password /usr/tenant/apie

Dans cet exemple, apie.com est le domaine du nouvel « espace client », password est le mot de passe de l’administrateur de l’« espace client » et apie est le nom de l’« espace client ».

Maintenant, admin@apie.com est le compte administrateur de l’« espace client » apie.com.

Utilisation d’un « espace client »

Suite à la création de notre nouvel « espace client » apie.com notre Alfresco contient maintenant 2 « espaces Clients » :

1. Le premier espace par défaut
2. Le deuxième apie.com

Connecter vous à l’explorer d’Alfresco avec le compte administrateur admin@apie.com et son mot de passe password, vous accédez à la page d’accueil du nouvel « espace client » de apie.com, voir la capture suivante :

Illustration 2: page d’accès à « Company home » de l »espace client » apie.com

La gestion des utilisateurs, des espaces, la sécurité, les scripts, les règles métier et les recherches sont spécifiques à l’« espace client » apie.com.

L’administrateur (admin@apie.com) peut créer les utilisateurs, qui auront un accès local à ce site « espace client ». Les utilisateurs créés pour cet « espace client » doivent se connecter avec le nom de domaine apie.com. Par exemple, si l’ID utilisateur est user1, alors l’utilisateur doit se connecter avec le login user1@apie.com.

De même, les dossiers et les contenus créés ne pourront être consultés et recherchés uniquement par les utilisateurs de l’« espace client ».

Le comportement vis à vis des « espaces clients » est identique pour l’ensemble des interfaces tels que : CIFS, FTP, WebDAV. Quelques soient l’interfaces la connexion via un compte id@apie.com aura accès uniquement à l’« espace client » apie.com.

Voir la capture d’écran ci-dessous d’une connexion webdav :

Illustration 3: Connexion webdav sur l’espace client apie.com

Gestion des « espaces clients »

En tant que super administrateur, vous pouvez activer ou désactiver les « espaces clients », de même, vous pouvez exporter ou importer les données des « espaces clients », vous pouvez effectuer d’autres tâches administratives, telles que changer le mot de passe administrateur de l’« espace client », gérer les utilisateurs, les groupes ou les sous-groupes.

Le tableau suivant liste plusieurs commandes importantes qui sont utiliser pour la gestion des « espaces clients ».

Exportation et importation des données d’un « espace client »

Dans le cadre d’une activité de maintenance, vous pouriez avoir besoin de faire une exportation de données spécifiques d’un « espace client ».

Par exemple, la commande suivante exécutée à partir de la console d’administration des « espace client » pour exporter la totalité de l’« espace client » apie.com dans le répertoire /opt/ sera

export apie.com /opt/

Vous noterez que les fichiers générés lors de l’exportation sont tous préfixé avec le domaine de l’« espace client ».

• apie.com_models.acp
• apie.com_spaces.acp
• apie.com_spaces_archive.acp
• apie.com_system.acp
• apie.com_users.acp
• apie.com_versions2.acp

De façon identique, vous pouvez recréer un « espace client » par importation des fichiers à partir d’une source donnée.

La syntaxe pour l’importation sera la suivante :

import apie.com /opt/exportdir/

Remarques sur le multi-tenant

La liste suivante sont les technologies qui ne sont aujourd’hui par supportées / implémentées / testées dans la mise en place d’un « espace client » (multi-tenant).

• WCM / Web Studio
• LDAP, NTLM and authentication methods other than « alfresco »
• Inbound Email
• Content Replication
• IMAP
• SPP / VTI (SharePoint Protocol)

Le CIFS est à valider.

Test du multi-tenant

Les tests du multi-tenant ont été effectués sur une machine linux mandriva 201.1 avec Alfresco Community version 3.3g (installation de base) et une base de donnée Postgresql version 8.4.4.

Compatibilité Share

Le multi-tenancy gère aussi bien l’interface Alfresco DM que l’interface SHARE.

Des tests fonctionnels sous SHARE sont nécessaires pour une complète validation fonctionnelle.

Références

Ce document se base sur la documentation anglaise du wiki d’Alfresco et du livre en anglais « Alfresco3 ECM Implementation » disponibles au Édition PackT Publishing, ainsi que des différents tests effectués à partir d’Alfresco Community version 3.3g.

En effet, la dernière version officielle d’Alfresco Communitiy comporte une nouvelle fonctionnalité à partir de share permettant de modifier ces fichiers Bureautique (MSoffice et openoffice.org) directement via google docs.

Ce qui vous permettra d’effectuer des modifications de documents de n’importe quel poste, quelques soient l’OS, les logiciels bureautique disponibles.

Table des matière

1. Google Docs

2. Alfresco et Google Docs

2.1 Utilisation de Google Docs à la création de document

2.2 Utilisation de Google Docs pour les documents importés

2.3 Configuration de la fonction d’édition dans Google Docs

1. Google Docs

Pour ce qui ne connaîtrait pas Google Docs. C’est une application mise à disposition de Google qui vous permet de créer et modifier des documents bureautique directement via votre navigateur internet. Les document prise en compte sont : le fichier texte, tableur et presentation.

Les focntionnalités ne sont pas aussi importantes que les outils disponibles localement comme MSoffice et Openoffice.org, mais largement suffisante pour 80% des cas d’utilisation journalière.

Il est aussi possible au travers de Google docs de travailler de façon collaborative sur un document en invitant d’autres utilisateurs et de corrigé de façon simultané le document.

Il vous sera nécessaire d’avoir un compte chez google pour accéder à ces fonctionnalités.

Pour plus d’information je vous renvoie à cette page : http://www.google.com/google-d-s/intl/fr/tour1.html

2. Alfresco et Google docs

Depuis la version 3.3g il est possible d’accèder à google docs via la librairie documentaire de Share.

Vous avez 2 possibilités de travailler avec google docs :

1. Soit en créant un nouveau document,
2. Soit à partir d’un document existant importé dans alfresco Share.

2.1 Utilisation de Google Docs à la création de document

Je considère que vous avez accès à un site share et que vous avez les droits de création et de modification sur la documentation.

Pour la création de document vous aviez précédemment la possibilité de création les documents suivants :

1. fichier plein texte
2. fichier XML
3. fixhier HTML

Maintenant, vous avez la possibilité de créer des documents de type :

1. Google Docs Document
2. Google Docs Tableur
3. Google Docs Presentation

Voici une capture d’écran du nouveau menu de création de document en ligne :

menu creation de document

choisi de créer un google docs document. Vous devez remplir le formulaire suivant :

formulaire de création de google docs

Seul le champ « Name » du document est obligatoire. Cliquer sur le bouton « Create« .

Création du googe docs document

Le document est alors créer dans votre librairie documentaire. Celui-ci est vide.

Document créer vide

Si vous regarder dans la liste des actions du documents, vous constaterez que celui -ci possède l’aspect « Google docs« . Cette aspect se matérialise par l’accès à l’action checkout google docs. voir l’illustration suivante :

Aspect Google Docs sur le document

l’Aspect « Google Docs » est automatiquement affecté au contenu nouvellement créé.

Cliquer sur l’action « Checkout to Google Docs« , pour vous permettre de modifier votre document en toute sécurité sous google docs.

Alfresco effectue les actions suivantes :

1. Création d’une copie de travail,
2. envoie de la copie de travail sous « Google Docs ».

Vous pouvez alors accéder à votre document en cliquant sur le lien « Google Docs » qui est apparu dans l’interface Share, voir l’illustration suivante :

Accès au document sous Google Docs

Vous pouvez alors renseigner votre document directement sous Google Docs :

Modification du document sous Google Docs

A la fin des modifications, revenir sous Share. Cliquer sur « Checkin from Google Docs » afin de prendre en compte les modifications.

Alfresco Share effectuera les opérations suivantes :

1. Sauvegarde du fichier document de Google Docs dans share,
2. Suppression de la copie de Travail,
3. Suppression du document dans Google Docs.

Checkin du document dans Google Docs

Vous pouvez constater dans l’illustration suivante, que le document initialement créé n’est plus vide.

Document Google Docs après publication

2.2 Utilisation de Google Docs pour les documents importés

Il est aussi possible de prendre tout type de document compatible avec « Google Docs » et de la modifier via Google docs. Pour ce faire vous devez ajouter au document l’aspect « Google Docs ».

Pour l’exemple, prenons le document de la capture suivante, un document openoffice ODT :

Document odt openoffice.org importé dans la librairie Share

Celui-ci ne possède pas l’action « Checkin Google Docs« , nous allons lui donner l’Aspect « Google Docs« , clique sur l’action « Manage Aspects« . vous accédez à l’écran suivant :

Ajout de l'Aspect Google Docs

Celui-ci est disponible au bas de la liste des aspects disponible. Appliquer les changement, ce qui vous permet d’accéder au « checkout to Google docs » pour votre document openffice.org ODT.

accès à l'action "checkin to Google Docs"

2.3 Configuration de la fonction d’édition dans Google Docs

Pour avoir la fonction d’édition dans « Google Docs », il vous sera nécessaire de renseigner la fichier : alfresco-global.properties (disponible sous $ALF_HOME/tomcat/alfresco/classes/

Ajouter les lignes suivantes, et modifier juste le username et le password :

# Enables google editable functionality
googledocs.googleeditable.enabled=true

# Google docs application name
googledocs.application.name=Alfresco ECM system

# Google docs URL (ne pas modifier cette adresse)
googledocs.url=http://docs.google.com/feeds/default/private/full

# System google docs authentication credentials
googledocs.username=votrelogin_google
googledocs.password=votrepassword_google

# Google docs spreadsheet service name
googledocs.spreadsheet.service.name=wise

Voilà, il ne vous reste plus qu’à tester cette nouvelle fonctionnalité.

Google Docs prendra en charge aussi bien vos document MSoffice que OpenOffice .org.

Attention pour ce qui concerne le format de openXML, celui-ci peut ne pas être bien  pris en compte notamment pour ce qui concerne les fichiers de présentation.

# Enables google editable functionality
googledocs.googleeditable.enabled=true

# Google docs application name
googledocs.application.name=Alfresco ECM system

# Google docs URL
googledocs.url=http://docs.google.com/feeds/default/private/full

# System google docs authentication credentials
googledocs.username=votrelogin_google
googledocs.password=votrepassword_google

# Google docs spreadsheet service name
googledocs.spreadsheet.service.name=wise

Un petit post pour parler d’un article paru dans le Linux pratique de mars-avril 2010 (http://www.linux-pratique.com/).

Linux Pratique N 58

Pour l’occasion Linux Pratique à créer une rubrique : « Solutions Professionelles ».

Je vous cite l’introduction de l’article :

« Un projet industriel au sens large (informatique, produit d’assurance, produit banquaire) nécessité la mise en oeuvre de nombreuses expertises. Celles-ci partent d’un besoin exprimé et cet article se propose de discuter de la problématique ardue de la gestion de la documentation dans un projet »

linux_pratique article alfresco

L’article pose le postulat d’un besoin pour une société dans l’industrie du logiciel de gérer sa documentation au travers du processus de conception du « chargé de clientèle » jusqu’au « chargé de qualité » en passant par la production et le développement.

Le besoin ressenti étant la mise en place d’une solution collaborative autour de la documentation. L’auteur (p-e-g ?) ayant l’expérience des technologies MOSS (Microsoft Office Sharepoint Server) et Alfresco propose d’appréhender les avantages/inconvénient de ces 2 solutions.

Ne pas oublier que nous sommes dans une revue défendant le libre et l’open-source, excellente au demeurant pour la découverte du monde linux pour tout type de profil utilisateur.

L’article commence par présenter MOSS dans ces grands principes et notamment une étude de prix (estimation) pour une structure de 10 personnes. Choses que je ne peux pas juger n’ayant aucune idée de la tarification de MOSS. L’approche, et les arguments sont honnêtes et pertinents.

Puis vient la présentation d’Alfresco, avec la présentation de sa double licence sur le modèle de REDHAT et MySql. Je ferais juste une remarque de l’auteur qui sous-entend que seule la version entreprise support les bases de données commerciale. Cette affirmation demande une confirmation, il me semble que la version communautaire peut se connecter sur Oracle ou SqlServer.

Le reste de l’article que je vous laisse découvrir présente la mise en place  de groupe et d’utilisateur dans l’interface share d’Alfresco. Vous y découvrirez aussi la mise en place de l’intégration de MSOffice dans Alfresco à partir du protocole SharePoint mise au point par Alfresco. Ainsi que le versionning, l’édition par check-in check-out permettant de faciliter le travail collaboratif.

La conclusion est plutôt surprenante vis à vis de la solution ouverte Openoffice.org. Nous ne pourrons qu’être désolé que l’éditeur ne fasse pas d’effort vis à vis de openoffice.org pour offrir une solution équivalente de sharepoint. Je sais qu’il existe des projets en cours du coté de la communauté, mais aujourd’hui aucun n’a aboutie.

En conclusion, l’article fait de la lumière sur un projet vraiment très intéressant pour les entreprises et notamment les PME. Alfresco leur permet en effet d’accéder à des processus d’entreprise qui il n’y a pas si longtemps n’étaient disponible que pour les « Grand comptes ». Encore faut-il que les PME soit au courant de ces projets opensource et libre existent.

Ce petit post pour vous signaler la mise en place d’un compte rendu de notre soirée Cenabumix autour d’Openoffice.org.

A l’ordre du jour:

1. Point sur Openoffice.org
2. Point sur les évolution à venir de la version 3.2, 3.3 et 4.0 (projet Renaissance)
3. Et une présentation du projet ooo4kids (openoffice.org pour les jeunes de 7 à 12 ans).

Bonne lecture.

Comme promis voici mon nouveau POST pour vous expliquer la marche à suivre pour utiliser PostgreSQL à la place de Mysql comme base de données sur Alfresco.

Quelques préliminaires

Tout mes tests ont été effectués sur une linux Mandriva 2009.1, avec la dernière version d’Alfresco la 3.2r2 disponible depuis le 23 novembre 2009. La version de PostgreSQL est la 8.3.

Tout d’abord, depuis la version 3.2x Alfresco utilise pas defaut Mysql, d’ailleurs lors de l’installation une interface d’aide à la création de la base de données est proposée.

[[Image]]

Remarque : L’installeur graphique sous linux pose des problèmes, notamment le paramétrage de la base de données Mysql, ainsi que la localisation d’openoffice.org.

Il est préférable d’exécuter l’installeur en ligne de commande.

prompt> ./Alfresco-Community-3.2r2-Linux-x86-Install -mode console

Voir l’installation en suivant le post suivant : installation_Alfresco.

Pour finir ces préliminaires, je tiens à signaler que l’avenir de Mysql pour l’instant n’est pas très rose. L’Europe fait tout ce qu’elle peut auprès d’ORACLE pour permettre la libération du projet dans le cadre du rapprochement ORACLE/SUN, mais cela ne va pas être facile. Donc en attendant, je pense que faire le choix de PostGreSQL est certainement une bonne initiative de pérennité (espérons qu’Alfresco reprendra sa copie pour réintégrer PostgreSQL dans son projet) .

Bien sur, je laisse les spécialistes dire tout le bien du projet PostgreSQL qui n’a rien à envier au projet Mysql, voir même plutôt le contraire.

Installation de PostgreSQL

L’installation de PostgreSQL sur Mandriva s’effectue par l’utilisation de la commande urpmi (je suppose que vos dépôts sont à jour). Les 2 packages suivants sont nécessaires : postgresql et postgresql-server.

prompt> urpmi postgresql8.3-server

prompt> urpmi postgresql8.3

Par défaut, la base de données aura le nom « alfresco » et l’utilisateur avec tous les droits et son mot de passe sera : « alfresco » et « alfresco« . Bien évidemment ces valeurs doivent être modifiées selon votre projet.

initialisation de la base de données Alfresco

Lors de l’installation, un utilisateur « postgres » est créé. Se connecter sur l’utilisateur « postgres » :

prompt> su -l postgres

Executer le shell de postgres :

prompt> psql

Créer la base de données :

prompt_postgres# CREATE DATABASE alfresco;

Créer l’utilisateur :

 prompt_postgres# CREATE USER alfresco;

Créer le mot de passe de l’utilisateur :

 prompt_postgres# ALTER USER alfresco WITH ENCRYPTED PASSQORD 'alfresco'; 

Donner les droits à l’utilisateur sur la base de données :

 prompt_postgres# GRANT ALL ON DATABASE alfresco TO alfresco;

Voilà, nous avons terminé l’initialisation de postgresql.

Pour sortir du pormp_postgres :

 prompt_postgres# \q

Initialisation d’Alfresco

Comme dit précédemment Alfresco par défault ne contient pas la gestion de la base de donnée PostgreSQL. Par conséquent, il vous faudra effectuer quelques manipulation.

Installation du driver java de postgresSQL

Vous devez aller à l’adresse suivante (http://jdbc.postgresql.org/download.html) pour récupérer le bon driver jdbc, celui-ci doit correspondre à 2 points :

1. A votre version de PostgreSQL
2. A votre version de java (attention Alfresco ne fonctionne pas bien avec openJDK, il faut utiliser le java de SUN).

Le fichier doit être copier : « dossier_installation-Alfresco/tomcat/lib/ »

Pour information, dans ce dossier, vous trouverez entre autres le jdbc de Mysql.

Paramétrage des « properties » pour la prise en charge le PostgreSQL

Les modifications sont à effectuer dans le fichier « alfresco-global.properties« .

Depuis la version 3.2, Le fichier est situé dans le dossier : « dossier_installation-Alfresco/tomcat/shared/classes/ »

Sous la partie Mysql, après avoir commenté les lignes de Mysql, ajouter les lignes suivantes (en bleu).

…
#
# MySQL connection
#————-
#db.driver=org.gjt.mm.mysql.Driver
#db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}
#hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

#
# PostgreSQL connexion
#
db.driver=org.postgresql.Driver
db.url=jdbc:postgresql://${db.host}:${db.port}/${db.name}
hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
hibernate.query.substitutions=true TRUE, false FALSE

…

Installation de PostgreSQL sur Alfresco

Depuis la version 3.2x, PostgreSQL n’est plus installé par défaut dans Alfresco. Il faut, par conséquent, récupérer un package (fichier amp, postgres-3.2r.amp) alfresco pour l’intégrer. Ce package est disponible sur le site de téléchargement: http://wiki.alfresco.com/wiki/Community_Edition_file_list_32r.

Vous remarquerez que l’adresse de téléchargement n’est pas la dernière version 3.2r2 mais la 3.2r. En effet, la version 3.2r2 n’est pas encore disponible. Généralement, elle est disponible quelques semaines après la sortie de la dernière version. Cela n’est pas trop grave car la version précédente 3.2r est compatible avec la dernière version d’ALfresco la 3.2r2.

Pour finir copier le fichier téléchargé (postgres-3.2r.amp) dans le dossier amps disponible dans le répertoire d’installation d’alfresco.

Déploiement d’un package amp

Alfresco fourni un programme java permettant le déploiement des packages amp. Ce programme est appelé par un script shell disponible à la racine du dossier d’installation d’Alfresco. le fichier s’appelle apply_amps.sh.

Avant de l’executer il vous faudra mettre a jour 2 variables d’environnement (en bleu) et corriger les 2 lignes (en bleu) de traitement java en modifiant $APPSERVER par $CATALINA_HOME, sinon le traitement ne marche pas.

#!/bin/sh
# ——-
# Script for apply AMPs to installed WAR
# ——-
ALF_HOME=/opt/Alfresco
export JAVA_HOME= »/usr/lib/jvm/java/ »
export PATH=$PATH:$JAVA_HOME/bin
cd « $ALF_HOME »
export CATALINA_HOME= »$ALF_HOME »/tomcat
echo « This script will apply all the AMPs in ./amps to the alfresco.war file in $CATALINA_HOME\webapps »
echo « Press control-c to stop this script . . . »
echo « Press any other key to continue . . . »
read RESP
#java -jar bin/alfresco-mmt.jar install ./amps $APPSERVER/webapps/alfresco.war -directory
java -jar bin/alfresco-mmt.jar install ./amps $CATALINA_HOME/webapps/alfresco.war -directory
#java -jar bin/alfresco-mmt.jar list $APPSERVER/webapps/alfresco.war
java -jar bin/alfresco-mmt.jar list $CATALINA_HOME/webapps/alfresco.war
echo « About to clean out tomcat/webapps/alfresco directory and temporary files… »
echo « Press control-c to stop this script . . . »
echo « Press any other key to continue . . . »
read DUMMY
rm -rf $CATALINA_HOME/webapps/alfresco
sh $CATALINA_HOME/bin/clean_tomcat.sh

Puis lancer le script shell. Celui-ci installera tous les package amp disponible dans le dossier amps.

prompt> ./apply_amps.sh

Penser à retirer les packages amp du dossier amps, pour ne pas les réinstaller lors d’un nouveau chargement d’un package amp..

Voilà, normalement, maintenant il vous suffit de lancer alfresco et vous aurez un super système ECM avec la base de données PostgreSQL.

A bientôt pour de nouvelle aventure …

Alfresco utilise la technologie AOP (Aspect Oriented Programming – Programmation orientée objet) comme framework de développement. Cela permet de modifier le comportement de l’application serveur sans toucher aux codes de l’application. Les règles « métier » profitent de cette technologies et nous permettent de modifier le comportement du serveur sans programmation.

Gestion des règles

Une règle « métier » est définie suivant les trois notions suivantes :

1. les conditions,
2. Les Actions,
3. Les déclencheurs.

La mise en place, des règles « métier », s’effectue en trois étapes :

1. la mise en place des conditions d’application des règles,
2. les actions à appliquer,
3. quelles sont les évènements déclencheurs.

Les conditions

Les conditions servent à définir sur quels contenus seront appliqués les règles métier.

Conditions des règles

Lors de la première étape de l’assistant il vous sera possible de choisir le contenu en fonction des critères suivants :

1. Une chaîne de caractère présente dans le nom du fichier,
2. Un document appartenant à une ou plusieurs catégorie,
3. Un type de format de document basé sur le type MIME,
4. Un document possédant un ou plusieurs aspect,
5. Un document ayant une propriété de type texte, date ou valeur numérique.

Vous pouvez croiser n’importe quelles conditions pour sélectionner le document. Le document doit répondre à toutes les conditions pour que la (ou les) règle(s) s’applique(nt).

Récemment il a été ajouté la possible de faire une sélection de type conditionnel en sélectionnant « Composite Choice ». Cela vous permet de spécifier autant de condition que vous voulez en les combinant avec la composant « OU ». Dans ce cas le document doit correspondre à une des conditions pour que les règles s’appliquent.

Conditionnel

Les actions

Un assistant vous aide dans la déclaration de vos actions.

Liste des actions

Lors de la deuxième étape de l’Assistant de création des règles, nous avons accès à la liste des actions suivantes (le libellé en anglais est fourni entre parenthèse) :

• Ajouter un ou des aspects (Add aspect to item) : Ajouter des propriétés et des comportements aux documents ou à un espace.
• Ajouter un processus simple (Add simlpe Workflow : ajouter un processus simple d’approbation documentaire avec possibilité de rejet sur un espace.
• Libération du document (Check in Content : Libération du document préalablement réservé pour modification.
• Réservation du document (Check out content : Réservation du document pour modification.
• Copier du document dans un espace défini (Copy item to specific space) : Copier le document dans un espace spécifique.
• Exécuter un script (Execute a script) : exécuter du code JavaScript
• Extraction de Meta-données du document (Extract Common metadara fields from content) : Extraire des méta-données du document
• Importation d’un ensemble de contenu Alfresco (Import Alfresco content package) : Importation d’un ensemble de contenu
• Attaché des catégories au document (Link item to category) :Attacher aux documents une ou des catégories spécifiques
• Déplacer un document dans un espace défini (Move item to a specific space) : Supprimer le document de l’espace actuel et le déplacer vers l’espace défini.
• Supprimer un aspect à un article (Remove an aspect from an item) : Supprimer une propriété ou un ensemble de propriétés aux documents ou à un espace.
• Envoyer un email à des utilisateurs définis (Send an email to spécific users) : envoyer un email à des utilisateurs définis ou groupes d’utilisateurs.
• Définir le type d’un document (Specialize the type of an item) : Définir le type de contenu pour le document (type MIME).
• Transformer et Copier un document dans un espace spécifique (Transform and copy content to a specific space) : Transformation d’un document de type bureautique tel que un ODF vers PDF avec la possibilité de le placer dans un autre espace.
• Transformer et Copier une image dans un espace spécifique (Transform and copy image to a specific space) : Transformation d’un document de type graphique tel qu’un JPG vers le format PNG avec la possibilité de le placer dans un autre espace.
• Blog_post (Blog_post) : Aucune idée, j’ai fait un test mais cela ne marche pas !!! POST sur le Forum attente réponse.
• Incrémentation d’un compteur (Incrément counter) : ????, pas encore testé.

Liste des différents « Aspect » pour l’action correspondant à « Ajouter un ou des aspects »

Liste des aspects

Liste des aspects disponibles quand vous choississez « Ajouter un ou des aspects» :

• Catégorisable (Classifiable) : Activer la notion de catégorisation pour permettre d’attacher des catégories au document.
• Conformité (Complienceable) : Ajouter une propriété de conformité« suppression à partir du (Remove after) » date à laquelle le document n’est plus valide.
• Dublin Core (Dubli core) : Ajouter les métadonnées Dublin Core pour le document. Dublin Core Metadata comprend les méta-données tels que Éditeurs, Auteurs, Sujet, et les Droits.
• Applicabilité (Effectivity) : Ajouter des propriétés d’applicabilité « applicable du (Effective from) » et « applicable au (Effectivity to) » dates pendant les quellles le document est applicable.
• Alias Mail (Email Alias) : Ajouter une propriété d’alias aux documentx ou à un espace.
• Réception de courriel (Emailed) : Ajouter un ensemble de propriétés nommé « Courrier électronique de données (Email data) » sur le document. Cet aspect est utilisé pour récupérer les informations de la messagerie, notamment si le courriel contient des documents en pièce jointe.
• Localisation (Localisable) : Ajoute une propriété de Localisation au document.
• Résumé (Summarizable) : Ajoute une propriété Résumé au document.
• Catégorisation (Taggable) : Ajoute la propriété de « catégorisation (taggable) » au document.
• Modèle (Templatable) : Activer le modèle de vue.
• Multilinguisme (Translatable): Ajouter la propriété « Multilingue (Translations) » au document.
• Versionable (Versionable) : Activer le versioning.

Les Déclencheurs

Lors de la troisième étape, nous aurons le choix de définir quel sera le déclencheurs de notre règle métier. Trois possibilités sont proposées :

1. Entrant (InBound) : Tout document arrivant dans l’espace, qu’il soit nouveau, copié ou déplacé,
2. Sortant (OutBound) :Tout document sortant de l’epace, qu’il soit supprimé ou déplacé,
3. Mise à jour (Update) : Tout document mise à jour, qu’il soit téléchargé ou sauvegardé.

Liste des déclencheurs

Si la règle métier doit s’appliquer dans les trois cas, il faudra créer 3 règles.

Celle-ci porte le non de Alfresco-Community-v3.2r2 (noter bien le petit 2 ajouté derrière le r).

Les nouveauté de cette version sont les suivantes :

• Mise en place de l’implémentation de la version CMIS 1.0 draft4 (Content Management Interoperability Services, service de gestion de contenu interopérable), avec appelle aux testeurs sur cette nouvelle implémentation (je ferais plus tard un post sur CMIS). La version précédente la 3.2r supportait la version 0.61. CMIS est disponible à l’adresse suivante : http://<host>:<port>/alfresco/service/cmis/index.html
• Correction et amélioration sur le RM (Record Management) DOD5015.2 pour la création de site de gestion des archives de document en version US (gestion au travers de l’interface Share).

Autres améliorations :

1. AVM DAO Refactor, remplacement d’Hibernate avec iBatis (sans modification de l’API AVM et de la configuration),
2. Amélioration de l’extracteur de mail IMAP, configuration de propriétés d’extraction du message e-mail,
3. Studio Web n’est plus installé par défaut,
4. Pour plus de sécurité, vous devez spécifier un mot de passe administrateur valide,
5. Options d’exportation
   • La possibilité d’exclure une liste d’aspects et / ou d’associations enfants,
   • La possibilité de maintenir la structure des dossier et les noms de fichiers dans une exportation ACP.
6. Améliorations de javascript pour les autorisations RM,
7. améliorations extensions de Share : Configuration possible d’action sur les documents de la librairie
   http://wiki.alfresco.com/wiki/Custom_Document_Library_Action#Configuration_.28V3.2_onwards.29
8. Diverses améliorations et mises à jour du projet mobile incluant
   • Le support de sites favoris,
   • Le support de l’URL de base /mobile,
   • Suppression des liens inactifs,
   • Résolution des problèmes de nommage de site.

Cliquer ici pour accéder à la page de téléchargement d’Alfesco Community v3.2r2

Sommaire

1. Préinstallation
2. Installation d’Alfresco
3. Connexion de la base de données
4. Lancement d’Alfresco
5. Utilisation d’Alfresco

Préinstallation

Les packages suivants sont nécessaires pour le bon fonctionnement d’Alfresco

1. le sdk java de SUN (la dernière fois que j’ai testé openjdk cela n’avait pas fonctionné, il faudra que je recommence des tests).
2. Une base de données mysql (la configuration pour postgresql sera aussi fourni)
3. openoffice.org et surtout n’oublier pas de le lancer au moins une fois pour lui déclarer java (comment ?).
4. ImageMagick, en effet Alfresco se sert de « convert » pour effectuer des transformations automatiques sur les images)
5. swftools, Alfresco utilise « pdf2swf » pour transformer à la volée les fichiers en swf (format flash) pour les visualiser directement au travers du navigateur sans avoir besoin de l’application source.

Normalement l’ensemble de ces applications sont déjà présentes sur votre linux, sinon elles sont disponibles sous formes de packages directement installables.

Installation d’Alfresco

Récupération d’Alfresco sur le serveur de l’éditeur suivre le lien suivant :

http://wiki.alfresco.com/wiki/Download_Community_Edition

Téléchargement d'Alfresco sur le site de l'éditeur

Prendre la version linux (bien évidement), Enregistrer le fichier dans votre espace.

Suivant l’endroit ou vous aller installer Alfresco, vous aurez peut-être besoin d’avoir les droits de l’administrateur (root).

Je vous conseille d’effectuer l’installation en mode console, l’installation graphique échoue trés souvent au moment de la détection d’openoffice.org (même en pratiquant le contournement proposé par Alfresco) et vous êtes obligé de stopper l’installation en cours. Pour effectuer l’installation en mode console, il suffit de faire :

prompt> ./install_alfresco -mode console

et suivre les instructions. Attention la base de donnée ne sera pas initialisée. Celle-ci devra être faite à la main. La procédure sera décrite ci-après.
Après installation il vous faudra configurer 2 fichiers.
A partir du répertoire d’installation (le répertoire ou vous avez déployé Alfresco), nous commencerons par modifier le fichier alfresco.sh

Vous devez renseigner 2 variables

1. ALF_HOME
2. JAVA_HOME

Les informations à renseigner sont en bleu, elles dépendent de votre environnement.

#!/bin/sh
# Start or stop Alfresco server
# Set the following to where Tomcat is installed
ALF_HOME=/home/jjt/Alfresco
cd « $ALF_HOME »
APPSERVER= »${ALF_HOME}/tomcat »
export JAVA_HOME=/usr/lib/jvm/java-6-sun/
# Set any default JVM values
export JAVA_OPTS=’-Xms128m -Xmx512m -XX:MaxPermSize=128m -server’
export JAVA_OPTS= »${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote »
# Following only needed for Sun JVMs before to 1.5 update 8
export JAVA_OPTS= »${JAVA_OPTS} -XX:CompileCommand=exclude,org/apache/lucene/index/IndexReader\$1,doBody -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo\$Merger,mergeIndexes -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo\$Merger,mergeDeletions »
#
if [ "$1" = "start" ]; then »
${APPSERVER}/bin/startup.sh »
# if [ -r ./virtual_start.sh ]; then
# sh ./virtual_start.sh
# fi
# if [ -r "$ALF_HOME"/start_oo.sh ]; then
# sh « $ALF_HOME »/start_oo.sh
# fi
elif [ "$1" = "stop" ]; then
« ${APPSERVER}/bin/shutdown.sh »
# if [ -r ./virtual_start.sh ]; then
# sh ./virtual_stop.sh
# fi
# if [ -r "$ALF_HOME"/start_oo.sh ]; then
# killall soffice.bin
# fi
fi

Depuis la version 3.2 la configuration globale c’est fortement simplifiée. Le deuxième fichier à configurer se trouve dans le répertoire à partir de la home directory : tomcat/shared/classes

Modifiez le fichier : alfresco-global.properties

Beaucoup d’informations sont déjà renseignées suite à l’installation préalable. Les lignes modifiées sont en bleu

###############################
## Common Alfresco Properties #
###############################
#
# Sample custom content and index data location
#————-
dir.root=./alf_data


#
# Sample database connection properties
#————-
db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306

#
# External locations
# Cette partie permet de renseigner les applications tierces permettant les transformations automatiques de type .doc en .pdf ou tiff en jpeg …
#————-
ooo.exe=/usr/bin/soffice
img.root=/usr
swf.exe=/usr/bin/pdf2swf
#

# MySQL connection
#————-
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

#
# Index Recovery Mode
#————-
#index.recovery.mode=Auto

#
# Outbound Email Configuration
# Cette partie permet de renseigner Alfresco pour lui permettre d’envoyer des mails aux utilisateurs
#————-
mail.host=votre serveur smtp
mail.port=25
mail.username=nom d’utilisateurmail.password=mot de passe
mail.encoding=UTF-8
mail.from.default=alfresco@alfresco.org
mail.smtp.auth=false
#

# Alfresco Email Service and Email Server

#————-
# Enable/Disable the inbound email service.  The service could be used by processes other than
# the Email Server (e.g. direct RMI access) so this flag is independent of the Email Service.
#————-
#email.inbound.enabled=true

# Email Server properties
#————-
#email.server.enabled=true
#email.server.port=25
#email.server.domain=alfresco.com
#email.inbound.unknownUser=anonymous

# A comma separated list of email REGEX patterns of allowed senders.
# If there are any values in the list then all sender email addresses
# must match. For example:
#   .*\@alfresco\.com, .*\@alfresco\.org
# Allow anyone:
#————-
#email.server.allowed.senders=.*

#
# To configure external authentication subsystems see:
# http://wiki.alfresco.com/wiki/Alfresco_Authentication_Subsystems
#————-
#authentication.chain=alfrescoNtlm1:alfrescoNtlm

#
# IMAP
# Cette partie permet de transformer votre alfresco en serveur IMAP et de vous connectez sur alfresco au travers de votre messagerie.
#————-
imap.server.enabled=true
imap.server.port=8143 (ou 143)
imap.server.host=Adresse IP de votre serveur alfresco

Connexion de la base de données

Mysql

Par défaut, Alfresco depuis la version 3.2 est paramétré pour fonctionner avec Mysql. Il est uniquement nécessaire de créer une base « Alfresco » avec l’utilisateur Alfresco et le mot de passe Alfresco. Un script d’initialisation est fourni pour la création de la base, de l’utilsateur et du mot de passe.

Le script se situe dans le répertoire (à partir de votre Home Alfresco) :

extras/databases/mysql

dans ce répertoire taper la commande :

prompt> mysql-u root -p < db_setup.sql

Demande du mot de passe root

Si tout c’est bien passé, la base est initialisée.

Postgresql

La mise en place de Postgresql sera Développée dans un prochain Post.

Lancement d’Alfresco

Au niveau du répertoire d’Alfresco saisir la commande suivante :

prompt> ./alfresco.sh start

Vous pouvez suivre les informations de log en ouvrant une nouvelle console et dans le repertoire d’alfresco, saisir la commande suivante :

prompt> tail -f tomcat/log/catalina.out

La commande tail permet d’afficher la fin du fichier de log, l’option -f permet de réactualiser l’affichage à chaque ligne de message. Cela vous permet de suivre tout les messages envoyé par défaut par Alfresco lors de la phase de lancement de l’application.

Si tout ce passe bien les derniers messages sont les suivants :

INFO: D�marrage de Coyote HTTP/1.1 sur http-808
01 nov. 2009 22:29:17 org.apache.catalina.startup.Catalina start
INFO: Server startup in 302506 ms

Utilisation d’Alfresco

Pour utiliser Alfresco, lancer votre navigateur internet et sasir l’adresse suivante :

http://localhost:8080/alfresco

ou

http://adresseIPduserveur:8080/alfresco

et vous obtenez la page suivante :

Page d'accueil en connexion invité (guest)

Vous êtes connecté sur la page de l’invité (guest).

Vous pouvez vous déconnecter en cliquant sur le coin en haut à droite (login (guest)), ce qui vous déconnecte et vous permet d’accéder à la page de login.

page de login

Pour accéder à l’administrateur, taper :

User Name : admin
password : amin
cliquer sur le bouton « login »

Vous êtes maintenant sur la page d’accueil de l’administrateur.

Page d'accueil de l'administrateur

A partir de cette page vous pourrez commencer à travailler sur Alfresco. Je vous conseille de commencer par créer un utilisateur afin de ne pas travailler sur le compte d’administration.

Dans les prochains post, nous verrons comment créer un utilisateur et des groupes. Bonnes découvertes.

N’oublier pas qu’aujourd’hui, les technologies de la gestion documentaire et de la gestion de contenu ne sont pas disponibles uniquement pour les Grands Comptes  et les  Sociétés du CAC 40.

N’hésitez pas à nous contacter pour toutes informations.

Cette install party comme ces dernières années sera organisée avec et au sein de l’IUT de la faculté d’Orléans.

L’install party aura lieu entre 14h00 et 18h00, à l’adresse suivante : IUT département informatique, rue d’Issoudun, 45100 Orléans La Source.

Venez nombreux, sans oublier d’avoir précédemment fait des sauvegarde de vos données sensibles et si possible une défragmentation du poste.

Vous pourrez choisir entre une distribution  ubuntu ou mandriva.

Voici l’affiche de l’évènement

install party 2009 cenabumix

plus d’information sur : cenabumix.org