EzGED Wiki

Outils pour utilisateurs

Outils du site

Vous êtes ici : start » doc » v3 » acquisition » apprentissage » fonctionsevaluation
Piste :
doc:v3:acquisition:apprentissage:fonctionsevaluation

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
doc:v3:acquisition:apprentissage:fonctionsevaluation [2017/12/27 11:12] – romaindoc:v3:acquisition:apprentissage:fonctionsevaluation [2023/03/17 09:56] (Version actuelle) – modification externe 127.0.0.1
Ligne 2: Ligne 2:
  
  
-===== Convertir en entier (cast) =====+===== Comment utiliser l'interface et l'assistant ? =====
  
-Double cliquez sur la fonction voulue donc "**Convertir en entier**", cela fait apparaitre la fonction dans la zone texte au dessus.+Pour utiliser un élément ou une fonction : 
 +  - dans la zone de texte en haut, posistionnez le curseur à l'endroit ou vous voulez l'inclure 
 +  - Double cliquer sur la fonction ou l'élément souhaité dans une des deux listes en dessous, la fonction ou l'élément apparait automatiquement en haut dans la zone de texte
  
-La fonction **long()** prend en paramètre une variable qu'elle transforme en entier.+Deux cas possibles :
  
-Dans la liste de champs en-dessous, il suffit donc de choisir le champs qui contient la valeur que vous souhaitez convertir. Faites un double clic.+  * Soit vous avez une fonction comme split, qui affiche un point "." devant,  exemple: .split("-") 
 +  * Soit vous avez une fonction sans point devant, donc avec () à la fin
  
-Vous verrez alors apparaitre la pseudo-variable, correspondant au champs, dans la zone texte, en argument de la fonction. +Dans le **premier cas**, le champs à impacter doit être placé devant le point qui précède la fonction donc : 
-A moins d'une erreur, il n'y a plus qu'à cliquer sur Valider pour que votre choix soit prêt à être appliqué. Il est indiqué dans le formulaire, section "**Options de capture**" +<code> 
-=== Condition OU entre plusieurs champs ===+@FLD19.split('-') 
 +</code> 
 +Dans le **second cas**, le champs à impacter sera entre parenthèses, comme un argument en programmation : 
 + 
 +Dans ce second cas, la position du champs dépend ensuite de la fonction, pour plus d'informations, voir le sommaire de cette page et cherchez la fonction concernée. 
 + 
 +Vous pouvez également dans la zone **Options de capture** > **Fonction**, appeler vos propres fonctions. **todo** 
 +===== Fonctions disponibles ===== 
 + 
 +====  Concaténation d'éléments  ==== 
 +<code>@concat</code> 
 +Permet de concaténer les valeurs de chacun des paramètres qui lui sont fournis. 
 + 
 +Il est également possible de spécifier un séparateur. 
 + 
 +{{wiki:icons:info.png}} Elle vous permet de réaliser des opérations de concaténation directement dans votre champ de recherche variable sans passer par un second champ de type spécifique. 
 + 
 +=== Options de capture === 
 + 
 +Deux syntaxes sont possibles. 
 + 
 +Sans spécifier de séparateur: 
 +<code>@concat(valeur1,valeur2,...,valeurN)</code> 
 + 
 +En spécifiant un séparateur: 
 + 
 +<code>@concat('@sep:separateur',valeur1,valeur2,...,valeurN)</code> 
 + 
 +Où //separateur// peut être le caractère (ou chaîne de caractères) de votre choix à l'exception du caractère quote simple. 
 + 
 +Chaque valeur peut être : 
 +  * Une chaîne de caractères encadrée par des quotes simples. 
 +  * Un numérique. 
 +  * [[#@self|@self]] : une référence au champ lui-même. 
 +  * [[#@<groupname>|@<groupname>]] : une référence à une capture dans le filtre de champ. (effectuée dans le filtre de champ). 
 + 
 +====  Date d'échéance  ==== 
 +<code>@dateecheance(@fldX,jours)</code> 
 +une macro qui fait une chose bien pratique de façon simple.  
 +== Options de capture== 
 + 
 + 
 +@fldX 
 +La référence au champ date. 
 + 
 +jours 
 +Le nombre de jours que l'on souhaite ajouter à la date 
 +====  Concaténation de Date ==== 
 +**@concatdate** permet de concaténer les valeurs de chacun des paramètres qui lui sont fournis et en plus leur applique la macro @Smartdate. 
 +<code>@concatdate(valeur1,valeur2,...,valeurN)</code> 
 + 
 +ou 
 +<code>@concat('@sep:separateur',valeur1,valeur2,...,valeurN)</code> 
 + 
 +Pour plus de détails se référer à la macro [[#Concaténation d'éléments|@concat]] 
 + 
 +====  Concaténation d'éléments et conversion en Date ==== 
 + 
 + 
 +**@concatdate** permet de concaténer les valeurs de chacun des paramètres qui lui sont fournis et en plus leur applique la macro **@Smartdate**. 
 +<code>@concatdate(valeur1,valeur2,...,valeurN)</code> 
 + 
 +ou 
 +<code>@concat('@sep:separateur',valeur1,valeur2,...,valeurN)</code> 
 + 
 +Pour plus de détails se référer à la macro [[#Concaténation d'éléments|@concat]] 
 +==== Condition OU entre plusieurs champs ====
  
 **@or** renvoi 1 (sous forme de chaîne de caractère) si les champs champ1 OU champ2 ont été retrouvés sur le document. **@or** renvoi 1 (sous forme de chaîne de caractère) si les champs champ1 OU champ2 ont été retrouvés sur le document.
Ligne 21: Ligne 90:
 Où champ1 et champ2 sont des références de champs (@FLDX) Où champ1 et champ2 sont des références de champs (@FLDX)
  
-===   Condition évaluée  ===+====Condition évaluée  ====
 <code>@condition(<expression>)</code> <code>@condition(<expression>)</code>
  
 Où //expression// doit être une expression python valide.  Où //expression// doit être une expression python valide. 
-Elle peut contenir des références à des champs d'analyse COLD ([[cold:reference:coldfldextra:fld|@FLDX]]).+Elle peut contenir des références à des champs d'analyse COLD (**@FLD**//xxx//).
 **@condition** évalue l'expression python fournie en paramètre. Elle retourne 1 si l'expression est évaluée à vraie, et 0 si l'expression **@condition** évalue l'expression python fournie en paramètre. Elle retourne 1 si l'expression est évaluée à vraie, et 0 si l'expression
 est évaluée à faux. est évaluée à faux.
  
-{{wiki:icons:info.png}} Avant évaluation les références @FLDX sont remplacées par leurs valeurs et sont encadrées+{{wiki:icons:info.png}} Avant évaluation les références **@FLD**//xxx// sont remplacées par leurs valeurs et sont encadrées
 par des simples quotes (sauf pour les valeurs 0, 1, True, False). par des simples quotes (sauf pour les valeurs 0, 1, True, False).
 Attention donc car un nombre devient une chaîne de caractère ! Il peut être alors nécessaire d'utiliser des fonctions Attention donc car un nombre devient une chaîne de caractère ! Il peut être alors nécessaire d'utiliser des fonctions
 de conversion ([[https://docs.python.org/2/library/stdtypes.html#numeric-types-int-float-long-complex|long(), int(), float()]]) de conversion ([[https://docs.python.org/2/library/stdtypes.html#numeric-types-int-float-long-complex|long(), int(), float()]])
    
-===  Conversion du jour numérique en texte  ===+====Conversion du jour numérique en texte  ====
  
 **@int2day** est une macro qui traduit un jour exprimé sous forme numérique dans sa représentation littérale. **@int2day** est une macro qui traduit un jour exprimé sous forme numérique dans sa représentation littérale.
Ligne 58: Ligne 127:
 En utilisant une [[cold:reference:groupname|variable de capture]] //<jour>// qui vaut 1 En utilisant une [[cold:reference:groupname|variable de capture]] //<jour>// qui vaut 1
   @int2day(@<jour>) => lundi   @int2day(@<jour>) => lundi
-===   Conversion du mois texte   en  mois numérique===+==== Conversion du mois texte   en  mois numérique==
 <code>@monthint(mois)</code> <code>@monthint(mois)</code>
  
Ligne 82: Ligne 151:
  
  
-===  Conversion du mois numérique en texte   ===+====  Conversion du mois numérique en texte   ====
  
 **@int2month** est une macro qui traduit un mois exprimé sous forme numérique dans sa représentation littérale. **@int2month** est une macro qui traduit un mois exprimé sous forme numérique dans sa représentation littérale.
 +
 +====  Valeurs alternatives ====
 +
 +
 +
 +**
 +@alternative** renvoi la première valeur non vide parmi une liste de valeurs possibles.
 +<code>
 +@alternative(@FLD4,@FLD3,'Non renseignée')
 +</code>
 + La macro **@alternative** prend au minimum 2 paramètres.
 +
 +Chaque paramètre alternatif peut être :
 +
 +      * Une chaîne de caractère (encadrée ou non par des simples quotes ou des doubles quotes)
 +     *  Une référence à un champ (**@FLD**//xxx//).
 +
 +=== Exemple ===
 +
 +^ ID ^ Description du champ ^ Valeur retrouvée ^
 +|3| Adresse de facturation | 2 Rue Pégoud, 90130 PETIT-CROIX |
 +|4| Recherche Adresse de livraison| 1 Rue du Général de Gaulle, 90130 Montreux-Château |
 +
 +Nous avons deux champs. L'un nous retrouve l'adresse de facturation. Le second l'adresse de livraison.
 +Nous voudrions, si l'adresse de livraison n'est pas spécifiée, choisir l'adresse de facturation.
 +
 +Créons un champ supplémentaire de type spécifique et utilisons la macro @alternative
 +  @alternative(@FLD4,@FLD3)
 +  
 +Le premier choix se porte sur le champ 4 (Recherche Adresse de livraison). S'il n'est pas trouvé on prendra la valeur
 +du champ 3 (Adresse de facturation).
 +
 +Et si aucun n'est trouvé et que l'on souhaite indexer une valeur par défaut :
 +  @alternative(@FLD4,@FLD3,'Non renseignée')
 + 
 +==== Convertir en entier (cast) ====
 +
 +Double cliquez sur la fonction voulue donc "**Convertir en entier**", cela fait apparaitre la fonction dans la zone texte au dessus.
 +
 +La fonction **long()** prend en paramètre une variable qu'elle transforme en entier.
 +
 +Dans la liste de champs en-dessous, il suffit donc de choisir le champs qui contient la valeur que vous souhaitez convertir. Faites un double clic.
 +
 +Vous verrez alors apparaitre la pseudo-variable, correspondant au champs, dans la zone texte, en argument de la fonction.
 +A moins d'une erreur, il n'y a plus qu'à cliquer sur Valider pour que votre choix soit prêt à être appliqué. Il est indiqué dans le formulaire, section "**Options de capture**"
 +
 +==== Couper sur séparateur (split) ====
 +
 +La fonction split génère un tableau contenant toutes les parties.
 +
 +Exemple : \\
 +"559_1003".split("_") donne
 +
 +["559", "1003"]
 +
 +Les index sont : 0,1
 +
 +Ou la première case donc index 0 : "559_1003".split("_")[0] contient "559"\\
 +Et la deuxième case donc index 1 : "559_1003".split("_")[1] contient "1003"
 +
 +Vous pouvez aussi parcourir les cases depuis la fin donc en partant de -1 pour la première case :
 +
 +"559_1003".split("_")[-1] donne "1003"
 +
 +====  Extraction d'une partie de la chaine ====
 + 
 +Cette macro permet de ne prendre qu'une partie d'une valeur.
 +
 +
 +
 +Il faut savoir qu'une chaine de texte en python est en réalité un tableau de caractères affichés les uns à la suite des autres.
 +
 +C'est à dire : "glou glou"\\
 +est en fait un tableau qui contient : ["g","l","o","u","g","l","o","u"]
 +
 +Donc utiliser la macro ainsi :
 +
 +@champ[0] affichera "g" uniquement
 +
 +Ou encore :
 +
 +@champ[1:3] affichera "lou"
 +
 +====  Rechercher la position d'une chaine xxx depuis le debut ====
 + 
 +@champ.find('z')
 +
 +La macro parcoure la chaine en affectant un numéro à chaque caractère (espaces compris), depuis 0.
 +Dès qu'elle trouve une première fois la valeur xxx, elle arrête la détection et renvoie la position du premier caractère.
 +
 +Si vous souhaitez obtenir la position du dernier caractère, vous pouvez utiliser la macro inverse rfind.
 +
 +Exemple : 
 +
 +si le champ contient "le cheval s'appelle Miguel"
 +et que vous cherchez le premier a, utilisez @champ.find('a')
 +Vous obtiendrez 7
 +
 +La macro compte les espaces comme des caractères.
  
  
  
doc/v3/acquisition/apprentissage/fonctionsevaluation.1514373120.txt.gz · Dernière modification : (modification externe)

Outils de la page

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki