Souhaitez une bonne année à vos utilisateurs Alfresco (1/2)

Voilà que l’année 2012 commence et j’en profite pour vous souhaiter une très belle année, pleine de réussite dans vos projets d’ECM ;-)
Afin de bien la démarrer, je vous propose un rapide module vous permettant de présenter vos vœux aux utilisateurs de votre plateforme Alfresco.
Lors de l’accès à leur tableau de bord les utilisateurs verront un message personnalisé :

Voeux 2012 : tableau de bord des utilisateurs personnalisé

Le principe

Un WebScript va être en charge de générer l’affichage. Il n’y a pas de contrainte particulière, tous les mécanismes habituels peuvent être mis en œuvre. Nous ne le détaillerons donc pas ici. Ce WebScript va être défini comme sous-composant du tableau de bord utilisateur, c’est-à-dire qu’il va venir enrichir un composant déjà existant de son rendu HTML.
Tout l’enjeu est de trouver quel est le meilleur choix de composant. Pour cela, SurfBug va nous être bien utile.

Rapide rappel de l’utilisation de SurfBug

Il faut en premier lieu l’activer en cliquant sur « Enabled » dans la page d’activation de SurfBug.
De retour sur Share, le rafraîchissement la page (tableau de bord utilisateur) permet de matérialiser les composants : ils sont encadrés de rouge.

SurfBug permet de matérialiser les différents composants


Lors du survol d’un composant, le cadre devient vert et un « click » permet d’afficher les détails :

Détail d'un composant avec SurfBug


Les informations essentielles sont présentes dans le « détail du composant » : scope, region-id et source-id. Elles nous serviront tout à l’heure pour le référencement de notre sous-composant.

Choix du composant à étendre

Le tableau de bord utilisateur n’offre pas beaucoup de choix dans les composants qu’il est possible d’étendre. En effet, la majorité des composants proviennent des dashlets qui sont personnalisables. On ne peut donc pas faire le pari de leur présence.
En revanche, le « titre » du tableau de bord est systématiquement affiché :

Le détail du composant indique :

On en retient :

  • scope : page
  • region-id : title
  • source-id : user/admin/dashboard

Attention à l’identifiant de la source : il indique « admin » car il s’agit de l’utilisateur connecté. Il ne faudra donc pas se baser sur cette information telle quelle pour notre module et plutôt chercher à la paramétrer.

Définition du module

Rapide rappel, la définition d’un module s’effectue dans un fichier XML, placé dans le dossier site-data/extensions d’un jar de la webapp.
Pour notre module personnel, nous allons commencer par définir le « composant d’ancrage » :
<scope>page</scope>
<region-id>title</region-id>
<source-id>user/{userid}/dashboard</source-id>

On retrouve ici les informations notées plus haut. L’identifiant de la source a été modifié pour que tous les utilisateurs soient concernés : admin est devenu {userid}.
Vient ensuite la description de notre sous-composant, qui se contente de définir un appel à notre WebScript :
<sub-components>
  <sub-component id="hny">
    <url>/torda/components/hny/happy-new-year</url>
  </sub-component>
</sub-components>

Activation du module

Pour l’activation du module, il faut utiliser la console de gestion des modules.

Activation du module "Happy New Year"


Le module « Happy New Year » a été ajouté à la liste des modules et, une fois les modifications appliquées (cf. Apply Changes), le message est affiché à tous les utilisateurs !

Voeux 2012 : tableau de bord des utilisateurs personnalisé

Dans le prochain billet de cette série, nous verrons comment éviter que ce message ne reste indéfiniment affiché.
En attendant, si vous aussi, vous souhaitez qu’Amexio vous souhaite une bonne année, vous pouvez télécharger le module exemple : happy-new-year-share-module.jar. A titre d’exercice, vous pouvez l’améliorer pour utiliser des fichiers de propriétés pour afficher le message en fonction de la langue de l’utilisateur.

Cette entrée a été publiée dans Alfresco, Technique, avec comme mot(s)-clef(s) , , , , , , . Vous pouvez la mettre en favoris avec ce permalien.

5 réponses à Souhaitez une bonne année à vos utilisateurs Alfresco (1/2)

  1. Ping : Libérez les dépendances JavaScript du joug des dépendances CSS ! | ECM & Co

  2. Ping : Souhaitez une bonne année à vos utilisateurs Alfresco (2/2) | ECM & Co

  3. Ping : La navigation par catégories dans les sites Alfresco Share 4.0 | ECM & Co

  4. Ping : Alfresco – Créer un tableau de bord statique « doktapepa

  5. sibe dit :

    Merci Charles, très intéressant ton blog. Good Job

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée.

Vous pouvez utiliser ces balises et attributs HTML : <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Protected by WP Anti Spam