Dashlet spécifique HelloWorld 3 (3/3)

Introduction :

Ce post fait suite à celui sur le dashlet HelloWorld 2.
Le dashlet HelloWorld 3 introduit le concept de fichier de configuration d'un webscript de présentation.


Structure du projet :

Le projet, dans votre IDE, a la structure suivante :

La différence avec le projet HelloWorld 2 réside dans la présence d’un fichier de configuration du webscript : hello-world.get.config.xml

Si vous n’êtes pas familier avec les fichiers de configuration de webscript :

http://wiki.alfresco.com/wiki/Web_Scripts#Web_Script_Configuration

Comprendre le fichier de configuration :

Le fichier XML de configuration du webscript peut porter des variables qui sont accessibles, entre autres, par le fichier contrôleur javascript.

hello-world.get.config.xml :

<hello-world>

<greeting>hello</greeting>

</hello-world>

La variable “greeting” ainsi définie peut être appelée par le fichier contrôleur javascript, par le biais d’un objet javascript “XML”, de la manière suivante :

hello-world.get.js

function main()

{

var s = new XML(config.script);

var greeting = s.greeting;

// Set the model object

if (greeting == "hello")

{

model.greeting = "hello";

}

else

{

model.greeting = "goodbye";

}

}

main();

Il faut noter que les variables définies dans le fichier de configuration du webscript sont également accessibles depuis le fichier de “vue “ (template freemarker).
Ici, nous avons fait le choix d’appeler la variable “greeting” dans le fichier javascript, en utilisant une méthode E4X (https://developer.mozilla.org/en/e4x )

L’avantage principal de définir des variables dans le fichier de configuration est la réutilisabilité (??! tout commentaire pour me fournir le terme français correct sera le bienvenu) du webscript. En effet, quiconque souhaiterait implémenter ce webscript, mais en personnalisant son comportement pourrait ne modifier que cet unique fichier de configuration, et non pas tout un ensemble de fichiers divers (javascript contrôleur, templates, etc …)


Liens :

Share Extras :

http://code.google.com/p/share-extras/

Le blog de Will Abson :

http://blogs.alfresco.com/wp/wabson/

A propos des webscripts :

http://wiki.alfresco.com/wiki/Web_Scripts

http://ecmarchitect.com/images/articles/alfresco-webscripts/web-script-article.pdf

http://www.springsurf.org/sites/1.0.0.M3/spring-webscripts/spring-webscripts-documentation/reference/index.html

A propos de MDC E4X :

https://developer.mozilla.org/en/e4x

Alfresco Share et sa personnalisation :

http://wiki.alfresco.com/wiki/Alfresco_Share

un excellent exemple avec DeckShare :

http://blogs.alfresco.com/wp/solutions/deckshare/

Alfresco community :
http://www.alfresco.org