Expressions calculées (Concepteur de requêtes)

De Wiki1000

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 :

  • Date et heure,
  • Mathématiques,
  • Statistique,
  • Logique,
  • Information,
  • Autres.

Fonctions disponibles :


  • 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.

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.

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.

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.

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.

Valeur retournée La chaine convertit.
ValeurAlpha Chaîne à convertir.

Exemple

PRETTY(Caption)


  • TIME : affiche l’heure.

TIME

Cette fonction retourne l'heure courante.

Valeur retournée L'heure.

Exemple

TIME


  • DATE : affiche la date.

DATE

Cette fonction retourne la date du jour.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Valeur retournée Nom de la base de données source.

Exemple

SOURCEDATABASENAME


  • GETTABLENAME : affiche le nom de la table SQL d'une classe.

GETTABLENAME(ClassName)

Cette fonction retourne le nom de la table SQL contenant les éléments de la classe ClassName.

Valeur retournée Retourne le nom de la table SQL.
ClassName Nom de la classe.

Exemple

GETTABLENAME('TClient')


  • EXISTCLASSNAME : Vérifie l'existence d'une classe dans une base de données spécifiée.

EXISTCLASSNAME(ClassName,DatabaseName)

Cette fonction retourne vrai si la classe ClassName existe dans la base de données DatabaseName.

Valeur retournée Retourne TRUE ou FALSE.
ClassName Nom de la classe.
DatabaseName Nom de la base de données.

Exemple

EXISTCLASSNAME('TClient',SOURCEDATABASENAME)


  • EXISTTABLENAME : Vérifie l'existence d'une table SQL dans une base de données spécifiée.

EXISTTABLENAME(TableName,DatabaseName)

Cette fonction retourne vrai si la table SQL TableName existe dans la base de données DatabaseName.

Valeur retournée Retourne TRUE ou FALSE.
TableName Nom de la table SQL.
DatabaseName Nom de la base de données.

Exemple

EXISTTABLENAME('dbo.TCLIENT',SOURCEDATABASENAME)


  • DATAMIN : Affiche la valeur minimale d'un attribut dans une classe spécifiée.

DATAMIN(ClassName,AttributName)

Cette fonction retourne la valeur minimale de l'attribut AttributName pour la classe ClassName.

Valeur retournée Retourne la valeur minimale.
ClassName Nom de la la classe.
AttributName Nom de l'attribut.

Exemple

DATAMIN('TEcriture','eDate')


  • DATAMAX : Affiche la valeur maximale d'un attribut dans une classe spécifiée.

DATAMAX(ClassName,AttributName)

Cette fonction retourne la valeur maximale de l'attribut AttributName pour la classe ClassName.

Valeur retournée Retourne la valeur maximale.
ClassName Nom de la la classe.
AttributName Nom de l'attribut.

Exemple

DATAMAX('TEcriture','eDate')


  • GETCONTEXTPARAMETER : Affiche la valeur d'un paramètre du contexte.

GETCONTEXTPARAMETER(ParamName)

Cette fonction retourne la valeur du paramètre ParamName du contexte.

Valeur retournée Retourne la valeur.
ParamName Nom du paramètre.

Exemple

GETCONTEXTPARAMETER('GlbSocietyName')


  • GETFOLDERNAME : Affiche le nom du dossier.

GETFOLDERNAME

Cette fonction retourne le nom du dossier.

Valeur retournée Retourne le nom du dossier.

Exemple

GETFOLDERNAME


  • GETSOCIETY : Affiche le nom de la société postfixé du nom du périmètre société.

GETSOCIETY

Cette fonction retourne le nom de la société postfixé du nom du périmètre société.

Valeur retournée Retourne le nom de la société.

Exemple

GETSOCIETY


  • SHARESOCIETY : Affiche le nom du périmètre de la société de travail.

SHARESOCIETY

Cette fonction retourne le nom du périmètre de la société de travail.

Valeur retournée Retourne le nom du périmètre.

Exemple

SHARESOCIETY


  • SHAREOIDSOCIETY : Affiche l'oid du périmètre de la société de travail.

SHAREOIDSOCIETY

Cette fonction retourne l'oid du périmètre de la société de travail.

Valeur retournée Retourne l'oid du périmètre.

Exemple

SHAREOIDSOCIETY


  • SHAREOIDGROUP : Affiche l'oid du groupe de partage.

SHAREOIDGROUP

Cette fonction retourne l'oid du groupe de partage.

Valeur retournée Retourne l'oid du groupe de partage.

Exemple

SHAREOIDGROUP


  • DBTRANSFORMATION : Affiche la valeur trouvé dans une table ou défaut.

DBTRANSFORMATION(ValeurRecherche , TableName , ColonneRetournee, ColonneRecherche, DefautRetourne)

Cette fonction retourne la valeur contenue dans la colonne ColonneRetournee de la table TableName dont la colonne ColonneRecherche est égale à ValeurRecherche. Si aucune ligne ne corespond à la recherche, alors la fonction retourne DefaultRetourne.

Valeur retournée Retourne Valeur contenue dans la colonne ColonneRetournee.
ValeurRecherche Valeur qui doit être contenu dans ColonneRecherche.
TableName Nom de la table dans laquelle doit être faite la recherche.
ColonneRetournee Nom de la colonne qui contient la valeur à retourner.
ColonneRecherche Nom de la colonne qui contient la valeur de recherche.
DefaultRetourne Valeur à retourner si il n'y a pas de donnée.

Exemple

DBTRANSFORMATION(codeCompte,'TCOMPTEGENERAL','Caption','codeCompte','1200000')


  • TRANSFORMATION : Affiche la valeur lorsque un paramètre est égale à une valeur spécifiée.

TRANSFORMATION(Valeur , ValeurRetournee1, ValeurRecherchee1, ValeurRetournee2, ValeurRecherchee,..., ValeurRetourneeN, ValeurRechercheeN)

Cette fonction retourne ValeurRetourneeX si Valeur est égale ValeurRechercheX.

Valeur retournée Retourne ValeurRetournee1 ou ValeurRetournee2 ou ... ValeurRetourneeN.
Valeur Valeur à rechercher.
ValeurRetournee1 Si Valeur = ValeurRecherchee1 alors la fonction retourne ValeurRetournee1.
ValeurRecherchee1 Si Valeur = ValeurRecherchee1 alors la fonction retourne ValeurRetournee1.
ValeurRetournee2 Si Valeur = ValeurRecherchee2 alors la fonction retourne ValeurRetournee2.
ValeurRecherchee2 Si Valeur = ValeurRecherchee2 alors la fonction retourne ValeurRetournee2.
...
ValeurRetourneeN Si Valeur = ValeurRechercheeN alors la fonction retourne ValeurRetourneeN.
ValeurRechercheeN Si Valeur = ValeurRechercheeN alors la fonction retourne ValeurRetourneeN.

Exemple

TRANSFORMATION(codeJournal,'Ecriture d'achat','ACHAT','Ecriture de vente','VENTE','Ecriture de banque','BANQUE')


  • _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 :

  • 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.
Récupérée de « https://frp.sage.fr/wiki1000/index.php?title=Expressions_calcul%C3%A9es_(Concepteur_de_requ%C3%AAtes)&oldid=4574 »
Outils personnels