« Expressions calculées (Concepteur de requêtes) » : différence entre les versions

De Wiki1000
Aucun résumé des modifications
Aucun résumé des modifications
 
(19 versions intermédiaires par le même utilisateur non affiché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.
GETTABLENAME(ClassName)
Cette fonction retourne le nom de la table SQL contenant les éléments de la classe ClassName.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur.
|-
|ParamName
|Nom du paramètre.
|}
Exemple
GETCONTEXTPARAMETER('XXX')
* GETFOLDERNAME : Affiche le nom du dossier.
GETFOLDERNAME
Cette fonction retourne le nom du dossier.
{|class="wikitable"
|-
|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é.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|Valeur retournée
|Retourne l'oid du groupe de partage.
|}
Exemple
SHAREOIDSOCIETY
* 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 :

Dernière version du 22 février 2010 à 15:14

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

{{#images:requeteurchampscalcules.png|requeteur}}

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.

{{#images:requeteurchampscalculesdonnees.png|requeteur}}

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.

{{#images:requeteurchampscalculesfonctions.png|requeteur}}

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.
Récupérée de « http://wiki.sage.fr/index.php?title=Expressions_calculées_(Concepteur_de_requêtes)&oldid=4739 »