Les bases du développement Notes/Domino

Transcription

1 Les bases du développement Notes/Domino Tsoft et Groupe Eyrolles, 2004, ISBN : X

2 Bouton d action Conversion d entrée Evénements Masquer Valeur Valeur par défaut Validation d entrée Module 5 : Programmer Objectifs avec les formules Ecrire des formules simples Programmer des événements de champs Masquer des champs et paragraphes Utiliser les les Créer des boutons de masques et de vues Outils de mise au point Progression Présentation du langage Le modèle événementiel Eléments de syntaxe Les Formatage automatique Valeur par défaut Conversion d entrée Validation d entrée Atelier 5-1, QCM Valeur Ordre d évaluation des formules Protection des formules Calculer avec des dates Les événements du masque Le titre de fenêtre Atelier 5-2, Atelier 5-3 QCM Masquer un champ Les Actions système Créer un bouton dans un masque Masquer un bouton Atelier 5-4, QCM Actions comme cases à cocher Menus hiérarchisés d actions Propriétés de la barre d actions Formule de sélection d une vue Formule de colonne calculée Formule de masquage de colonne Programmation des couleurs de lignes Créer un bouton d action dans une vue Créer une action partagée Atelier 5-5, QCM Outils de déboguage Récapitulatif syntaxique Atelier 5-6 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-1

3 Présentation du langage Présentation du langage Langage central intégré à Domino/Notes depuis les premières versions Avantages Exécution performante Langage simple et peu structurant Utilisé dans des événements, des boutons, des agents Traitements itératifs For, While, DoWhile depuis la version 6 Limites Pas de bibliothèques de sous-programmes Ne gère pas les événements de curseur Outils de débogage non disponibles Avantages Limites Le langage de formules est disponible depuis les toutes premières versions de Domino/Notes. Il a été conçu dès le départ pour effectuer des traitements très simples. Au fil des versions, les applications Notes sont devenues complexes car plus ambitieuses et le langage de formules a évolué en conséquence. Il n en demeure pas moins qu il a les avantages de ses limites et inversement. Ce module introduit les notions indispensables pour utiliser le langage de formules. La présentation de la syntaxe a été placée en fin de module parce qu une présentation en début est habituellement fastidieuse et puis parce que ce n est pas réellement la syntaxe qui peut poser des difficultés mais l esprit du langage. Le langage de formules s utilise dans les événements attachés à un champ, à un masque, pour effectuer des calculs de colonnes, sélectionner des documents pour une vue. C est parfois le seul langage disponible : le titre d une fenêtre Notes, la valeur par défaut d un champ, le contenu d une colonne calculée s évaluent à l aide d une formule. La programmation de ce type d événement requiert précisément un langage simple et peu structurant. Une bibliothèque importante de fonctions les apporte une solution simple et performante à la plupart des traitements requis. La version 6 a introduit des instructions de traitements itératifs : For, While, DoWhile. Le langage de formules est utilisable également pour écrire des traitements appliqués à un ensemble de documents. Ses limites apparaissent alors : la programmation structurée reste limitée, il ne sait pas gérer des bibliothèques de fonctions et de sousprogrammes et ignore même l existence de la programmation orientée objet. Lorsqu il s agit de gérer des événements de curseur à l écran entrée dans un champ, sortie d un champ, passage au-dessus d un champ, le langage de formules n apporte pas de solutions. 5-2 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

4 Le modèle événementiel Le modèle événementiel Une note de conception est un conteneur d objets Masque contient l objet masque, des objets champs, images, actions Vue contient l objet vue, des objets colonnes et actions Des événements sont associés aux objets Contiennent des instructions en formules, JavaScript, LotusScript Un événement résulte souvent d une action utilisateur Ouverture d un masque pour création de document Enregistrement d un document Copier/coller Autres actions Les notes de conception sont représentées comme des objets dans Designer : un masque, une vue, un agent sont des objets. Chacun a des caractéristiques : Son nom qui permet de l identifier de façon unique dans la base Son type : masque, vue, agent Des propriétés : couleur d arrière-plan, couleur de lignes D autres objets dépendants qui sont contenus dans l objet : un bouton, un champ, une image dans un masque ou encore une colonne dans une vue Des traitements rattachés sous forme d événements : initialisation, déchargement, clic, ouverture Les événements sont des conteneurs de programmes écrits en formules, LotusScript, JavaScript et Java. La plupart des événements supportent un seul type de langage, les autres supportant aussi bien les formules que LotusScript ou Java. Le programme s initialise et se termine à chaque appel de l événement. Les événements sont déclenchés par des actions de l utilisateur ouverture d un masque, clic sur un bouton, enregistrement d un document, fermeture d un document ou du système lancement d un agent Le client Notes et le serveur Domino enchaînent l appel à un ou à des événements et les opérations de lecture et écriture sur disque. Le concepteur a la possibilité de capturer les événements par de la programmation objet avec LotusScript en définissant des méthodes portant le même nom que les événements. Cette solution est complexe à mettre en œuvre et la technique de programmation la plus répandue consiste à adhérer au modèle événementiel proposé et à ajuster l application en conséquence. Ce choix est sensible essentiellement pour l interface utilisateur pour les applications tournant sur le client Lotus Notes. Une maquette d écran de saisie ou de visualisation qui accompagne les cas d utilisation permet de déterminer les choix liés à la technologie utilisée, ici Lotus Domino/Notes. Les événements étudiés dans ce module sont rattachés aux champs et au masque. La bonne compréhension du moment où ils sont activés est nécessaire pour une conception saine de l application. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-3

5 Eléments de syntaxe Eléments de syntaxe Langage faiblement typé Initialisation automatique d une variable comme texte vide Type de variable déterminé par une affectation Noms de variables non sensibles à la casse Instructions séparées par un point-virgule ( ; ) Particularités := est l opérateur d affectation tva := 19.6; = est l opérateur de comparaison pour égalité Form = "masoj" Opérateurs arithmétiques et de comparaisons : + - * / = <>!= < > Délimiteurs de chaîne de caractères : "chaîne" ou {chaîne} Variables Le langage de formules manipule des variables et des constantes à l aide d opérateurs. Les instructions et les fonctions utilisent des caractères séparateurs. Un champ dans un masque est identifié dans une formule par une variable qui porte son nom. Par exemple, le contenu du champ Statut est testé dans la formule qui suit ( Statut = 1 ; FIELD Etat := OK ; FIELD Rel := Oui ) ; Des variables temporaires peuvent aussi servir à enregistrer des valeurs intermédiaires. Par exemple, la variable de travail nom contient successivement une chaîne de caractères en majuscules, en minuscules, puis en minuscules sauf la première lettre : nom := DUPONT ; nom ; nom ; Le langage de formules étant faiblement typé, c est la valeur assignée à une variable qui en détermine le type. Dans une même formule, ce qui suit est parfaitement licite : tmp := 24; REM {Des instructions utilisant la valeur numérique tmp};.. tmp := "Dupont & Co"; REM {Des instructions utilisant la valeur texte tmp}; REM {Des instructions utilisant la valeur booléenne tmp}; Les performances d exécution restent comparables avec ou sans variables temporaires du fait que le moteur de formules procède à l évaluation au dernier moment. Une variable non initialisée contient une chaîne de caractères vide (""). La teste le contenu d une variable et retourne Vrai si elle est vide. 5-4 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

6 Constantes Les constantes servent à déterminer des valeurs par défaut, et interviennent dans des calculs, des comparaisons logiques. Type de constante Texte Notation Texte entre apostrophes doubles ou simples : Tests Durée Ou entre accolades { } titre := Tests Durée ; titre := Tests Durée ; titre := {Tests Durée} ; Nombre Entier : -24 ou 24 Décimal : -1,3 ou 1,3 Scientifique : 1,3 E3 tva := 19,6 ; Date/heure Valeur entre crochets [01/10/1999] [10:12] ou [10:12:00] [01/10/ :12:00] SELECT DateReunion > [01/01/2000] Lorsqu une constante de type texte contient une apostrophe simple ou double, deux solutions sont possibles : Encadrer la constante avec des accolades { } : {Test d une durée} Taper le caractère d échappement \ devant l apostrophe : Test d\ une durée Opérateurs Le tableau liste les opérateurs utilisés en langage de formules sur des scalaires valeurs simples ou des listes. Les opérateurs de type produit cartésien ( **, *+, = ) applicables aux listes ont été omis. Opérateur arithmétique Opération := Affectation tva := 19,6 ; : Concaténation d éléments d une liste couleurs := rouge : vert : bleu + - * / + - Valeur numérique positive Valeur numérique négative pas := -10 ; Multiplication Division Addition, concaténation quantite + 10 La variable contient Soustraction Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-5

7 Remarques L opérateur d affectation est constitué des deux caractères deux-points suivi de égal (:= ) : le caractère égal ( = ) est l opérateur de comparaison. L opérateur + appliqué à des scalaires (valeurs simples) de type texte produit un scalaire de type texte. L opérateur : appliqué à des scalaires (valeurs simples) de type texte produit une liste (valeurs multiples) de type texte. Les opérateurs arithmétiques ne peuvent manipuler que des variables numériques : il n y a pas de conversion automatique. Opérateur logique = <>!= =! >< < > <= >=! & Opération Egalité Inégalité Inégalité Inégalité Inégalité Plus petit que Plus grand que Plus petit ou égal à Plus grand ou égal à NON ( HeureDebut!= NULL ;..) ET ( HeureDebut!= NULL & HeureFin!= NULL ;.) OU logique Caractères séparateurs Instructions Lorsqu une formule comprend plusieurs instructions, elles sont séparées par le point-virgule ( ; ). trav ObjetReunion ) trav ) ; Arguments d une et d une Les arguments d une ou d une sont séparés par le point-virgule ( ; [Compose] ; masoj ) Eléments d une liste Lorsqu une liste est créée par formule, ses éléments sont séparés par un caractère deux-points ( : ). Ce caractère est également répertorié comme opérateur de concaténation des éléments d une liste. Il apparaît notamment dans les arguments de : il est alors bien difficile de faire la différence entre le caractère séparateur entre arguments et le caractère séparateur des éléments d une liste qui est elle-même un argument. Ouvrez les yeux et lisez l aide 5-6 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

8 Les 1 ; argument 2 ; ; argument n) Retourne une valeur texte, numérique, date/heure, booléen Arguments séparés par un point-virgule ( ; ) Utilisation Manipuler les chaînes de caractères : recherche... Manipuler les dates : décalage, conversions... Traiter les listes : modifier l élément n... Tester : est-ce un nouveau document? Traiter des informations : prénom et nom de l utilisateur... Obtenir des informations d environnement : base active... Syntaxe Les sont fournies en standard avec Designer et permettent d accomplir simplement des traitements pouvant être complexes. La syntaxe générale des est abordée ici. La liste des principales classées par thèmes donne une idée des fonctions accomplies. Ces fonctions sont détaillées par la suite. Une est appelée simplement par son nom ou avec des paramètres en nombre variable mis entre parenthèses et séparés par un point-virgule ( ; ) : des variables : des noms de champs, des constantes : numériques, textuelles, date/heure, des mots-clés entre crochets : qui dépendent de la fonction, une autre Elle retourne une valeur dont le type dépend de la fonction : texte, nombre, Retourne le nom de l utilisateur courant sous forme d une chaîne de caractères. Hélène ; extrait une partie du nom. [CN] signifie Common Name, donc prénom et nom. Hélène Retourne une valeur numérique ou date/heure sous forme d une chaîne de caractères. Si Quantite=800, alors 800 en caractères est ; C,2 ) Le deuxième paramètre est optionnel et précise le format de sortie. C,2 signifie : format monétaire et deux décimales ; Si Ventes=800, alors 800,00 F est retourné. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-7

9 Les sont accessibles depuis le panneau de programmation de Designer. Référence Aide et Coller Cliquer sur l onglet (Référence) Sélectionner Taper la première lettre du nom d une fonction pour se positionner dans la liste Cliquer (Aide) ou appuyer sur la touche Table des matières Langage de formules Langage de formules de A à Z. Dans cet ouvrage se reporter à l annexe Manipulation de chaînes de caractères Ces fonctions permettent de modifier une chaîne, de faire des recherches, des remplacements de ; ; Description Transforme le contenu de chaine en majuscules. azerty donne AZERTY. Transforme le contenu de chaine en minuscules. azerty donne azerty. Transforme le contenu de chaine en minuscules sauf le premier caractère de chaque mot. jean françois rouquie donne Jean François Rouquie. Elimine les espaces superflus : les espaces en début et en fin sont éliminés. Les espaces entre deux mots sont réduits à un seul. : paul le roux donne paul le roux. Retourne les quatre premiers caractères (en partant de la gauche) de chaine : azerty donne azer. Retourne les quatre derniers caractères (en partant de la droite) de chaine : azerty donne erty. Insère un caractère de retour à la ligne. Par exemple : Nom + Adresse. 5-8 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

10 Ces seront utilisées principalement dans ce module pour convertir le contenu d un champ de saisie. Par exemple, le contenu du champ NomProjet est standardisé élimination des espaces superflus, mise en minuscules avec une capitale pour la première lettre de chaque mot avec la formule ( NomProjet ) ) Manipulation de dates Ces fonctions permettent de récupérer des valeurs système et d opérer des décalages dans le ;aa ;mm ; jj ;hh ;mm ;jj) Description Retourne la date du jour au format date/heure. Retourne la date de demain au format date/heure. Retourne la date d hier au format date/heure. Retourne la date et l heure actuelle au format date/heure. Retourne le mois au format nombre de la variable date qui est au format retourne le mois en cours. Retourne le jour au format nombre de la variable date qui est au format retourne le jour pour aujourd hui. Retourne l année au format nombre de la variable date qui est au format retourne l année en cours. Retourne le numéro du jour dans la semaine à partir de dimanche de la variable date qui est au format date/heure. Date et heure de création du document. Date et heure de dernière modification du document. Décalage dans le temps à partir de la date contenue dans la variable date en année (aa), mois (mm), jour (jj), heure (hh), minute (mm) et seconde (ss). Conversion du contenu d une variable chaine de type texte en date/heure. 25/12/ :00:10 est valide et sera converti. Retourne au format date/heure la date dont les composants année (aa), mois (mm), jour (jj), heure, minute et seconde ont été fournis en nombres ;12 ;2000) retourne 25/12/2000. Ces fonctions sont utilisées dans ce module pour afficher la date de création d un document, la date du jour, calculer des valeurs par défaut dans les champs de saisie. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-9

11 Traitement de listes Les listes sont des tableaux à une dimension. Les décrites ici sont applicables dans ce module aux champs pour lesquels des valeurs multiples sont autorisées. Dans la suite du cours, d autres utilisations plus sophistiquées seront détaillées. Voir le module Fonctions avancées du masque. Autoriser entrées multiples ; sep) Transforme une chaîne de caractères en une liste chaine, chaque élément de la liste étant un mot de la chaîne de caractères. Le caractère séparateur des mots est contenu dans ; sep) Concatène tous les éléments d une liste liste séparés par le caractère sep en une chaîne de Retourne une sous-liste contenant les nbr premiers éléments de liste (si nbr est positif) ou les nbr derniers éléments de liste (si nbr est négatif). Effectue la somme arithmétique de tous les éléments des nombres de liste. Retourne le nombre d éléments de liste. Il est nécessaire de transformer une liste en une chaîne de lorsqu un traitement ne doit pas distinguer les éléments. Tests logiques Les tests logiques retournent un booléen qui est ou Dans ce module, ils sont utilisés principalement pour valider la saisie d un utilisateur, sélectionner les documents affichés dans une vue, effectuer un calcul dans une colonne. D autres utilisations seront détaillées dans les modules (condition ; expression si vrai ; expression message Description La condition est une expression logique retournant un booléen qui conditionne l exécution d une expression si VRAI ou si FAUX. Retourne 1 VRAI. Retourne 0 FAUX en l accompagnant d un message. Arrête le déroulement de la procédure. Teste le contenu d une variable et retourne 1 VRAI si le contenu de variable 5-10 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

12 Fonction @IsNewDoc Description Retourne 1 VRAI si le contenu de valeur correspond à un élément de la liste. Retourne 1 si valeur contient un nombre. Retourne 1 si valeur contient une date/heure. Retourne 1 si le document est en cours de création et n a pas encore vont servir pour tester la validité d une saisie sert également à effectuer des traitements conditionnés comme l affichage d une icône dans une colonne de vue d après le contenu d un champ. Fonctions spéciales Ces fonctions retournent des informations ou exécutent des tâches qui ne se rattachent pas aux types précédents. C est un groupe très important en quantité et en qualité. La liste qui suit est très @Name([CN] @ClientType Description Retourne le nom de l utilisateur courant sous forme d une chaîne de caractères. Hélène extrait une partie du nom. [CN] signifie Common Name, donc prénom et nom. Hélène ROUQUIE Retourne la liste des utilisateurs ayant modifié le document. Retourne la place occupée en octets par les fichiers rattachés dans un document. Retourne le nombre de fichiers rattachés dans un document Notes. Retourne la liste des noms de fichiers rattachés dans un document Notes. Retourne Notes si le client connecté à l application utilise le logiciel Notes et Web s il utilise un navigateur. Retourne le nom de la base actuelle avec son chemin complet incluant les noms de dossiers et le nom du serveur. Retourne le contenu d une colonne d une vue c est une liste dans une base et un serveur donnés. Affiche un dialogue à l utilisateur comprenant des champs de saisie et de visualisation. Récupère l identifiant unique d un document Notes dans une base. Elle sert à établir des liens entre documents. La plupart de ces seront abordées en détail dans les modules Fonctions avancées du masque et Programmation avancée avec les formules. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-11

13 Formatage automatique Formatage automatique Formule HTML LotusScript Le formatage automatique est une aide de saisie qui propose des listes de fonctions, de mots-clés, de classes d objets selon le contexte : formules, HTML, LotusScript. Le formatage est paramétrable dans les propriétés du panneau de programmation. Formules Taper jusqu à ce que la fonction recherchée soit mise en évidence Appuyer sur la touche sélectionner la fonction pour La frappe du affiche la liste des et des Le choix propose la liste des 5-12 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

14 Appuyer sur pour faire défiler les listes de paramètres possibles HTML LotusScript La frappe du nom d ou d une affiche la liste des paramètres. La liste des éléments HTML est proposée dans le panneau de programmation HTML. Cette fonction est développée séparément Programmation HTML. Les listes affichées correspondent au modèle objet Domino et ne comprennent pas les instructions du langage. s est de la classe NotesSession Membres de NotesSession Designer est capable d afficher les listes des propriétés et des attributs d une classe en fonction du type de la variable concernée. Paramétrage Clic droit dans le panneau de programmation, puis commande Propriétés du panneau de programmation Cliquer sur l onglet (Formatage automatique). Cocher Affichage automatique des membres pour voir la liste Formules : des et HTML : des éléments HTML LotusScript : la liste des classes, des attributs et des méthodes Cocher Incrustation automatique des paramètres pour voir les paramètres des et des <Différée> : taper la temporisation entre la frappe d un caractère et la mise à jour de la liste Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-13

15 Champ : valeur par défaut Champ modifiable : valeur par défaut Valeur initiale d un champ modifiable Codée dans un événement Exécuté une seule fois à la création du champ L expression retourne une valeur stockée par Notes dans le champ Champ Valeur par défaut La valeur par défaut fixe la valeur initiale d un champ modifiable : C est une expression codée dans l événement Valeur par défaut du champ modifiable, Cette expression ne s exécute qu une seule fois à la création du document et avant que l utilisateur puisse commencer la saisie, L expression retourne une valeur que Notes se charge de stocker dans le champ. Remarque Il n y a pas de mécanisme standard qui permette à l utilisateur de demander à Notes de remettre la valeur par défaut dès qu il a commencé à saisir et à modifier les champs. Cliquer sur le champ dans le panneau de travail Cliquer sur l onglet (Objets), puis sur Valeur par défaut et saisir l expression Expressions valides : Champ de type nombre 24 Champ de type date/heure Champ de type Noms Champ de type texte, liste 30 jours à partir d aujourd hui ;0 ;0 ;30 ;0 ;0 Europe 5-14 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

16 Champ : conversion d entrée Champ modifiable : conversion d entrée Chapitre 5 : Programmer avec les formules Modification de la valeur saisie dans un champ modifiable Codée dans un événement Exécuté à chaque enregistrement du document Expression construite avec le champ L expression retourne une valeur stockée par Notes dans le @ThisValue Conversion d entrée Champ La conversion d entrée modifie la valeur saisie dans un champ modifiable : L expression est dans l événement Conversion d entrée du champ modifiable, L expression référence la valeur du champ par son nom ou Cette expression s exécute à l enregistrement du document (commande Fichier/Enregistrer ) et lorsque les calculs de champs sont demandés (commande Vue/Mettre à jour ou touche F9), L expression retourne une valeur que Notes se charge de stocker dans le champ. Cliquer sur le champ dans le panneau de travail, puis sur l onglet (Objets) Cliquer Conversion d entrée et saisir une expression contenant le nom du champ Expressions Utiliser cette de préférence au nom du champ. Elle retourne la valeur du champ. ObjetReunion : élimination des espaces ObjetReunion : combinaison d une et d MotsCles : le texte dans le champ est mis en minuscules, la première lettre de chaque mot en CodeProduit : mise en CodeProduit : mise en minuscule. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-15

17 Champ : validation d entrée Champ modifiable : validation d entrée Validation de la saisie dans un champ modifiable Codée dans un événement Exécuté à chaque enregistrement du document après la conversion d entrée Expression construite avec le champ L expression retourne un booléen Vrai ou Faux et un message d @ThisValue Faux OK Validation d entrée La validation d entrée bloque l enregistrement du document si la valeur saisie dans un champ modifiable est reconnue fausse. L expression est dans l événement Validation d entrée du champ modifiable, L expression référence la valeur du champ par son nom ou et éventuellement celui d autres champs corrélés, Cette expression s exécute à l enregistrement du document (commande Fichier/Enregistrer ) et lorsque les calculs de champs sont demandés (commande Vue/Mettre à jour ou touche F9), L expression retourne un booléen VRAI ou FAUX que Notes interprète pour autoriser ou interdire l enregistrement du teste une valeur vide du texte, un nombre ou une date/heure. Cliquer sur le champ dans le panneau de travail, puis sur l onglet (Objets) Cliquer Validation d entrée et saisir une expression contenant le nom du champ Expressions valides : Le champ ObjetReunion (@This) Objet de la réunion : ce champ doit être renseigné ) Si le champ Marche contient Velo, alors le champ TypeVelo (@This) est requis ( Marche = Velo Type de vélo : ce champ doit être renseigné lorsque le marché cible est Vélo ) 5-16 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

18 Champ calculé : valeur Champ calculé : valeur Valeur d un champ calculé, calculé à la création, calculé à l affichage Codée dans un événement Exécuté à chaque enregistrement du document et au chargement si calculé à l affichage Expression construite avec des champs L expression retourne une valeur stockée par Notes dans le champ Fonctions : Champ Valeur Le contenu d un champ calculé est déterminé par une formule et il n est pas modifiable par l utilisateur. Il existe trois types de champs calculés, chacun ayant un style de codage des formules qui lui est propre. Notes effectue les calculs dans un ordre déterminé qui influe sur la disposition des champs et le résultat de l évaluation. Les trois types de champs calculés Calculé Calculé à la création Le champ est physiquement présent dans le document. Son contenu est calculé à chaque fois que le document est enregistré (commande Fichier/Enregistrer ) et calculé (commande Vue/Mettre à jour ou touche F9). Le champ est physiquement présent dans le document. Son contenu est calculé une seule fois par le masque à la création du document et avant que l utilisateur voie le document. Calculé à l affichage Le champ est physiquement absent dans le document et n existe qu en mémoire et à l écran. Son contenu est calculé à chaque fois que le document est enregistré (commande Fichier/Enregistrer ) et calculé (commande Vue/Mettre à jour ou touche F9). Principe général de codage La valeur du champ est déterminée comme suit : C est une expression codée dans l événement Valeur du champ calculé, L expression contient habituellement le ou les noms d autres champs comme variables, Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-17

19 Lorsque le contenu du champ est déterminé en dehors de son événement valeur dans un bouton l expression est le nom du champ lui-même. Cette situation est développée ultérieurement, Cette expression s exécute à chaque enregistrement (commande Fichier/Enregistrer ) et calcul (commande Vue/Mettre à jour ou touche F9) du document lorsque le champ est calculé ou calculé à l affichage, Cette expression s exécute au chargement du document lorsque le champ est calculé à l affichage, L expression retourne une valeur que Notes se charge de stocker dans le champ. Cliquer sur cette icône, ou commande Création/Champ... <Nom> : taper le nom du champ qui doit être unique dans le masque <Type> : sélectionner Calculé à l affichage Calculé à la création Calculé Puis choisir un type Texte Date/Heure Nombre Noms Auteurs Lecteurs Calculé à l affichage, Calculé à la création, Calculé Valeur Expression Saisir une expression dans le panneau de programmation Champ calculé à la création Lorsqu un champ est défini comme calculé à la création, cela signifie que le masque s engage à effectuer le calcul une seule fois, à la création du document et avant même que l utilisateur ait pu saisir quelque chose. L événement valeur d un tel champ pourra donc contenir des expressions du Date du jour. Ceci permet de conserver dans un champ la date de création du document (sans l heure) pour effectuer des catégorisations dans une vue. Nom de l utilisateur ayant créé le document. Cette valeur est figée et ne sera plus réévaluée par la suite Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

20 Remarque Le contenu d un champ calculé à la création peut être modifié par une formule de calcul déclenchée depuis un bouton, ou dans un événement de masque ou encore par un agent. La formule qui est inscrite dans l événement valeur qui lui est attaché ne sera exécutée qu une seule fois. Il est recommandé de définir un champ dont le contenu est modifié par des boutons ou d autres moyens, comme calculé à la création pour des raisons de performances : la formule contenue dans l événement Valeur n est pas évaluée inutilement lorsque le document est enregistré ou que les calculs du masque s exécutent. Champ calculé Un champ calculé est évalué à chaque fois qu un document est modifié. La formule inscrite dans l événement valeur qui lui est attaché fait référence à d autres champs et utilise des Champ calculé à l affichage Le contenu d un champ calculé à l affichage est simplement présent en mémoire et n est pas enregistré dans le document. La formule de calcul du champ doit être protégée en cas de besoin. L une des utilisations de ce type de champ est l affichage de valeurs obtenues par ou du contenu de champs du document qui ne doivent pas @Name([CN] ;@Username) Categories Recommandation La date/heure de création La date/heure de dernière modification La date/heure de dernière consultation La date du jour Le nom de l utilisateur courant Le contenu du champ Categories Les champs calculés sollicitent le client Notes ou le serveur Domino si le client est un navigateur. Un grand nombre de champs calculés une centaine correspondent à autant de formules d événements valeur dont l exécution consomme des ressources. Quelques précautions permettent d optimiser aisément les calculs. Définir comme Calculé à la création les champs pour lesquels l évaluation de la formule ne doit avoir lieu qu une fois, ou dont le contenu est modifié par d autres moyens. Définir comme Calculé à l affichage les champs dont le contenu peut être créé à partir d autres champs et qui n ont pas besoin d être sauvegardés dans le document. Lorsque deux champs partagent des formules complexes d accès à des données sur le serveur vues, documents, mutualiser le code commun dans un champ calculé à l affichage. Effectuer des tests avant d exécuter une formule si elle accède à des données sur le serveur : exécuter la formule seulement si c est nécessaire. Ces recommandations seront répétées dans les situations correspondantes. Le choix du type de champ doit toujours être réfléchi. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-19

21 Séquence d exécution des formules Ordre d évaluation des formules Calculs effectués comme dans un tableur De gauche à droite De haut en bas Deux passages Conversion d entrée et valeur Validation d entrée Notes évalue les expressions dans les événements des champs modifiables et calculés en deux passes et à la façon d un tableur : de gauche à droite et de haut en bas. Première passe : événements conversion d entrée des champs modifiables et valeurs des champs calculé et calculé à l affichage, Deuxième passe : événements validation d entrée des champs modifiables. Designer 6.0 Démonstrations/Masques/ Masque\Séquence des calculs La figure montre l ordre dans lequel se fera l évaluation : Conversion d entrée de Saisie, Valeur de Calcul_1, Valeur de Calcul_2, Conversion d entrée de SaisieAutre, Valeur de Calcul_3, Validation d entrée de Saisie, Validation d entrée de SaisieAutre. Cette logique détermine quelques règles pour disposer les champs sur le masque : L événement valeur de Calcul_2 peut utiliser les champs Saisie et Calcul_1, La formule de l événement valeur de Calcul_2 ne devrait pas faire référence aux champs qui suivent : SaisieAutre et Calcul_3. Cela marchera probablement mais le résultat peut être difficile à interpréter, Si un calcul utilise la valeur saisie dans un champ, par exemple Saisie sur la figure, et que le champ est vide l utilisateur n a rien saisi, cela peut provoquer une erreur dans la formule Protection des formules. Le mécanisme complet des événements de masque est décrit dans un paragraphe séparé. L explication qui est donnée ici montre que la disposition des champs doit tenir compte des impératifs de présentation et aussi de la séquence de calcul. Une pratique courante de programmation consiste à grouper les champs calculés à l affichage contenant des valeurs utilisées par d autres formules en tête du masque Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

22 Protection des formules Protection des formules Des erreurs dans les formules se produisent si Un champ n est pas renseigné : il contient un texte vide "" Ce champ est utilisé dans une formule arithmétique, une requérant un type Date ou Nombre Le masque exécute toutes les formules au chargement L utilisateur n a encore rien saisi Une erreur arrête le chargement : tester si les champs requis sont : sortir de la formule en retournant une valeur vide La formule d un événement valeur doit être protégée si elle manipule des valeurs numériques ou de type Date/Heure. En effet, lorsqu un champ ne contient rien, qu il soit de type texte, nombre ou date/heure, il s évalue comme une chaîne de caractères vide "" qui est souvent notée par convention avec l expression NULL. Si on mélange dans une expression du caractère et du numérique, une erreur se produira. Designer 6.0 Démonstrations/Masques/ Formules\Protection des formules Un masque de saisie contient une série de trois champs modifiables de type numérique à renseigner par l utilisateur : Prix_1, Prix_2 et Prix_3. Ces champs sont sommés dans un quatrième champ calculé de type numérique Total qui s évalue comme étant la somme des trois champs précédents : Prix_1 + Prix_2 + Prix_3 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-21

23 Lorsque l utilisateur affiche le masque, il n y a pas d erreur : les trois champs modifiables numériques sont vides ("") et le champ numérique calculé Total s évalue comme vide ("") : la somme de "" avec "" donne "". En revanche, si l utilisateur saisit un seul prix et que le calcul s exécute par enregistrement du document ou en appuyant sur la touche F9, le champ Total ne s évalue pas correctement : la formule combine une valeur numérique et deux valeurs vides (""). Un message d erreur est affiché dans le champ Total. Numérique Vide = NULL Message Il faut donc protéger l exécution de la formule. Dans certains cas, le masque ne peut même pas s afficher. Par exemple, si la formule du champ Total est ( Prix_1 + Prix_2 + Prix_3 ) / 1000,ce dialogue s affiche à la création du document : Solution recommandée Le test d un champ non renseigné se fait : cette retourne VRAI si le champ n est pas renseigné. Elle évite également de connaître la représentation d un champ non renseigné par une chaîne vide. La retourne zéro si le champ est vide, sinon, elle retourne le contenu du ; 0 ; Prix_1) ; 0 ; Prix_2) ; 0 ; Prix_3) Solution dans les versions précédentes de Designer La étant une nouveauté de la version 6, la solution adoptée dans les versions précédentes est de comparer le contenu du champ avec la chaîne vide "" ou d utiliser la variable NULL qui contient une chaîne vide. NULL est une convention d écriture : ce n est pas un mot réservé du langage comme c est le cas avec Prix_1 = NULL ; 0 ; Prix_1 ) Prix_2 = NULL ; 0 ; Prix_2 ) Prix_3 = NULL ; 0 ; Prix_3 ) Prix_1 = "" ; 0 ; Prix_1 ) Prix_2 = "" ; 0 ; Prix_2 ) Prix_3 = "" ; 0 ; Prix_3 ) 5-22 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

24 Calculer avec des dates Calculer avec des dates Décalage dans le ; AA ; MMM ; JJ ; HH ; MM ; SS) Date du jour, @Tomorrow Conversion en Extraction d une partie de Extraction d une ; MMM ; JJ ; MMM ; JJ ; HH ; MM ; SS) Calcul de l âge en L utilisation de dates dans des calculs a déjà été abordée dans des exemples simples. Ce paragraphe fait une synthèse des méthodes utilisables avec le langage de formules : décalage dans le temps, valeurs de référence, conversion en date/heure, extraction d une partie de la date/heure, calcul de l âge. Décalage dans le ( DateOrigine ; AA ; MMM ; JJ ; HH ; MM ; SS ) Le décalage se calcule à partir d une valeur d origine de type date/heure en années, mois, jours, heures, minutes et secondes. Tous les paramètres doivent être présents. Le résultat est une valeur de type date/heure postérieure ou antérieure à la valeur de référence : Date/heure postérieure à la valeur de référence : décalage positif, Date/heure antérieure à la valeur de référence : décalage négatif. Exemples Type de champ Résultat attendu Calculé à la création Calculé Calculé Date de paiement : 30 jours à partir de la date de création du document. Date de purge : 90 jours après la date de dernière modification. Date de début de semaine (le lundi est le deuxième jour de la semaine) qui précède la date d échéance. ; 0 ; 0 ; 30 ; 0 ; 0 ; 0 ; 0 ; 0 ; 90 ; 0 ; 0 ; DateEcheance ; 0 ; 0 ; -(@Weekday(DateEcheance) -2 ); 0 ; 0 ; 0 ) Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-23

25 Protection de la formule Le premier paramètre doit être de type date/heure et les paramètres suivants de type nombre. Si les types ne sont pas corrects, un message d erreur apparaît : La formule doit être protégée si l un des paramètres peut être non renseigné parce que c est un champ de saisie du masque : il n y a pas de valeur par défaut et l utilisateur peut toujours sciemment ou non effacer le contenu du champ de saisie. Par exemple DateFacture ; 0 ; 0 ; 60 ; 0 ; 0 ; 0 ) envoie un message d erreur si le champ DateFacture est vide, ce qui est le cas à la création du document. Pour protéger l instruction, on écrit DateFacture ; 0 ; 0 ; 60 ; 0 ; 0 ; 0 ) ; NULL protège l exécution en retournant NULL (du vide) si DateFacture n est pas renseignée et contient NULL (du vide). En reprenant le même exemple, si on suppose que l utilisateur saisit dans un champ Echeance le nombre de jours entre la date de la facture et l échéance de règlement, la formule s écrira alors (!@IsNull(DateFacture) &!@IsNull(Echeance) ; 0 ; 0 ;Echeance; 0 ; 0 ; 0 ) ; NULL ) Si toutes les variables comprises sont renseignées (!@IsNull ) alors le calcul est effectué, sinon NULL est retourné. Remarques Deux éléments syntaxiques d expressions logiques apparaissent : l inégalité logique s écrit!= ou <> la combinaison d expressions logiques par la relation AND (notée &). La relation OR est notée (AltGr + 6). NULL est la convention d écriture désignant une variable par exemple, un champ dont le contenu est vide. On peut écrire aussi bien DateFacture =. Il vaut mieux adhérer à la convention et écrire DateFacture = NULL. Valeurs de @Now Description Retourne la date du jour au format date/heure. Retourne la date de demain au format date/heure. Retourne la date d hier au format date/heure. Retourne la date et l heure actuelle au format date/heure Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

26 Ces valeurs s utilisent pour le calcul de valeurs par défaut, dans des agents qui déterminent quels sont les documents à archiver, etc. Pour positionner la valeur par défaut d une date à trente jours de la date actuelle, on écrit dans l événement Valeur par ; 0 ; 0 ; 30 ; 0 ; 0 ; 0). Conversion en date Les deux transforment respectivement une chaîne de caractères et des nombres retourne une date/heure si le contenu de variabletexte est une date/heure valide : Paramètre Valeur retournée une date seule 02/02/99 02/02/99 une heure seule 15:34 15:34:00 une date et une heure 2/8/00 15:34 02/08/ :34:00 une plage de dates AA ; MMM ; JJ ) retourne une date à partir de paramètres de type 93 ; 02 ; 15 ) retourne 15/02/93. Extraction Cette expression doit être protégée. Une valeur de type date/heure étant donnée, on peut extraire l année, le mois, le jour, etc., sous forme de nombre. Il s agit en fait de l opération inverse de la conversion de nombre @Day(date) retournent respectivement au format nombre l année, le mois et le jour d une variable date au retournent respectivement au format nombre l heure, les minutes, les secondes d une variable date au format date/heure. Il n existe pas de fonction extrayant depuis une date le numéro de semaine dans l année. Calcul de l Cette retourne un nombre de jours entre deux dates. Les paramètres joursexclus et datesexclues sont optionnels et représentent respectivement les jours de la semaine à exclure samedi, dimanche et les jours calendaires à exclure 1 er mai, 25 décembre. Dans les versions précédentes, il fallait faire la différence entre deux dates qui retournent des secondes, puis diviser le résultat par le nombre de secondes dans un jour 3600 x 24 = pour obtenir un âge en jours. Par exemple : ( DateEvaluee DateReference ) / Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-25

27 Les événements du masque Les événements du masque Titre de fenêtre QueryOpen Valeur par défaut Calculé à la création Calculé à l affichage Calculé : Valeur onload (PostOpen) PostOpen Calculé à l affichage Valeur Titre de fenêtre QueryOpen Conversion d entrée Calculé à l affichage Calculé : Valeur Validation d entrée PostRecalc onsubmit (QuerySave) Conversion d entrée Calculé à l affichage Calculé : Valeur Validation d entrée PostSave onunload (QueryClose) Titre de fenêtre Les événements de champs programmés en langage de formules Valeur par défaut, Conversion d entrée et Validation d entrée sont appelés suite à une action utilisateur au niveau du masque : l utilisateur rafraîchit les formules en appuyant sur la touche F9 ou un bouton, et sauvegarde le document en création ou en modification. Les événements de masque et de champs s enchaînent. Des événements de masque et de champ ont deux noms du fait de l adoption des standards de programmation actuels. Designer 6.0 Démonstrations/Masques/ Masque\Evenements Action utilisateur Séquence des événements Création du document Ouverture du document Rafraîchissement par F9 Enregistrement Titre de fenêtre (masque), puis QueryOpen (masque) Valeur par défaut (champ modifiable) Valeur (champ calculé à la création, calculé, calculé à l affichage) onload ou PostOpen (masque) Titre de fenêtre (masque), puis QueryOpen (masque) Valeur (champ calculé à l affichage) onload ou PostOpen (masque) Conversion d entrée (champ modifiable) Valeur (champ calculé, calculé à l affichage) Validation d entrée (champ modifiable) PostRecalc (masque) OnSubmit ou QuerySave (masque) Conversion d entrée (champ modifiable) Valeur (champ calculé, calculé à l affichage) Validation d entrée (champ modifiable) PostSave (masque) onunload ou QueryClose (masque si fermeture fenêtre) Titre de fenêtre (masque si enregistrement simple) 5-26 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

28 Le titre de fenêtre Le titre de fenêtre Le titre de fenêtre est aussi le titre du bouton de tâche Facilité de navigation pour l utilisateur Le Titre de fenêtre est un événement de masque qui détermine le texte apparaissant dans la partie supérieure gauche de la fenêtre Notes. Ce texte identifie également les boutons de tâches lorsque plusieurs fenêtres sont ouvertes. Il est recommandé de créer un texte explicite tout en restant court pour faciliter la navigation. Cet événement s exécute à la création, à l affichage et à l enregistrement d un document Les événements du masque. La formule de calcul de l événement prend en compte les deux situations : le document est en cours de création : aucun champ n est renseigné, le document a déjà été enregistré sur disque : les champs sont renseignés. Les deux principales utilisées Booléen : retourne 1 (VRAI) si le document en cours de création n a pas encore été enregistré sur disque, retourne 0 (FAUX) s il a déjà ; expression nouveau ; expression existant et retourne une chaîne de caractères : expression nouveau : retourne une chaîne de caractères lorsque le document n a pas encore été enregistré, par exemple Nouveau produit, expression existant : retourne une chaîne de caractères lorsque le document a été enregistré, associant une constante et le contenu d un champ, par exemple Fiche + NomProduit retourne Fiche Aspirateur si NomProduit contient Aspirateur. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-27

29 Masquer un champ Masquer un champ Les formats de saisie sont masqués en visualisation Création, modification Visualisation L affichage d un champ avec les interfaces de saisie boutons radio et cases à cocher ne doit être utilisé que si le document est en mode modification. En mode de visualisation simple, l affichage du contenu du champ est suffisant. Ce paragraphe indique comment masquer ou montrer un paragraphe contenant un champ selon l état du document : visualisation ou modification. Des règles plus élaborées prenant en compte notamment la valeur d un champ du document ou les droits de l utilisateur courant sont vues dans le module Fonctions avancées du masque et dans le module Mettre en œuvre un workflow. Définition du paragraphe Le masque Notes fonctionne selon le paradigme du traitement de texte. Une ligne du masque ou une ligne dans une cellule de tableau représente donc un paragraphe. Il suffit de masquer un élément un mot, un champ d un paragraphe pour que tout le paragraphe soit masqué. L utilisation de tableaux sans bordures permet de gérer l affichage ou le masquage d éléments sur une même ligne de l écran. Contrôle de l interface de saisie d un champ L interface de saisie boutons radio, cases à cocher n est affichée que lorsque le document est en mode de modification. Par exemple : Interface de saisie et de modification Interface de visualisation et d impression Le masque est ouvert dans Designer Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

30 Créer le champ modifiable, par exemple payscible avec une interface de type case à cocher Créer un champ calculé à l affichage dont la valeur est le contenu du champ modifiable, par exemple payscible_1 dont l événement valeur contient la formule payscible Les deux champs sont dans des paragraphes séparés, par exemple sur deux lignes successives à l intérieur d une cellule de tableau. Afficher le dialogue des propriétés du champ modifiable Cliquer sur l onglet (Masquer le paragraphe quand). Cocher les options de masquage en lecture Nom du champ modifiable Masquer le ou les paragraphes si le document est Prévisualisé pour lecture Ouvert pour lecture Imprimé Afficher le dialogue des propriétés du champ calculé à l affichage Cliquer sur l onglet (Masquer le paragraphe quand). Cocher les options de masquage en modification Prévisualisé pour modif. Ouvert pour modification Copié dans le Presse-papiers Notes affiche soit le champ modifiable, soit le champ calculé à l affichage selon l état du document sans qu il y ait de perte de place. Les deux champs sont définis sur deux lignes successives dans Designer, Notes calculant la place nécessaire à l exécution. L étiquette Pays ciblés est dans une cellule séparée du tableau et est affichée quel que soit l état du document. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-29

31 Les ; argument 1 ; ; argument n) Exécute une commande de menu Arguments séparés par un point-virgule ( ; ) Utilisation : exécuter des commandes Boutons dans les vues Boutons dans les documents Depuis des agents Enchaînement de commandes : Sauvegarder document Fermer fenêtre Syntaxe Les menus de l interface utilisateur Notes ont une équivalence en Ceci permet, par formule, de déclencher une action normalement effectuée depuis un menu. Les sont très utilisées dans des boutons de masques et de [nomcommande] ; arg1 ; arg2 ; ; argn ) nomcommande : rappelle l enchaînement des menus en anglais, arg1, arg2,, argn : un nombre variable d arguments, propres à la commande, séparés par des points-virgules ( ; ). Les sont accessibles depuis le panneau de programmation de Designer. Référence Aide et Coller Cliquer sur l onglet (Référence) Sélectionner Taper la première lettre du nom d une commande pour se positionner dans la liste Cliquer (Aide) ou appuyer sur la touche Table des matières Langage de formules Langage de formules - de A à Z. Dans cet ouvrage se reporter à l annexe 5-30 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

32 Actions système Actions système absentes par défaut Ajout des actions système par menu Suppression en option Personnalisation Libellé par formule Image ressource Incorporation dans un menu Ne fonctionnent pas sur le Web Les actions système sont des actions courantes : modifier un document, l envoyer... Elles sont absentes par défaut et il est possible de n en sélectionner qu une partie. Les actions système ne sont pas traduites pour le Web : il faut créer une action avec la correspondante. Commande Création/Action/Insérer actions système Toutes les actions système sont insérées. Pour retirer une action système : Clic droit sur l action, puis commande Supprimer Pour personnaliser l action système : Double clic sur l action pour afficher ses propriétés Libellé calculé par formule Icône personnalisée Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-31

33 Créer un bouton dans un masque Créer un bouton dans un masque Panneau d actions @Command([FileCloseWindow]) Les boutons définis dans les masques apparaissent dans la barre de boutons dans la partie supérieure du document immédiatement en dessous de la barre de tâches. L utilisation de boutons dans les masques offre plusieurs avantages : l utilisateur n a pas besoin de connaître les menus de Notes, les boutons peuvent s afficher selon le contexte du document (visualisation, modification ) et selon les droits de l utilisateur, l application n a pas besoin de tenir compte du logiciel client Notes ou navigateur d autant plus qu un navigateur n a pas accès aux menus de Notes. Ce paragraphe aborde la création d un bouton dans un masque et l utilisation des commandes système. Le masquage d un bouton d après le contexte est vu dans le paragraphe suivant et aussi dans le module Fonctions avancées du masque. Les les plus courantes sont présentées. Procédure de création d un bouton Le masque est en mode modification dans Designer. Cliquer sur cette icône ou commande Vue/Panneau d actions. Commande Création/Action/Action <Nom> : taper un nom court devant apparaître dans le bouton Cliquer Inclure dans la barre de boutons Cliquer Inclure dans le menu Actions en option <Icône> : sélectionner une option Aucune : le bouton apparaît avec le texte inscrit dans <Nom> Notes : l icône fait partie du jeu standard Notes Perso. : l icône a été créée comme ressource au format GIF ou JPG 5-32 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

34 Nom Inclure dans la barre de boutons Inclure dans le menu Actions Icône Icône personnalisée Cliquer Personnalisée Cliquer sur ce bouton pour afficher la liste des ressources images. Appuyer sur les touches de défilement pour prévisualiser les images Type de l image Sélectionner une ressource image Remarques Les images GIF et JPG permettent d utiliser des images personnalisées dans l application, notamment en choisissant leur taille. Elles sont transmises en l état à un navigateur sans aucune conversion. Il est conseillé d utiliser ce type d images en récupérant les images des modèles de bases Notes. Pour voir la formule correspondant à la ressource image : Cliquer sur ce bouton. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-33

35 La formule est une expression retournant le nom de la ressource image. L expression pourrait être plus élaborée et tenir compte de la valeur de champs dans un document pour déterminer l affichage d un bouton ou d un autre. Cette méthode est bien adaptée à une application de workflow. Icône Notes Cliquer Notes Image <Image> : cliquer sur la flèche d affichage de la liste des images Sélectionner une image dans la palette d images Notes Remarque Il n est pas possible d ajouter des images à cette palette. Par ailleurs, ces images seront converties pour un affichage dans un navigateur. Cette méthode a été conservée d abord pour des raisons de compatibilité. Choix de La procédure est décrite dans le paragraphe Action La formule associée à un bouton d action peut être autre chose qu une simple et effectuer un traitement complexe : Mettre en œuvre un workflow Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

36 Lorsque deux s enchaînent, il faut les séparer par un point-virgule ( ; ). Par exemple, pour enchaîner l enregistrement du document et la fermeture de la fenêtre Disposer les boutons d actions Double clic sur l action dans le panneau d actions pour afficher le dialogue des propriétés <Position> : choisir la position Position courantes Les commandes listées ici ont un sens dans le contexte d un masque pour l affichage ou la création/modification d un document. AttachmentDetachALL Compose EditBottom EditClear EditDocument FileCloseWindow FilePrint FileSave ToolsSpellCheck ViewRefreshFields Détacher tous les fichiers rattachés dans le document. Création d un document avec le masque indiqué. Envoyer le curseur sur le dernier champ modifiable. Marquer le document pour suppression. Mettre le document visualisé en mode modification. Fermer la fenêtre Notes courante. Imprimer le document. Enregistrer le document dans la base. Vérifier l orthographe. Exécuter les formules de calcul. Certaines exécutées depuis un bouton devraient être cachées selon l état du document. EditBottom EditDocument FileSave ToolsSpellCheck ViewRefreshFields Caché si ouvert en lecture Oui Oui Oui Oui Caché si ouvert en écriture Oui Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-35

37 Masquer un bouton Masquer un bouton Un bouton est affiché selon le contexte. Par exemple Document en modification : bouton (Enregistrer) Document en visualisation : bouton (Modifier) Eviter les messages d erreur Tenir compte des droits de l utilisateur Création, modification Visualisation Un bouton d action exécutant la de fermeture de fenêtre a un sens quel que soit l état du document, visualisation simple ou modification. Le bouton exécutant la d enregistrement du document dans la base n a de sens que si le document est en mode édition. Il faut donc le cacher si le document est en mode de visualisation simple. Ce paragraphe indique comment masquer ou montrer un bouton selon l état du document : visualisation ou modification. Des règles plus élaborées prenant en compte notamment la valeur d un champ du document ou les droits de l utilisateur courant sont vues dans le module Fonctions avancées du masque et dans le module Mettre en œuvre un workflow. La procédure est semblable à celle utilisée pour un champ, la seule différence étant que le bouton d action se trouve dans la barre d actions et non dans un paragraphe. Afficher le dialogue des propriétés de l action Cliquer sur l onglet (Masquer). Cocher les options de masquage selon l action et l état du document (lecture ou modification) Masquer l action lorsque le document est 5-36 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

38 Action case à cocher La case est cochée d après la valeur d un champ Indication de l état d une action Non cochée : à faire ou disponible Cochée : action effectuée Libellé construit par formule Voici une nouveauté de la version 6 particulièrement bien adaptée aux applications de workflow dans lesquelles un document change d état dans le courant du processus : la case à cocher est un moyen simple de signaler ce qui doit être fait et ce qui a été fait. Cette fonction jointe au calcul du libellé du bouton rend ce dernier porteur de plus d informations. Cette fonction est illustrée par un scénario dans lequel le bouton sert à valider un document dont l état est enregistré dans un champ Etat. Le libellé de ce bouton affiche l état du document une fois approuvé. Créer l action <Nom> : ce champ n est pas utilisé si le libellé est renseigné <Libellé> : taper une formule, par ; "Attente d'approbation" ; Etat ) Le libellé calculé invite l utilisateur à décider du statut du document lorsque le champ Etat est vide, sinon il affiche le contenu de Etat. <Type> : sélectionner Case à cocher <Valeur> : taper une formule qui indique quand la case doit être cochée. Dans l exemple, lorsque Etat est La formule de l action listeetat := "Approuve" : "Refuse" : FIELD Etat:=@Prompt([OkCancelList];"Approbation";"Donnez Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-37

39 Menus hiérarchisés Hiérarchie des actions en version 5 Convention d écriture Hiérarchie des actions en version 6 Option dans Designer Glisser-déplacer Hiérarchisation des actions système Les actions apparaissent dans le menu Outils ou dans des sous-menus rattachés au menu Outils. Cette hiérarchisation se construit différemment en version 5 et en version 6 du logiciel. Hiérarchie d actions en version 5 Les actions sont hiérarchisées en version 5 en utilisant une convention d écriture consistant à ajouter des barres obliques dans le nom de l action : /Outils/Exportation/XML fera apparaître l action XML dans le sous-menu Exportation attaché au menu Outils. Hiérarchie d actions en version 6 La version 6 introduit l objet sous-action et des facilités de réorganisation par glisserdéplacer. Commande Création/Action/Action avec sous-action Clic droit sur l action avec une flèche qui correspond au menu pour lui donner un nom Pour déplacer action ou sous-action : Cliquer sur l action ou la sous-action, puis la déplacer en conservant le bouton gauche de la souris appuyé 5-38 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

40 Propriétés de la barre d actions Propriétés de la barre d actions Image d arrière-plan Style de bordure Hauteur de la barre Chapitre 5 : Programmer avec les formules Taille Arrière-plan Bordure Le dialogue de propriétés de la barre d actions détermine son apparence : image d arrière-plan, style de bordure, hauteur de la barre Cliquer sur l onglet (Taille de la barre d actions). <Hauteur de la barre> : sélectionner Défaut Exs : taille des minuscules de la police choisie Pixels Cliquer sur l onglet (Arrière-plan de la barre d actions). L arrière-plan peut être coloré ou agrémenté d une image. <Couleur> : sélectionner une couleur dans la palette <Image> : choisir une image dans les ressources d image de la base Cliquer sur l onglet (Bordure de la barre d actions). Choisir une épaisseur, un style et l ombre portée si nécessaire Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-39

41 Formule de sélection d une vue Formule de sélection d une vue Une vue correspond à un index de vue dans la base SELECT expression logique Détermine quels documents sont affichés dans la vue Opérateurs booléens égalité =, inégalité!=, relation ET &, relation OU Items du document, Restrictions Variables d environnement (NOTES.INI) du poste de travail et du serveur exclues Nom d utilisateur utilisable dans les vues privées seulement déconseillées Une vue est généralement attachée à une formule de sélection. La vue Tous documents de la base Courrier est l exception qui confirme la règle. Dans une application, il est recommandé de séparer les documents dont le contenu change beaucoup de ceux qui sont figés en utilisant des formules de sélection appropriées : l utilisateur y gagnera en clarté et la mise à jour des index sera plus économique sur le serveur Domino. Les formules de sélection des vues publiques ne peuvent pas se construire dynamiquement à la façon d une clause WHERE d un ordre SQL : tout le monde voit la même chose, lorsqu il n y a pas de champs Lecteurs dans les documents. Syntaxe de la formule de sélection La formule de sélection d une vue détermine quels documents font partie de l index de la vue et sont affichés. Une formule de sélection s écrit : avec le mot-clé obligatoire SELECT, suivi d une expression logique qui retourne un booléen 1 (VRAI) ou 0 (FAUX). Une expression logique simple est une comparaison par égalité ( = ) ou inégalité (!= ou > ou < ou >= ou <= ) du contenu de deux items, ou d un item et d une constante, ou d un item et d une valeur retournée par une Les expressions logiques simples se combinent avec des opérateurs ET (&), OU (AltGr + 6 pour ). SELECT Form = masoj SELECT Etat!= Archive SELECT Form = masoj & Etat = Archive > 0 Documents créés avec le masque dont le pseudonyme est masoj Documents dont l item Etat ne contient pas Archive Documents créés avec le masque dont le pseudonyme est masoj ET dont l item Etat contient Archive Documents ayant au moins un fichier rattaché 5-40 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

42 Utilisation de variables temporelles La collection de documents déterminée par la formule de sélection doit être relativement stable dans le temps. Ainsi, des formules faisant appel date et heure actuelles, utilisée pour calculer l âge d un document, sont fortement déconseillées parce qu elles sont constamment réévaluées. Il vaut mieux calculer l âge du document dans un champ en utilisant un agent par exemple et effectuer la sélection d après le contenu de l item. Voir le module Créer des agents. Redbook Performance Considerations for Domino Applications. SG Annexe B-1. Time/Date Views. L exemple qui suit est tiré du Redbook. Il s agit d afficher tous les événements dont la date est postérieure à la date du jour (@ToDay) moins sept. Version non optimisée Le contenu de Evendate est comparé à la date résultant L indicateur de rafraîchissement est affiché en permanence. SELECT Form = "masagenda" & EvenDate Version optimisée La variable temporaire seldate qui est un booléen s évaluant à True ou False, est construite puis utilisée dans l expression qui suit le mot-clé SELECT. L indicateur de rafraîchissement n est pas affiché en permanence. Il faut provoquer la reconstruction de l index toutes les 24 heures. cejour := "Aujourd'hui"; edt dwk := edt ; 0 ; 0 ; 1 ; 0 ; 0 ; 0) ; 0 ; 0 ; 2 ; 0 ; 0 ; 0) ; 0 ; 0 ; 3 ; 0 ; 0 ; 0) ; 0 ; 0 ; 4 ; 0 ; 0 ; 0) ; 0 ; 0 ; 5 ; 0 ; 0 ; 0) ; 0 ; 0 ; 6 ; 0 ; 0 ; 0) ; dwk_fmt dwk ; "T1S3" ); seldate ; SELECT Form = "masagenda" & seldate La variable dwk contient une liste de dates depuis la date de l événement jusqu au sixième jour qui suit effectue des décalages de 1, 2, 3, 4, 5 puis 6 jours dans le futur. L opérateur deux-points ( : ) sépare les éléments de la liste. La variable dwk_fmt est la conversion en caractères de dwk, les mots Hier, Aujourd hui et Demain se substituant à la représentation jj/mm/aaaa. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-41

43 L index de la vue doit être reconstruit après minuit par le programme UPDALL. Cette tâche se planifie sur le serveur Domino dans un document programme créé par l administrateur dans l annuaire Domino. Les paramètres de UPDALL précisent la base et le nom de la vue, ici viewoptimisee. Activites\DE60Demo.nsf -r -t viewoptmisee Cette technique a le mérite de rendre l affichage de la vue immédiat et d éviter du travail à la tâche UPDATE sur le serveur pendant la journée. La mise en exploitation est contraignante du fait de la création du document Programme par l administrateur. Affichage partiel La permet d ajouter un filtre qui opère sur les documents sélectionnés dans l index de la vue. Elle s exécute dans deux contextes précis : Une vue de type standard en filtrant le contenu d une colonne catégorisée, Une vue de type Agenda en filtrant le contenu d une colonne non catégorisée. Toute tentative d utilisation en dehors de ces deux contextes rend le filtre inopérant : la vue s affiche : vue [SETVIEWFILTER] ; chainesele ; nomcolonne ; estcategorie ) La formule de bouton qui ouvre une vue depuis un masque est du type : ; La vue dont le pseudonyme est vuefampro est ouverte en filtrant la colonne Famille qui doit contenir Imprimante. La colonne est catégorisée. Le même résultat est obtenu en intégrant une vue dans un masque et en affichant uniquement une catégorie de la vue. Cette technique peut se substituer dans certains cas à celle de la vue partagée devenant privée à la première utilisation : l utilisateur ne voit que les documents qui le concernent pourvu que le critère soit une : vue [SETVIEWFILTER] ; chainesele ; nomcolonne ; correspondance ) La correspondance peut être exacte ou approchée : correspondance = 0 : les lignes dont le contenu de colonne commence par la chaîne entrée dans chainesele sont sélectionnées, correspondance = 1 : les lignes dont le contenu de colonne est exactement la chaîne entrée dans chainesele sont sélectionnées. Remarque La sélection sur le contenu d une colonne qui n est pas catégorisée est réservé uniquement aux vues de type Agenda. Pour répondre à ce besoin avec des vues de type standard, il faut recourir à de la programmation LotusScript : le modèle objet de Domino en version 6 donne accès à la note de conception View et permet de construire une vue entièrement par programme Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

44 Formule de colonne calculée Formule de colonne calculée Les colonnes font partie de l index de vue Les calculs sont effectués à chaque réindexation de la vue La formule qui retourne la valeur texte manipule des Opérateurs arithmétiques et de concaténation Items du document, pour convertir date/heure, nombre, texte Restrictions identiques aux formules de sélection Colonnes triées et cachées Une formule de calcul détermine une valeur Le tri se fait sur cette valeur, invisible de l utilisateur Le contenu d une colonne calculée est déterminé par une formule. Le résultat du calcul est enregistré dans l index de la vue à chaque réindexation de la vue lorsque le contenu du document est modifié. Ce mécanisme assure que l information affichée dans la vue est la plus récente. La formule qui retourne la valeur de la colonne met en jeu des variables champs du document combinées par des opérateurs arithmétiques (addition +, soustraction -, multiplication * et division /) et de concaténation de chaînes de caractères ( + ). Les utilisées dans les événements de champs sont pour les conversions. Les restrictions qui s appliquent à la formule de sélection sont valables pour une formule de colonne calculée. ne doit pas apparaître dans une formule de colonne calculée. Une colonne calculée cachée est utilisée couramment pour déterminer un ordre de tri des documents sans que l utilisateur voie le contenu de la colonne. Par exemple, dans une application de suivi de réunions, une vue contient des documents ordre du jour (Form = masoj ), des documents de comptes rendus ( Form = mascr ) et des documents tâches affectées (Form = mastache ). On veut afficher les documents dans la séquence logique Ordre du jour, C/R et Tâches. Le tri sur le contenu de l item Form ne donne pas le résultat voulu. Il faut créer une colonne calculée et cachée dont la formule est (Form = "masoj" ; "A" ; Form = "mascr" ; "B" ; Form = "mastache" ; "C" ; "Z") Masquer la colonne Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-43

45 Formule de masquage de colonne Formule de masquage de colonne Masquage de colonne Toujours : colonne destinée au tri des documents, à un accès programme Par calcul : formule applicable à tous les documents et/ou à l utilisateur courant Diminution du nombre de vues Vues privées Vues publiques d accès contrôlé Une colonne cachée sert couramment à classer les documents sans que l utilisateur voie le critère de classement ou est destinée à être lue par programme, par exemple le UNID du document. La version 6 permet de conditionner l affichage d une colonne par une formule. Une colonne sera affichée par exemple d après l utilisateur courant identifié par un rôle dans la LCA ou son type Notes ou Web. Un résultat comparable est atteint dans les versions antérieures en créant des vues partagées d accès contrôlé ou des vues partagées devenant privées à la première utilisation. La limitation du nombre de vues est un facteur de performances important pour les bases de taille importante. Double clic sur le titre de la colonne pour afficher ses ) = "Notes" ) Cliquer sur l onglet (Spécial). Cocher Masquer colonne si la formule est vérifiée, puis taper une formule Dans l exemple, la colonne est affichée si l utilisateur a le rôle [Marketing] et utilise un client Notes. Elle est cachée dans tous les autres cas Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

46 Programmation des couleurs de lignes Programmation des couleurs de lignes Mise en évidence d une ligne par couleur Colonne cachée Retourne une valeur RVB ou hexadécimale Calcul Contenu d un champ de type Couleur Couleurs programmées Arrière-plan de la ligne, de la vue Avant-plan (texte) Marge latérale et verticale En version 6, une colonne spéciale contient la couleur en format RVB Rouge Vert Bleu décimal ou hexadécimal des rangées de la vue. Cette colonne est cachée du fait que son contenu n a pas de signification pour l utilisateur. La couleur retournée par la colonne vient soit d un item du document, de type Couleur, soit d une formule de colonne. Elle détermine la couleur d arrière-plan et des caractères. La vue peut être encadrée d une marge de couleur dont l épaisseur va de 1 à 100 pixels. Couleur programmée de ligne Codification des couleurs La codification des couleurs est en mode décimal représentation dans Designer ou en mode hexadécimal standard sur Internet. Il faut donc disposer de tables de couleurs ou utiliser le dialogue Couleurs de Designer. Afficher les propriétés de la vue Cliquer sur l onglet (Style). <Lignes> : cliquer sur la flêche Dialogue Couleurs Cliquer sur l icône du coin supérieur droit pour afficher le dialogue Couleurs Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-45

47 Notation RVB en décimal Cliquer sur la couleur voulue et relever la valeur RVB, ici 198:239:253 Création de la colonne couleur Créer une colonne qui soit à gauche de la première colonne à partir de laquelle s effectue le coloriage. En principe, c est la première colonne Une vue est interprétée par Domino en balayant les colonnes de gauche à droite. Ainsi, si la colonne «couleur» est la première en partant de la gauche, elle détermine les couleurs de toutes les autres colonnes à sa droite. Si la colonne «couleur» est au milieu des autres colonnes, elle déterminera la couleur des colonnes à sa droite seulement. S il y a plusieurs colonnes «couleurs» dans la vue, chacune détermine les couleurs des colonnes à sa droite jusqu à la rencontre de la colonne «couleur» suivante qui impose alors sa règle. En résumé, et pour rester simple, la colonne qui détermine la couleur des rangées est la première en partant de la gauche dans la vue. Cocher Utiliser valeur comme couleur <Valeur de colonne> : taper une formule qui retourne La couleur d arrière-plan seulement La couleur d arrière-plan puis la couleur d avant-plan noir := 0 : 0 : 0; bleu1 := 187 : 223 : 255; bleu2 := 149 : 205 : 255; defaut := -1 : -1 : = "Imprimante" ; bleu1:noir ; Famille = "Logiciel" ; bleu2 : noir; defaut) 5-46 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

48 Marge L exemple utilise quatre couleurs RVB enregistrées au format décimal dans des variables temporaires. Les valeurs ont été récupérées du dialogue Couleurs de Designer. La variable defaut ( -1 : -1 : -1) retourne la couleur courante de l arrière-plan et de l avant-plan de la vue. Si la famille est Imprimante, la couleur d arrière-plan est bleu1 et celle d avantplan est noir, Si la famille est Logiciel, la couleur d arrière-plan est bleu2 et celle d avant-plan est noir, Sinon, la couleur définie au niveau de la vue est utilisée. Cliquer sur l onglet (Spécial). Cocher Masquer la colonne de préférence lorsque la mise au point est terminée Afficher les propriétés de la vue Cliquer sur l onglet (Style). Couleur d arrière-plan de vue Grille Marge : épaisseur Marge : couleur <Lignes> : sélectionner la couleur d arrière-plan de la vue <Grille><Style> : sélectionner le trait séparateur des lignes de la vue <Marge> : ajuster l épaisseur de chacune des arêtes ou agir globalement en utilisant les deux flèches de défilement du bord latéral droit <Marge><Couleur> : sélectionner la couleur des marges de la vue Remarque La grille et la marge associées à des couleurs programmées donnent un aspect tableau de résultat à une vue. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-47

49 Champ type Couleur Champ de type Couleur Champ contenant une couleur en représentation RVB hexadécimale Onglet Notes : choix d une couleur Onglet Web : choix des saturations Rouge, Vert et Bleu Utilisé pour définir les couleurs de vues Une couleur est enregistrée dans un item sous forme d un texte représentant une chaîne hexadécimale, par exemple "0000FFB2" pour un bleu vert soit 0 : 255 : 178 en notation décimale RVB. Designer 6.0 Démonstrations/Masques/ (masprofilcouleur) Le type de champ Couleur propose un dialogue de choix à l utilisateur. Sur le navigateur, ce type de champ est traduit en <INPUT TYPE=TEXT>. Les champs de type Couleur sont utiles essentiellement dans les vues. La personnalisation des couleurs d une vue par l utilisateur se fait par saisie des préférences dans un document de profil propre à l utilisateur qui est ensuite accédé par programmation LotusScript Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

50 Créer un bouton d action dans une vue Créer un bouton d action dans une vue Panneau @Command( [ToolsRefreshAllDocs] ; masinvitation ) Ressource image La procédure de création du bouton d action dans une vue ou dans un dossier est en tous points semblable à la procédure de création du bouton d action dans un masque. Le contexte étant différent, le jeu des utilisées n est pas le même. Les principales utilisées sont listées ici. Compose EditClear EditDocument FileCloseWindow FileExport FileImport FilePrint FolderMove NavigateNextUnread RemoveFromFolder ToolsRefreshAllDocs ViewCollapseAll ViewExpandAll ViewShowUnread Création d un document en utilisant le masque ; "masoj"). Marquer le ou les documents sélectionnés pour suppression. Ouvrir le document sélectionné en mode modification. Fermer la fenêtre Notes courante. Export du contenu de la vue. Importation d un fichier texte. Imprimer la vue ou les documents sélectionnés. Création de liens pour les documents sélectionnés dans un dossier. Passer au document suivant non lu. Retirer un document d un dossier sans le supprimer de la base. Rafraîchit exécute les formules de calcul les champs de tous les documents de la vue. Condenser toutes les catégories. Détailler toutes les catégories. Visualiser les documents non lus seulement. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-49

51 Créer une action partagée Créer une action partagée Ressource image + Formule Référence au code partagé Actions Masques Vues Un nombre important d actions se répète à l identique dans les masques et les vues : fermeture de la fenêtre Notes, passage du document en mode modification, impression Il est alors intéressant de définir l action une seule fois le texte du bouton, l image associée, la ou les commandes et de référencer cette action dans les masques et les vues. Toute modification ultérieure de l action sera répercutée automatiquement dans tous les masques et les vues qui l utilisent. Cette démarche est identique à celle qui a consisté à définir des ressources images. Dans le cas des actions, on définit des ressources actions partagées. Procédure de création Vue Code partagé/actions puis cliquer (Nouvelle action partagée) Suivre la procédure de création d une action de masque ou de vue Ou Copier/Coller une action existante depuis un masque ou une vue Procédure d insertion Ouvrir le masque ou la vue dans Designer Commande Création/Action/Insérer action partagée Insérer une ou plusieurs actions Cliquer sur une action puis (Insérer) 5-50 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

52 Outils de débogage Outils de débogage Affichage du contenu d une variable dans un ; titre ; message Affichage du contenu d une variable dans la zone de Mise en commentaire d instructions par REM {. ;.. ;.. } ; Test de l exécution d une formule Taper la formule dans un champ de type texte Appuyer sur Majuscule-F9 Le résultat se substitue à la formule Dans les versions actuelles, il n y a pas d outil de mise au point débogage des formules, des agents écrits en Java ou du code JavaScript. Le seul outil disponible l est en LotusScript. Dans le langage de formules il faut recourir à des affichages du contenu des variables avec la La mise en commentaire de blocs d instructions avec REM est également utile. Les formules peuvent aussi être testées dans un champ de type Texte. Affichage d une variable La est destinée à dialoguer avec l utilisateur. Pour mettre au point une formule, on utilise une forme particulière [OK] ; "titre" ; "message") ; Par : " +@UserName); affiche : ne peut afficher que du texte. Le contenu de variables numériques ou de type date doit être converti avec la Dans un événement de champ ou de masque, il ne faut pas que soit la dernière expression va retourner une valeur 1 qui sera inscrite par Notes dans le champ si l événement est valeur par défaut, conversion d entrée ou valeur, ou qui sera interprété comme VRAI si est dans un événement de validation d entrée. Il faut donc que vienne avant la dernière expression dans l événement et qu il soit séparé de cette dernière par un point-virgule. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-51

53 Exemple Expression de calcul de DureeReunion A l exécution, affiche le contenu des deux variables servant au calcul de la durée, puis le calcul de la durée Le message est affiché dans la zone de message de Notes sans intervention de l utilisateur. Le contenu de variables numériques ou de type date doit être converti sinon aucune information n est affichée. REM Le mot-clé REM déclare un commentaire. Les instructions à mettre en commentaire sont encadrées par des accolades. REM étant une instruction, il faut la séparer des suivantes par un point-virgule ( ; ). Dans l exemple, l instruction de a été mise en commentaire. REM DureeReunion"; "HeureDebutReunion : " + ". HeureFinReunion : " ); &!@IsNull(HeureFinReunion); ( HeureFinReunion - HeureDebutReunion )/ 1440 ; NULL) Exécution de formules Il est pratique de tester l exécution d une en utilisant les exemples fournis dans l aide. Il suffit de l écrire dans un champ de type texte et d appuyer sur - -F9. Le résultat de la formule s affiche dans le champ. Cette particularité d un champ de type texte qui consiste à tenter d exécuter son contenu n est pas documentée, mais cela marche Pour conserver la trace de l instruction, il suffit de l écrire dans un champ de type texte riche et de la copier/coller dans le champ de type texte pour l exécuter. Une application Notes très simple contenant un masque avec deux champs et une vue sert alors de bibliothèque d exemples Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

54 courantes La liste complète des est donnée dans l Calcul d un décalage dans le temps en année, mois, jour, heure, minute et seconde à partir d une date de Calcul d un âge à partir d une date de référence en excluant en option des jours de la semaine et des Nom du serveur et de la base sur lesquels s exécute la formule. Retourne le booléen Faux accompagné d un message. Elle est utilisée dans les événements de validation d entrée de champ. Retourne le booléen Vrai. Elle est utilisée dans les événements de validation d entrée de champ et aussi partout où une valeur non signifiante doit être retournée. Exécution conditionnelle d instructions. Retourne le booléen Vrai tant que le document n a pas été enregistré. Convertit un nom en différents formats. Le paramètre [CN] permet d extraire la partie Common Name d un nom d utilisateur. Mise en minuscules d un texte ; la première lettre de chaque mot est mise en majuscule. Suppression des espaces superflus avant, après et au milieu d un texte : un seul espace entre deux mots. Date du jour sur l ordinateur sur lequel s exécute la formule. Contenu du champ auquel est rattaché l événement. Nom du champ auquel est rattaché l événement. Nom de l utilisateur courant. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-53

55 courantes courantes AttachmentDetachAll Compose EditBottom EditClear EditDocument FileCloseWindow FilePrint FileSave ToolsSpellCheck ViewRefreshFields La liste complète des est donnée dans l annexe AttachmentDetachAll Compose EditBottom EditClear EditDocument FileCloseWindow FilePrint FilePrintSetup FileSave RemoveFromFolder ToolsSpellCheck ToolsRefreshAllDocs ViewCollapseAll ViewExpandAll ViewShowUnread ViewRefreshFields Détache tous les fichiers rattachés d un document dans un dossier désigné par l utilisateur. Création d un document avec le masque indiqué. Déplace le point d insertion en bas du masque lorsque le document est en modification. Supprime un document ou les données mises en évidence dans le document en modification. Met le document actuel en modification. Ferme la fenêtre active. Imprime la vue, les documents Affiche le dialogue de configuration de l impression. Sauvegarde le document en cours de modification. Retire un document d un dossier sans le supprimer de la base. Vérifie l orthographe. Rafraîchit exécute les formules de calcul les champs de tous les documents de la vue. Condense toutes les catégories. Détaille toutes les catégories. Visualise les documents non lus seulement. Correspond à la touche F9 : exécution des formules de calcul du masque Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

56 Récapitulatif syntaxique Récapitulatif syntaxique Variables Constantes Opérateurs Mots-clés Caractères séparateurs Evénements Une formule est faite d une ou plusieurs instructions séparées par des points-virgules ( ; ) Ces instructions sont bâties avec les composants : variables, constantes, opérateurs, mots-clés, Une formule s écrit - dans un événement de masque de champ dans un masque - dans une vue : colonne calculée - dans un agent Variables Le module a présenté l utilisation courante du langage de formules dans les événements de champ, les sélections de vue, les colonnes calculées d une vue. Ce paragraphe récapitule la syntaxe du langage. Le langage de formules comme tout langage informatique manipule des variables et des constantes à l aide d opérateurs. Le langage utilise également des éléments qui lui sont propres : mots-clés, Une variable référence un champ, défini habituellement dans un masque, ou encore une zone de travail intermédiaire en mémoire (variable de travail). Le nom d une variable n est pas sensible à la casse (majuscules et minuscules). (!@IsNull(HeureFinReunion)&!@IsNull(HeureDebutReunion); (HeureFinReunion HeureDebutReunion)/1440; NULL) Il y a deux champs définis dans le masque : HeureDebutReunion et HeureFinReunion. Ils sont référencés par leur nom dans une expression présente dans l événement Valeur du champ calculé DureeReunion. Variable de travail Une variable de travail permet de simplifier l écriture d une formule et d en faciliter la maintenance. Une variable de travail est allouée automatiquement par Notes sans qu il soit besoin de la déclarer. Exemple 1 : Evénement conversion d entrée du champ @ThisValue ) ) Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-55

57 Peut s écrire aussi bien : ) trav ) ; La variable trav est allouée automatiquement par Notes et elle est du type texte parce que l expression qui est à droite de l opérateur d affectation ( := ) retourne du trav ) retourne la valeur convertie de ObjetReunion dans ObjetReunion. Exemple 2 : Instruction de trace dans l événement valeur du champ ; Tests Duree ; HeureDebutReunion : +. HeureFinReunion : Peut s écrire aussi bien : titre := Tests Duree ; message := HeureDebutReunion : ; message := message +. HeureFinReunion : ; titre ; message) ; Dans cet exemple, titre et message sont deux variables de travail. La variable message est définie puis modifiée dans deux instructions d affectation. Remarque Une faute assez fréquente dans la rédaction d une formule consiste à taper un nom de champ incorrect. Par exemple, dans l événement conversion d entrée du champ ObjetReunion, si, au lieu de ObjetReunion ) ) on ObjetRuenion ) ) Notes ne trouve pas de champ nommé ObjetRuenion, donc il alloue une variable de travail vide (NULL), et le résultat de la formule (NULL) ira dans le champ ObjetReunion dont le contenu sera effacé. La parade consiste à éviter d écrire les noms de champs quand c est possible en La dyslexie a moins de conséquence en @ThisValue ) ) Il n y a pas de moyen en langage de formules de forcer la déclaration des variables. Mots-clés La formule de sélection d une vue commence avec le mot-clé SELECT. Par exemple : SELECT Form = masoj Le mot-clé est le premier mot de l expression, il est suivi d un espace et doit être saisi en majuscules par convention (Notes le transforme en majuscules s il est saisi en minuscules). Les mots-clés sont listés ici. Leur utilisation sera reprise en détail par la suite. DEFAULT DEFAULT nomdechamp := expression ; 5-56 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

58 Si le champ nomdechamp existe dans le document, il est laissé en l état, sinon il est créé et prend la valeur de expression. Le type du champ texte, nombre ou date/heure est déterminé par la valeur retournée d expression. Ce mot-clé permet de créer un champ qui n a pas été défini dans un masque. Il s agit souvent de champs servant à contrôler l état d un document dans un circuit de workflow. Ces champs sont créés par des agents ou dans un événement de masque tel que le QuerySave. ENVIRONMENT ENVIRONMENT variable := expressiontexte ; Cette instruction crée une variable d environnement dans le NOTES.INI du poste client. Par exemple : ENVIRONMENT DernierNumero := 24 ; Donne la ligne suivante dans le NOTES.INI du poste : $DernierNumero = 24 La est équivalente au mot-clé ENVIRONMENT. La permet de lire et d écrire dans le NOTES.INI. Remarque L entretien d informations propres à l utilisateur dans le NOTES.INI n est pas fiable parce que le NOTES.INI n est pas toujours sauvegardé et qu il peut être modifié par l utilisateur. Par ailleurs, si l utilisateur change de poste, il ne retrouve plus le même contexte. Il est préférable d utiliser un document profil utilisateur dans la base comme décrit dans le module Programmation avancée avec les formules. FIELD FIELD nomdechamp := expression ; Le champ nomdechamp est créé s il n existe pas dans le document, puis il prend la valeur de expression. Le type du champ texte, nombre ou date/heure est déterminé par la valeur retournée d expression. Ce mot-clé est similaire à DEFAULT avec un mode de fonctionnement un peu différent dans la mesure où le champ prend obligatoirement la valeur de expression. Ce mot-clé est utilisé pour mettre à jour (et créer si cela est nécessaire) des champs servant à contrôler l état d un document dans un circuit de workflow, ou encore pour exécuter des opérations de maintenance de bases : suppression de champs inutilisés, création de nouveaux champs dans des documents existants, changement de noms de champs. Il sera utilisé principalement dans des agents, des boutons ou des événements de masque (QuerySave). REM REM {Traitement propre au département 24 } ; REM sert à mettre des commentaires dans une formule. Les commentaires sont encadrés de préférence avec des accolades { }. Sa particularité est d être lui-même une expression qui doit obéir à des règles de syntaxe et se terminer par un point-virgule ( ; ). Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-57

59 SELECT SELECT expression logique L expression logique, plus ou moins complexe, retourne un booléen 1 (VRAI), auquel cas le document est sélectionné, ou 0 (FAUX), auquel cas le document n est pas sélectionné. SELECT s utilise dans les formules de sélection de vues et aussi dans les agents pour déterminer la collection de documents qui sera traitée par l agent. Par exemple : SELECT DateReunion > [01/01/2000] Pour sélectionner tous les documents. Fonctions ( arg1 ; arg2 ;.. ; argn) nomfonction, arg1, arg2,, argn : un nombre variable d arguments, propres à la fonction, séparés par des points-virgules ( ; ). Par L exécution d une doit être protégée : si un argument est de type numérique ou date/heure, il est impératif de vérifier qu il est bien renseigné et, éventuellement, que son type est correct. Cette vérification met en [nomcommande] ; arg1 ; arg2 ; ; argn ) nomcommande : rappelle l enchaînement des menus en anglais, arg1, arg2,, argn : un nombre variable d arguments, propres à la commande, séparés par des points-virgules ( ; ). Evénements Le langage de formules a été utilisé principalement dans des événements de champs. Lorsqu une formule comprend plusieurs instructions, la dernière instruction doit retourner une valeur qui sera placée automatiquement par Notes dans le champ (événement Valeur par défaut, Conversion d entrée, Valeur) ou interprétée comme un booléen (événement Validation d entrée). Une faute courante consiste à écrire dans un événement ici de conversion d entrée : ObjetReunion ) ); au lieu de ObjetReunion ); auquel cas Designer signale une erreur : 5-58 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

60 Rappel des objectifs Rappel des objectifs Savoir-faire Ecrire des formules simples Programmer des événements de champs Masquer des champs et paragraphes Utiliser les les Créer des boutons de masques et de vues Outils de mise au point Connaissance Les événements de masque Ce chapitre présente le langage de formules dans les situations d emploi simples et courantes : événements attachés à un masque, à un champ et dans les colonnes calculées et les sélections de documents d une vue. La création de boutons d actions dans un masque et dans une vue ainsi que les actions partagées sont également abordées. L utilisation des outils de débogage très simples est recommandée dans la suite du cours. Résumé du chapitre Présentation du langage Le langage de formules est disponible depuis les toutes premières versions de Domino/Notes. Il a été conçu dès le départ pour effectuer des traitements très simples. Au fil des versions, les applications Notes sont devenues complexes car plus ambitieuses et le langage de formules a évolué en conséquence. Les Les sont fournies en standard avec Designer et permettent d accomplir simplement des traitements pouvant être complexes : capitalisation d une chaîne de caractères, récupération du nom de l utilisateur courant Champ : valeur par défaut La valeur par défaut fixe la valeur initiale d un champ modifiable : C est une expression codée dans l événement Valeur par défaut du champ modifiable, Cette expression ne s exécute qu une seule fois à la création du document et avant que l utilisateur puisse commencer la saisie, L expression retourne une valeur que Notes se charge de stocker dans le champ. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-59

61 Champ : conversion d entrée La conversion d entrée modifie la valeur saisie dans un champ modifiable : C est une expression codée dans l événement Conversion d entrée du champ modifiable, L expression de préférence au nom du champ comme variable, Cette expression s exécute à chaque enregistrement (commande Fichier/Enregistrer ) et calcul (commande Vue/Mettre à jour ou touche F9) du document, L expression retourne une valeur que Notes se charge de stocker dans le champ. Champ : validation d entrée La validation d entrée bloque l enregistrement du document si la valeur saisie dans un champ modifiable est reconnue fausse : C est une expression codée dans l événement Validation d entrée du champ modifiable, L expression de préférence au nom du champ comme variable et éventuellement le nom d autres champs corrélés, Cette expression s exécute à chaque enregistrement (commande Fichier/Enregistrer ) et calcul (commande Vue/Mettre à jour ou touche F9) du document, L expression retourne un booléen VRAI ou FAUX que Notes interprète pour autoriser ou interdire l enregistrement du sert à tester le contenu d un champ texte, nombre ou date/heure. Champ calculé : valeur Le contenu d un champ calculé est déterminé par une formule et il n est pas modifiable par l utilisateur. Il existe trois types de champs calculés calculé, calculé à la création, calculé à l affichage, chacun ayant un style de codage des formules qui lui est propre. Un champ calculé à l affichage n est pas enregistré dans le document, Un champ calculé à la création n est évalué qu une seule fois par le masque. Notes effectue les calculs du haut vers le bas et de gauche à droite : il faut en tenir compte pour disposer les champs sur le masque. Calculer avec des dates Calculer avec les dates consiste à effectuer un décalage dans le utiliser des valeurs convertir du texte ou du nombre extraire une partie de la calculer un Les événements du masque Un masque est chargé pour créer un document et pour visualiser ou modifier un document existant. Lorsqu un document est en création/modification, l utilisateur le sauvegarde ou demande à rafraîchir les formules en utilisant la touche F9 ou l icône de rafraîchissement. Dans chacun de ces cas une suite d événements de masque et de champs sont exécutés dans un ordre déterminé. La valeur par défaut d un champ modifiable n est exécutée qu une seule fois à la création du document, 5-60 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

62 La validation d entrée s exécute après la conversion d entrée, L événement valeur d un champ calculé n est exécuté que si le document est en mode modification. Le titre de fenêtre Le Titre de fenêtre est un événement de masque qui détermine le texte apparaissant dans la partie supérieure droite de la fenêtre Notes. Ce texte identifie également les boutons de tâches lorsque plusieurs fenêtres sont ouvertes. Il est recommandé de créer un texte explicite tout en restant court pour faciliter la navigation. Cet événement s exécute à la création, à l affichage et à l enregistrement d un document. Les Les menus de l interface utilisateur Notes ont une équivalence en Ceci permet, par formule, de déclencher une action normalement effectuée depuis un menu. Les sont très utilisées dans des boutons de masques et de vues. Créer un bouton dans un masque Les boutons définis dans les masques apparaissent dans la barre de boutons dans la partie supérieure du document immédiatement en dessous de la barre de tâches. L utilisation de boutons dans les masques offre plusieurs avantages : l utilisateur n a pas besoin de connaître les menus de Notes, les boutons peuvent s afficher selon le contexte du document (visualisation, modification ) et selon les droits de l utilisateur, l application n a pas besoin de tenir compte du logiciel client Notes ou navigateur d autant plus qu un navigateur n a pas accès aux menus. Masquer un paragraphe, un bouton Les interfaces de saisie boutons radio et cases à cocher ne doivent être utilisées que si le document est en mode modification. En mode de visualisation simple, l affichage du contenu du champ est suffisant. Un bouton d action exécutant la de fermeture de fenêtre a un sens quel que soit l état du document, visualisation simple ou modification. Le bouton exécutant la d enregistrement du document dans la base n a de sens que si le document est en mode édition. Il faut donc le cacher si le document est en mode de visualisation simple. Formule de sélection d une vue La formule de sélection d une vue détermine quels documents font partie de l index de la vue et sont affichés. Une formule de sélection s écrit : avec le mot-clé obligatoire SELECT, suivi d une expression logique qui retourne un booléen 1 (VRAI) ou 0 (FAUX). La sélection des documents d une vue s appuie d abord sur la formule de sélection puis sur la capacité de n afficher qu une catégorie de la vue ou certains documents dans une vue de type Agenda avec la Les doivent être utilisées avec précaution dans une vue surtout si cette dernière affiche un grand nombre de documents. Le passage par des variables de travail et des recettes associées à des mises à jour programmées de l index de la vue sont alors nécessaires. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-61

63 Formule de colonne calculée Le contenu d une colonne calculée est déterminé par une formule. Le résultat du calcul est enregistré dans l index de la vue à chaque réindexation de la vue lorsque le contenu du document est modifié. Ce mécanisme assure que l information affichée dans la vue est la plus récente. Créer un bouton d action dans une vue La procédure de création du bouton d action dans une vue ou dans un dossier est en tous points semblable à la procédure de création du bouton d action dans un masque. Le jeu des utilisées n est pas le même. Créer une action partagée Un nombre important d actions se répète à l identique dans les masques et les vues : fermeture de la fenêtre Notes, passage du document en mode modification, impression Il est alors intéressant de définir l action une seule fois le texte du bouton, l image associée, la ou les commandes et de référencer cette action dans les masques et les vues. Toute modification ultérieure de l action sera répercutée automatiquement dans tous les masques et les vues qui l utilisent. Cette démarche est identique à celle qui a consisté à définir des ressources images. Dans le cas des actions, on définit des ressources actions partagées. Outils de débogage Dans les versions actuelles, il n y a pas d outil de mise au point débogage des formules, des agents écrits en Java ou du code JavaScript. Le seul outil disponible l est en LotusScript. Dans le langage de formules il faut recourir à des affichages du contenu des variables avec la La mise en commentaire de blocs d instructions avec REM est également utile. Les formules peuvent aussi être testées dans un champ de type Texte. Récapitulatif syntaxique Le langage de formules comme tout langage informatique manipule des variables et des constantes à l aide d opérateurs. Le langage utilise également des éléments qui lui sont propres : mots-clés, Points essentiels La cinématique de Notes l ordre dans lequel sont effectués les calculs et le style de programmation des événements sont les deux points essentiels du module. Ordre d évaluation des formules Les formules s exécutent lors de la création d un document, lorsqu il est enregistré, calculé et chargé en visualisation. Selon ces situations, seules certaines formules sont exécutées selon les événements auxquels elles sont rattachées. Dans tous les cas, les formules des événements de champs s exécutent du haut vers le bas et de gauche à droite. Les événements de masque s exécutent soit avant soit après les événements de champs. Evénement A un champ modifiable ou calculé et au masque sont attachés des événements. La dernière instruction codée dans un événement doit retourner une valeur que Notes se charge d affecter. Cette instruction s appelle l expression principale Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

64 Protection des formules Lorsqu une formule utilise une il faut veiller à ce que la ne soit exécutée que lorsque tous les paramètres dont elle a besoin sont renseignés s ils sont de type nombre ou texte. Champs calculés champ calculé : évalué à chaque calcul et enregistrement du document, physiquement présent dans le document, champ calculé à la création : évalué une seule fois, à la création du document, avant même que l utilisateur ait pu saisir une information, physiquement présent dans le document, champ calculé à l affichage : évalué à la création, au chargement et à l enregistrement du document. Il est physiquement absent du document. Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-63

65 QCM 5 QCM 5 Pour commencer Evénements de champ Valeur par défaut, conversion d entrée, validation d entrée, valeur Evénements de masque Boutons d actions Programmer dans une vue Sélection, colonne calculée/masquée, couleurs programmées Une liste de réponses est proposée pour chaque question posée. Cocher la ou les réponses correctes. 1. Pour commencer 1.1 Une formule met en jeu des calculs arithmétiques A. Les variables utilisées sont déclarées numériques B. Une variable est numérique après affectation d un nombre C. Les variables sont toutes de type texte et le langage opère la conversion D. Les variables sont de type texte et numérique, le langage opérant une conversion quand c est possible E. Une variable prend le type de l expression à droite de l opérateur d affectation F. Le concepteur est responsable du contenu des variables 1.2 Lors de la frappe du nom d une variable A. Il faut tenir compte des majuscules et minuscules, sinon le langage crée automatiquement de nouvelles variables. Par exemple datecreation et DateCreation sont considérées comme deux variables différentes B. Le langage ne tient pas compte des majuscules et des minuscules pour les variables de travail. Les noms de champs doivent respecter les majuscules et minuscules C. Le langage ne tient jamais compte de la casse majuscules et minuscules mais toujours de la dyslexie 1.3 Une variable de travail A. Ne peut recevoir qu une seule valeur dans une opération d affectation B. Peut recevoir plusieurs valeurs de même type C. Peut recevoir plusieurs valeurs de tout type (texte, numérique, date) 5-64 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

66 1.4 Quelles sont les expressions correctes? A. tmp := TSOFT ; B. tmp := [TSOFT] ; C. tmp := 4 ; D. tmp := {4} ; E. tmp := [23/12/2003] ; F. tmp := {23/12/2003} ; G. tmp := [12:10:00 23/12/2003] ; H. tmp := [23/12/ :10:03] ; 1.5 Dans quel cas la variable temporaire tmp contient-elle une date en format texte? A. tmp := {23/12/2003} ; B. tmp := [23/12/2003] ; 1.6 Quelles sont les expressions correctes? A. tmp := 4 + 5; B. tmp 4 ) + 5; C. SELECT nom := TSOFT D. SELECT datereunion >= [01/01/2003] 1.7 Le champ titre contient le texte «les nouveautés de TSOFT». Pour le transformer en «Les Nouveautés de Tsoft», quelle formule appliquer? B. tmp D. tmp = titre 2. Evénements de champs 2.1 La formule de l événement valeur par défaut peut-elle A. Prendre en compte la saisie de l utilisateur dans un champ précédent B. Etre appelée avec un bouton C. Etre modifiée ou effacée par l utilisateur 2.2 La formule de l événement conversion d entrée s exécute A. A chaque enregistrement du document B. Lorsque le curseur sort du champ C. Lorsque les formules du masque sont calculées en appuyant sur la touche F9 D. Lorsque l utilisateur a effectivement entré une valeur 2.3 La formule de l événement conversion d entrée peut contenir A. La référence à un nom de champ de saisie précédent B. La référence au champ courant sans mentionner son nom Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-65

67 C. Une D. Un test du contenu du champ courant et l envoi d un message 2.4 La formule de l événement validation d entrée s exécute A. A chaque enregistrement du document B. Lorsque le curseur sort du champ C. Lorsque les formules du masque sont calculées en appuyant sur la touche F9 D. Lorsque l utilisateur a effectivement entré une valeur E. Avant l événement conversion d entrée F. Après l événement conversion d entrée 2.5 La formule de l événement validation d entrée peut contenir A. La référence à un nom de champ de saisie précédent B. La référence au champ courant sans mentionner son nom C. Une D. Un test de contenu du champ courant 2.6 Les formules des événements de champs modifiables du masque s évaluent de gauche à droite et de haut en bas lorsque l utilisateur enregistre un document dans l ordre suivant A. En un balayage : champ par champ, les trois événements valeur par défaut, conversion d entrée et validation d entrée B. En trois balayages : tous les événements valeur par défaut, puis conversion d entrée, puis validation d entrée C. En deux balayages : tous les événements conversion d entrée, puis validation d entrée D. En un balayage : champ par champ, les deux événements conversion d entrée et validation d entrée 2.7 Un masque contient des champs calculés et modifiables. Les formules des événements de champs s évaluent de gauche à droite et de haut en bas lorsque l utilisateur enregistre un document dans l ordre suivant A. En un balayage : champ par champ, l événement valeur pour un champ calculé puis les événements conversion d entrée et validation d entrée pour un champ modifiable B. En deux balayages : tous les événements valeur des champs calculés puis les événements conversion d entrée et validation d entrée des champs modifiables C. En deux balayages : tous les événements valeur des champs calculés et les événements conversion d entrée des champs modifiables, puis les événements validation d entrée des champs modifiables D. En deux balayages : tous les événements valeur des champs calculés et les événements validation d entrée des champs modifiables, puis les événements conversion d entrée des champs modifiables 2.8 L événement valeur par défaut d un champ modifiable fait référence à un champ calculé à la création du masque A. L ordre des champs dans le masque n a pas d importance B. Le champ calculé doit être avant le champ modifiable C. Le champ calculé peut être après le champ modifiable 5-66 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

68 2.9 Les formules sont généralement protégées dans les événements A. Conversion d entrée d un champ modifiable B. Valeur d un champ calculé C. Valeur d un champ calculé à la création D. Validation d entrée d un champ modifiable E. Valeur d un champ calculé à l affichage 2.10 La date de règlement d une facture est de 60 jours à partir de la date d émission de la facture. Le ou les opérateurs et utilisables sont B. Opérateur d addition : DateEmission calcule le nombre de jours ouvrés entre deux dates A. En accédant aux jours de congés de l annuaire et en enlevant deux jours par semaine, samedi et dimanche par défaut B. D après un paramètre de la fonction indiquant les jours ouvrés de la semaine C. D après un paramètre de la fonction indiquant les jours calendaires à exclure D. D après un paramètre de la fonction indiquant les jours de la semaine à exclure 3. Evénements de masque 3.1 L utilisateur a saisi un nouveau document et l enregistre pour la première fois. Une formule ou un programme LotusScript qui s exécute dans l événement onsubmit du masque (anciennement QuerySave) accède aux valeurs A. Des champs modifiables tels que les a saisis l utilisateur B. Des champs modifiables après exécution de la conversion d entrée C. Des champs calculés et calculés à l affichage d après ce qu a saisi l utilisateur D. Des champs calculés et calculés à l affichage après chargement du masque 3.2 L utilisateur crée un nouveau document. Une formule ou un programme LotusScript qui s exécute dans l événement onload du masque (anciennement PostOpen) accède aux valeurs A. Des champs modifiables tels que les a saisis l utilisateur B. Des champs modifiables avant saisie (il n y a que les valeurs par défaut) C. Des champs calculés et calculés à l affichage après chargement du masque 3.3 La retourne le booléen Vrai A. Tant que l utilisateur n a pas enregistré et fermé le document en cours de création B. Tant que l utilisateur n a pas enregistré le document en cours de création 3.4 La peut être utilisée A. Dans l événement onsubmit du masque (anciennement QuerySave) B. Dans l événement PostSave du masque Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-67

69 3.5 Le document est en mode visualisation. Un champ modifiable de type bouton radio doit être redéfini pour afficher simplement le contenu de l item. Celui-ci est du type A. Modifiable. Le nom du champ de type bouton radio est dans l événement valeur par défaut B. Modifiable. Le nom du champ de type bouton radio est dans l événement conversion d entrée C. Calculé. Le nom du champ de type bouton radio est dans l événement valeur D. Calculé à l affichage. Le nom du champ de type bouton radio est dans l événement valeur 4. Boutons d actions Quelles propositions sont vraies? A. La formule d un bouton d action se termine par une B. Un bouton d action de masque peut être masqué par une formule C. Notes masque automatiquement les boutons d actions lorsque le contexte ne permet pas l exécution de la D. Les actions système peuvent être remplacées par des actions partagées car elles ont chacune une correspondance avec une E. Une action case à cocher ne peut référencer qu un champ modifiable du masque F. Une action case à cocher peut référencer tout item du document affiché 5. Programmer dans une vue 5.1 Une vue est publique. Quelles propositions sont vraies? A. Tous les noms d items d un document peuvent être référencés dans une formule de colonne calculée B. Tous les noms d items d un document peuvent être référencés dans la formule de sélection de vue C. Les noms d items d un document ne peuvent être référencés dans la formule de sélection de vue que s ils ont une correspondance avec un champ du masque qui a servi à créer le document D. Une colonne de vue peut être masquée en tenant compte du nom de l utilisateur E. La formule de sélection de la vue peut faire référence au nom de l utilisateur 5.2 Quelles propositions sont vraies? A. La colonne calculant la couleur à afficher retourne les trois valeurs RVB séparées par le caractère deux-points ( : ) B. La couleur retournée par une colonne s applique à toutes les colonnes de la vue quelle que soit sa position C. La couleur retournée par une colonne s applique à toutes les colonnes de la vue à droite de la colonne D. La couleur retournée par une colonne peut venir d un item du document créé avec un champ de type Couleur du masque E. Une vue peut utiliser les actions partagées existantes utilisées dans des masques pourvu que les soient applicables au contexte de la vue 5-68 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

70 Atelier 5 Atelier 5 Objectifs : Programmer les événements de champ et de masque Programmer les sélections et colonnes calculées de vue Créer des boutons de masque et de vue, des boutons partagés Durée : 2 heures 15 minutes Exercice 1 : Gérer la saisie dans les champs 25 mn Etapes Des contrôles de saisie, une standardisation de la saisie sont introduits dans le masque de saisie Ordre du jour. Mettez en place les règles de gestion qui suivent : Champ Défaut Conversion Validation Organisateur Utilisateur courant Obligatoire ObjetReunion NomProjet Categories TypeReunion Participants DateReunion 7 jours après la date de création Enlever espaces superflus Enlever espaces superflus, lettres minuscules sauf la première de chaque mot Obligatoire Obligatoire Obligatoire Obligatoire Obligatoire Obligatoire HeureDebutReunion 9h30 Obligatoire HeureFinReunion LieuReunion Veillez à minimiser l utilisation des noms de champs dans les formules Obligatoire Obligatoire Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-69

71 Procédures Reportez-vous aux pages 5-4 à Exercice 2 : Etude des événements 15 mn Etapes Cet atelier consiste à étudier la séquence des événements de masque et de champ en utilisant la base Designer 6.0 Démonstrations. Ouvrez la base dans Designer Ouvrez le masque Masque\Evénements en mode conception Etudiez la disposition des champs et lisez le contenu des événements des champs : ils contiennent qui affichera un dialogue lorsque l événement s exécutera Cliquez sur l événement Titre de fenêtre du masque : la même méthode est utilisée pour tracer l exécution de l événement, de même que tous les événements du masque Prévisualisez le masque dans Notes et notez la séquence des événements, ainsi que le moment où le document créé est affiché à l utilisateur Enregistrez le document et notez la séquence des événements Appuyez sur la touche F9 et notez la séquence des événements Fermez le document et notez la séquence des événements Ouvrez la base Designer 6.0 Démonstrations dans le client Notes et ouvrez un document Evenements : notez la séquence des événements Passez le document en mode modification et notez la séquence des événements 5-70 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

72 Exercice 3 : Effectuer des calculs dans des champs 20 mn Etapes Le champ DureeReunion est modifié comme suit : il est calculé d après l heure de début et l heure de fin de la réunion Créez un champ DateCreation qui affiche la date de création du document Le champ AuteurDoc devrait contenir le nom de l utilisateur qui a créé le document et ne pas être modifiable Le bouton de tâche doit afficher Nouvel ordre du jour à la création du document, l objet de la réunion pour un document existant Procédures Reportez-vous aux pages 5-28 à Exercice 4 : Cacher, ajouter des boutons de masque 25 mn Etapes Créez les boutons suivants dans le masque Ordre du jour Bouton Fonction Visibilité Modifier Mise en mode modification du document affiché Quitter Fermer la fenêtre Notes Toujours Imprimer Imprimer le document Toujours Document en visualisation Orthographe Vérifier l orthographe Document en modification Enregistrer Enregistrer le document Document en modification Créez des champs supplémentaires pour que l interface de saisie des champs qui suivent n apparaisse pas en mode visualisation du document : DateReunion, HeureDebutReunion, HeureFinReunion, LieuReunion Procédures Reportez-vous aux pages 4-20 à Exercice 5 : Créer des actions partagées 25 mn Etapes Créez les actions partagées suivantes Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-71

73 Bouton Fonction Visibilité Modifier Mise en mode modification du document affiché Quitter Fermer la fenêtre Notes Toujours Imprimer Imprimer le document, la vue Toujours Document en visualisation Orthographe Vérifier l orthographe Document en modification Enregistrer Enregistrer le document Document en modification Créer Ordre du jour Créer un nouvel Ordre du jour Toujours Modifier les vues Réunions\1. Par date et Réunions\2. Agenda réunions pour insérer les boutons d actions partagées : Quitter, Imprimer, Créer Ordre du jour Modifier les vues Codes\1. Nom de projet et Codes\2. Types de réunions pour insérer les boutons d actions partagées : Quitter, Imprimer, Modifier Procédures Reportez-vous aux pages 5-37 à Exercice 6 : Utiliser les outils de débogage 25 mn Etapes Dans l événement valeur du champ DureeReunion, pour afficher le contenu des variables HeureDebutReunion et HeureFinReunion Créez un document puis enregistrez-le et notez ce que Création d une base de test des formules Créez une base vide sur le serveur en l appelant Formules Créez un masque appelé Formules contenant un champ nommé Titre de type texte un champ nommé Body de type texte riche un champ nommé Exec de type texte Créez un bouton d action dans le masque intitulé Supprimer RC et contenant la formule suivante Créez une vue affichant tous les documents de la base et le champ Titre de chaque document 5-72 Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement

74 Créez un nouveau document Formules et complétez-le comme suit Titre Formule Exécution <Titre> : tapez un titre pour identifier facilement l exemple par la suite, par ;@UserName) <Body> : tapez une formule en deux instructions séparées par un point-virgule et un retour à la ligne, par exemple la formule indiquée sur la figure <Exec> : copiez/collez le contenu de <Body> dans <Exec> Cliquez sur le bouton (Supprimer RC) : le champ <Exec> a alors l apparence qu il a sur la figure Appuyez sur - -F9. Le champ <Exec> affiche alors la valeur retournée par la formule Procédures Reportez-vous aux pages 5-51 à Tsoft/Eyrolles Lotus Domino Designer 6 : Bases du développement 5-73