topic Re: [Share custom Action] Envoyer un document par mail in Alfresco Archive

[Share custom Action] Envoyer un document par mail

roxy — Wed, 15 Dec 2010 11:25:59 GMT

Bonjour,Je souhaite depuis un site Share, envoyer manuellement un document (aux membres du site contenant le doc, mais ça n'est pas encore la question - et il y a de la littérature pour ce paramétrage).Il n'existe pas sous Share le pendant d'Alfresco à la fonction "Lancer une action / Envoyer un cou

Re: [Share custom Action] Envoyer un document par mail

jayjayecl — Wed, 15 Dec 2010 11:54:53 GMT

Bonjour, pourquoi ne pas ajouter une action dans la document Library de Share ?

http://wiki.alfresco.com/wiki/Custom_Share_Action_UI
http://wiki.alfresco.com/wiki/Custom_Document_Library_Action

(Note :
Prenez soin de vérifier sur ces pages la conformité avec votre version d'Alfresco)

Re: [Share custom Action] Envoyer un document par mail

roxy — Wed, 15 Dec 2010 13:46:29 GMT

Merci beaucoup,

Un seul bémol … je suis sur 3.4 et la manip ne semble pas documentée.
Je cherche donc !!!

Si jamais vous avez des info, je suis preneur.

Re: [Share custom Action] Envoyer un document par mail

roxy — Thu, 16 Dec 2010 11:54:10 GMT

Bon ça ne marche pas …

J'ai pu sans problème ajouter un nouvel item dans la liste des actions
tomcat\webapps\share\WEB-INF\classes\alfresco\site-webscripts\org\alfresco\components\documentlibrary\documentlist.get.config.xml
Mais quand je clique ce dernier … pas de réaction

J'ai suivi autant que possible le process
http://wiki.alfresco.com/wiki/Custom_Document_Library_Action
mais comme c'est censé ne pas fonctionner sous 3.4 …

Si quelqu'un a déjà créé une nouvelle action sur Share 3.4 … HELP

Re: [Share custom Action] Envoyer un document par mail

roxy — Thu, 16 Dec 2010 17:08:57 GMT

Bonjour,

Je rebondis sur ma question du topic
Envoyer "à la demande" un document par mail (SHARE)
http://forums.alfresco.com/fr/viewtopic.php?f=8&t=4575&start=0

Cf. [img]http://e-nautia.com/people/roxy/photo_606.jpg[/img]

Je bute sur l'ajout d'une action dans la document Library de Share (en version 3.4).
Le process est documenté sur
http://wiki.alfresco.com/wiki/Custom_Document_Library_Action
mais il est bien indiqué que ça ne marche pas sur la v3.4 …

Quelqu'un a-t-il déjà fait cela ?

Merci d'avance

Re: [Share custom Action] Envoyer un document par mail

michaelh — Thu, 16 Dec 2010 17:15:50 GMT

Bonjour,

Pourquoi ne pas continuer sur le sujet déjà lancé par vous au lieu de "rebondir" ?
=> Sujets fusionnés.

Re: [Share custom Action] Envoyer un document par mail

roxy — Mon, 20 Dec 2010 09:20:18 GMT

Et bien … je pensais que :
Envoyer "à la demande" un document par mail (SHARE)
et
Ajouter une action dans la document Library de Share 3.4
n'étaient pas le même sujet

Pour rappel, mon VRAI problème n'est pas le script de mail mais bien l'ajout de l'action
et avec un titre comme "Envoyer "à la demande" un document par mail (SHARE)", j'ai peur de ne pas avoir de réponse.

Re: [Share custom Action] Envoyer un document par mail

jayjayecl — Tue, 21 Dec 2010 17:38:49 GMT

Titre du sujet modifié.

Re: [Share custom Action] Envoyer un document par mail

bertrandf — Wed, 22 Dec 2010 14:00:58 GMT

Bien que ca soit écrit l'inverse sur le wiki, il me semble bien que la démarche est la même sur Alfresco 3.4 que sur Alfresco 3.2 et plus.

En gros le principe est :
- "Déclaration" de votre action dans un fichier XML (il existe différents fichiers selon ou vous voulez afficher l'action : dans la documentLibrary d'un site, dans la documentLibrary de l'Entrepôt, sur le détail d'un fichier d'un site, sur le détail d'un dossier d'un site, sur le détail d'un fichier de l'entrepôt, sur le détail d'un dossier de entrepôt.
Dans votre cas, ca serait plus : /site-webscripts/org/alfresco/components/documentlibrary/documentlist.get.config.xml

- Ensuite il faut créer un petit fichier JavaScript qui va gérer votre action (ce fichier sert juste à instancier votre "classe" JavaScript qui fera l'affichage et le traitement de votre action).
Quelque chose qui ressemblerait à ca :

  Alfresco.DocumentActions.prototype.onActionSendByMail = function DocumentActions_onActionSendByMail(file) {
    if (!this.modules.SendByMail) {
      this.modules.SendByMail = new Alfresco.module.DoclibSendByMail(this.id).setOptions({
        file: file
      });
    }
    else {
      this.modules.SendByMail.setOptions({
        file: file
      });
    }
    this.modules.SendByMail.showDialog();
  };‍‍‍‍‍‍‍‍‍‍‍‍‍

- Il faut ensuite créer une "classe" JavaScript qui va gérer votre action. Dedans il faudra gérer l'affichage de votre action (fenêtre de dialogue en YUI), l'action sur le bouton envoyer (appel à un webscript situé coté entrepôt alfresco), …
Vous serez surement amené à créer un webscript dans Share pour gérer l'aspect de votre boite de dialogue (c'est de qui est fait la plupart du temps). Cela permet de ne pas avoir à créer tout les éléments qui composeront le 'body' de votre boite de dialogue en JavaScript, le contenu sera généré en fonction du template du webscript.

- Il faudra également réalisé le webscript dans alfresco pour réalisé l'envoi du mail.

Je pense que ce sujet peut vous aider : http://forums.alfresco.com/fr/viewtopic.php?f=25&t=3767
Vous pouvez vous inspirez de ce qui est fait par défaut dans Share pour comprendre et avancer dans vos développements, c'est ce que je fais personnellement.

Nous (Atol Conseils et Développements) avons déjà réalisé cette action pour un client pour un Alfresco Entreprise 3.3.3 et l'action avait été testée avec succès sur Alfresco 3.4 beta1 également donc vous pouvez vous inspirez du wiki sans trop de danger.

Cordialement.

Re: [Share custom Action] Envoyer un document par mail

roxy — Thu, 30 Dec 2010 10:18:37 GMT

Bonjour et merci de votre réponse,

malheureusement je continue de buter sur deux points précis :

dans
documentlist.get.config.xml
si je définis mon action comme suis :
<action type="action-link" …
Je n'arrive pas à obtenir le moindre résultat (surement un pb sur le fichier qui contient "… Alfresco.DocumentActions.prototype.onActionSendByMail = function DocumentActions_onActionSendByMail(file) …" mauvais nom, mauvais emplacement … bref …)
Du coup je suis passé par une définition du type
<action type="simple-link"
et j'appelle un composant que j'ai placé dans la partie "shared" (shared\classes\alfresco\web-extension\site-webscripts\org\alfresco\components\mail-utilisateurs\mail-utilisateurs.get.html.ftl + JS + …)
ça ne marche pas trop mal sauf que je n'ai pas accès aux objets "actions" et "search" …
quelqu'un sait-il pourquoi ?
faut-il repasser par Alfresco (je le fais déjà pour récupérer la liste des personnes qui sont membres du site contenant le doc) ?

Re: [Share custom Action] Envoyer un document par mail

roxy — Fri, 31 Dec 2010 10:31:08 GMT

Je récapitule mon problème

OBJECTIF
Envoyer un mail aux membres des groupes appartenant à un site depuis une action personnalisée sur un document de ce site

CE QUE J'AI PU FAIRE
1/ Création d'un composant appelé par mon action (qui récupère bien tous les utilisateurs via un appel du type "var json = remote.call("/api/sites/" + page.url.templateArgs.site + "/memberships?size=100&authorityType=USERS_GROUP");")
2/ Création d'un Script dans la Data Dictionary qui fait ce que je veux

CE QUE JE N'AI PAS PU FAIRE
Envoyer un mail via dans mon composant

RESUME
Mon action est définie dans
"C:\Alfresco\tomcat\webapps\share\WEB-INF\classes\alfresco\site-webscripts\org\alfresco\components\documentlibrary\documentlist.get.config.xml"
et dans
"C:\Alfresco\tomcat\webapps\share\components\documentlibrary\documentlist.js" (en fait dans documentlist-min.js)
par :

…
<action type="simple-link" id="onActionMailUtilisateurs" permission="edit"  href="{mailUtilisateursUrl}" label="actions.document.mail-utilisateurs" />
…‍‍‍

…
mailUtilisateursUrl: fnPageURL("mail-utilisateurs?nodeRef=" + nodeRef + "&proxyAlfresco=" + Alfresco.constants.PROXY_URI + "&contentUrl=" + contentUrl),
…‍‍‍

Cette dernière est paramétrée comme suit :
Sur "C:\Alfresco\tomcat\webapps\share\WEB-INF\classes\alfresco\site-data\pages\mail-utilisateurs.xml" :

<?xml version='1.0' encoding='UTF-8'?>
<page>
   <title>Mail utilisateurs avec lien documents</title>
   <title-id>page.mailUtilisateurs.title</title-id>
   <description>Mail Utilisateurs</description>
   <description-id>page.mailUtilisateurs.description</description-id>
   <template-instance>mail-utilisateurs</template-instance>
   <authentication>user</authentication>
   </page>‍‍‍‍‍‍‍‍‍

Puis dans "C:\Alfresco\tomcat\webapps\share\WEB-INF\classes\alfresco\site-data\template-instances\mail-utilisateurs.xml" :

<?xml version='1.0' encoding='UTF-8'?>
<template-instance>
   <template-type>org/alfresco/mail-utilisateurs</template-type>

   <properties>
      <pageFamily>documentlibrary</pageFamily>
      <container>documentLibrary</container>
   </properties>
   
   <components>
      <component>
         <region-id>mail-utilisateurs</region-id>
         <url>/components/mail-utilisateurs/mail-utilisateurs</url>
       <properties>
            <itemId>{nodeRef}</itemId>
         <contentId>{contentUrl}</contentId>
         <proxyId>{proxyAlfresco}</proxyId>
         </properties>
      </component>
   </components>
</template-instance>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Mon composant "mail-utilisateurs"
"C:\Alfresco\tomcat\shared\classes\alfresco\web-extension\site-webscripts\org\alfresco\components\mail-utilisateurs\mail-utilisateurs.get.js"
(je ne donne pas son code ici pour ne pas trop alourdir- mais je peux le faire en cas de besoin) est appelé correctement, mais impossible de lui faire envoyer un mail (je n'ai pas accès à "actions" qui semble le seul moyen d'envoyer un mail via "actions.create("mail");").

Pour rappel, le script ci-dessous dans la "Data Dictionary" marche très bien et je peux l'appeler depuis une règle (sauf que je veux que l'envoi puisse être manuel).
Peut-être pourrai-je l'appeler depuis mon composant ?

    //var nodeRef = args["noderef"];
    //var document = search.findNode(nodeRef);

    var persons = [];
    var perms = document.getPermissions();
    for(var i=0 ; i<perms.length ; i++) {
       var perm = perms[i].split(";");
       if(perm[0] == "ALLOWED" && perm[1].lastIndexOf("GROUP_") != -1) {
          var group = people.getGroup(perm[1]);
          if(group) {
             var persons = people.getMembers(group);
             for each (person in persons){
                if(person.properties.userName != "admin" && person.properties.userName != "guest") {
                   var email = person.properties.email;
                   if(email)
                      sendMail(email);
                }
             }
          }
       }
    }

    function sendMail(email) {
       // Envoi mail
       var mail = actions.create("mail");
       mail.parameters.to = email;
       mail.parameters.subject = "Nouveau Document";
       mail.parameters.from = "Info@Alfresco";
       mail.parameters.template = companyhome.childByNamePath("Data Dictionary/Email Templates/Notify Email Templates/notify_user_email.ftl");
       mail.parameters.text = "Inutile grace au Template ";
       mail.execute(document);
    }‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: [Share custom Action] Envoyer un document par mail

bertrandf — Fri, 31 Dec 2010 10:48:11 GMT

Bonjour,

Le comportement est tout à fait normal, depuis Share vous n'avez pas accès aux APIs JavaScript "classiques".
Il faut considérer Share comme une couche de présentation de l'entrepôt, quasiment tout ce qui concerne les traitements est fait coté entrepôt.

L'API JavaScript coté Share est très limitée, avec vous pourrez tout de même récupérer des informations sur l'utilisateur connecté, sur la page ou vous êtes, … et surtout vous avez l'objet remote qui vous permet d'appeler des webscripts situés dans l'entrepôt.
http://wiki.alfresco.com/wiki/Surf_Platform_-_Freemarker_Template_and_JavaScript_API

Il faut donc développer un webscript coté Alfresco et y faire appel depuis Share.
Concrètement vous allez récupérer les paramètres que vous voulez dans Share (nodeRef, …) et les transmettre à votre webscript situé coté Alfresco (utilisation de l'objet remote) qui se chargera de faire le traitement.

PS : Je ne comprends pas comment vous faites pour récupérer le nodeRef du document sur lequel vous êtes. Je pense que réaliser une action avec une page et plus compliqué que la méthode expliquée dans le wiki.

Re: [Share custom Action] Envoyer un document par mail

bertrandf — Fri, 31 Dec 2010 14:22:38 GMT

En réponse à la mise à jour de votre message (qui va dans le même sens que mon message précédent) :

Il faut reprendre le traitement de votre fichier mail-utilisateurs.get.js mais dans un webscript coté alfresco et dans votre fichier mail-utilisateurs.get.js faire appel à ce webscript.

En gros, il faut créé un webscript dans alfresco :
(Par exemple dans C:\Alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\templates\webscripts)

mon-webscript.get.desc.xml

<webscript>
<shortname>Mon webscript</shortname>
<description>Mon webscript qui envoie des mails</description>
<url>/sendMail</url>
<format default="json">argument</format>
<authentication>user</authentication>
</webscript>‍‍‍‍‍‍‍

mon-webscript.get.js : Vous reprenez ce que vous avez déjà fait dans mail-utilisateurs.get.js

try {
  model.users = [];
  model.failures = [];

  var nodeRef = args["noderef"];
  var document = search.findNode(nodeRef);

  var perms = document.getPermissions();
  for (var i=0 ; i<perms.length ; i++) {
     var perm = perms[i].split(";");
     if (perm[0] == "ALLOWED" && perm[1].lastIndexOf("GROUP_") != -1) {
        var group = people.getGroup(perm[1]);
        if (group) {
           var persons = people.getMembers(group);
           for each (p in persons) {
              if (p.properties.userName != "admin" && p.properties.userName != "guest") {
                 var email = p.properties.email;
                 if (email) {
                  sendMail(p, document);
                 }
              }
           }
        }
     }
  }
}
catch (e) {}

function sendMail(p, doc) {
  try {
    // Envoi mail
    var mail = actions.create("mail");
    mail.parameters.to = p.properties.email;
    mail.parameters.subject = "Nouveau Document";
    mail.parameters.from = "Info@Alfresco";
    mail.parameters.template = companyhome.childByNamePath("Data Dictionary/Email Templates/Notify Email Templates/notify_user_email.ftl");
    mail.parameters.text = "Inutile grace au Template ";
    mail.execute(doc);

    model.users.push(p.properties.userName);
  }
  catch(e) {
    model.failures.push(p.properties.userName);
  }
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

mon-webscript.get.json.ftl

<@compress single_line=true>
<#escape x as jsonUtils.encodeJSONString(x)>
{
  "document": "${document.name}",
  "users": [
    <#list users as userName>
      "${userName}"
      <#if userName_has_next>,</#if>
    </#list>
  ],
  "failures": [
    <#list failures as authority>
      "${authority}"
      <#if authority_has_next>,</#if>
    </#list>
  ]
}
</#escape>
</@>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Et dans votre fichier mail-utilisateurs.get.js (coté Share), il faut faire appel à ce webscript.
Vous devriez avoir quelque chose du genre :

var nodeRef = page.url.args.nodeRef;

var result = remote.call("/sendMail?nodeRef=" + stringUtils.urlEncode(nodeRef));
if (result.status == 200) {
  var json = eval('(' + result + ')');
  
  model.success = json.users;
  model.failures = json.failures;
}‍‍‍‍‍‍‍‍‍

En espérant que ca vous aide et que vous puissiez avance.

Re: [Share custom Action] Envoyer un document par mail

roxy — Fri, 31 Dec 2010 14:41:48 GMT

Merci Bertrand vos infos m'aident beaucoup,

j'ai pu (enfin !) faire marcher mon envoi de mail en appelant un nouveau script d'Alfresco,

Juste deux petites modifs par rapport au code transmis par Bertrand :

sur mon-webscript.get.desc.xml, je passe le nodeRef du document ce qui permet de le traiter ainsi que de récupérer les personnes qui ont des droits dessus.

mon-webscript.get.desc.xml

    <webscript>
    <shortname>Mail utilisateurs avec lien document</shortname>
    <description>Mon webscript qui envoie des mails</description>
    <url>/sendMailUtilisateurs?nodeRef={nodeRef?}</url>
    <format default="json">argument</format>
    <authentication>user</authentication>
    </webscript>‍‍‍‍‍‍‍

et du coté du JS, on rajoute une boucle pour éviter les doublons (plusieurs mails envoyés à la même adresse)
mon-webscript.get.js

…
              var email = person.properties.email;
                     // Insertion dans la table users (suppression des doublons)
                      if(email) {
                       var exist = 0;
                         for(var seq=0 ; seq<users.length ; seq++) {
                             if (users[seq] == email) {
                                  exist = 1;
                             }
                         }
                         if (exist == 0){
                            users[users.length] = email;      
                        }
…‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Bonne année 2011 à tous

Re: [Share custom Action] Envoyer un document par mail

amorisset — Mon, 24 Jan 2011 11:10:56 GMT

Bonjour,

Pouvez-vous nous indiquer comment vous avez corrigé vos erreurs ?

cordialement,

Aude

Re: [Share custom Action] Envoyer un document par mail

roxy — Mon, 24 Jan 2011 12:24:11 GMT

Bonjour,

j'ai l'impression que tout est dans les messages …
si un point vous semble opaque, dites-moi lequel et je vous donnerai des précisions

cordialement