Alfresco et Liferay

« Doclib Portlet » avec Alfresco.

alfresco_liferay_01alfresco-logo

Nouvel article sur l’intégration d’Alfresco dans les portails de type j2ee. Cet article s’inspire fortement du wiki d’Alfresco, j’espère que cette traduction, adaptation permettront au francophone de comprendre les principes et la mise en place de cette technologie.

La technologie « Doclib Portlet » fournie la possibilité d’intégrer la gestion documentaire d’Alfresco Share au sein d’un portail de type j2ee. Alfresco, pour ces tests, à choisi le projet Liferay. 3 portlets sont disponibles à partir d’Alfresco Share, celles-ci vous permettrons d’accéder directement au référentiel complet d’Alfresco, ou bien à l’accès à une librairie documentaire d’un des sites d’Alfresco Share dont vous êtes propriétaire, ainsi que la totalité des librairies documentaires des sites Alfresco Share dont l’accès est « Public ».

Possibilités des « Portlets »

Les « Doclib Portlets » de Alfresco Share inclus toutes les fonctionnalités disponibles en standard dans l’onglet « Librairies Documentaires » des sites pour les dossiers et les documents (bien sur en fonction de vos droits).

Pour les dossiers

liferay_actions_dossier

Pour les documents

liferay_actions_document

Les autres fonctionnalités non disponible pour les « librairies Documentaires » sont les suivantes :

  1. La vue des actions dans Alfresco « Explorer » n’est pas disponible pour les dossiers,
  2. Quand vous affichez la liste des détails pour un dossier ou un document, la section « Share » n’est pas affiché.
  3. Votre Nom d’utilisateur n’est pas lié à votre page de profil.

Comme l’entête de Share n’est pas affichable dans le « Doclib Portlet », les fonctions suivantes ne sont pas disponibles non plus :

  1. « la barre d’outil Share » : Mon Dashboard, Mon profil, ma liste de site, la liste des utilisateurs, la recherche, l’aide et la déconnexion.
  2. « Autres pages composantes » : Wiki, Blog, Calendar, Liens, Forums, Liste de données,
  3. « Dashboard des sites »: Invitation, Personnalisation du tableau de bord, Edition des détails de site, Personnalisation des sites et Quitter le site.

Installation et configuration de Liferay

Cette section décrit comment effectuer l’installation et la configuration de Alfresco « Doclib Portlets » dans Liferay.

Pour information, Liferay est un site « portail d’Entreprise » libre et open-source permettant à n’importe quelle entreprise de mettre en place son portail. Celui-ci permet très facilement l’intégration de nombreux Portlets déjà disponible. voir : http://en.wikipedia.org/wiki/Liferay#Core_Portlets

Prérequis

Avant de procéder à l’installation et à la configuration, assurez-vous :

  1. qu’Alfresco est installé et travaille correctement. Les versions d’Alfresco supportées sont pour la version communautaire à partir de la 3.4.a et plus et pour la version Entreprise à partir de la 3.3SP1 et plus.
  2. J’ai effectué mes tests sur une version Alfresco Community 3.4.c installée sur un serveur linux mandriva 2010.2 à partir de l’installeur officiel intégrant tomcat version 6.
  3. J’ai installé le version Liferay portail 5.2.3 en utillisant tomcat version 6. J’ai récupéré sur internet le zip suivant : liferay-portal-tomcat-6.0-5.2.3.zip installé et contrôlé qu’il travail correctement. ATTENTION : Alfresco ne supporte pas à ce jour la version 6 de liferay.
  4. Alfresco et Liferay après validation de leur fonctionnement ont été stoppé afin de permettre les modifications pour permettre l’intégration du « Doclib Portlets » d’Alfresco.

Configuration de Liferay

Vous ne pouvez pas par défaut lancer Liferay et Alfresco en même temps, en effet, ils se lancent tous les 2 sur les mêmes ports, exemple le port 8080. Par conséquent, nous devons modifier quelques paramètres sur Liferay pour ne pas être confronté à des conflits de ports entre les 2 applications.

Localisez le fichier suivant : server.xml qui se trouve sous l’arborescence suivante : $HOME_LIFERAY/tomcat-6.0.18/conf/ et effectuer les modifications suivantes :

<server port="8105" shutdown="SHUTDOWN'">
... <Connector port="8180" protocole="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" /> ... <Connector port="8109" procol="AJP/1.3" redirectPort="8443" URIEncoding="UTF-8" />

Configuration d’Alfresco

Ajouter les lignes suivantes dans le fichier de propriétés Alfresco : alfresco-global.properties, disponible dans le dossier suivant :

$HOME_ALFRESCO/tomcat/shared/classes/
authentication.chain=AlfrescoNtlm1:AlfrescoNtlm,external1:external
external.authentication.proxyUserName=

Déploiement de l’application web « Share » dans Liferay

Copier le fichier share.war disponible dans le dossier suivant : $HOME_ALFRESCO/tomcat/webapps/

dans le dossier suivant de Liferay : $HOME_LIFERAY/deploy

Configuration de l’application Share dans Liferay

Éditer le fichier catalina.properties disponible dans le dossier suivant : $HOME_LIFERAY/tomcat-6.0.18/conf/

et rechercher la chaîne de caractère : shared.loader

et rentrer les données suivantes :

shared.loader=${catalina.home}/shared/classes,${catalina.home}/shared/lib/*.jar

Créer l’arborescence de dossiers dans Liferay : $HOME_LIFERAY/tomcat-6.0.18/shared/classes/alfresco/web-extension/

Puis dans le dossier web-extension, créer le fichier suivant : share-config-custom.xml

Éditer le et copier les lignes suivantes :

<alfresco-config>
<config evaluator="string-compare" condition="Remote">
 <remote> <endpoint>
 <id>alfresco-noauth</id>
 <name>Alfresco - unauthenticated access</name>
 <description>Access to Alfresco Repository WebScripts that do not require authentication</description>  <connector-id>alfresco</connector-id>  <endpoint-url>http://localhost:8080/alfresco/s</endpoint-url> <identity>none</identity> </endpoint> <endpoint>  <id>alfresco-feed</id> <name>Alfresco Feed</name> <description>Alfresco Feed - supports basic HTTP authentication</description> <connector-id>http</connector-id>  <endpoint-url>http://localhost:8080/alfresco/s</endpoint-url> <basic-auth>true</basic-auth>   <identity>user</identity> </endpoint>  <connector>   <id>alfrescoCookie</id>  <name>Alfresco Connector</name>   <description>Connects to an Alfresco instance using cookie-based authentication</description>   <class>org.springframework.extensions.webscripts.connector.AlfrescoConnector</class>  </connector> <endpoint> <id>alfresco</id> <name>Alfresco - user access</name>  <description>Access to Alfresco Repository WebScripts that require user authentication</description>  <connector-id>alfrescoCookie</connector-id>  <endpoint-url>http://localhost:8080/alfresco/wcs</endpoint-url> <identity>user</identity> <external-auth>true</external-auth> </endpoint> </remote> </config> </alfresco-config>

Si vous avez modifier les point d’accès d’Alfresco n’oublier d’effectuer les modifications concernant les endpoint-url de localisation de votre repository.

Démarrage d’Alfresco et de Liferay

Commencer par démarrer Alfresco, puis Liferay. Vérifier qu’aucune erreur n’apparaît lors du démarrage de chaque application. Les fichiers de logs se trouvent dans les répertoires suivants :

Pour alfresco : $HOME_ALFRESCO/tomcat/log/catalina.out

Pour Liferay : $HOME_Liferay/tomcat-6.0.18/log/catalina.out

Test de la « doclib Portlet » Share dans Liferay

Création d’un utilisateur Liferay

Connectez vous dans Liferay en tant qu’administrateur et créer un nouveau compte utilisateur pour chaque utilisateur alfresco pour lesquels vous voulez avoir un accès au portail. Les utilisateurs doivent avoir obligatoirement un droit d’accès avec les bonnes permissions dans Alfresco, de plus, le login de l’utilisateur de Liferay doit être parfaitement identique au login utilisateur d’Alfresco, sinon vous n’aurez pas d’accès aux « Doclib Portlets » d’Alfresco Share.

Ajout des « Doclib Portlets » dans Liferay

Commencer par vous connecter à Liferay sur lapage d’accueil cliquer en haut à droite sur « Welcome » et cliquer sur « Sign In » Connecté vous avec l’utilisateur que cous avez créer précédement.

alfresco_liferay_02alfresco_liferay_03alfresco_liferay_04

Une fois que vous êtes connecté.

  1. Créer une nouvelle page en cliquant sur « Add Page » et donner lui un nom,alfresco_liferay_05alfresco_liferay_06
  2. Sélectionner une mise en forme accessible via le menu en haut à droite « Welcome … » cliquer dans la liste « Layout Template » puis choisir la pleine largeur en utilisant le layout « 1-Column »,
    alfresco_liferay_07

    alfresco_liferay_08
  3. Puis toujours  à partir du menu « Welcome … » sélectionner dans la liste « Ajouter une Application »alfresco_liferay_09 
  4. Liferay ouvre une fenêtre listant l’ensemble des portlets disponibles sur votre serveur. Vous devriez trouver « Alfresco share » en haut de la liste. Cliquer sur le « + » et cliquer sur « Add » pour importer la sélection suivante : Share:My Document Librairies.
    Liferay créra le portlet « My Document librairies ».

alfresco_liferay_10
alfresco_liferay_11

alfresco_liferay_12

 

  • Créer une autre page avec la même mise en forme et ajouter le Portlet : Share : Repository Browser.
  • Pour finir, créer une dernière nouvelle page, toujours avec la même mise en page et ajouter le Portlet : Share : Site document Librairy. Si vous êtes propriétaires de plusieurs sites sur Alfresco Share, Liferay affichera un message vous permettant de configurer la librairie documentaire à laquelle vous voulez accéder.

 

Important : Il faut déployer chaque Portlet dans sa propre page. Il n’est pas possible d’avoir 2 Portlets Alfresco share sur la même page.

Au final vous obtenez les choses suivantes :

1. Pour le repository complet d’Alfresco,

alfresco_liferay_repository

2. Pour une librairie documentaire de share,

alfresco_liferay_repository_site

  1. <Connector port= »8109 » procol= »AJP/1.3 » redirectPort= »8443 »
    URIEncoding= »UTF-8 » />

4 commentaires

  1. seo website dit :

    design parfait grâce au tekonorma.fr

  2. Bonjour, c’est vraiment intéressant, merci tekonorma.fr

  3. Je suis impressionné du tekonorma.fr, j’ai besoin de le dire. Vraiment pas souvent que je rencontre un blog qui chaque éducative et divertissante, et laissez-moi vous informer, vous avez été touché le clou sur la tête. Votre concept est remarquable, la difficulté est une chose que peu de gens sont suffisamment parler intelligemment. Je suis très heureuse que je suis tombé tout cela dans mon chercher quelque chose à ce sujet.

  4. demotywatory dit :

    My brother recommended I might like this blog. He was totally right. This post actually made my day. You can not imagine just how much time I had spent for this info! Thanks!

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée.