topic Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site in Alfresco Archive

[RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Wed, 11 May 2011 11:46:37 GMT

Bonjour,Un petit problème qui me poursuit depuis quelques jours, et auquel je ne trouve pas de solutions… J'aimerais envoyer une notification à tous les utilisateurs du site lors d'une modification d'un document contenu dans un dossier."Il suffit d'appliquer une règle de contenu" En effet, c'est bie

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

bertrandf — Wed, 11 May 2011 12:23:46 GMT

Il suffit d'appliquer une règle de contenu

Une règle qui exécute un script. Ce script récupère les utilisateurs du sites (la méthode getSiteShortName() est pratique pour connaitre le site en fonction du noeud) et envoi un mail (vous pouvez meme restreindre vos envois en fonction du rôle de chaque utilisateur).

Le tout en JavaScript :
http://wiki.alfresco.com/wiki/3.4_JavaScript_API
http://wiki.alfresco.com/wiki/3.4_JavaScript_Services_API

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Mon, 16 May 2011 15:26:09 GMT

Bonjour et merci pour ces indications !

J'ai donc commencé à écrire mon script, et je peux récupérer le nom de mon site en question.
Je suis maintenant bloqué pour récupérer les utilisateurs de mon site. Je m'explique, j'essaye d'utiliser la fonction listMembers() (sans paramètre pour tous les récupérer dans un premier temps) mais je n'y arrive pas… Je l'ai pourtant retourné dans tous les sens mais rien n'y fait… (http://wiki.alfresco.com/wiki/3.4_JavaScript_Services_API#Get_list_of_site_members)

// Récupérer le nom du site
var parent = document.getParent();
var leSite = parent.getSiteShortName();

// Et les membres
var membres = leSite.listMembers(); 
Erreur : "Cannot find function listMembers"

// ou encore
var membres = site.listMembers();
Erreur : ""site" n'est pas defini"

// ou encore …
var site = siteService.getSite(leSite);
var members = site.listMembers(); 
Erreur : La méthode 'org.alfresco.repo.site.script.Site.listMembers()' est introuvable"‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Voili voilou, une petite idée? J'imagine que ça doit être tout bête, mais je sèche…

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

bertrandf — Mon, 16 May 2011 15:31:18 GMT

getSiteShortName() ne retourne pas un 'objet' site mais seulement son shortName.

Il faudrait faire qqch comme ca :

var shortName= parent.getSiteShortName();
var leSite = siteService.getSite(shortName);

var membres = leSite.listMembers();‍‍‍‍

[EDIT] Oups, je viens de voir que j'ai pas lu en entier votre POST.

Peut être essayer avec :
leSite.listMembers(null, null, 1000, false);

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Tue, 17 May 2011 09:24:58 GMT

Bonjour,

Merci, pour votre réactivité! J'avais en effet rectifié en mettant les paramètres pour listMembers. Cependant, il faut enlever le dernier booléen, sinon error ! (d'ailleurs, ça veut aussi dire que le wiki n'est pas à jour pour les params d'entrées ?)

J'avance progressivement… Je n'arrive toujours pas à récupérer un nom d'utilisateur, pour enfin avoir son email :

// On récupère les membres du site
var membres = leSite.listMembers(null,null,0);
var membre;
for each (membre in membres) {
   var donneesUtilisateur =  people.getPerson(membre);
   // Et je récupère l'email de la personne et c'est gagné…
‍‍‍‍‍‍‍

Sauf que :
membre vaut : "siteCollaborator" et non l'id du premier membre du site…
et donc donneesUtilisateur vaut : null puisque aucun utilisateur ne s'appelle "siteCollaborator"…

D'après le Wiki, listMember() retourne : "Map<String, String>. The list of members of a site with their roles. If no name or role filter is specified, all members of the site are listed."
Je pense que j'utilise mal la ressource Map. Une suggestion d'utilisation ?

Merci, Matteo

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

bertrandf — Tue, 17 May 2011 09:29:27 GMT

(d'ailleurs, ça veut aussi dire que le wiki n'est pas à jour pour les params d'entrées ?)

Oui

Pour vous aider à avancer, allez voir le fichier memberships.get.js qui doit se trouver dans /alfresco/WEB-INF/classes/alfresco/templates/webscripts/org/alfresco/repository/site/membership/

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Tue, 17 May 2011 14:25:14 GMT

Bonjour,

Ca y est mon script d'envoi fonctionne, je le mets à disposition ici. Je me suis un peu arraché les cheveux, mais au moins je connais mieux l'API maintenant! Peut-être existe-t-il plus simple ou mieux codé, mais ça marche, c'est le principal

Ce script est à placer dans le répertoire 'scripts' du 'dictionnaire des données'. Il envoie un mail à tous les utilisateurs sauf l'administrateur (pour ne pas trop le spammer le pauvre!)


// Récupérer le nom du site
var parent = document.getParent();
var shortName= parent.getSiteShortName();
var leSite = siteService.getSite(shortName);

// On récupère les membres du site
var membres = leSite.listMembers(null,null,0);
var nomDuSite = leSite.title;
var membre;

for (membre in membres){
   var donneesMembres = people.getPerson(membre);
   var email = donneesMembres.properties.email;
   if (donneesMembres.properties.userName!="admin") {
      // create mail action
      var mail = actions.create("mail");
      mail.parameters.to = email;
      mail.parameters.subject = "Un document a été mis à jour dans l'univers '"+nomDuSite+"'…";
      mail.parameters.from = "admin@alfresco.fr";
      mail.parameters.template = companyhome.childByNamePath("Dictionnaire de données/Modèles d'e-mail/Modèles d'e-mail de notification/notify_user_email.ftl");
      mail.parameters.text = "Un document mis à jour !" ;
      // execute l'action
      mail.execute(document);
   }
}‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

A +, et merci à BertrandF !
P.S : si on veut seulement l'envoyer aux collaborateurs par exemple, il suffit d'appliquer un filtre dans listMembers().

[EDIT] : J'ai modifié le titre qui est un peu plus parlant pour ce qui a été fait finalement !

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Mon, 30 May 2011 15:46:33 GMT

O M G (ou OMD pour nous les francophones!)

Je crois rêver… Ce topic n'est malheureusement pas clôt… Je me suis rendu compte que j'obtenais des erreurs. Le pire, c'est que je ne comprends pas pourquoi je n'avais pas vu ces phénomènes quand j'avais fait mes tests, et pensait que c'était "Résolu"..

Bon le fait est là. Lorsque j'exécute le scénario suivant :
1. Ajouter 1 règle lors de "l'ajout ou création d'un document", exécuter l'action : "exécuter le script" ci-dessus.
2. Ajouter un fichier (build.xml) dans le répertoire (toto) concerné par la règle,
3. Consulter ce fichier, en y cliquant dessus.

Et j'obtiens dans ma boite mail, ces 3 mails :
"Le document suivant : build.xml, a été ajouté dans le dossier : toto." –> Ce mail est OK
"Le document suivant : doclib, a été ajouté dans le dossier : build.xml." –> ??? Celui-ci moins ….
"Le document suivant : webpreview, a été ajouté dans le dossier : build.xml." –> re ???

Y comprenez-vous quelque chose ??? Là je sèche, et ça me dépasse totalement.. Je pensais être pourtant si content de ce script……

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

bertrandf — Mon, 30 May 2011 16:02:37 GMT

Bonjour,

Les fichiers doclib et webpreview sont liés à la prévisualisation et la vignette d'un document.
Dans share, pour chaque document, vous retrouverez ces fichiers.

Dans votre script, il suffit de tester le type du document courant, si vous souhaitez envoyer des mails seulement pour des documents de type cm:content :

if (document.type == "{http://www.alfresco.org/model/content/1.0}content") {
}‍‍

if (document.typeShort== "cm:content") {
}‍‍

Sinon, vous vérifiez que le document courant n'est pas une vignette ou une prévisualisation (type {http://www.alfresco.org/model/content/1.0}thumbnail) :

if (document.type != "{http://www.alfresco.org/model/content/1.0}thumbnail") {
}‍‍

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

matteo_1847 — Tue, 31 May 2011 08:18:11 GMT

Bonjour,

Merci pour cette solution plus 'propre'… En effet, en attendant, je n'envoyais l'e-mail que si le nom du document ne s'appelait pas webpreview ou doclib… Donc ça fonctionnait également, jusqu'au jour où un utilisateur aurait ajouté un document intilué "webpreview"!..

Une dernière chose étrange, ce phénomène-ci. Cela ne concerne pas spécialement MA règle mais les règles en général, lors de la mise à jour d'un document :
1. je positionne l'unique règle de contenu suivante : quand "des éléments sont mis à jour dans le dossier" sur "tous les éléments" j'exécute l'action "envoyer un E-mail" à mon adresse.
2. j'ajoute un document —> la règle est déclenchée : je reçois un e-mail (alors qu'il s'agit d'un ajout et que la règle est définie pour les éléments mis à jour).
3. je mets à jour ce document (grace à "mettre à jour") —> je reçois 2 mails identiques (au lieu d'un seul).

Mon install d'alfresco (3.4-d) est pourtant clean… Puis-je vous demander si vous arrivez à reproduire le scénario ci-dessus?

Merci beaucoup.

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

bertrandf — Tue, 31 May 2011 09:24:38 GMT

2. Après un ajout, alfresco renseigne des métadonnées et les sauvegarde ce qui doit déclencher la règle.

3. Je pense que le phénomène est dû au versioning, étant donné qu'il créé une nouvelle version du document, la règle s’exécute probablement deux fois.
Je pense que si vous modifiez seulement les métadonnées d'un fichier, la règle s’exécutera une seule fois.

Il faudrait chercher pour voir si vous ne pouvez pas améliorer votre script pour ne pas envoyer de mail lorsque cela concerne la création de la version (je ne sais pas si c'est faisable).

Re: [RESOLU] Re: Envoi d'email à tous les membres d'un site

pascal_sighma — Wed, 01 Jun 2011 02:57:23 GMT

Bonjour matteo, bonjour BertrandF,

J'ai reproduit effectivement ton pb. Je n'ai pas rajouté ton script en amont du test donc je suis dans un environnement vierge.
Pour avoir déjà eu des soucis dans les règles avec "tous les éléments", j'ai modifié cela pour lui mettre un type MIME. Cela ne règle pas le pb d'envoi de mail a l'ajout, alors que je l'ai bien mis comme demandé en mise a jour.
Mais pour ce pb je penche fortement pour l'idée de BertrandF

2. Après un ajout, alfresco renseigne des métadonnées et les sauvegarde ce qui doit déclencher la règle.

Mais par contre il n'y a plus que un seul mail envoyé a la mise a jour, la vraie en 1.1, avec le filtre type MIME.

Je ne sais pas si cela aidera dans la réflexion, mais je suivrais ce post avec attention.