Alfresco 29/03/2012

Tutoriel pour la mise en place d’Alfresco

SOMMAIRE
I. Présentation et installation d’Alfresco ----------------------------------------------------------------------------- 2
A. Présentation ---------------------------------------------------------------------------------------------------------- 2
B. Installation Alfresco 3.4.d avec MSSQL Server (attention le paramétrage fonctionne différemment) ---- 2
C. Installation Alfresco 3.3.g avec MySQL (conforme au paramétrage ci-dessous) ---------------------------- 4

II. Personnalisation et paramétrage ------------------------------------------------------------------------------------ 5

A. Paramétrage de l’accès à Google Docs --------------------------------------------------------------------------- 5
1. Condition de création d’un compte utilisateur Google --------------------------------------------------------- 5
2. Paramétrage d’Alfresco --------------------------------------------------------------------------------------------- 5
3. Observations----------------------------------------------------------------------------------------------------------- 8
B. Paramétrage de la langue utilisée --------------------------------------------------------------------------------- 8
C. Ajout de la fonctionnalité de sondages ---------------------------------------------------------------------------- 9
D. Réduction des fonctionnalités proposées -------------------------------------------------------------------------- 9

Page 1 sur 10
 Alfresco 29/03/2012

I. Présentation et installation d’Alfresco

A. Présentation

Alfresco est un système de gestion de contenu (en anglais ECM pour Enterprise Content
Management) open source en langage Java.
Il est à la base le résultat 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 décidé de bâtir une nouvelle société articulée sur le
logiciel libre.
La mission que se donne Alfresco est : « ouvrir le monde de la Gestion de Contenu afin
d’augmenter les innovations grâce à la participation de la communauté et au libre accès au
code source, et viser à fournir une application complète à moindre coût, et avec plus
d'agilité ».
La version dite « Community » est sous licence LGPL, donc librement téléchargeable,
modifiable, redistribuable et utilisable, dans les limites des règles établies par cette licence. La
version « Entreprise » s'en démarque principalement par l'offre de support technique associée;
n'y sont intégrées cependant que les nouveautés dûment testées et validées, ce qui la fait
différer très légèrement 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 systèmes d’exploitation, serveurs d’applications et
bases de données. Son interface utilisateur Web permet l’administration et l’accès aux
contenus; Elle est complétée par des possibilités d’accès aux documents via CIFS, NFS,
WebDAV et FTP. Alfresco est à la base plutôt orienté stockage de documents mais dispose
d’un module WCM (Web Content Management). Il propose des fonctionnalités en standard
telles que : gestion des permissions, indexation automatique, recherche simple et évoluée,
workflows, application automatique de règles sur les documents, versionnage, verrouillage de
documents en modification, conversion de documents (basée sur OpenOffice), scripting,
templates de présentation freemarker, …

B. Installation Alfresco 3.4.d avec MSSQL Server (attention le

paramétrage fonctionne différemment)

Télécharger sur le site d’Alfresco la version

Community 3.4d ou récupérer l’exécutable dans
mon dossier des fichiers d’installation.

Création de la base de données MS SQL Server,

nommée eedf_alfresco.

Lancer l’installation sur le serveur Windows.

Voir ci-dessous les étapes de l’installation.

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 l’archive SQLServer2008R2.zip fournie dans mon
dossier des fichiers d’installation.

Ajout du fichier jtds-1.2.5.jar fourni dans mon dossier des fichiers d’installation 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 remplaçant la deuxième 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 arrêter le serveur => \tomcat\bin\shutdown.bat

C. Installation Alfresco 3.3.g avec MySQL (conforme au

paramétrage ci-dessous)

Télécharger sur le site d’Alfresco la version Community 3.3.g ou récupérer l’exécutable dans
mon dossier des fichiers d’installation.

Lancer l’installation sur le serveur Windows. Choisir la langue « English » (impératif).

Choisir l’installation personnalisée.

Lancer le serveur.

Page 4 sur 10
 Alfresco 29/03/2012

II. Personnalisation et paramétrage

A. Paramétrage de l’accès à Google Docs
1. Condition de création d’un compte utilisateur Google

Conditions création adresse gmail : Conditions

5.5 Sauf si vous y avez été expressément autorisé par un accord distinct conclu avec Google,
vous acceptez de ne pas reproduire, dupliquer, copier, vendre, négocier ou revendre les
Services à quelque fin que ce soit.

8.5 Vous acceptez être le seul et unique responsable de tout Contenu que vous créez,
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 préjudice 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é expressément 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 société ou organisation dans des
conditions susceptibles engendrer, délibérément ou non, une confusion quant au propriétaire
ou à la personne licenciée pour utiliser ces marques, noms ou logos.

10. Licence de Google

10.1 Google vous concède, à titre gratuit, une licence personnelle, non-cessible, non-exclusive
et pour le monde entier, d’utilisation du logiciel qui vous est fourni par Google dans le cadre
des Services tels que fournis par Google (désigné ci-après le « Logiciel »). Cette licence est
exclusivement destinée à vous permettre d’utiliser et de bénéficier des Services fournis par
Google, dans le respect des présentes Conditions.

10.2 Vous ne pouvez pas (et vous ne pouvez autoriser aucune tierce personne à) copier,
modifier, créer une œuvre dérivée, désassembler, effectuer l’ingénierie inverse, décompiler ou
tenter de toute autre manière d'extraire le code source de tout ou partie du Logiciel, sauf si la
loi le permet ou l’exige expressément ou si vous y avez été expressément autorisé par écrit par
Google.

10.3 Sauf autorisation expressément accordée par écrit par Google, vous ne pouvez pas céder
(ou sous-licencier) vos droits d'utilisation du Logiciel, consentir une sûreté sur le Logiciel ou
vos droits d’utilisation ou céder de toute autre manière tout ou partie de vos droits d'utilisation
du Logiciel.

2. Paramétrage d’Alfresco

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>

Redémarrer Alfresco

Page 7 sur 10
 Alfresco 29/03/2012

3. Observations

On gère correctement l’édition avec Google Docs. Sur la page de modification d’un
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 l’on doit notifier ses identifiants et mots de passe lorsque l’on veut éditer en
ligne (l’identifiant doit correspondre à l’identifiant google ou à défaut l’adresse mail de
l’utilisateur). Les checkout/checkin se font quant à eux automatiquement avec les identifiants
mis en paramètres.

Rq : Le fichier \tomcat\webapps\alfresco\WEB-INF\classes\alfresco\subsystems\googledocs\
default\googledocs-context.xml contient les propriétés d’accès au service GoogleDocs, et en
particulier les identifiants et mots de passe utilisés sont accédés par les propriétés globales (cf
point 2 ci-dessus).

B. Paramétrage de la langue utilisée

Télécharger le package de langue française .

Le pack doit être décompressé 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 désirées.
Ne conserver que la ou les langues désirées.

Modifier et/ou créer 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\site-
webscripts\org\alfresco\components\navigation\collaboration-navigation.get_fr.properties
\tomcat\shared\classes\alfresco\web-extension\site-
webscripts\org\alfresco\components\dashboard\customise-dashlets.get_fr.properties

et le dossier \tomcat\shared\classes\alfresco\web-extension\site-
webscripts\org\alfresco\components\dashlets

pour certains oublis et/ou précisions de traduction.

Ajouter le dossier \tomcat\shared\classes\alfresco\web-extension\site-

webscripts\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/share-

extras/wiki/SitePollDashlet.

Récupérer mon fichier « site-poll-dashlet-0.4.1.jar » dans mon dossier d’installation OU

Ouvrir avec Eclipse par exemple le fichier jar « site-poll-dashlet-0.4.1.jar » qui se trouve dans
\tomcat\shared\lib ou télécharger les sources directement sur le site ci-dessus.

Il y a un problème avec le fichier de traduction \config\alfresco\site-webscripts\org\

sharextras\components\dashlets\site-poll.get_fr.properties (il a l’air correct mais c’est son
homologue anglais qui est pris en compte => déboguer ou écraser le fichier anglais).

Il y a un problème avec la gestion des dates (de démarrage de publication et de clôture du

sondage) => déboguer 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" />

Recréer le fichier jar, avec les commandes ant (cf le readme et/ou le site ci-dessus) ou avec
l’option d’extraction en JAR d’Eclipse.
Ajouter le nouveau fichier jar « site-poll-dashlet-0.4.1.jar » dans \tomcat\shared\lib.

Pour créer de nouveaux sondages, cliquer sur l’onglet sondages. Créer un groupe de sondages
(s’il n’y en a déjà ou si vous souhaitez créer un sondage dans une autre catégorie). Puis,
cliquer sur ajouter un élément et remplir le formulaire de création du sondage. Retourner sur
le tableau de bord du site et dans le bloc « Mes sondages », configurer le sondage à
afficher.(Dans le cas de l’affichage sous forme de liste, pas besoin)

D. Réduction des fonctionnalités proposées

Fichier modifié Pourquoi?

\tomcat\webapps\share\WEB-INF\classes\alfresco\site- - Réorganisation du
data\presets\presets.xml tableau de bord des
sites
- Simplification de la
barre des menus
\tomcat\webapps\alfresco\WEB- - Suppression des
INF\classes\alfresco\model\datalistModel.xml fonctionnalités autres
que sondage dans les
DataLists de l’onglet
Sondages
\tomcat\webapps\share\WEB-INF\classes\alfresco\site- Suppression des icônes
webscripts\org\alfresco\components\header\header.get.html.ftl dans l’entête

Page 9 sur 10
 Alfresco 29/03/2012

\tomcat\webapps\share\WEB-INF\classes\alfresco\site- Suppression onglet

webscripts\org\alfresco\components\navigation\collaboration- Membres dans la barre
navigation.get.html.ftl des menus
\tomcat\webapps\share\WEB-INF\classes\alfresco\site- Suppression des
webscripts\org\alfresco\components\title\collaboration- boutons sur la ligne des
title.get.html.ftl titres
\tomcat\webapps\share\WEB-INF\classes\alfresco\site- Modifier la liste des
webscripts\org\alfresco\components\document-details\document- actions disponibles dans
actions.get.config.xml la page des details d’un
document
\tomcat\webapps\share\WEB- Page des details d’un
INF\classes\alfresco\templates\org\alfresco\document-details.ftl document
\tomcat\shared\classes\alfresco\web-extension\share-config- Gestion des aspects
custom.xml visibles ou non d’un
document
\tomcat\webapps\share\WEB-INF\classes\alfresco\site- Suppression avatar sur
webscripts\org\alfresco\components\dashlets\colleagues.get.html.ftl la page d’accueil

http://localhost:8080/share/page/user/{user}/dashboard Accès tableau de bord utilisateur

http://localhost:8080/share/page/user/{user}/dashboard Accès profil utilisateur
http://localhost:8080/share/page/site-finder Recherche des sites
http://localhost:8080/share/page/people-finder Recherche dans l’annuaire
http://localhost:8080/share/page/repository Entrepôt
http://localhost:8080/share/page/console/admin-console/ Administration
http://www.alfresco.com/help/33/community/sharehelp/ Aide

Page 10 sur 10