Sujet: Méthodes d'appel des balises

Résumé:
Cet article discute des différentes méthodes qui peuvent être utilisées pour appeler des balises dans Lasso Professional 7.

Contenu:
Tout le monde est familier de la manière habituelle d'appeler des balises dans Lasso [Nom_Balise: {Paramètres}] et [$Instance->(Nom_balise: {Paramètres})]. Cet article détaille quelques autres méthodes qui peuvent être utiles dans certaines situations et inclut les appels [Tag->Run], [Tag->Async], [Tag->Invoke], et [Pair->Invoke].

Syntaxe normale

La méthode usuelle d'appel des balises est familière à tout utilisateur de Lasso. Le nom de la balise est suivi de deux points ":" et enfin d'un ensemble de paramètres séparés par des virgules. Les paramètres peuvent être de n'importe quel type ou peuvent être des paires nom/valeur ou mot clé/valeur. The usual method of calling tags is familiar to all Lasso users. The tag name is followed by a colon and then a list of parameters separated by commas. Parameters can be of any type or can be name/value or keyword/value pairs.

[Nom_balise {Paramètres}]

Les balises membres de n'importe quel type de données peuvent être appelées de façon similaire mais auquelles on adjoint une instance de base et le symbole de balise membre ->.

[$Instance->(Tag_Name: {Paramètres})]

[Tag->Run]

On souhaite parfois appeler une balise en utilisant un nombre variable de paramètres. Ceci n'est pas possible en utilisant la syntaxe classique avec les deux points ":" car chaque paramètre de la balise doit être spécifié explicitement. La solution est d'appeler la balise en utilisant une balise membre du type de données appelée [Tag->Run].

Lasso dispose d'un système objet dans lequel chaque valeur incluant des données littérales, des variables mais aussi les balises elles-mêmes sont des objets qui héritent du type [Null] et disposent de leurs propres balises membres. Pour appeler une balise membre d'un objet balise il est nécessaire de faire référence à cet objet balise. Ceci peut être réalisé en utilisant le symbole \. \Nom_Balise retourne alors une référence à la balise spécifiée.

Une fois donnée une référence à la balise, la balise peut être appelée en utilisant la balise membre [Tag->Run]. La balise requiert deux paramètres. -Params=(Array) spécifie les paramètres qui doivent être utilisés lors que la balise est exécutée. -Name='Nom_Balise' spécifie le nom de la balise qui est appelée (et c'est particulièrement important sur les balises intégrées).

[\Nom_Balise->(Run: -Params=(Array: {Paramètres}),
-Name='Nom_Balise')]

La syntaxe est un peu compliquée mais elle exécuté exactement le même travail que [Nom_Balise:{Paramètres}]. Cependant, l'avantage c'est que les paramètres sont spécifiés dans un Array. Cet Array peut donc être bâti dynamiquement et précisé de n'importe quelle valeur(s) avant que la balise ne soit appelée.

Une référence à la balise membre peut être trouvée en utilisant le symbôle \ avec le symbole -> en tant que [Instance->\Nom_Balise]. Il est alors possible d'appeler la balise en utilisant [Tag->Run]. Cependant, les balises membres requièrent un paramètre additionnel car l'instance d ebase doit être spécifiée comme -Base.

[$Instance->\Nom_Balise->(Run: -Params=(Array: {Paramètres}),
-Name='Nom_Balise', -Base=$Instance)]

[Tag->Async]

Lasso supporte l'appel de n'importe quelle balise de manière asynchrone. La balise sera alors exécutée dans un process (thread) séparé de celui qui procède la page courante et aucune valeur de retour ne sera générée. N'importe quel balise qui ne requière aucun accès à des variables sur la page courante peuvent être exécutés de manière asynchrone. Ceci est utile lorsqu'une balise mettra du temps à s'exécuter mais que la valeur retournée n'a pas d'importance.

La balise [Tag->Async] est utilisée comme la balise [Tag->Run].

[\Nom_Balise->(Async: -Params=(Array: {Paramètres}),
-Name='Nom_Balise')]

Par exemple, un usage est d'appeler [Include_URL] de manière à charger une URL distante peut être pour déclencher une action à distance sur un serveur d'application. Si vous ne souhaitez pas disposer du résultat du chargement de cette page en retour alors la balise [Include_URL] peut être exécutée de manière asynchrone.

[\Include_URL->(Async: -Params=(Array: 'http://www.exemple.com/trigger.lasso'), -Name='Include_URL')]

[Tag->Invoke]

Une autre méthode d'appel des balises est d'utiliser la balise membre [Tag->Invoke]. Les paramètres passés à [Tag->Invoke] sont transmis à la balise qui est appelée. Comme les paramètres doivent être spécifiés explicitement cette méthode ne peut être utilisée pour passer des paramètres de manière dynamique à une balise (mais jetez un coup d'oeil à ce sujet à la section suivante)

[\Tag_Name->(Invoke: {Paramètres})]

Invoke est actuellement la balise membre de type [Null] de base de Lasso (référencée en tant que [Null->Invoke]). Tout type de données dans Lasso peut être "invoqué". La plupart des types de données renverrons simplement leur valeur. Les Customs Types peuvent outrepasser la balise [Null->Invoke] afin de fournir un comportement particulier lorsqu'ils sont invoqués. Les balises et les paires ont tous un comportement particulier lorsqu'ils sont invoqués.

[Pair->Invoke]

Un type Pair a un comportement spécial lorsqu'il est invoqué. L'objet dans la première partie de la paire est invoqué lui-même en utilisant l'objet de la seconde partie de la paire en tant que paramètre de l'array. Ceci permet de stocker dans une paire à la fois une référence à la balise ainsi qu'un jeu de paramètres. Invoquer la paire appelle en fait la balise avec ces paramètres. Ce type de paire est appelée une "fermeture" (closure).

[(Pair: \Tag_Name = (Array: {Paramètres}))->(Invoke)]

Cette méthode présente une autre manière d'appeler des balises avec des paramètres dynamiques. Elle pourrait être utilisée pour créer une queue d'actions à exécuter. Chaque élément dans l'array des actions serait invoqué un par un. Les valeurs littérales et les variables de l'array renverraient simplement leur valeurs, les balises seraient exécutées avec aucun paramètre et les fermetures de paires seraient exécutées comme décrit dans cette section.

[Var: 'mesActions' = (Array: 'String', \Server_Date, (Pair: \Cookie = (Array: 'Cookie Name')))]
[Var: 'maValeur' = '']
[Iterate: $mesActions, (Var: 'tempAction')]
   [$maValeur += $tempAction->(Invoke)]
[/Iterate]
[Encode_HTML: $maValeur]

Note: les méthodes d'invocation peuvent être utilisées sur des balises qui requièrent un paramètre -Name. Ceci inclut les balises intégrées de Lasso [String_...], [Date_...], et [Math_...] entre autres. Les méthodes d'invocations ne peuvent pas être exécutées sur des balises membres car il n'y alors aucun moyen de spécifier l'objet de base.

Plus d'information

Plus d'informations sur les différentes méthodes d'appel des balises peuvent être trouvées dans le manuel Extending Lasso 7 Guide ou sur LDML Reference.