Apps

Module ESN 6.2

Description

Ce module s’articule autour de quatre grandes fonctionnalités de Réseau Social d’Entreprise :

  • Gestion de profil
  • Suivi des activités
  • Gestion des expertises
  • Gestion des relations

Pour plus de détails, veuillez consulter nos fiches cookbooks de nouveautés :

Cette version ne fonctionne qu'à partir de la version 10 du coeur.


Captures d'écran

1. Profil - Profil d’un membre
2. Profil - édition
3. Suivi des activités
4. Annuaire des experts

Installation

Installation

Installer le module et redémarrer

Configuration

6.2 et nouveau profil

 

A partir de la version 6.2, une nouvelle version du profil est disponible. Si vous souhaitez revenir à la précédente version (Dans le cas où vous auriez fait des développements spécifiques sur cette ancienne version par exemple), il vous suffit d'activer la propriété suivante : 

jcmsplugin.esn.profile.full.old-template.boolean: true

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.

Filtrage par type d'activités
 
  • "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}
 
Filtrage d'espace de travail 
 
Vous pouvez filtrer la portlet sur un seul workspace en mettant la valeur "ws_{ID de l'espace de travail}".
Vous pouvez donc par exemple définir la valeur "ws_j_4" pour affiner la portlet sur l'espace par défaut.
 
En ajoutant le filtre "exclude-ws", le workspace alors défini sera exclu des résultats de la portlet.
Par exemple en mettant "ws_j_4 excluse-ws", tous les espaces seront affichés, sauf le j_4 (Espace par défaut).

Développeurs

Définir la limite de création d'activités de mise à jour

Les mises à jour d'une Publication sont affichées dans le mur seulement lorsque cette mise à jour intervient après un certain nombre d'heures, définie en propriété. Par défaut, cette limite est réglée à 12 heures.

Il est possible d'aller redéfinir cette durée dans vos propriétés (En minutes) : 

# Minimum time to log a same activty as the last one (in minutes)
jcmsplugin.esn.activity.min-time: 720

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é

Module ESN 5.4 - MicroBlogging form

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>

 


FAQ

1. Comment sont calculées les suggestions de mise en relation ?

Le module ESN calcule les suggestions de mise en relation à partir des éléments suivants :

  • Relations de mes relations
  • Membres appartenant aux mêmes espaces collaboratifs que moi
  • Membres ayant les mêmes expertises que moi

Tout membre respectant au moins l'un de ces critères sera suggèrer sauf :

  • Si ce membre est déjà une relation
  • Si cette suggestion a déjà été rejetée
  • Si une demande de mise en relation a été envoyé à ce membre
  • L'ensemble des membre à suggérer est ensuite trié selon la proximité avec l'utilisateur. Le calcul de proximité se base sur une pondération des 3 critères relation, espace co, et expertise (+ un 4e a partir de ESN 2.1 : les réunions en commun)

Les pondération peuvent être paramétré via les propriété suivante (les valeurs indiquées sont les valeurs par défaut) :

  • jcmsplugin.esn.closeness.coefficient.workspace: 4
  • jcmsplugin.esn.closeness.coefficient.category: 3
  • jcmsplugin.esn.closeness.coefficient.member: 2
  • jcmsplugin.esn.closeness.coefficient.contact: 1
  • jcmsplugin.esn.closeness.coefficient.event: 4 (à partir de ESN 2.1)
2. Comment est calculé le taux de complétude du profil ?

Le taux de complétude du profil ESN est calculé sur le renseignement des critères suivants (tous les critères ont la même pondération) :

Info du membre :

  • Civilité
  • Fonction
  • Organisation
  • E-mail
  • Téléphone
  • Portable
  • Adresse
  • Photo

Info ESN :

  • Présentation
  • Centre d'intérêt
  • Date de naissance
  • Date d'arrivée dans la société
  • Au moins une relation
  • Au moins une expertise renseignée
  • Au moins un poste renseigné
  • Au moins une formation renseignée

Informations

Version
  • 6.2
Stabilité
  • Stable
Compatibilité
  • JPlatform 10 SP1
    JPlatform 10 SP2
Certifié Jalios
  • Oui
Prix
  • Module payant
Support
  • Jalios Support
Auteur
  • Jalios
Licence
  • Jalios
Taille
  • 1,66 Mo
Mis-à-jour
  • 09/04/19
Téléchargements
  • 19
Modules nécessaires
Calendrier
v 5.0.1
DB Commentaires
v 6.0