topic Re: Accès au repository in Alfresco Archive

Accès au repository

pilate — Fri, 28 May 2010 11:52:18 GMT

Bonjour,Je suis en train de faire un test de dashlet mais je n'ai pas d'acces au repo avec l'EL ${space.name}. Alfresco me dit : Expression space is undefined on line 15, column 31 in com/domain/mon-dashlet.get.html.ftl‍Voici mes fichiers : mon-dashlet.get.desc.xml<webscript> <shortname&g

Re: Accès au repository

bertrandf — Fri, 28 May 2010 12:32:03 GMT

Je serai tenté de dire que c'est normal que ca ne fonctionne pas …

Premièrement, qu'essayez-vous de faire exactement, faire une dashlet c'est bien beau mais vous voulez faire quoi dedans ?

Sachez que depuis votre webscript situé coté Share, vous n'aurez pas accès au repository comme lorsque vous créez un webscript coté alfresco.

La pluspart du temps, le fonctionnement est le suivant :
1- créer un webscript coté entrepot (coté Alfresco) qui renvoie des données structurées (JSON, XML, …).
2- créer un webscript coté Share (de type dashlet dans votre cas)
3- réceptionner les données de votre webscript (celui situé coté Alfresco) dans votre fichier javascript du webscript situé coté Share à l'aide des outils qui vont biens : http://wiki.alfresco.com/wiki/Surf_Platform_-_Freemarker_Template_and_JavaScript_API#Connectors
4- traiter les données et les mettre en forme dans votre dashlet avec freemarker

Cet article peut éventuellement vous aider à comprendre le mécanisme de communication entre Share et le repository via les webscripts (notamment vers la fin de l'article).
Je vous conseille également de regarder ce qui est fait dans les dashlets de base de Share qui sont de bonnes sources d'information.

J'espère avoir été assez précis.

Re: Accès au repository

pilate — Fri, 28 May 2010 13:13:30 GMT

ça c'est une réponse comme je les aime. Merci beaucoup (faut dire que je me suis amélioré niveau question :mrgreen: ).
j'ai regardé les webscript côté share mais j'avoue ne pas tout biter :
- l'extension .head ?
- les @ et les # partout ?
- …

Je vais regarder les liens. Merci encore !!

EDIT : et qu'en est-il des websdcripts dans shared/classes ?

Re: Accès au repository

bertrandf — Fri, 28 May 2010 13:25:40 GMT

Les fichiers .head ne sont pas indispensables mais très utiles pour les dashlets, ca vous permet d'intégrer vos css et script js proprement.
Les #, c'est pour la notation freemarker, n'est plus ni moins. Dans les fichiers .head, cela permet d'inclure le fichier component.head.inc grâce au <#include.
Après les @, c'est pour appeler des macros freemarker. Dans les fichiers .head, on fait appel à la macro script (<@script), cela permet juste de charger le bon fichier javascript (extension -min.js ou .js pour le mode debug).
Doc freemarker sur les macros : http://freemarker.sourceforge.net/docs/ref_directive_macro.html

Je serai vous, je commencerai pas un webscript simple.

Il vous suffit pour cela de créer :
un webscript coté Alfresco :
- 1 fichier XML (desc.xml)
- 1 fichier freemarker (.json.ftl par exemple)
(éventuellement un fichier javascript)

A placer dans :
/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/extension/templates/webscripts/
ou /tomcat/webapps/alfresco/WEB-INF/classes/alfresco/templates/webscripts/
ou /tomcat/webapps/alfresco/WEB-INF/classes/alfresco/webscripts/

un webscript coté Share :
- 1 fichier XML (desc.xml)
- 1 fichier JavaScript (pour appeler votre wbscript coté alfresco)
- 1 fichier freemarker (.html.ftl)

A placer dans : /tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/dashlets/

EDIT : Voici un exemple de code pour faire appel à votre webscript situé coté Alfresco

var connector = remote.connect("alfresco");

var result  = connector.get("/com/domain/votre-webscript-coté-alfresco);
if(result.status == 200){
  var data = eval( '(' + result + ')');
  
  //traiter ici vos données
  //écrire dans le model pour récupérer des données dans votre template
}‍‍‍‍‍‍‍‍‍

Re: Accès au repository

pilate — Fri, 28 May 2010 13:33:17 GMT

bah apparemment, les webscripts dans shared/classes ça fonctionne .

Je voudrais récupérer les blogs du site courant. Sont-ils aussi dans le repository

EDIT : apparemment oui

Re: Accès au repository

pilate — Fri, 28 May 2010 13:39:08 GMT

Les fichiers .head ne sont pas indispensables mais très utiles pour les dashlets, ca vous permet d'intégrer vos css et script js proprement.
Les #, c'est pour la notation freemarker, n'est plus ni moins. Dans les fichiers .head, cela permet d'inclure le fichier component.head.inc grâce au <#include.
Après les @, c'est pour appeler des macros freemarker. Dans les fichiers .head, on fait appel à la macro script (<@script), cela permet juste de charger le bon fichier javascript (extension -min.js ou .js pour le mode debug).
Doc freemarker sur les macros : http://freemarker.sourceforge.net/docs/ref_directive_macro.html

Je serai vous, je commencerai pas un webscript simple.

Il vous suffit pour cela de créer :
un webscript coté Alfresco :
- 1 fichier XML (desc.xml)
- 1 fichier freemarker (.json.ftl par exemple)
(éventuellement un fichier javascript)

A placer dans :
/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/extension/templates/webscripts/
ou /tomcat/webapps/alfresco/WEB-INF/classes/alfresco/templates/webscripts/
ou /tomcat/webapps/alfresco/WEB-INF/classes/alfresco/webscripts/

un webscript coté Share :
- 1 fichier XML (desc.xml)
- 1 fichier JavaScript (pour appeler votre wbscript coté alfresco)
- 1 fichier freemarker (.html.ftl)

A placer dans : /tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/dashlets/

EDIT : Voici un exemple de code pour faire appel à votre webscript situé coté Alfresco
var connector = remote.connect("alfresco");

var result  = connector.get("/com/domain/votre-webscript-coté-alfresco);
if(result.status == 200){
  var data = eval( '(' + result + ')');
  
  //traiter ici vos données
  //écrire dans le model pour récupérer des données dans votre template
}‍‍‍‍‍‍‍‍‍

Merci pour le coup de main. Petite remarque, j'ai fait un tuto FreeMArker et il n'y avait pas de # devant les balises ??!! :?

ex : <list orders as o></list>

et à quoi sert le fichier component.head.inc exactement ?

Re: Accès au repository

pilate — Fri, 28 May 2010 17:27:39 GMT

Par contre de la version 3.2r2 à la version 3.3, on dirait qu'il y a eut des modifications importantes.

Share utilise les webscripts de Spring, c'est ça ?

Et on peut exporter directement le webscript sous forme de jar dans le dossier lib de share.

Faut-il procéder de la même manière pour faire communiquer un Webscript avec le repository que sur la 3.2r2 ?

Les WS custom de la 3.2r2 fonctionneront-ils avec la 3.3 ?

EDIT : quelquechose me dit que le webscript côté Alfresco pour récupérer les blogs du site existe déjà, non ?

Re: Accès au repository

pilate — Sun, 30 May 2010 11:06:46 GMT

Bon voilà, j'ai fais beaucoup de tests pour comprendre la chose.

Il n'y a apparemment pas d'API js directe pour atteindre les blogs directement. Ou puis-je passer par le service js Activities.

J'avoue que ça reste en core un peu flou pour moi. D'ailleurs, quelle est la différence entre API et Service js ?

Ils font tous les deux plus ou moins la même chose, c'est-à-dire des accès et modification dans le repository…

Re: Accès au repository

pilate — Mon, 31 May 2010 16:49:06 GMT

Ok, j'essaie de me connecter au werbscript blogsearch.get via l'url /sample/blog/search?q={searchTerm} avec le code suivant :

function main() {

   var s = new XML(config.script);
   model.maxItems = parseInt(s.maxitems, 10);

   var result, blogs = {};

   var result = remote.call("/sample/blog/search?q=/company_home/sites/blog//*");

   if (result.status == 200 && result != "{}") {

      try {
         var blgs = eval('(' + result + ')');
      } catch (e) {
      }
   }
   model.blogs = blgs;
}

main();‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Oui je sais c'est cracrin, j'ai encore du mal avec les requêtes lucene, et c'est tout ce que je suis capable de pondre à ce jour :cry:

Quand j'affiche le resultat ${blogs} sur mon ftl, j'obtiens la string suivante : org.mozilla.javascript.Undefined@3ed3c4

Suis-je sur la bonne voie ?

Merci de votre aide :wink:

Re: Accès au repository

pilate — Mon, 07 Jun 2010 08:14:27 GMT

Bonjour,

C'est vraiment très compliqué tous ces échanges entre le model, le remote, les différents formats.

Quelle(s) formation(s) me conseillez-vous de faire pour être plus à l'aise en développement Surf.

Re: Accès au repository

pilate — Tue, 08 Jun 2010 14:03:14 GMT

Bonjour,

Je ne comprends pas, dans vos exemple, vous faites :

toto = eval('(' + result + ')');‍

Si je laisse les guillemets, j'obtiens cette erreur :

Cannot parse XML: Scanner State 24 not Recognized  (file:/‍

Si je les retire, ça passe. Pourtant dans tous les codes javascript des sources, il y a bien les guillemets.

Pourquoi j'ai cette erreur ?

Re: Accès au repository

pilate — Tue, 08 Jun 2010 14:48:51 GMT

Il vous suffit pour cela de créer :
un webscript coté Alfresco :
- 1 fichier freemarker (.json.ftl par exemple)

Est-il possible ici de créer un fichier freemarker au format html ? Si oui comment récupérer les données côtés Share, autrement dit, ces données seront-elles directement interprétée en html ou dois-je les retravailler en javascript côté Share ?

Re: Accès au repository

bertrandf — Tue, 08 Jun 2010 16:30:37 GMT

Est-il possible ici de créer un fichier freemarker au format html ? Si oui comment récupérer les données côtés Share, autrement dit, ces données seront-elles directement interprétée en html ou dois-je les retravailler en javascript côté Share ?

Oui mais c'est "moins propre" (enfin ca dépend ce que vous voulez faire).

Coté Share, même principe que lorsque vous récupérez du JSON avec l'eval en moins.

Dans le fichier JavaScript (version courte, sans gestion des erreurs, …) :

var connector = remote.connect("alfresco");
model.result = connector.get("/com/domain/votre-webscript-coté-alfresco-html);‍‍

Dans le template coté Share :

${result}
‍‍

Re: Accès au repository

pilate — Wed, 09 Jun 2010 10:28:19 GMT

Oui c'est pas très mais ça fonctionne

Par contre, j'ai besoin du nodeRef du site côté Alfresco. De quel côté puis-je le récupérer et surtout comment ?

Re: Accès au repository

bertrandf — Thu, 10 Jun 2010 08:12:33 GMT

Par contre, j'ai besoin du nodeRef du site côté Alfresco. De quel côté puis-je le récupérer et surtout comment ?

Je dirai qu'il faut que vous récupériez le nom du site dans votre webscript coté share puis que vous le passiez en paramètre lors de l'appel à votre webscript situé coté entrepôt.
Dans votre webscript coté alfresco, vous recherchez le noeud dans /company_home/sites/ à l'aide de l'API Search : http://wiki.alfresco.com/wiki/3.2_JavaScript_API#Search_API

Par exemple :

var siteNode = companyhome.childrenByXPath("st:sites/cm:" + args.site.toLowerCase())[0];‍

Re: Accès au repository

pilate — Thu, 10 Jun 2010 15:04:13 GMT

Vous me conseillez à plusieurs reprises d'utiliser le json pour transmettre mes données. Pourrais-je les récupérer et les mettre en forme HTML côté Share ?

var siteNode = companyhome.childrenByXPath("st:sites/cm:" + args.site.toLowerCase())[0];‍

Si je fais ça côté Alfresco, je n'ai pas accès à args.site. Peut-être est-ce dû à ma version qui est la 3.3 :?:

Re: Accès au repository

pilate — Fri, 11 Jun 2010 07:47:51 GMT

C'est bon j'ai compris le truc, mon dashlet fonctionne. Merci beaucoup pour ton aide Bertrand.

J'ai maintenant compris à quoi peut servir la formation pour développeur. :mrgreen:

C'est vraiment immense toutes ces nouvelles technos java moi qui en étais resté à Struts et jsp … :roll:

Re: Accès au repository

pilate — Wed, 23 Jun 2010 07:40:36 GMT

Bonjour à tou(te)s,

En regardant les quelques codes javascript, j'en viens à me poser une question.

Peut-on à partir d'un noeud récupérer tous les fils avec un critère du style requête lucene ? Exemple :


postNodes = node.searchChildrenByXPath("fm:post");
‍‍‍