SmartExpressions - Historique des versions

Damien : /* Fusionner plusieurs listes */

2026-03-05T12:29:17Z

Fusionner plusieurs listes

Damien : /* Ajouter une valeur dans une liste plate */

2025-11-26T14:35:47Z

Ajouter une valeur dans une liste plate

Damien : /* Assigner un nouveau couple clé-valeur dans une liste */

2025-11-26T14:35:23Z

Assigner un nouveau couple clé-valeur dans une liste

Damien : /* Ajouter une valeur dans une liste plate */

2025-11-26T14:31:02Z

Ajouter une valeur dans une liste plate

Damien : /* Assigner un nouveau couple clé-valeur dans une liste */

2025-11-26T14:30:00Z

Assigner un nouveau couple clé-valeur dans une liste

Damien : /* Fonctions sur des listes */

2025-11-22T13:34:53Z

Fonctions sur des listes

Damien : /* Fonctions sur des listes */

2025-11-22T13:32:55Z

Fonctions sur des listes

Damien : /* Obtenir la valeur d'un élément d'une liste à partir d'une clé */

2025-11-22T11:38:53Z

Obtenir la valeur d'un élément d'une liste à partir d'une clé

Damien : /* Principes */

2025-07-03T15:43:09Z

Principes

Damien : /* Obtenir la valeur d'un élément d'une liste à partir d'une clé dynamique */

2025-04-07T08:56:07Z

Obtenir la valeur d'un élément d'une liste à partir d'une clé dynamique

@@ Ligne 763 : / Ligne 763 : @@
 ::'''Exemple de paramétrage :'''
 ::   <code>merge(GERANTS, MANDATS_NOMINATION)</code>
 ==== Fonctions autres ====

← Version précédente		Version du 26 novembre 2025 à 14:35
Ligne 613 :		Ligne 613 :


−	==== Ajouter une valeur dans une liste plate ====	+	===== Ajouter une valeur dans une liste plate =====

	# Fonction : <code>add_to_list</code>		# Fonction : <code>add_to_list</code>

@@ Ligne 613 : / Ligne 613 : @@
-#### Ajouter une valeur dans une liste plate
+==== Ajouter une valeur dans une liste plate ====
 # Fonction : <code>add_to_list</code>
@@ Ligne 634 : / Ligne 634 : @@
 ASSOCIE_ITEM.PARTS > 25 ? add_to_list(_PREV, ASSOCIE_ITEM.PRENOM) : _PREV
 </pre>
 :: Ou, autre exemple, lister les clés des associés qui ont plus de 50% des parts :
 <pre>
@@ Ligne 639 : / Ligne 642 : @@
 ASSOCIE_ITEM.PARTS > 30 ? add_to_list(_PREV, _KEY) : _PREV
 </pre>
 ===== Additionner les répétitions d'une sous-variable d'une liste structurée =====

@@ Ligne 613 : / Ligne 613 : @@
-===== Ajouter une valeur dans une liste plate =====
+#### Ajouter une valeur dans une liste plate
 # Fonction : <code>add_to_list</code>
@@ Ligne 621 : / Ligne 621 : @@
 ## - La valeur à ajouter à la liste (string, nombre…) ;
+'''''Usage'''''
 :: Soit la liste plate PRODUITS qui vaut ["voiture", "sac"] :
@@ Ligne 628 : / Ligne 627 : @@
 :: - <code>add_to_list(PRODUITS, "pomme", "poire")</code> => va renvoyer la liste ["voiture", "sac", "pomme", "poire"] (on peut passer autant de valeur qu'on le souhaite à la fonction, elles seront ajoutées à la fin).
-'''Usage avancé'''
+'''''Usage avancé'''''
 :: Cette fonction peut-être très utile, combinée à un [[Instructions de Boucle dans une Variable Dynamique (DynVar Loop Statement)|#reduce]], pour fabriquer des listes plates dynamiques.
 :: Par exemple, si je veux lister les prénoms des associés ayant plus de 25% des parts :

← Version précédente		Version du 26 novembre 2025 à 14:30
Ligne 613 :		Ligne 613 :


		+	===== Ajouter une valeur dans une liste plate =====
		+
		+	# Fonction : <code>add_to_list</code>
		+	# Nombre de paramètres : <code>2 à N</code>
		+	# Paramètres attendus :
		+	## - Une variable de type [[DataStore\|List]] plate (ex: ["jaune", "vert", "bleu"]) ;
		+	## - La valeur à ajouter à la liste (string, nombre…) ;
		+
		+
		+	'''Usage'''
		+
		+	:: Soit la liste plate PRODUITS qui vaut ["voiture", "sac"] :
		+	:: - <code>add_to_list(PRODUITS, "pomme")</code> => va renvoyer la liste ["voiture", "sac", "pomme"] (la nouvelle valeur est ajoutée à la fin).
		+	:: - <code>add_to_list(PRODUITS, "pomme", "poire")</code> => va renvoyer la liste ["voiture", "sac", "pomme", "poire"] (on peut passer autant de valeur qu'on le souhaite à la fonction, elles seront ajoutées à la fin).
		+
		+	'''Usage avancé'''
		+	:: Cette fonction peut-être très utile, combinée à un [[Instructions de Boucle dans une Variable Dynamique (DynVar Loop Statement)\|#reduce]], pour fabriquer des listes plates dynamiques.
		+	:: Par exemple, si je veux lister les prénoms des associés ayant plus de 25% des parts :
		+	<pre>
		+	#reduce list ASSOCIES as ASSOCIE_ITEM, [] as _PREV :
		+	ASSOCIE_ITEM.PARTS > 25 ? add_to_list(_PREV, ASSOCIE_ITEM.PRENOM) : _PREV
		+	</pre>
		+	:: Ou, autre exemple, lister les clés des associés qui ont plus de 50% des parts :
		+	<pre>
		+	#reduce list ASSOCIES as ASSOCIE_ITEM, [] as _PREV :
		+	ASSOCIE_ITEM.PARTS > 30 ? add_to_list(_PREV, _KEY) : _PREV
		+	</pre>

	===== Additionner les répétitions d'une sous-variable d'une liste structurée =====		===== Additionner les répétitions d'une sous-variable d'une liste structurée =====

@@ Ligne 610 : / Ligne 610 : @@
 '_bcd456' => 13.50,
 ]</pre>
@@ Ligne 662 : / Ligne 663 : @@
 ::   <p>Pour obtenir ce même filtre avec un age dynamique :</p>
 ::   <p><code>filter_by_expr(ASSOCIES, "ITEM.AGE > PARAM1", AGE_MAX)</code></p>
@@ Ligne 679 : / Ligne 679 : @@
 ::'''Exemple de paramétrage :'''
-<code>join(COULEURS, ", ")<code> donnera "jaune, rouge, bleu"
+<code>join(COULEURS, ", ")</code> donnera "jaune, rouge, bleu"
 <p>Il est possible de combiner "join" avec la fonction "filter_by_keys".</p>
 <p>Par ex : join( filter_by_keys(FILIALES_DISPLAY, CONV.TRESO_FILIALES_PARTICIPANTES) , "", "", "\t - ", " ; \n")</p>
@@ Ligne 700 : / Ligne 701 : @@
 ::   <p>Pour obtenir ce même filtre avec un age dynamique :</p>
 ::   <p><code>filter_by_expr(ASSOCIES, "ITEM.AGE > PARAM1", AGE_MAX)</code></p>
@@ Ligne 717 : / Ligne 719 : @@
 ::   <p>Pour obtenir ce même filtre avec un age dynamique :</p>
 ::   <p><code>filter_by_expr(ASSOCIES, "ITEM.AGE > PARAM1", AGE_MAX)</code></p>

@@ Ligne 499 : / Ligne 499 : @@
 ==== Fonctions sur des listes ====
 ===== Obtenir la valeur d'un élément d'une liste à partir de clés =====
@@ Ligne 531 : / Ligne 533 : @@
 ::::- <code>get_value(EMPLOYES, MEILLEUR_EMPLOYE, 'SALAIRE')</code> => va renvoyer le salaire du meilleur employé selon le choix effectué.<br/>
 </p>
 ===== Obtenir la valeur d'un élément d'une liste à partir de son index =====
@@ Ligne 550 : / Ligne 555 : @@
 :: Notez que dans le cas d'une liste structuré, l'élément retourné sera lui même une liste avec des sous-variables. Il faudra donc parfois combiner cette fonction avec un `get_value` :
 :: '''''Exemple''''' : Obtenir le <code>NOM</code> du 3ème employé de la liste <code>EMPLOYES</code> : <code>get_value( get_value_by_index(EMPLOYES, 3), 'NOM')</code>
 ===== Savoir si une liste contient ou pas une certaine clé =====
@@ Ligne 570 : / Ligne 578 : @@
 - <code>has_key(EMPLOYES_CDI, MEILLEUR_EMPLOYE)</code> => va renvoyer TRUE si la clé renseignée dans <code>MEILLEUR_EMPLOYE</code> se trouve bien dans la liste <code>EMPLOYES_CDI</code>.
 </p>
@@ Ligne 601 : / Ligne 610 : @@
 '_bcd456' => 13.50,
 ]</pre>
@@ Ligne 620 : / Ligne 630 : @@
 <p><code>list_sum(VARIABLE_LISTE,"SOUS_VARIABLE")</code></p>
 <p>Pour obtenir le prix de toutes les Chemises dans l'exemple ci-dessus, il faudra paramétrer une [[Dynvars|Dynvar]] dont la formule sera <code>list_sum(CHEMISES,"prix")</code></p>
@@ Ligne 633 : / Ligne 645 : @@
 ::<p><code>filter_by_keys(ASSOCIES, ASSOCIES_PRESENTS)</code></p>
-===== Montrer et organiser les valeurs d'une liste (à rerédiger plus parfaitement) =====
 # Fonction : <code>join</code>
@@ Ligne 639 : / Ligne 673 : @@
 # Paramètres attendus :
 ## - Une variable de liste (paramètre obligatoire) ;
-## - Séparateur (facultatif) ;
+## - Séparateur de jointure (facultatif) ;
 ## - Dernier séparateur (facultatif) ;
 ## - Préfixe (facultatif) ;
@@ Ligne 645 : / Ligne 679 : @@
 ::'''Exemple de paramétrage :'''
 <p>Il est possible de combiner "join" avec la fonction "filter_by_keys".</p>
 <p>Par ex : join( filter_by_keys(FILIALES_DISPLAY, CONV.TRESO_FILIALES_PARTICIPANTES) , "", "", "\t - ", " ; \n")</p>
 ==== Fonctions autres ====

@@ Ligne 500 : / Ligne 500 : @@
 ==== Fonctions sur des listes ====
-===== Obtenir la valeur d'un élément d'une liste à partir d'une clé =====
+===== Obtenir la valeur d'un élément d'une liste à partir de clés =====
 # Fonction : <code>get_value</code>
-# Nombre de paramètres : <code>2 ou 3</code>
+# Nombre de paramètres : <code>min 2</code>
 # Paramètres attendus :
 ## - Une variable de type [[DataStore|List]] ;
-## - La clé à cibler ;
+## - De 2 à N : la clé de l'élément antérieur ;
 ::'''Cas pratique'''
@@ Ligne 515 : / Ligne 514 : @@
 <pre>
+    [
-      '_abc123' => [ 'NOM': 'Jean', 'DATE_ENTREE': '13-08-2020', 'SALAIRE': 32000.00 ,
+      '_abc123' => [ 'NOM': 'Jean', 'DATE_ENTREE': '13-08-2020', 'SALAIRE': 32000.00 ],
-      '_xyz987' => [ 'NOM': 'Sylvie', 'DATE_ENTREE': '11-12-2019', 'SALAIRE': 39500.00
+      '_xyz987' => [ 'NOM': 'Sylvie', 'DATE_ENTREE': '11-12-2019', 'SALAIRE': 39500.00 ]
+    ]
 </pre>
@@ Ligne 532 : / Ligne 531 : @@
 ::::- <code>get_value(EMPLOYES, MEILLEUR_EMPLOYE, 'SALAIRE')</code> => va renvoyer le salaire du meilleur employé selon le choix effectué.<br/>
 </p>
 ===== Obtenir la valeur d'un élément d'une liste à partir de son index =====

@@ Ligne 71 : / Ligne 71 : @@
 === Principes ===
-<p>Une fonction prend toujours la forme suivante : <code>MA_FONCTION( xxx )</code></p>
+<p>Une fonction prend toujours la forme suivante : <code>nom_de_la_fonction( xxx )</code></p>
 </br>
 <p>Une fonction est donc toujours composée de trois éléments :</p>
-<p><code>MA_FONCTION</code> : on commence toujours par nommer la '''fonction''' souhaitée.</p>
+<p><code>nom_de_la_fonction</code> : on commence toujours par nommer la '''fonction''' souhaitée.</p>
 <p><code>( )</code> : ces parenthèses dites "d'exécution" peuvent contenir plusieurs paramètres, séparés chacun par une virgule. Chaque fonction pourra avoir plus ou moins de paramètres.</p>
 <p><code>xxx</code> : les '''paramètres''' de la fonction. Ce sont les paramètres qui vont permettre à la fonction de s'exécuter.</p>

@@ Ligne 500 : / Ligne 500 : @@
 ==== Fonctions sur des listes ====
-===== Obtenir la valeur d'un élément d'une liste à partir d'une clé dynamique =====
+===== Obtenir la valeur d'un élément d'une liste à partir d'une clé =====
 # Fonction : <code>get_value</code>
@@ Ligne 509 : / Ligne 509 : @@
 ## - Dans le cas d'une liste "structurée" (issue d'un [[Repeaters|Repeater]] par exemple), on peut préciser le nom de la sous-variable à renvoyer.
-'''Cas pratique'''
+::'''Cas pratique'''
-<p>Cas d'une liste EMPLOYES, utilisée dans un Repeater, dont chaque élément défini 3 sous-variables: <code>EMPLOYES.NOM</code>, <code>EMPLOYES.DATE_ENTREE</code>, <code>EMPLOYES.SALAIRE</code>. <br/>
+::<p>Cas d'une liste EMPLOYES, utilisée dans un Repeater, dont chaque élément défini 3 sous-variables: <code>EMPLOYES.NOM</code>, <code>EMPLOYES.DATE_ENTREE</code>, <code>EMPLOYES.SALAIRE</code>. <br/>
-Ceci étant, l'utilisateur a renseigner dans un formulaire 2 fiches correspondante à EMPLOYES. Elles ont respectivement les clés '_abc123' et '_xyz987' :
+::::Ceci étant, l'utilisateur a renseigner dans un formulaire 2 fiches correspondante à EMPLOYES. Elles ont respectivement les clés '_abc123' et '_xyz987' :
 </p>
 <pre>
-−
+   [
- '_abc123' => [ 'NOM': 'Jean', 'DATE_ENTREE': '13-08-2020', 'SALAIRE': 32000.00 ,
+     '_abc123' => [ 'NOM': 'Jean', 'DATE_ENTREE': '13-08-2020', 'SALAIRE': 32000.00 ,
- '_xyz987' => [ 'NOM': 'Sylvie', 'DATE_ENTREE': '11-12-2019', 'SALAIRE': 39500.00
+     '_xyz987' => [ 'NOM': 'Sylvie', 'DATE_ENTREE': '11-12-2019', 'SALAIRE': 39500.00
-−
+   ]
 </pre>
-'''Usage'''
+::'''Usage'''
 <p>
-- <code>get_value(EMPLOYES, '_abc123', 'NOM')</code> => va renvoyer "Jean" <br/>
+::::- <code>get_value(EMPLOYES, '_abc123', 'NOM')</code> => va renvoyer "Jean" <br/>
-- <code>get_value(EMPLOYES, '_xyz987', 'SALAIRE')</code> => va renvoyer <code>39500.0</code>
+::::- <code>get_value(EMPLOYES, '_xyz987', 'SALAIRE')</code> => va renvoyer <code>39500.0</code>
 </p>
 <p>
-Mais là où cette fonction prend tout son intérêt, c'est quand le second paramètre est dynamique, c'est à dire qu'il est fourni au travers d'une variable.<br/>
+::Mais là où cette fonction prend tout son intérêt, c'est quand le second paramètre est dynamique, c'est à dire qu'il est fourni au travers d'une variable.<br/>
-Prenons par exemple, une variable "MEILLEUR_EMPLOYE", qui serait utilisée dans un formulaire avec un champ "choice-list", et qui prendra pour valeur la clé correspondante au meilleur employé de l'entreprise (= c'est à dire '_abc123' ou '_xyz987' dans notre exemple).
+::Prenons par exemple, une variable "MEILLEUR_EMPLOYE", qui serait utilisée dans un formulaire avec un champ "choice-list", et qui prendra pour valeur la clé correspondante au meilleur employé de l'entreprise (= c'est à dire '_abc123' ou '_xyz987' dans notre exemple).
 <br/>
-- <code>get_value(EMPLOYES, MEILLEUR_EMPLOYE, 'SALAIRE')</code> => va renvoyer le salaire du meilleur employé selon le choix effectué.<br/>
+::::- <code>get_value(EMPLOYES, MEILLEUR_EMPLOYE, 'SALAIRE')</code> => va renvoyer le salaire du meilleur employé selon le choix effectué.<br/>
 </p>
 ===== Savoir si une liste contient ou pas une certaine clé =====