Expressions calculées (Concepteur de requêtes)

De Wiki1000
(Différences entre les versions)
 
(20 révisions intermédiaires par un utilisateur sont masquées)
Ligne 21 : Ligne 21 :
 
Catégorie des fonctions disponibles :
 
Catégorie des fonctions disponibles :
  
* Date et heure,
+
* [[:category:Requêteur Fonctions Chaines de caractères|Fonctions Chaines de caractères]]
  
* Mathématiques,
+
* [[:category:Requêteur Fonctions Date et heure|Fonctions Date et heure]]
  
* Statistique,
+
* [[:category:Requêteur Fonctions Mathématiques|Fonctions Mathématiques]]
  
* Logique,
+
* [[:category:Requêteur Fonctions d'aggrégation|Fonctions d'aggrégation]]
  
* Information,
+
* [[:category:Requêteur Fonctions de base de données|Fonctions de base de données]]
  
* Autres.
+
* [[:category:Requêteur Fonctions de traduction|Fonctions de traduction]]
  
Fonctions disponibles :
+
* [[:category:Requêteur Fonctions multi-sociétés|Fonctions multi-sociétés]]
  
 +
* [[:category:Requêteur Fonctions diverses|Fonctions diverses]]
  
* IF : permet en fonction d’une condition de présenter telle ou telle information.
 
 
IF(Condition , Valeur1 , Valeur2)
 
 
Si la Condition est vrai, la fonction retourne Valeur1 sinon cette fonction retourne valeur 2.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne Valeur1 si Condition = TRUE
 
Retourne Valeur2 si Condition = FALSE.
 
|-
 
|Condition
 
|Expression retournant une valeur logique.
 
|-
 
|Valeur1
 
|Valeur retournée si la condition est vérifiée.
 
|-
 
|Valeur2
 
|Valeur retournée si la condition n'est pas vérifiée.
 
|}
 
 
Exemple
 
 
SI(Sens='Débit',Montant,0)
 
 
 
* STR : converti un nombre en caractères alphanumériques.
 
 
STR(Nombre)
 
 
Cette fonction convertit un nombre en chaine de caractères.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Chaine de caractères.
 
|-
 
|Nombre
 
|Valeur numérique à convertir.
 
|}
 
 
Exemple
 
 
STR(Montant)
 
 
 
* UPPER : converti une chaîne de caractères en majuscule.
 
 
UPPER(ValeurAlpha)
 
 
Cette fonction convertit une chaîne de caractères en majuscule.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|La chaine convertit en majuscule.
 
|-
 
|ValeurAlpha
 
|Chaîne à convertir.
 
|}
 
 
Exemple
 
 
UPPER(Caption)
 
 
 
* LOWER : converti une chaîne de caractères en minuscule.
 
 
LOWER(ValeurAlpha)
 
 
Cette fonction convertit une chaîne de caractères en minuscule.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|La chaine convertit en minuscule.
 
|-
 
|ValeurAlpha
 
|Chaîne à convertir.
 
|}
 
 
Exemple
 
 
LOWER(Caption)
 
 
 
* PRETTY: converti le premier caractère en majuscule et les caractères restant en minuscules.
 
 
PRETTY(ValeurAlpha)
 
 
Cette fonction convertit le premier caractère d'une chaine en majuscule et les caractères restant en minuscules.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|La chaine convertit.
 
|-
 
|ValeurAlpha
 
|Chaîne à convertir.
 
|}
 
 
Exemple
 
 
PRETTY(Caption)
 
 
 
* TIME : affiche l’heure.
 
 
TIME
 
 
Cette fonction retourne l'heure courante.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|L'heure.
 
|}
 
 
Exemple
 
 
TIME
 
 
 
* DATE : affiche la date.
 
 
DATE
 
 
Cette fonction retourne la date du jour.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|La date du jour.
 
|}
 
 
Exemple
 
 
DATE
 
 
 
* COPY : copie une chaîne de caractères à partir d'une position et pour une longueur définie. Par exemple Copy('1234567890', 5, 5) affiche la valeur 56789. La valeur '1234567890' peut faire référence à une autre colonne de la requête.
 
 
COPY(Valeur , Debut , Longueur)
 
 
Cette fonction extrait une sous-chaîne d'une chaine de caractère.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|sous-chaine.
 
|-
 
|Valeur
 
|Chaîne source.
 
|-
 
|Debut
 
|Position de la sous-chaîne.
 
|-
 
|Longueur
 
|Longueur de la sous-chaîne.
 
|}
 
 
Exemple
 
 
COPY(Caption,3,5)
 
 
 
* SUM : effectue une somme. Cette fonction est utilisée pour le format.
 
 
SUM(ColonneNumerique)
 
 
Cette fonction retourne la somme du champ ColonneNumerique de chacune des lignes d'une source de données.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la somme.
 
|-
 
|ColonneNumerique
 
|Champ de la source de données.
 
|}
 
 
Exemple
 
 
SUM(dsqbuild1.Montant)
 
 
 
* COUNT : incrémente l’item à chaque sélection. Cette fonction est utilisée pour le format.
 
 
COUNT
 
 
Cette fonction retourne le nombre de lignes d'une source de données.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la nombre de lignes.
 
|}
 
 
Exemple
 
 
COUNT
 
 
 
* MAX : affiche la valeur maximale. Cette fonction est utilisée pour le format.
 
 
MAX(ColonneNumerique)
 
 
Cette fonction retourne la valeur maximale du champ ColonneNumerique de chacune des lignes d'une source de données.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la valeur maximale.
 
|-
 
|ColonneNumerique
 
|Champ de la source de données.
 
|}
 
 
Exemple
 
 
MAX(dsqbuild1.Montant)
 
 
 
* MIN : affiche la valeur minimale. Cette fonction est utilisée pour le format.
 
 
MIN(ColonneNumerique)
 
 
Cette fonction retourne la valeur minimale du champ ColonneNumerique de chacune des lignes d'une source de données.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la valeur minimale.
 
|-
 
|ColonneNumerique
 
|Champ de la source de données.
 
|}
 
 
Exemple
 
 
MIN(dsqbuild1.Montant)
 
 
 
* AVERAGE : effectue la moyenne. Cette fonction est utilisée pour le format.
 
 
AVERAGE(ColonneNumerique)
 
 
Cette fonction retourne la valeur moyenne du champ ColonneNumerique de chacune des lignes d'une source de données.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la valeur moyenne.
 
|-
 
|ColonneNumerique
 
|Champ de la source de données.
 
|}
 
 
Exemple
 
 
AVERAGE(dsqbuild1.Montant)
 
 
 
* TRUE : affiche la valeur logique ‘vraie’.
 
 
* FALSE : affiche la valeur logique ‘fausse’.
 
 
* INT : affiche la partie entière du nombre.
 
 
INT(Nombre)
 
 
Cette fonction retourne la partie entière d'un nombre.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la partie entière.
 
|-
 
|Nombre
 
|Valeur numérique à convertir.
 
|}
 
 
Exemple
 
 
INT(Montant)
 
 
 
* FRAC : affiche la valeur décimale du nombre.
 
 
FRAC(Nombre)
 
 
Cette fonction retourne la partie fractionnaire d'un nombre.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne la partie fractionnaire.
 
|-
 
|Nombre
 
|Valeur numérique à convertir.
 
|}
 
 
Exemple
 
 
FRAC(Montant)
 
 
 
* SQRT : affiche le carré du nombre.
 
 
SQRT(Nombre)
 
 
Cette fonction retourne le carré d'un nombre.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne le carré.
 
|-
 
|Nombre
 
|Valeur numérique à convertir.
 
|}
 
 
Exemple
 
 
SQRT(Montant)
 
 
 
* DIV : affiche le résultat du quotient de 2 nombres.
 
 
DIV(Valeur1 , Valeur2)
 
 
Cette fonction retourne le quotient Valeur1 / Valeur2.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne le quotient.
 
|-
 
|Valeur1
 
|Valeur numérique.
 
|-
 
|Valeur2
 
|Valeur numérique.
 
|}
 
 
Exemple
 
 
DIV(Montant,Quantite)
 
 
 
* TYPEOF : affiche le type de donnée d'une expression ou d'une colonne.
 
 
TYPEOF(Valeur)
 
 
Cette fonction retourne le type d'une valeur.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne 'STRING' si Valeur est alphanumérique
 
Retourne 'FLOAT' si Valeur est numérique
 
Retourne 'INTEGER' si Valeur est un entier
 
Retourne 'BOOLEAN' si Valeur est booléen (Vrai ou faux)
 
Retourne 'ERROR' si Valeur contient une erreur.
 
 
|-
 
|Valeur
 
|Valeur à analyser.
 
|}
 
 
Exemple
 
 
TYPEOF(Caption)
 
 
 
* FORMATNUMERIC : permet de réaliser un formatage d'une valeur numérique.
 
 
FORMATNUMERIC(Masque , ValeurNumerique)
 
 
Cette fonction convertit une valeur numérique en utilisant un spécificateur de format.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne Valeur convertie.
 
|-
 
|Format
 
|Format de conversion.
 
|-
 
|ValeurNumerique
 
|Valeur à convertir.
 
|}
 
 
Exemple
 
 
FORMATNUMERIQUE('#.##0.00',Montant)
 
 
 
* CONCAT : Concatène des chaines de caractères.
 
 
CONCAT(Valeur1 , Valeur2 , ... , Valeurn)
 
 
Cette fonctionne concatène plusieurs chaines de caractères.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Retourne une valeur alphanumérique.
 
|-
 
|Valeur1
 
|Première chaine de caractère à concaténer.
 
|-
 
|Valeur2
 
|Première chaine de caractère à concaténer.
 
|-
 
|...
 
|-
 
|Valeurn
 
|Dernière chaine de caractère à concaténer.
 
|}
 
 
Exemple
 
 
CONCAT(Code,' ',Caption)
 
 
 
* DEFDATABASEURL : affiche l'url de la base de données par défaut.
 
 
DEFDATABASEURL
 
 
Cette fonction retourne l'url de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|url de la base de donnée par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASEURL
 
 
 
* DEFDATABASEURL_PROVIDER : affiche le nom du fournisseur de la base de données par défaut.
 
 
DEFDATABASEURL_PROVIDER
 
 
Cette fonction retourne le nom du fournisseur de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Nom du fournisseur de la base de données par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASEURL_PROVIDER
 
 
 
* DEFDATABASEURL_SERVER : affiche le nom du serveur de la base de données par défaut.
 
 
DEFDATABASEURL_SERVER
 
 
Cette fonction retourne le nom du serveur de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Nom du serveur de la base de données par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASEURL_SERVER
 
 
 
* DEFDATABASEURL_DATABASE : affiche le nom de la base de données par défaut.
 
 
DEFDATABASEURL_DATABASE
 
 
Cette fonction retourne le nom de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Nom du la base de données par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASEURL_DATABASE
 
 
 
* DEFDATABASEURL_TABLEPREFIX : affiche le préfixe des tables de la base de données par défaut.
 
 
DEFDATABASEURL_TABLEPREFIX
 
 
Cette fonction retourne le préfixe des tables de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Préfixe des tables de la base de données par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASEURL_TABLEPREFIX
 
 
 
* DEFDATABASENAME : affiche le nom du référentiel de la base de données par défaut.
 
 
DEFDATABASENAME
 
 
Cette fonction retourne le nom du référentiel de la base de données par défaut.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Nom du référentiel de la base de données par défaut.
 
|}
 
 
Exemple
 
 
DEFDATABASENAME
 
 
 
* SOURCEDATABASEURL : affiche l'url de la base de données source.
 
 
SOURCEDATABASEURL
 
 
Cette fonction retourne l'url de la base de données source.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Url de la base de données source.
 
|}
 
 
Exemple
 
 
SOURCEDATABASEURL
 
 
 
* SOURCEDATABASENAME : affiche le nom de la base de données source.
 
 
SOURCEDATABASENAME
 
 
Cette fonction retourne le nom de la base de données source.
 
 
{|class="wikitable"
 
|-
 
|Valeur retournée
 
|Nom de la base de données source.
 
|}
 
 
Exemple
 
 
SOURCEDATABASENAME
 
 
 
* GETTABLENAME : affiche le nom de la table SQL d'une classe.
 
 
* EXISTCLASSNAME : Vérifie l'existence d'une classe dans une base de données spécifiée.
 
 
* EXISTTABLENAME : Vérifie l'existence d'une table SQL dans une base de données spécifiée.
 
 
* DATAMIN : Affiche la valeur minimale d'un attribut dans une classe spécifiée.
 
 
* DATAMAX : Affiche la valeur maximale d'un attribut dans une classe spécifiée.
 
 
* GETCONTEXTPARAMETER : Affiche la valeur d'un paramètre du contexte.
 
 
* GETFOLDERNAME : Affiche le nom du dossier.
 
 
* GETSOCIETY : Affiche le nom de la société postfixé du nom du périmètre société.
 
 
* SHARESOCIETY : Affiche le nom du périmètre de la société de travail.
 
 
* SHAREOIDSOCIETY : Affiche l'oid du périmètre de la société de travail.
 
 
* SHAREOIDGROUP : Affiche l'oid du périmètre dossier.
 
 
* DBTRANSFORMATION : Affiche la valeur trouvé dans une table ou défaut.
 
 
* TRANSFORMATION : Affiche la valeur lorsque un paramètre est égale à une valeur spécifiée.
 
 
* _TP : Affiche la traduction d'une chaine de caractères.
 
 
* TRANSLATESRCMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire sources.
 
 
* TRANSLATEGUIMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire interfaces.
 
 
* TRANSLATEMENUMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire menus.
 
 
* TRIM : supprime les caractères blancs.
 
 
* TRIMLEFT : supprime les caractères blancs en début de chaîne.
 
 
* TRIMRIGHT : supprime les caractères blancs de fin de chaîne.
 
 
* FILLTOLEFT : permet de compléter à gauche par un caractère particulier sur une longueur choisie.
 
 
* FILLTORIGHT : permet de compléter à droite par un caractère particulier sur une longueur choisie.
 
 
* LENGTH : permet de compter le nombre de caractères constituant une chaîne.
 
 
* POS : permet de donner la position d'un caractère ou de plusieurs dans une chaîne.
 
 
* ABS : affiche la valeur absolue.
 
 
* ROUND : arrondi à x décimales.
 
 
* MONTANTTOLETTRE : transcrit un montant en chiffre vers un montant en lettre, par exemple pour l’édition des chèques.
 
 
* MONTANTTOLETTREEX : transcrit un montant en chiffre vers un montant en lettre dans une langue spécifiée, par exemple pour l’édition des chèques.
 
 
* FORMATMONTANT : permet de réaliser le formatage d’une valeur numérique en indiquant le nombre de décimales.
 
 
* POWER : permet d'effectuer des calculs d'élévation à une puissance (par exemple : 10 Puissance 10).
 
 
* LOG10 : affiche le logarithme base 10 d'une valeur spécifiée.
 
 
* LOG : affiche le logarithme naturel d'une valeur spécifiée.
 
 
* EXP : affiche l'exponentielle d'une valeur spécifiée.
 
 
* ENCODEDATE : indique une date à partir d’une valeur (jour, mois et année), par exemple pour l’impression des lettres de relance au 15 du mois, la fonction sera : ENCODEDATE(15, MONTH, YEAR) (YEAR indique l’année en cours, MONTH indique le mois en cours, DAY indique le jour).
 
 
* YEAR : Affiche l'année d'une date spécifiée.
 
 
* MONTH : Affiche le mois d'une date spécifiée.
 
 
* DAY : Affiche le jour d'une date spécifiée.
 
 
* ENCODETIME : indique une heure à partir d’une valeur (heure, minute et seconde).
 
 
* HOUR : affiche l’heure.
 
 
* MINUTE : affiche la minute.
 
 
* SECOND : affiche la seconde.
 
 
* DAYOFWEEK : affiche le jour de la semaine.
 
 
* INCDATE : incrémente la date de x jour(s).
 
 
* INCMONTH : incrémente la date de x mois.
 
 
* INCYEAR : incrémente la date de x année(s).
 
 
* DATEVAL : affiche la valeur de la date.
 
 
* DELTADATE : calcule la différence entre 2 dates.
 
 
* FORMATDATE : applique le format sélectionné à la date.
 
 
* FINDVALUE : affiche la valeur d'un champs lorsqu'une condition est respectée.
 
 
* SUMARBRE : affiche la somme d'une donnée pour un code hirarchique spécifié.
 
 
* GETCLASSTABLENAME : affiche le nom de la table SQL pour classe spécifiée.
 
 
* DISPLAYLABEL : affiche le libellé d'une colonne spécifiée.
 
 
* DATAFIELD : permet de rechercher un paramètre appartenant à une autre classe en fonction de la valeur d'un attribut dans la classe.
 
 
* DATAIN : permet de rechercher un élément dans une autre classe, pour lequel un attribut appartient à un ensemble de valeurs.
 
 
* DATABETWEEN : permet de rechercher un élément dans une autre classe, et pour lequel un paramètre est compris entre tel et tel attributs de la classe.
 
 
* EXISTASSOCIATION : indique s’il existe une association entre une classe A et les classes B et C dont les rôles sont D et E et dont les champs F et G sont égaux à H et I.
 
 
* SUMARBRE : effectue la somme sur un niveau de l’arborescence. Avant d’activer cette fonction, il faut sélectionner GENEREARBRE.
 
 
* CLASSFIELD : permet de rechercher un paramètre ‘objet’ appartenant à une autre classe en fonction de la valeur d'un attribut dans la classe.
 
 
* WRITEFIELD : modifie la valeur d'un champs dans une classe lorque une condition est vérifiée.
 
 
* INVOKEMETHOD
 
 
* SUMQUERY : effectue la somme en prenant en compte un champs d’une autre requête. Cette fonction vous permet d’insérer le cumul d’une sous-requête dans la colonne d’une requête principale.
 
 
* ISEXIST : permet de savoir si une requête ou une sous-requête possède des enregistrements. Formatage : ISEXIST(‘DsQBuildRequete1’).
 
 
* OBJETCLASSLABEL : permet de connaître la classe de l’objet.
 
 
* GETENUMERE : permet d’associer le libellé des énumérés d’une zone renseignée à l’aide d’une boîte à liste déroulante. (Exemple : Pour la zone Type de compte, 0 correspond à l’énuméré Bilan, 1 à Gestion et 2 à Autre).
 
 
* GENEREARBRE : permet de connaître l’arborescence d’un objet de la classe.
 
 
* SYSDATA : permet d’insérer par exemple la date système ou le numéro d’une page dans une condition d’impression.
 
 
* OBJECTINCLASS : permet de rechercher si un objet est dans une classe en s’appuyant sur son IDOTP.
 
 
* OTPCHILDS : recherche la liste des IDOTP correspondant à une classe mère (Un IDOTP est un attribut technique permettant de savoir à quelle classe appartient un objet, dans le cadre des classes dérivées).
 
  
 
Les boutons de la fenêtre Champs calculé permettent d’effectuer les opérations courantes :
 
Les boutons de la fenêtre Champs calculé permettent d’effectuer les opérations courantes :

Version actuelle en date du 22 février 2010 à 17:14

Pour chacune des expressions (champs calculés, condition d'expressions...), un assistant peut être utilisé.

requeteurchampscalcules.png

L’expression du champ calculé se construit à l’aide des données, fonctions, variables, symboles mathématiques ou logiques proposés dans le bas de la fenêtre.

Les éléments sélectionnés sont insérés à l’emplacement du curseur.

Le bouton données ouvre la fenêtre» Champs calculé» présentant les données disponibles. Les données de la requête sont proposées pour être insérées dans l’expression du champ.

requeteurchampscalculesdonnees.png

Les données sont accessibles une fois que les champs sont insérés dans la requête.

Le bouton fonctions ouvre la fenêtre permettant de sélectionner toutes les fonctions disponibles.

requeteurchampscalculesfonctions.png

Pour faciliter le choix de la fonction, sélectionnez tout d’abord sa catégorie.

Catégorie des fonctions disponibles :


Les boutons de la fenêtre Champs calculé permettent d’effectuer les opérations courantes :

  • Le bouton + permet d’additionner des éléments.
  • Le bouton - permet de soustraire des éléments.
  • Le bouton * permet de multiplier des éléments.
  • Le bouton / permet de diviser des éléments.
  • Le bouton = permet de sélectionner des éléments équivalents.
  • Le bouton < permet de sélectionner des éléments inférieurs.
  • Le bouton > permet de sélectionner des éléments supérieurs.
  • Le bouton <> permet de sélectionner des éléments différents.
  • Le bouton <= permet de sélectionner des éléments inférieurs ou égaux.
  • Le bouton >= permet de sélectionner des éléments supérieurs ou égaux.
  • Le bouton Not permet de sélectionner les valeurs différentes de la valeur spécifiée.
  • Le bouton And permet de sélectionner les éléments s’ils correspondent aux conditions établies.
  • Le bouton Or permet de sélectionner les éléments si au moins un des éléments correspond aux conditions établies.




Whos here now:   Members 0   Guests 0   Bots & Crawlers 1
 
Outils personnels