Module ESN 5.4.1

Installation

Installer le module et redémarrer

Configuration

Types

Activer les Contenus Utilisateurs suivants dans votre espace de travail :

• ESN - Formation
• ESN - Expertise
• ESN - Poste
• ESN - Profile

Activer les types de portlet suivants:

• Portlet Etat des membres
• Portlet activité des membres
• Portlet anniversaire

Graphviz

GraphViz (diminutif de Graph Visualization Software) est un ensemble d'outils open source créés par les laboratoires de recherche d'AT&T qui manipulent des graphes définis à l'aide de scripts suivant le langage DOT. Cet ensemble fournit aussi des bibliothèques permettant l'intégration de ces outils dans diverses applications logicielles.

 Voici la procédure pour installer graphviz :

• Télécharger graphviz ici :  http://www.graphviz.org/
• Installer Graphviz
• Dans les propriétés du module, propriété "Graphviz - Chemin de dot.exe", saisir le chemin vers  dot.exe  (e.g. C:\Program Files\Graphviz2.22\bin\dot.exe)

Expertises

Avec l'esn, chaque membre peut définir ses expertises. Vous pouvez déclarer les branches de catégories qui seront utilisées pour le classement des expertises. Si aucune branche n'est définie, la racine des catégories sera utilisée.

Pour déclarer une branche d'expertise :

• Dans les propriétés du module, saisir les id des catégories dans la propriété : "Branche des catégories de compétence" 
• Les fils de ces catégories seront les expertises sélectionnables par les utilisateurs
• Le type MemberCategories (ESN - Expertises) doit être activé dans l'espace de travail des profils

Les membres peuvent automatiquement être assignés à des groupes en fonction de leurs expertises.  Voici la procédure à suivre :

• Dans les propriétés du module
• Activer : "Asservissement des groupes aux expertises"
• Editer le fichier  WEB-INF/data/custom.prop et ajouter la propriété extra.Category.jcmsplugin.esn.groups
• Editer une catégorie d'expertise, et définir l'id du groupe associé à cette expertise dans le nouveau champ disponible (via l'extra data)
• Tous les membres associés à une expertise et ayant un groupe asservi seront automatiquement ajoutés à ce groupe.

Pour des raisons de sécurité, seul les administrateurs peuvent changer les groupes associés à des catégories .

Activer les Conditions d'utilisation de l'ESN

Pour activer les Conditions d'utilisation de l'ESN :

1. Créer un contenu qui contiendra les textes des Conditions d'utilisation de l'ESN
2. Dans les propriétés du module :
   • Activer : "Accepter les conditions d'utilisation de l'ESN"
   • Définir l'id de la publication dans : "Conditions d'utilisation de l'ESN - Publication"
   • Définir le nom du champ contenant le texte des conditions dans : "Conditions d'utilisation de l'ESN - Champ"

Dès que les conditions sont activées, la première fois qu'un membre accèdera à son profil, il devra accepter les conditions d'utilisation.

Les membres devront accepter les conditions à chaque mise à jour de la publication portant les conditions d'utilisation.

Analyse des usages (Analytics)

Le module ESN fournit des nouvelles métriques pour l'analyse des usages.

Activité

Cette métrique indique pour chaque jour le nombre d'activité enregistrée.

Une activité représente une contribution, une mise en relation, la mise à jour de son profile, l'inscription à un espace, ...

Palmarès de l'activité

Cette métrique représente la répartition des activités par type (ajout et mise à jour de données, microblogging, mise en relation, ...)  Il s'agit de moyennes sur la période analysée.

Relation

Cette métrique indique pour chaque jour la moyenne par membre du nombre de relation, du nombre de membre suivi et du nombre de suiveur.

Microblogging

Cette métrique indique pour chaque jour le nombre de microblogging publiés.

Nouveau profils

Cette métrique indique pour chaque jour le nombre de nouveau profil créés. Les profils de comptes représentent ceux des membres ayant un compte utilisateur. Les profils de contact représentent ceux des fiches contacts.

Complétude des profils

Cette métrique indique pour chaque jour la complétude des profils. Il s'agit d'une moyenne sur l'ensemble des profils.

Propriétés

"Envoyer un mail d'alerte lors de la déclinaison d'une mise en relation" (Valeur par défaut "Non") : 

Envoie une alerte au membre ayant fait la demande de mise en relation si le membre receveur refuse la demande.

Désactiver la purge automatique des activités "jcmsplugin.esn.activity.purge.enabled" : 

Permet de désactiver la purge des activités en déclarant la valeur suivante "jcmsplugin.esn.activity.purge.enabled: false" dans vos propriétés

Portlet Activité des Membres (Paramétrage)

La portlet Activité des Membres dispose de plusieurs filtres appliquables lors de son paramétrage : 

Activités affichées : 

• Activités des membres suivis dans tous les espaces : affiche l'activité des membres que vous suivez, dans tous les espaces.
• Activités des membres suivis dans les espaces suivis : affiche l'activité des membres que vous suivez, affiné sur les espaces auquel vous participez.
• Activités de tous les espaces suivis : affiche l'activité des espaces auquel le membre connecté appartient.
• Activités de l'espace courant : affiche l'activité liée à l'espace courant.

Options : 

• Afficher le résumé : permet de définir si le résumé de la publication est affiché.
• Afficher les médias : permet de définir si le média de la publication est affiché (Lecteur vidéo, visionneuse, image dans le cas d'un document de type image).
• Afficher les commentaires : permet de définir si les commentaires doivent être visibles dans l'activité.
• Nombre d'activités affichées : Le nombre d'activité affiché par page.

Vous pouvez aussi, en éditant la portlet, afficher les champs cachés, et définir des filtres avancés dans le champ "Filtres". Les valeurs doivent être séparées par des espaces.

• "microBlogging" filtre les activités suivantes : 
  • Filtre toutes les activités de MicroBlogging
• "profile" filtre les activités suivantes : 
  • X a ajouté le poste {poste}
  • X a ajouté la formation {formation}
  • X a ajouté le lien {lien}
  • X a renseigné ses domaines de compétence
  • X a mis à jour ses domaines de compétence : {liste des compétences}
  • X a mis à jour ses domaines de compétence
  • X a mis à jour ses coordonnées
  • X a mis à jour son profil
• "contact" filtre les activités suivantes : 
  • X a mis à jour le profil de Y
  • X a ajouté une note sur Y
• "connect" filtre les activités suivantes : 
  • X est entré(e) en relation avec Y
  • X a ajouté Y à ses relations
• "ws" filtre les activités suivantes : 
  • {0} a rejoint l'espace {1}
• "create" filtre les activités suivantes : 
  • X a ajouté un commentaire
  • X a publié l'événement {Nom de l'événement}
  • X a publié {Nom de la publication}
  • X a partagé {Nom de la WebPage}
• "update" filtre les activités suivantes : 
  • X  a mis à jour {Nom de la publication}
  • X a mis à jour l'événement {Nom de l'événement}
• "delete" filtre les activités suivantes : 
  • X a supprimé {Nom de la publication}
• "update-pstatus" filtre les activités suivantes : 
  • X a passé la publication {Nom de la publication} dans l'état {PStatus}
• "upload" filtre les activités suivantes : 
  • X a déposé le document {Nom du document}
  • X a fait un dépôt en masse avec l'archive zip {Nom du Zip}

Développeurs

Désactiver la création de certaines activités

Il est possible de désactiver la création de certaines activités en modifiant une propriété "jcmsplugin.esn.activity.nontracked". Par défaut la propriété bloque la création d'activités de suppression et de lock : 

jcmsplugin.esn.activity.nontracked: jcmsplugin.esn.activity.delete jcmsplugin.esn.activity.lock jcmsplugin.esn.activity.unlock

La liste des différents types d'activité : 

• jcmsplugin.esn.activity.profile.job: Membre a ajouté le poste X
• jcmsplugin.esn.activity.profile.education: Membre a ajouté la formation X
• jcmsplugin.esn.activity.profile.link: Membre a ajouté le lien X
• jcmsplugin.esn.activity.profile.categories: Membre a renseigné ses domaines de compétence
• jcmsplugin.esn.activity.profile.categories.add: Membre a mis à jour ses domaines de compétence : X
• jcmsplugin.esn.activity.profile.categories.add-empty: Membre a mis à jour ses domaines de compétence
• jcmsplugin.esn.activity.profile.info: Membre a mis à jour ses coordonnées
• jcmsplugin.esn.activity.profile: Membre a mis à jour son profil
• jcmsplugin.esn.activity.contact.profile: Membre a mis à jour le profil de X
• jcmsplugin.esn.activity.contact.note: Membre a ajouté une note sur X
• jcmsplugin.esn.activity.connect-account: Membre est entré(e) en relation avec X
• jcmsplugin.esn.activity.connect: Membre a ajouté X à ses relations
• jcmsplugin.esn.activity.ws: Membre a rejoint l'espace X
• jcmsplugin.esn.activity.create: Membre a crée X
• jcmsplugin.esn.activity.update: Membre a mis à jour X
• jcmsplugin.esn.activity.delete: Membre a supprimé X
• jcmsplugin.esn.activity.create.DBComment: Membre a ajouté un commentaire
• jcmsplugin.esn.activity.create.DBForumTopic: Membre a posté la discussion X
• jcmsplugin.esn.activity.create.DBPollVote: Membre a participé au sondage X
• jcmsplugin.esn.activity.create.Review: Membre a publié un avis sur X
• jcmsplugin.esn.activity.create.Event: Membre a publié l'événement X
• jcmsplugin.esn.activity.create.CalendarEvent: Membre a publié l'événement X
• jcmsplugin.esn.activity.update.CalendarEvent: Membre a mis à jour l'événement X
• jcmsplugin.esn.activity.update.Event: Membre a mis à jour l'événement X
• jcmsplugin.esn.activity.create.FileDocument: Membre a déposé le document X
• jcmsplugin.esn.activity.create.Publication: Membre a publié X
• jcmsplugin.esn.activity.create.MicroBlogging: (MicroBlogging)
• jcmsplugin.esn.activity.create.WebPage: Membre a partagé X
• jcmsplugin.esn.activity.unzip: Membre a fait un dépôt en masse avec l'archive zip X
• jcmsplugin.esn.activity.update-pstatus: Membre a passé la publication X dans l'état Y
• jcmsplugin.esn.activity.lock: Membre a verrouillé le document X
• jcmsplugin.esn.activity.unlock: Membre a relâché le document X

Remplacer le contenu affiché par un type d'activité donnée

Vous pouvez remplacer le contenu affiché par une activité de deux façons.

Soit en remplaçant intégralement la jsp utilisée pour afficher l'activité : 

jcmsplugin.esn.activity.jsp-mapping.le-nom-de-ma-propriete: pathToMyJsp.jsp
jcmsplugin.esn.activity.jsp-data-mapping.le-nom-de-mon-type: pathToMyJsp.jsp

Vous pourrez alors vous baser sur les jsp existantes pour créer votre propre jsp d'activité. 

Vous pouvez récupérer l'activité existante via l'attribut de request suivant : 

ActivityEntry itActivityEntry = (ActivityEntry) request.getAttribute("jcmsplugin.esn.activity.activity-entry");

Soit en remplaçant seulement le corps de l'activité affichée, technique qui est déjà utilisée pour les activités de mise en relation, et d'événement de calendrier.

Il suffit de déclarer la propriété suivante dans vos propriétés : 

jcmsplugin.esn.activity.body.jsp-data-mapping.CalendarEvent: plugins/ESNPlugin/jsp/activity/doActivityBodyCalendarEvent.jsp

"CalendarEvent" étant ici le nom du type affichée dans l'activité.

Ensuite vous pouvez récupérer l'activité affichée dans votre jsp via l'attribut de request suivante : 

ActivityEntry activityEntry = (ActivityEntry) request.getAttribute("jcmsplugin.esn.activity.activity-entry");

 Vous pouvez aussi remplacer les activités par leur propriété comme par exemple pour les activités de mise en relation : 

jcmsplugin.esn.activity.body.jsp-mapping.jcmsplugin.esn.activity.connect : plugins/ESNPlugin/jsp/activity/doActivityBodyNewContact.jsp

"jcmsplugin.esn.activity.connect" étant la propriété de l'activité de mise en relation.

Ajout de création de types dans le mur d'activité

Depuis la version 5.4, vous pouvez déclarer des formulaires qui viennent s'ajouter dans la zone de création de MicroBlogging. Par défaut le module fournit les types suivants : 

• MicroBlogging
• Page Web
• Question / Idée / Discussion (Via le module Espaces de Conversations)
• Sondage (Via le module sondage)

Pour ajouter un type dans ce formulaire il faut tout d'abord déclarer deux propriétés : 

jcmsplugin.esn.activity.form-tab.poll: plugins/DBPollPlugin/jsp/esn/doActivityAddPollForm.jsp
jcmsplugin.esn.activity.form-tab.poll.handler: plugins/DBPollPlugin/jsp/esn/doActivityAddPollHandler.jsp

La propriété ".handler" déclare un handler comme dans la jsp suivante : 

<%@page import="com.jalios.jcmsplugin.esn.activity.MemberActivityMode"%>
<%@ include file='/jcore/doInitPage.jspf' %><%
boolean hasValidated = Util.toBoolean(request.getAttribute("jcmsplugin.esn.activity.has-validated"), false);
if (hasValidated) {
 return;
}
PortletMemberActivity box = (PortletMemberActivity) request.getAttribute("jcmsplugin.esn.activity.box");
boolean isPollMode = Util.toBoolean(getUntrustedStringParameter("microbloggingMode", "").equals("poll"), false);
boolean isWorkspaceMode = "currentWS".equals(box.getActivityMode());
boolean canPublishPollForm = isWorkspaceMode ? loggedMember.canPublish(Poll.class, workspace) : loggedMember.canPublishSome(Poll.class);
if (!canPublishPollForm) { // Sortir ici si on ne peut pas publier de Sondages
 request.setAttribute("jcmsplugin.esn.activity.can-publish.poll", false);
 return;
}
%>
<jsp:useBean id='formHandler' scope='page' class='generated.EditPollHandler'><%
 %><jsp:setProperty name='formHandler' property='request' value='<%= request %>'/><%
 %><jsp:setProperty name='formHandler' property='response' value='<%= response %>'/><%
 %><jsp:setProperty name='formHandler' property='*' /><%
 %><jsp:setProperty name='formHandler' property='noRedirect' value='true' /><%
%></jsp:useBean>
<% 
request.setAttribute("pollHandler", formHandler);
request.setAttribute("jcmsplugin.esn.activity.can-publish.poll", canPublishPollForm);
if (isPollMode && formHandler.validate()) { // Validation du handler
 HibernateUtil.commitTransaction();
 HibernateUtil.beginTransaction(); 
 request.setAttribute("jcmsplugin.esn.activity.has-validated", true); // Envoyer l'info à la jsp qui fait l'affichage du formulaire global 
}
%>

L'autre propriété permet de déclarer le formulaire qui sera affiché : 

<%@page import="com.jalios.jcmsplugin.esn.activity.MemberActivityMode"%>
<%@ include file='/jcore/doInitPage.jspf' %><%
String microbloggingMode = getUntrustedStringParameter("microbloggingMode", "");
boolean isPollMode = microbloggingMode.equals("poll");
if (!isPollMode) {
 return;
}
PortletMemberActivity box = (PortletMemberActivity) request.getAttribute("jcmsplugin.esn.activity.box");
boolean isWorkspaceMode = "currentWS".equals(box.getActivityMode());
EditPollHandler formHandler = (EditPollHandler) request.getAttribute("pollHandler");
request.setAttribute("formHandler", formHandler);
request.setAttribute("field-vertical",true);
%>
<% if (!isWorkspaceMode) { %>
 <%
 ServletUtil.backupAttribute(pageContext, "TRIGGER_WS_CHANGE_REFRESH");
 request.setAttribute("TRIGGER_WS_CHANGE_REFRESH", true);
 %>
 <%@ include file='/jcore/doWorkspaceField.jspf' %>
 <%
 ServletUtil.restoreAttribute(pageContext, "TRIGGER_WS_CHANGE_REFRESH");
 %>
<% } %>
<jalios:field name="title" formHandler="<%= formHandler %>" css="focus">
 <jalios:control />
</jalios:field>
<jalios:include jsp="/types/Poll/doEditPoll.jsp" />
<% request.removeAttribute("field-vertical"); %>
<div class="buttons text-right">
 <button type="submit" name="opCreate" data-jalios-target-position="closest" data-jalios-target=".PortletMemberActivity" data-jalios-action="ajax-refresh" value="true" class="btn btn-primary" ><%= glp("ui.com.btn.publish") %></button>
</div>