Alfresco, Google Docs et Document ODF

Dans cette article, nous vous proposons de mettre en oeuvre l'intégration des documents ODF pour la fonctionnalité « Google docs » mise à disposition dans Alfresco.
Nous utilisons la version Alfresco 4.0.d community pour la mise en place de ces tests.
Seuls les formats ODT (Texte) et ODS (tableur) seront ajoutés, en effet Google Docs n'a pas aujourd'hui implémenté le format ODP (Présentation). Voir liste des formats disponible pour google Docs en fin d'article.
Nous en profitons aussi pour mettre à jour l'ancien article sur ce blog à propos de googledocs, en effet depuis la version 4.x quelques modifications ont été apportées au paramétrage de googledocs pour alfresco.
 
Pour finir cette introduction, Je vous informe que l'article, l'implémentation et les tests ont été effectués par Damien Kerfers actuellement en stage chez TekoNorma.
 

Sommaire

    1. Gérer les types de document ODF
    2. Paramétrer les labels dans alfresco Share
    3. Ajouter les icônes aux nouvelles entrées
    4. Paramétrages de Google docs
    5. Pour finir

1. Gérer les types de document ODF (odt, ods)

 
Pour qu'Alfresco soit capable de gérer d'autres types de fichiers que les fichiers Microsoft Office (Word, Excel…) il suffit de paramétrer Alfresco en modifiant le fichier suivant :
<tomcat>/shared/classes/alfresco/web-extension/share-config-custom.xml
 
Voici un extrait du fichier :
<alfresco-config>
...

<!-- Google Docs Integration -->
<config evaluator="string-compare" condition="DocumentLibrary" replace="true">
<google-docs>
<enabled>true</enabled>
<creatable-types>
<creatable type="odt">application/vnd.oasis.opendocument.text</creatable>
<creatable type="ods">application/vnd.oasis.opendocument.spreadsheet</creatable>
<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>
</alfresco-config>

 

Les balises creatable précisent les types MIME gérés (exemple « application/vnd.oasis.opendocument.text ») et l'extension du fichier associée (exemple « odt »).
 
ATTENTION :  Il faut redémarrer Alfresco pour prendre les modifications en compte
 
Si vous copiez le code tel quel vous remarquerez que dans Alfresco Share, si vous voulez créer un fichier, des éléments se sont rajoutés dans la liste, mais qu'ils ne sont pas très explicites.

 

Affichage des nouveaux types de Doc ODF

 

Pour remédier à cela nous devons définir les messages à afficher pour ces nouveaux éléments dans Alfresco.

2. Paramétrer les labels dans Alfresco Share

Pour modifier le message de base qui s'affiche dans Alfresco Share, nous devons modifier le fichier :
<tomcat>/webapps/share/WEB-INF/webapps/share/WEB-INF/classes/alfresco/messages/slingshot_<language>.properties
language est évidemment la langue du client.

 

Pour rajouter des messages aux types précédemment créés, il suffit de rajouter les lignes en suivant la syntaxe suivante :
google-docs.<type>=<message>
où type est l'attribut « type » du type MIME que l'on a rajouté dans la partie précédente.
Des entrées existent déjà pour les types Microsoft Office, il suffit juste de rajouter les entrées à côté de celles déjà existantes.
 
Exemple :
google-docs.odt=Document OpenOffice pour Google Docs&trade;...
google-docs.ods=Feuille de calcul OpenOffice pour Google Docs&trade;...
google-docs.doc=Document Google Docs&trade;...
google-docs.xls=Feuille de calcul de Google Docs&trade;...
google-docs.ppt=Pr\u00e9sentation de Google Docs&trade;..
 
ATTENTION :  Il faut redémarrer Alfresco pour prendre les modifications en compte
On obtient un meilleur résultat :
affichage de la présence des nouveaux types de doc ODF
 
Mais ce n'est pas parfait, il nous manque les icônes.

3. Ajouter des icônes aux nouvelles entrées

Si vous voulez avoir une icône à côté de votre message tout neuf, il faut rajouter une image au format PNG avec une taille en 16×16 dans le dossier suivant :
<tomcat>/webapps/share/components/images/filetypes/
 
L'image doit respecter un nom bien défini :
<type>-file-16.png
<type> est l'attribut « type » du type MIME.
 
Exemple : odt-file-16.png, si on a défini le type « odt » dans le fichier share-config-custom.xml dans la partie 1.
Nul besoin de redémarrer Alfresco ici, si l'image ne s'affiche pas, videz le cache de votre navigateur web et réactualiser la page.
Voici le résultat final que l'on peut obtenir :

 

Affichage des icones

4. Paramétrage de googlesdocs

Depuis la version 4.x googledocs est en mode https.

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 ces adresses)
googledocs.url=https://docs.google.com/feeds/default/private/full
googledocs.downloadurl=https://docs.google.com/feeds/download

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

# Google docs spreadsheet service name
googledocs.spreadsheet.service.name=wise
googledocs.spreadsheet.downloadurl=https://spreadsheet.google.com/feeds/download

5. Pour finir

Voici la liste des formats de document supportés par Google docs (information wikipedia) :

 

 

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée.