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

De Wiki1000
Aucun résumé des modifications
Aucun résumé des modifications
 
(15 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('GlbSocietyName')
* 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
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.
{|class="wikitable"
|-
|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.
{|class="wikitable"
|-
|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.
_TP(Value)
Cette fonction traduit la chaine de caractère Value dans la langue courante.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur traduite.
|-
|Value
|Message à traduire.
|}
Exemple
_TP('Numéro du compte')
* TRANSLATESRCMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire sources.
TRANSLATESRCMSG(Value)
Cette fonction traduit la chaine de caractère Value dans la langue courante en utilisant le dictionnaire sources.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur traduite.
|-
|Value
|Message à traduire.
|}
Exemple
TRANSLATESRCMSG('Numéro du compte')
* TRANSLATEGUIMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire interfaces.
TRANSLATEGUIMSG(Value)
Cette fonction traduit la chaine de caractère Value dans la langue courante en utilisant le dictionnaire interfaces.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur traduite.
|-
|Value
|Message à traduire.
|}
Exemple
TRANSLATEGUIMSG('Numéro du compte')
* TRANSLATEMENUMSG : Affiche la traduction d'une chaine de caractère en utilisant le dictionnaire menus.
TRANSLATEMENMSG(Value)
Cette fonction traduit la chaine de caractère Value dans la langue courante en utilisant le dictionnaire menus.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur traduite.
|-
|Value
|Message à traduire.
|}
Exemple
TRANSLATEMENMSG('Numéro du compte')
* TRIM : supprime les caractères blancs.
TRIM(Value)
Cette fonction supprime les blancs contenu dans la chaine de caractère Value.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur sans les blancs.
|-
|Value
|Chaine de caractères à traiter.
|}
Exemple
TRIM('Caption')
* TRIMLEFT : supprime les caractères blancs en début de chaîne.
TRIMLEFT(Value)
Cette fonction supprime les blancs au début de la chaine de caractère Value.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur sans les blancs.
|-
|Value
|Chaine de caractères à traiter.
|}
Exemple
TRIMLEFT('Caption')
* TRIMRIGHT : supprime les caractères blancs de fin de chaîne.
TRIMRIGHT(Value)
Cette fonction supprime les blancs à la fin de la chaine de caractère Value.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur sans les blancs.
|-
|Value
|Chaine de caractères à traiter.
|}
Exemple
TRIMRIGHT('Caption')
* FILLTOLEFT : permet de compléter à gauche par un caractère particulier sur une longueur choisie.
FILLTOLEFT(Value, NombreCaracteres, Char)
Cette fonction rajoute à gauche de la chaine de caractère Value le caractère Char sur une longueur de NombreCaracteres.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur complétée.
|-
|Value
|Chaine de caractères à compléter.
|-
|NombreCaracteres
|Nombre de caractères à ajouter.
|-
|Char
|Caractère à ajouter.
|}
Exemple
FILLTOLEFT(Montant,15,'*')
* FILLTORIGHT : permet de compléter à droite par un caractère particulier sur une longueur choisie.
FILLTORIGHT(Value, NombreCaracteres, Char)
Cette fonction rajoute à droite de la chaine de caractère Value le caractère Char sur une longueur de NombreCaracteres.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur complétée.
|-
|Value
|Chaine de caractères à compléter.
|-
|NombreCaracteres
|Nombre de caractères à ajouter.
|-
|Char
|Caractère à ajouter.
|}
Exemple
FILLTORIGHT(CodeJournal,12,' ')
* LENGTH : permet de compter le nombre de caractères constituant une chaîne.
LENGTH(Value)
Cette fonction retourne le nombre de caractères contenue dans la chaine Value.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le nombre de caractères.
|-
|Value
|Chaine de caractères à analyser.
|}
Exemple
LENGTH(Caption)
* POS : permet de donner la position d'un caractère ou de plusieurs dans une chaîne.
POS(Substr, Value)
Cette fonction retourne la position de la sous-chaine Substr dans la chaîne de caractères Value, zéro si la sous-chaine n'est pas trouvée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la position de la sous-chaine, zéro si la sous-chaine n'est pas trouvée.
|-
|Substr
|Sous-chaine à retrouver.
|-
|Value
|Chaine de caractères à analyser.
|}
Exemple
POS('foo',Caption)
* ABS : affiche la valeur absolue.
ABS(Nombre)
Cette fonction retourne la valeur absolue d'un nombre.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur absolue.
|-
|Nombre
|Expression entière ou flottante.
|}
Exemple
ABS(Montant)
* ROUND : arrondi à x décimales.
ROUND(Nombre,Decimales)
Cette fonction arrondie un nombre flottant au nombre de décimales spécifié.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le nombre arrondi.
|-
|Nombre
|Nombre à arrondir.
|-
|Decimales
|Nombre de décimales.
|}
Exemple
ROUND(Montant,2)
* ISNULL : retourne la valeur spécifiée si elle est non nulle sinon une valeur par défaut.
ISNULL(Valeur, DefaultValue)
Cette fonction retourne Valeur si Valeur n'est pas nul, sinon retourne DefaultValue.
{|class="wikitable"
|-
|Valeur retournée
|Retourne Valeur si non nul
Retourne DefaultValue si nul.
|-
|Valeur
|Retournée si non nulle.
|-
|DefaultValue
|Retournée si Valeur est nulle.
|}
Exemple
ISNULL(RoleTiers,'Pas de tiers')
* MONTANTTOLETTRE : transcrit un montant en chiffre vers un montant en lettre, par exemple pour l’édition des chèques.
MONTANTTOLETTRE(Montant, Devise, CentimesDevise)
Cette fonction retourne Montant en lettre.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le montant en lettre.
|-
|Montant
|Montant à transcrire.
|-
|Devise
|Code devise.
|-
|CentimesDevise
|Code centimes.
|}
Exemple
MONTANTTOLETTRE(Montant,'Euros','Centimes')
* 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.
MONTANTTOLETTREEX(Montant, Devise, CentimesDevise, Langue)
Cette fonction retourne Montant en lettre dans la langue spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le montant en lettre.
|-
|Montant
|Montant à transcrire.
|-
|Devise
|Code devise.
|-
|CentimesDevise
|Code centimes.
|-
|Langue
|FR Français
EN Anglais
ES Espagnol
DE Allemand
PT Portugais
TN Tunisie.
|}
Exemple
MONTANTTOLETTREEX(Montant,'Livres','Cents','EN')
* FORMATMONTANT : permet de réaliser le formatage d’une valeur numérique en indiquant le nombre de décimales.
FORMATMONTANT(Montant, Decimales)
Cette fonction retourne le Montant formaté avec le nombre de décimales spécifié.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le montant formaté.
|-
|Montant
|Montant à transcrire.
|-
|Decimales
|Nombre de décimales.
|}
Exemple
FORMATMONTANT(Montant,2)
* POWER : permet d'effectuer des calculs d'élévation à une puissance (par exemple : 10 Puissance 10).
POWER(Montant, Puissance)
Cette fonction retourne élève le Montant à la puissance spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur calculée.
|-
|Montant
|Montant à transcrire.
|-
|Puissance
|Puissance spécifiée.
|}
Exemple
POWER(Montant,2)
* LOG10 : affiche le logarithme base 10 d'une valeur spécifiée.
LOG10(Valeur)
Cette fonction retourne le logarithme base 10 de la valeur spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur calculée.
|-
|Valeur
|Valeur à transcrire.
|}
Exemple
LOG10(Montant)
* LOG : affiche le logarithme naturel d'une valeur spécifiée.
LOG(Valeur)
Cette fonction retourne le logarithme naturel de la valeur spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur calculée.
|-
|Valeur
|Valeur à transcrire.
|}
Exemple
LOG(Montant)
* EXP : affiche l'exponentielle d'une valeur spécifiée.
EXP(Valeur)
Cette fonction retourne l'exponentielle de la valeur spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne la valeur calculée.
|-
|Valeur
|Valeur à transcrire.
|}
Exemple
EXP(Montant)
* 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).
ENCODEDATE(Jour,Mois,Annee)
Cette fonction retourne la date du Jour, du mois et de l'année spécifiée.
{|class="wikitable"
|-
|Valeur retournée
|Retourne une date.
|-
|Jour
|Jours de la date retournée.
|-
|Mois
|Mois de la date retournée.
|-
|Annee
|Année de la date retournée.
|}
Exemple
ENCODEDATE(31,1,2010)
* YEAR : Affiche l'année d'une date spécifiée.
YEAR(ValeurDate)
Cette fonction retourne l'année de la date ValeurDate.
{|class="wikitable"
|-
|Valeur retournée
|Retourne l'année.
|-
|ValeurDate
|Date depuis laquelle l'année doit être extraite.
|}
Exemple
YEAR(DATE)
* MONTH : Affiche le mois d'une date spécifiée.
MONTH(ValeurDate)
Cette fonction retourne le mois de la date ValeurDate.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le mois.
|-
|ValeurDate
|Date depuis laquelle le mois doit être extraite.
|}
Exemple
MONTH(DATE)
* DAY : Affiche le jour d'une date spécifiée.
DAY(ValeurDate)
Cette fonction retourne le jour de la date ValeurDate.
{|class="wikitable"
|-
|Valeur retournée
|Retourne le jour.
|-
|ValeurDate
|Date depuis laquelle le jour doit être extraite.
|}
Exemple
DAY(DATE)
* ENCODETIME : indique une heure à partir d’une valeur (heure, minute et seconde).
ENCODETIME(Heures,Minutes,Secondes)
Cette fonction retourne l'heure dont les heures, les minutes et les secondes sont spécifiées.
{|class="wikitable"
|-
|Valeur retournée
|Retourne une heure.
|-
|Heures
|Heures de l'heure retournée.
|-
|Minutes
|Minutes de l'heure retournée.
|-
|Secondes
|Secondes de l'heure retournée.
|}
Exemple
ENCODETIME(12,30,0)
* HOUR : affiche l’heure.
HOUR(Valeur)
Cette fonction retourne les heures de l'heure Valeur.
{|class="wikitable"
|-
|Valeur retournée
|Retourne les heures.
|-
|Valeur
|Heure depuis laquelle les heures doivent être extraites.
|}
Exemple
HOUR(TIME)
* MINUTE : affiche la minute.
MINUTE(Valeur)
Cette fonction retourne les minutes de l'heure Valeur.
{|class="wikitable"
|-
|Valeur retournée
|Retourne les minutes.
|-
|Valeur
|Heure depuis laquelle les minutes doivent être extraites.
|}
Exemple
MINUTE(TIME)
* SECOND : affiche la seconde.
SECOND(Valeur)
Cette fonction retourne les secondes de l'heure Valeur.
{|class="wikitable"
|-
|Valeur retournée
|Retourne les secondes.
|-
|Valeur
|Heure depuis laquelle les secondes doivent être extraite.
|}
Exemple
SECOND(TIME)
* 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 »