Fonctions Visual Basic

Un large éventail de fonctions Visual Basic (VB) peut être utilisé avec SunSystems Reporting Services. Voici quelques uns des nombreux types de fonctions disponibles :

Général
Date
Décision

Fonctions générales

Les fonctions et opérateurs généraux suivants sont souvent utilisés :

Fonction VB Générale	Libellé
ABS(Expression)	Retourne la valeur absolue d'une expression.
MOD	Vous pouvez utiliser l'expression RowNumber(Nothing) MOD 2 pour déterminer les lignes paires et impaires d'un ensemble de données.
MID, LEFT, RIGHT, LEN et TRIM	Fonctions de chaîne permettant de manipuler des données textuelles.
LCASE, UCASE	Convertit les valeurs de chaîne en minuscules ou en majuscules.
FORMAT(Expression, "Standard")	Convertit une chaîne numérique au format numérique standard.
CSTR, CDATE, CDBL	Convertit les expressions en chaîne, en date ou en valeur numérique double. Remarque: Il peut s'avérer nécessaire de convertir une instruction IF complexe censée retourner une valeur numérique, en l'intégrant dans une fonction CDBL.
ME.Value	Cette expression retourne la valeur actuelle de la zone de texte et s'avère utile dans une expression d'affichage ou de formatage conditionnel lorsque la condition dépend de la valeur de la zone de texte.

Fonctions de date

Les fonctions de date suivantes sont souvent utilisées :

Fonctions de date	Libellé
DAY(Date)	Retourne un entier compris entre 1 et 31 correspondant au jour du mois.
MONTH(Date)	Retourne un entier compris entre 1 et 12 correspondant au mois.
MONTHNAME(Date)	Retourne le libellé du mois, par exemple Septembre.
WEEKDAY(Date)	Retourne un entier compris entre 1 (correspondant au dimanche) et 7 (correspondant au samedi).
WEEKDAYNAME(Date)	Retourne le libellé du jour, par exemple Mardi.
YEAR(Date)	Retourne un entier compris entre 1 et 9999 correspondant à l'année, à partir de la date spécifiée.
DATEPART("interval", Date)	Retourne un entier contenant le composant spécifié d'une valeur de date donnée dont l'intervalle est : d : Jour (du mois) y : Jour (de l'année) h : Heure n : Minute m : Mois q : Trimestre s : Deuxième w : Jour de la semaine ww : Semaine calendaire (semaine de l'année, 1 à 53) yyyy : Exercice
DATEADD("interval", number, Date)	Retourne une valeur de date contenant la date et l'heure auxquelles un intervalle de temps spécifié a été ajouté, notamment : d : Jour (tronqué vers la valeur intégrale) y : Jour (de l'année) tronqué vers la valeur intégrale h : Heure (arrondie à la milliseconde près) n : Minute (arrondie à la milliseconde près) m : Mois (tronqué vers la valeur intégrale) q : Trimestre (tronqué vers la valeur intégrale) s : Seconde (arrondie à la milliseconde près) w : Jour (de la semaine) tronqué vers la valeur intégrale ww : Semaine (de l'année) tronquée vers la valeur intégrale yyyy : Année (tronquée vers la valeur intégrale)
DATEDIFF("interval", Date1, Date2)	Retourne une valeur longue spécifiant la différence entre les dates 1 et 2 en unités d'intervalle de temps, à savoir : d : Jour y : Jour de l'année (considéré comme un jour d) h : Heure n : Minute m : Mois q : Trimestre s : Deuxième w : Semaine ww : Semaine calendaire de l'année (utilise le premier jour de la semaine)
DATESERIAL(Année, Mois, Jour)	Où Année est requise. Expression d'entier de 1 à 9999. Néanmoins, les valeurs inférieures à cette fourchette sont également acceptées. Si la valeur de l'année est comprise entre 0 et 99, celle-ci est interprétée comme étant située entre 1930 et 2029. Si la valeur de l'année est inférieure à 1, elle est soustraite de l'année actuelle. Mois est requis. Expression d'entier de 1 à 12. Néanmoins, les valeurs non comprises dans cette fourchette sont également acceptées. La valeur du mois est réduite de 1 puis appliquée au mois de janvier de l'année calculée. En d'autres termes, la valeur (mois - 1) est ajoutée à janvier. L'année est recalculée si nécessaire. Les résultats sont les suivants : Si le mois a pour valeur 1, le résultat est Janvier de l'année calculée. Si le mois a pour valeur 0, le résultat est Décembre de l'année précédente. Si le mois a pour valeur -1, le résultat est Novembre de l'année précédente. Si le mois a pour valeur 13, le résultat est Janvier de l'année suivante. Jour est requis. Expression d'entier de 1 à 31. Néanmoins, les valeurs non comprises dans cette fourchette sont également acceptées. La valeur du jour est réduite de 1 puis appliquée au premier jour du mois calculé. En d'autres termes, la valeur (jour - 1) est ajoutée au premier jour du mois. Le mois et l'année sont recalculés si nécessaire. Les résultats sont les suivants : Si le jour a pour valeur 1, le résultat est le premier jour du mois calculé. Si le jour a pour valeur 0, le résultat est le dernier jour du mois précédent. Si le jour a pour valeur -1, le résultat est l'avant-dernier jour du mois précédent. Si le jour est postérieur à la fin du mois en cours, le résultat est le jour correspondant du mois suivant. Par exemple, si le mois a pour valeur 4 et le jour 31, le résultat est le 1er mai.

L'expression suivante retourne également une valeur sur trois en fonction de la valeur de l'indicateur (Marker), mais elle utilise quant à elle la fonction Switch, qui retourne la valeur associée à la première expression évaluée TRUE :

=Switch(Fields!Marker.Value >= 7, "Green", Fields!Marker.Value >= 5, "Amber", Fields!Marker.Value < 5, "Red")

Utilisation d'expressions avec des compteurs

La fonctionnalité Compteurs état vous permet d'utiliser une expression pour spécifier un numéro de départ au début de l'exécution de l'état et d'incrémenter ce numéro à chaque document traité. Indiquez si le numéro de départ doit être saisi au moment de l'exécution comme paramètre ou extrait d'une valeur de champ de données.

Vous pouvez incrémenter un compteur en fonction du changement de la valeur d'un champ et stipuler qu'il s'applique uniquement lorsque des filtres spécifiques sont utilisés à l'exécution.

Après avoir créé un compteur, vous pouvez l'ajouter à l'état. Sélectionnez Affichage > Champs spéciaux pour afficher les compteurs disponibles dans le volet Champs spéciaux et glissez-déplacez le compteur requis sur l'état.