Alfresco

29/03/2012

Tutoriel pour la mise en place dAlfresco

SOMMAIRE
I. A. B. C. II. A. 1. 2. 3. B. C. D. Prsentation et installation dAlfresco ----------------------------------------------------------------------------- 2 Prsentation ---------------------------------------------------------------------------------------------------------- 2 Installation Alfresco 3.4.d avec MSSQL Server (attention le paramtrage fonctionne diffremment) ---- 2 Installation Alfresco 3.3.g avec MySQL (conforme au paramtrage ci-dessous) ---------------------------- 4 Personnalisation et paramtrage ------------------------------------------------------------------------------------ 5 Paramtrage de laccs Google Docs --------------------------------------------------------------------------- 5 Condition de cration dun compte utilisateur Google --------------------------------------------------------- 5 Paramtrage dAlfresco --------------------------------------------------------------------------------------------- 5 Observations----------------------------------------------------------------------------------------------------------- 8 Paramtrage de la langue utilise --------------------------------------------------------------------------------- 8 Ajout de la fonctionnalit de sondages ---------------------------------------------------------------------------- 9 Rduction des fonctionnalits proposes -------------------------------------------------------------------------- 9

Page 1 sur 10

Alfresco

29/03/2012

I. Prsentation et installation dAlfresco

A. Prsentation
Alfresco est un systme de gestion de contenu (en anglais ECM pour Enterprise Content Management) open source en langage Java. Il est la base le rsultat des travaux d'une quipe qui provient massivement de Documentum, leader historique du march, mais aussi d'Interwoven pour la partie gestion de contenu web. Le co-fondateur d'Alfresco est aussi le co-fondateur de Documentum et vient s'ajouter la liste des entrepreneurs ayant dcid de btir une nouvelle socit articule sur le logiciel libre. La mission que se donne Alfresco est : ouvrir le monde de la Gestion de Contenu afin daugmenter les innovations grce la participation de la communaut et au libre accs au code source, et viser fournir une application complte moindre cot, et avec plus d'agilit . La version dite Community est sous licence LGPL, donc librement tlchargeable, modifiable, redistribuable et utilisable, dans les limites des rgles tablies par cette licence. La version Entreprise s'en dmarque principalement par l'offre de support technique associe; n'y sont intgres cependant que les nouveauts dment testes et valides, ce qui la fait diffrer trs lgrement de la version communautaire. Alfresco revendique une communaut de plus de 120 000 personnes dans le monde, pour plus de 60 000 serveurs en utilisation et plus de 1 500 clients souscripteurs. Il est compatible avec de nombreux systmes dexploitation, serveurs dapplications et bases de donnes. Son interface utilisateur Web permet ladministration et laccs aux contenus; Elle est complte par des possibilits daccs aux documents via CIFS, NFS, WebDAV et FTP. Alfresco est la base plutt orient stockage de documents mais dispose dun module WCM (Web Content Management). Il propose des fonctionnalits en standard telles que : gestion des permissions, indexation automatique, recherche simple et volue, workflows, application automatique de rgles sur les documents, versionnage, verrouillage de documents en modification, conversion de documents (base sur OpenOffice), scripting, templates de prsentation freemarker,

B. Installation Alfresco 3.4.d avec MSSQL Server (attention le paramtrage fonctionne diffremment)
Tlcharger sur le site dAlfresco la version Community 3.4d ou rcuprer lexcutable dans mon dossier des fichiers dinstallation. Cration de la base de donnes MS SQL Server, nomme eedf_alfresco. Lancer linstallation sur le serveur Windows. Voir ci-dessous les tapes de linstallation.

Page 2 sur 10

Alfresco

29/03/2012

Page 3 sur 10

Alfresco

29/03/2012

Ouverture avec WinRAR du fichier tomcat/webapps/alfresco.war et ajout dans le dossier \WEB-INF\classes des fichiers extraits de larchive SQLServer2008R2.zip fournie dans mon dossier des fichiers dinstallation. Ajout du fichier jtds-1.2.5.jar fourni dans mon dossier des fichiers dinstallation au dossier tomcat\lib. Remplacement du fichier \tomcat\shared\classes\alfresco-global.properties par celui de mon dossier. Modification du fichier \tomcat\bin\setenv.bat en remplaant la deuxime ligne par : set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF8 -Duser.timezone=GMT Xmx1024m -XX:MaxPermSize=256m Lancement du serveur : \tomcat\bin\startup.bat Remarque : pour arrter le serveur => \tomcat\bin\shutdown.bat

C. Installation Alfresco 3.3.g avec MySQL (conforme au paramtrage ci-dessous)

Tlcharger sur le site dAlfresco la version Community 3.3.g ou rcuprer lexcutable dans mon dossier des fichiers dinstallation. Lancer linstallation sur le serveur Windows. Choisir la langue English (impratif). Choisir linstallation personnalise.

Lancer le serveur.

Page 4 sur 10

Alfresco

29/03/2012

II. Personnalisation et paramtrage

A. Paramtrage de laccs Google Docs
1. Condition de cration dun compte utilisateur Google
Conditions cration adresse gmail : Conditions 5.5 Sauf si vous y avez t expressment autoris par un accord distinct conclu avec Google, vous acceptez de ne pas reproduire, dupliquer, copier, vendre, ngocier ou revendre les Services quelque fin que ce soit. 8.5 Vous acceptez tre le seul et unique responsable de tout Contenu que vous crez, transmettez ou affichez dans le cadre de votre utilisation des Services; vous assumez par ailleurs la responsabilit des vos actes (y compris toute perte ou tout prjudice souffert par Google) cet gard. Vous reconnaissez que Google ne saurait tre responsable ni votre gard ni celui d'autrui de ce fait. 9.6 Sauf si vous y avez t expressment autoris par crit par Google, vous reconnaissez que, dans le cadre de votre utilisation des Services, vous n'utiliserez aucune marque commerciale, marque de service, nom commercial, logo appartenant une socit ou organisation dans des conditions susceptibles engendrer, dlibrment ou non, une confusion quant au propritaire ou la personne licencie pour utiliser ces marques, noms ou logos. 10. Licence de Google 10.1 Google vous concde, titre gratuit, une licence personnelle, non-cessible, non-exclusive et pour le monde entier, dutilisation du logiciel qui vous est fourni par Google dans le cadre des Services tels que fournis par Google (dsign ci-aprs le Logiciel ). Cette licence est exclusivement destine vous permettre dutiliser et de bnficier des Services fournis par Google, dans le respect des prsentes Conditions. 10.2 Vous ne pouvez pas (et vous ne pouvez autoriser aucune tierce personne ) copier, modifier, crer une uvre drive, dsassembler, effectuer lingnierie inverse, dcompiler ou tenter de toute autre manire d'extraire le code source de tout ou partie du Logiciel, sauf si la loi le permet ou lexige expressment ou si vous y avez t expressment autoris par crit par Google. 10.3 Sauf autorisation expressment accorde par crit par Google, vous ne pouvez pas cder (ou sous-licencier) vos droits d'utilisation du Logiciel, consentir une sret sur le Logiciel ou vos droits dutilisation ou cder de toute autre manire tout ou partie de vos droits d'utilisation du Logiciel.

2. Paramtrage dAlfresco
Pour activer google docs sur Alfresco, il faut : Aller dans ./tomcat/shared/classes/alfresco-global.properties et ajouter : Page 5 sur 10

Alfresco

29/03/2012

# 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=supralog@hotmail.fr googledocs.password=supradmin # Google docs spreadsheet service name googledocs.spreadsheet.service.name=wise

Aller dans \tomcat\shared\classes\alfresco\web-extension\share-config-custom.xml et ajouter (ou simplement remplacer par mon fichier) :
<!-- Document Library config section --> <config evaluator="string-compare" condition="DocumentLibrary" replace="true"> <!-Whether the folder Tree component should enumerate child folders or not. This is a relatively expensive operation, so should be set to "false" for Repositories with broad folder structures. --> <tree> <evaluate-child-folders>false</evaluate-child-folders> </tree> <!-Used by the "Manage Aspects" action For custom aspects, remember to also add the relevant i18n string(s) cm_myaspect=My Aspect --> <aspects> <!-- Aspects that a user can see --> <visible> <aspect name="cm:generalclassifiable" /> <aspect name="cm:complianceable" /> <aspect name="cm:dublincore" /> <aspect name="cm:effectivity" /> <aspect name="cm:summarizable" /> <aspect name="cm:versionable" /> <aspect name="cm:templatable" /> <aspect name="cm:emailed" /> <aspect name="emailserver:aliasable" /> <aspect name="cm:taggable" /> <aspect name="app:inlineeditable" /> <aspect name="gd:googleEditable" /> </visible> <!-- Aspects that a user can add. Same as "visible" if left empty --> <addable> </addable>

Page 6 sur 10

Alfresco

29/03/2012

<!-- Aspects that a user can remove. Same as "visible" if left empty --> <removeable> </removeable> </aspects> <!-Used by the "Change Type" action Define valid subtypes using the following example: <type name="cm:content"> <subtype name="cm:mysubtype" /> </type> Remember to also add the relevant i18n string(s): cm_mysubtype=My SubType --> <types> <type name="cm:content"> </type> <type name="cm:folder"> </type> </types> <!-If set, will present a WebDAV link for the current item on the Document and Folder details pages. Also used to generate the "View in Alfresco Explorer" action for folders. --> <repository-url>http://localhost:8080/alfresco</repository-url> <!-Google Docs integration --> <google-docs> <!-Enable/disable the Google Docs UI integration (Extra types on Create Content menu, Google Docs actions). If enabled, remember to also make sure the gd:googleEditable aspect is made visible in the <aspects> section above. --> <enabled>true</enabled> <!-The mimetypes of documents Google Docs allows you to create via the Share interface. The I18N label is created from the "type" attribute, e.g. google-docs.doc=Google Docs&trade; Document --> <creatable-types> <creatable type="doc">application/msword</creatable> <creatable type="xls">application/vnd.ms-excel</creatable> <creatable type="ppt">application/vnd.ms-powerpoint</creatable> </creatable-types> </google-docs> </config>

Redmarrer Alfresco Page 7 sur 10

Alfresco

29/03/2012

3. Observations
On gre correctement ldition avec Google Docs. Sur la page de modification dun document, dans le menu Actions sur le document , on clique sur Checkout sous Google Docs puis sur View in Google Docs . On effectue alors les modifications et on sauvegarde dans Google Docs en cliquant sur la disquette par exemple. On quitte Google Docs pour revenir sous Alfresco Share et on clique sur Checkin from Google Docs . On observe que lon doit notifier ses identifiants et mots de passe lorsque lon veut diter en ligne (lidentifiant doit correspondre lidentifiant google ou dfaut ladresse mail de lutilisateur). Les checkout/checkin se font quant eux automatiquement avec les identifiants mis en paramtres. Rq : Le fichier \tomcat\webapps\alfresco\WEB-INF\classes\alfresco\subsystems\googledocs\ default\googledocs-context.xml contient les proprits daccs au service GoogleDocs, et en particulier les identifiants et mots de passe utiliss sont accds par les proprits globales (cf point 2 ci-dessus).

B. Paramtrage de la langue utilise

Tlcharger le package de langue franaise . Le pack doit tre dcompress dans : \tomcat\shared\classes\alfresco\

Editer le fichier \tomcat\shared\classes\alfresco\extension\web-client-config-custom.xml Retirer les marques de commentaire autour des listes des langues dsires. Ne conserver que la ou les langues dsires. Modifier et/ou crer les fichiers : \tomcat\shared\classes\alfresco\messages\slingshot_fr.properties \tomcat\shared\classes\alfresco\messages\common_fr.properties \tomcat\webapps\share\WEB-INF\classes\alfresco\messages\common.properties (changer directement dans la version anglaise) \tomcat\shared\classes\alfresco\web-extension\sitewebscripts\org\alfresco\components\navigation\collaboration-navigation.get_fr.properties \tomcat\shared\classes\alfresco\web-extension\sitewebscripts\org\alfresco\components\dashboard\customise-dashlets.get_fr.properties et le dossier \tomcat\shared\classes\alfresco\web-extension\sitewebscripts\org\alfresco\components\dashlets pour certains oublis et/ou prcisions de traduction.

Ajouter le dossier \tomcat\shared\classes\alfresco\web-extension\sitewebscripts\org\alfresco\components\data-lists pour des oublis de traduction.

Page 8 sur 10

Alfresco

29/03/2012

C. Ajout de la fonctionnalit de sondages

Si vous voulez des infos sur le module => http://code.google.com/p/shareextras/wiki/SitePollDashlet. Rcuprer mon fichier site-poll-dashlet-0.4.1.jar dans mon dossier dinstallation OU Ouvrir avec Eclipse par exemple le fichier jar site-poll-dashlet-0.4.1.jar qui se trouve dans \tomcat\shared\lib ou tlcharger les sources directement sur le site ci-dessus. Il y a un problme avec le fichier de traduction \config\alfresco\site-webscripts\org\ sharextras\components\dashlets\site-poll.get_fr.properties (il a lair correct mais cest son homologue anglais qui est pris en compte => dboguer ou craser le fichier anglais). Il y a un problme avec la gestion des dates (de dmarrage de publication et de clture du sondage) => dboguer cette fonctionnalit ou la supprimer en modifiant le fichier \config\alfresco\web-extension\poll-datalist-config-custom.xml Commenter les lignes ci-dessous (3 occurrences)
<show id="cm:from" /> <show id="cm:to" />

Recrer le fichier jar, avec les commandes ant (cf le readme et/ou le site ci-dessus) ou avec loption dextraction en JAR dEclipse. Ajouter le nouveau fichier jar site-poll-dashlet-0.4.1.jar dans \tomcat\shared\lib. Pour crer de nouveaux sondages, cliquer sur longlet sondages. Crer un groupe de sondages (sil ny en a dj ou si vous souhaitez crer un sondage dans une autre catgorie). Puis, cliquer sur ajouter un lment et remplir le formulaire de cration du sondage. Retourner sur le tableau de bord du site et dans le bloc Mes sondages , configurer le sondage afficher.(Dans le cas de laffichage sous forme de liste, pas besoin)

D. Rduction des fonctionnalits proposes

Fichier modifi \tomcat\webapps\share\WEB-INF\classes\alfresco\sitedata\presets\presets.xml Pourquoi? - Rorganisation du tableau de bord des sites - Simplification de la barre des menus - Suppression des fonctionnalits autres que sondage dans les DataLists de longlet Sondages Suppression des icnes dans lentte Page 9 sur 10

\tomcat\webapps\alfresco\WEBINF\classes\alfresco\model\datalistModel.xml

\tomcat\webapps\share\WEB-INF\classes\alfresco\sitewebscripts\org\alfresco\components\header\header.get.html.ftl

Alfresco \tomcat\webapps\share\WEB-INF\classes\alfresco\sitewebscripts\org\alfresco\components\navigation\collaborationnavigation.get.html.ftl \tomcat\webapps\share\WEB-INF\classes\alfresco\sitewebscripts\org\alfresco\components\title\collaborationtitle.get.html.ftl \tomcat\webapps\share\WEB-INF\classes\alfresco\sitewebscripts\org\alfresco\components\document-details\documentactions.get.config.xml

29/03/2012

Suppression onglet Membres dans la barre des menus Suppression des boutons sur la ligne des titres Modifier la liste des actions disponibles dans la page des details dun document \tomcat\webapps\share\WEBPage des details dun INF\classes\alfresco\templates\org\alfresco\document-details.ftl document \tomcat\shared\classes\alfresco\web-extension\share-configGestion des aspects custom.xml visibles ou non dun document \tomcat\webapps\share\WEB-INF\classes\alfresco\siteSuppression avatar sur webscripts\org\alfresco\components\dashlets\colleagues.get.html.ftl la page daccueil

http://localhost:8080/share/page/user/{user}/dashboard Accs tableau de bord utilisateur http://localhost:8080/share/page/user/{user}/dashboard Accs profil utilisateur http://localhost:8080/share/page/site-finder Recherche des sites http://localhost:8080/share/page/people-finder Recherche dans lannuaire http://localhost:8080/share/page/repository Entrept http://localhost:8080/share/page/console/admin-console/ Administration http://www.alfresco.com/help/33/community/sharehelp/ Aide

Page 10 sur 10