Expressions calculées (Concepteur de requêtes)

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 :

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

• STR : converti un nombre en caractères alphanumériques.

• UPPER : converti une chaîne de caractères en majuscule.

• LOWER : converti une chaîne de caractères en minuscule.

• PRETTY: converti le premier caractère en majuscule et les caractères restant en minuscules.

• TIME : affiche l’heure.

• DATE : affiche la 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.

• SUM : effectue une somme. Cette fonction est utilisée pour le format.

• COUNT : incrémente l’item à chaque sélection. Cette fonction est utilisée pour le format.

• MAX : affiche la valeur maximale. Cette fonction est utilisée pour le format.

• MIN : affiche la valeur minimale. Cette fonction est utilisée pour le format.

• AVERAGE : effectue la moyenne. Cette fonction est utilisée pour le format.

• TRUE : affiche la valeur logique ‘vraie’.

• FALSE : affiche la valeur logique ‘fausse’.

• INT : affiche la partie entière du nombre.

• FRAC : affiche la valeur décimale du nombre.

• SQRT : affiche le carré du nombre.

• DIV : affiche le résultat du quotient de 2 nombres.

• TYPEOF : affiche le type de donnée d'une expression ou d'une colonne.

• FORMATNUMERIC : permet de réaliser un formatage d'une valeur numérique.

• CONCAT : Concatène des chaines de caractères.

• DEFDATABASEURL : affiche l'url de la base de données par défaut.

• DEFDATABASEURL_PROVIDER : affiche le nom du fournisseur de la base de données par défaut.

• DEFDATABASEURL_SERVER : affiche le nom du serveur de la base de données par défaut.

• DEFDATABASEURL_DATABASE : affiche le nom de la base de données par défaut.

• DEFDATABASEURL_TABLEPREFIX : affiche le préfixe des tables de la base de données par défaut.

• DEFDATABASENAME : affiche le nom du référentiel de la base de données par défaut.

• SOURCEDATABASEURL : affiche l'url de la base de données source.

• SOURCEDATABASENAME : affiche le nom de la base de données source.

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

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