Lotus Domino Designer 6 Bases du développement Accéder aux données

Transcription

1 Lotus Domino Designer 6 Bases du développement Accéder aux données Ce fac-similé contient la table des matières, le préambule et le début d un chapitre. Auteur Jean François Rouquié GUIDE DE FORMATION

2 La marque Tsoft est une marque déposée. La collection des guides de formation Tsoft est éditée par la société Tsoft. Toutes les marques citées dans cet ouvrage sont des marques déposées par leurs propriétaires respectifs. Ce livre n est pas le manuel de IBM/Lotus Designer 6 et son contenu n engage pas la société IBM. Tous les efforts ont été faits par Tsoft pour fournir dans cet ouvrage une information claire et exacte à la date de parution. Tsoft n assume de responsabilités, ni pour son utilisation, ni pour les contrefaçons de brevets ou atteintes de tierces personnes qui pourraient résulter de cette utilisation. L auteur peut être contacté à l adresse jean-francois.rouquie@wanadoo.fr. Guide de formation Tsoft Lotus Domino Designer 6 Bases du développement : Accéder aux données Référence : TS0065 Décembre 2003 Ce pictogramme mérite une explication. Son objet est d alerter le lecteur sur la menace que représente pour l avenir de l écrit, particulièrement dans le domaine de l édition technique et universitaire, le développement massif du photocopillage. Le Code de la propriété intellectuelle du 1 er juillet 1992 interdit en effet expressément la photocopie à usage collectif sans autorisation des ayants droit. Or, cette pratique s est généralisée dans les établissements d enseignement supérieur, provoquant une baisse brutale des achats de livres et de revues, au point que la possibilité même pour les auteurs de créer des œuvres nouvelles et de les DANGER faire éditer correctement est aujourd hui menacée. Nous rappelons donc que toute reproduction, partielle ou totale, de la présente publication est interdite sans LE PHOTOCOPILLAGE autorisation du Centre TUE LE LIVRE français d exploitation du droit de copie (CFC, 20 rue des Grands-Augustins, Paris).

3 Avant-propos Lotus Domino 6.0 et 6.5 sont les successeurs d une lignée de serveurs de groupware. Ils sont maintenant le pilier E-collaboration de l offre logicielle d IBM et entament l intégration dans les architectures J2EE et IBM Instant Messaging. Les entreprises installent des intranets pour diffuser l information. En fait d informations, il s agit souvent de connaissances qu il faut mettre en forme et cibler vers des populations déterminées d utilisateurs. Lotus a été également le pionnier du Knowledge Management. Domino est une composante de la réponse technologique de IBM/Lotus pour l intranet et la gestion des connaissances. Lotus Notes a été conçu comme un outil de développement d applications groupware organisées en bases de documents. La base de documents est réellement le concept unificateur de Domino/Notes : toute information est inscrite dans un document lequel est enregistré dans une base. Le serveur Domino fournit des services tels que les accès multiples à une même base, le routage des documents d une base vers une autre, la réplication de bases entre serveurs ou entre un serveur et un client. Le développement d applications ne repose donc pas uniquement sur l apprentissage d un langage parce qu il met en jeu un cocktail : Une gestion de bases de documents : mécanismes d accès, de partage Des services sur le serveur Domino : sécurité, routage, réplication Plusieurs langages, disponibles selon le contexte, dont JavaScript et Java. L accès aux bases de données de l entreprise : Oracle, DB2, Sybase L accès aux applications de l entreprise : SAP L accès depuis des serveurs d applications J2EE IBM WebSphere Application Server, Tomcat aux bases Domino par des balises JSP. Domino est l exemple type d un serveur d applications dans une architecture client/serveur à trois niveaux. Le développement d applications avec Domino/Notes est un monde à l intérieur duquel il faudra faire des choix d après les objectifs et les impératifs de l entreprise. Par ailleurs, le développement des applications Notes est inséparable de l administration des serveurs Domino. Il est recommandé au développeur qui veut Tsoft Lotus Domino Designer 6 : Accéder aux données AP-1

4 Avant-propos s aguerrir de suivre un cours d initiation à l administration de Domino. La collection TSOFT/Eyrolles propose un ouvrage intitulé «Domino 6.0 : Administration» qui complète le présent ouvrage. Cet ouvrage Atelier accès aux données est le troisième d une collection qui étudie le développement d applications Lotus Domino/Notes 6 : Développer une base de partage : apprentissage des briques de base du développement en réalisant une application de suivi de projet, Développer un workflow : approfondir les connaissances en mettant en place une application de workflow simple dont l analyse est fournie en diagrammes UML, Accéder aux données : comment accéder aux données ODBC et aux bases relationnelles de la façon la plus simple. Un autre ouvrage Lotus Designer 6. Atelier de développement Web sera consacré uniquement au développement d applications accédées depuis un navigateur. A qui s adresse l ouvrage? Cet ouvrage est basé sur la version française de Lotus Domino et peut être utilisé sans modification avec la version 6.5 du logiciel. Il s adresse : aux centres de formation et sociétés de services qui proposent à leurs clients des formations au développement avec Lotus Domino Designer 6, aux personnes ayant suivi les cours IBM Lotus qui cherchent un ouvrage de référence, aux développeurs d applications Lotus Domino 5 qui veulent mettre à jour leurs connaissances en auto-formation, aux CLP Certified Lotus Professional qui préparent l examen de passage à la certification de la version 6. Contenu pédagogique Les trois parties de cet ouvrage se proposent de vous apprendre les bases du développement Lotus Domino Designer pour que vous soyez en mesure de créer des bases de collaboration et que vous puissiez aborder l étude des langages LotusScript, Java et JavaScript dans l environnement de Designer. L ouvrage vous apprendra à utiliser les mécanismes élémentaires du développement qui vous seront indispensables quelle que soit l orientation que vous prendrez ensuite pour développer vos propres applications : Accéder aux données externes par ODBC, Accéder en temps réel aux données relationnelles avec DECS et DCR, Comprendre l utilisation de XML pour l échange de données. Un renvoi vers l aide disponible en ligne dans une base Notes lorsque des points méritent un approfondissement pour qui voudra aller plus loin. Ces renvois sont signalés par une loupe dans la marge, par exemple : Table des matières Structure d une application Création d une application Création de bases de documents Un renvoi vers la base de démonstration fournie pour illustrer certains points du cours. Ils sont signalés par une icône spéciale, par exemple : Designer 6.0 Démonstrations/Masques/ ODBC\Dialogue affichant Customer.dbf AP-2 Tsoft Lotus Domino Designer 6 : Accéder aux données

5 Avant-propos L ensemble a été conçu de façon suffisamment modulaire pour pouvoir construire plusieurs cursus de formation :!Préambule. Ce support peut être utilisé pour suivre un cours dans un centre de formation, mais aussi par quelqu un qui veut s auto-former. C est également un ouvrage de référence destiné à être consulté pour surmonter les difficultés inhérentes à l utilisation d un logiciel puissant. Le langage utilisé est celui dit de «formules». Ce langage est très simple et a été retenu de préférence au langage LotusScript ou JavaScript, ou encore Java, pour deux raisons : L objectif du cours est de faire comprendre et assimiler des mécanismes fondamentaux sans s encombrer des arcanes syntaxiques d un langage évolué, Le langage de formules est toujours disponible et reste parfaitement utilisable pour apporter une réponse simple à des questions simples. Les langages évolués sont présentés d une façon sommaire dans l introduction. L administration Domino est mise en pratique au travers de l installation du serveur Domino décrite en annexe. Elle est aussi abordée dans les parties traitant de la sécurité, du routage des documents et du fonctionnement des agents. Il est donc souhaitable d installer le client Domino Administrator pour essayer les procédures proposées. Comment le support est-il conçu? Modularité L ensemble a été conçu de façon suffisamment modulaire pour pouvoir construire plusieurs cursus de formation!préambule. Les modules suivent une chronologie qui peut être modifiée par un instructeur averti. Plan d un module La progression d un module est indiquée sur la première page après les objectifs. La place des ateliers est indiquée dans la progression. Il est conseillé de les faire au fur et à mesure. Informations de référence L exposé d un principe une diapositive et un commentaire est généralement suivi de la description de la procédure à mettre en œuvre. Les procédures sont identifiées par le mot Référence dans le titre ce qui permet de les retrouver ultérieurement. Le support sert ainsi d ouvrage de référence destiné à être consulté pour surmonter les difficultés inhérentes à l utilisation d un logiciel puissant. Ateliers Les ateliers sont une mise en œuvre immédiate de concepts et de procédures. Ils se présentent sous forme d activités dirigées avec des instructions précises ou comme des exercices demandant de la réflexion et de la prise d initiatives. Le temps à consacrer à chaque atelier est indiqué. C est un élément de référence qui permet d évaluer le temps consacré à la lecture et à la mise en pratique d un module. Chacun avance à sa propre allure : si le temps paraît trop juste, on peut aussi se dire que la lenteur est une stratégie éprouvée d acquisition et de maîtrise des connaissances. Tsoft Lotus Domino Designer 6 : Accéder aux données AP-3

6 Avant-propos QCM et rappel des objectifs Chaque module se termine par un rappel des objectifs suivi du résumé de chaque paragraphe. Ce rappel aide le lecteur à construire la synthèse de ce qui a été vu. Un QCM termine également le module. L objectif est de tester la compréhension des principes : il n y a pas de questions exigeant une connaissance détaillée des procédures ou de l interface. Le QCM peut être déroulé avec profit dans les 24 heures qui suivent la fin d un module. Un instructeur peut s en servir comme matériau pour procéder à la séance de rafraîchissement de mémoire qui ouvre souvent la journée de cours. Et les certifications? Les personnes désirant passer les certifications Lotus trouveront sur le site le descriptif des compétences requises pour les examens ainsi que les sources d informations disponibles. Six examens préparent à la certification : Examen Titre 610 Notes Domino 6 Application Development foundation Skills 611 Notes Domino 6 Application Development Intermediate Skills 612 Notes Domino 6 : Developing Web Applications 513 Using JavaScript in Notes Domino Applications 273 LotusScript in Notes for Advanced Developers 516 Using Java in Notes Domino Applications Titre TSOFT Développer une base de partage Développer un workflow Développer un workflow Module 13 Atelier de développement Web non disponible non disponible non disponible Les certifications Lotus ont été modifiées en 2003 pour s harmoniser avec les certifications IBM. Les titres des certifiés sont : IBM Certified Associate Developer Lotus Notes and Domino 6 IBM Certified Application Developer Lotus Notes and Domino 6 IBM Certified Advanced Application Developer Lotus Notes and Domino 6 Les nouveaux titres correspondent respectivement à Certified Lotus Specialist (CLS), Certified Lotus Professional (CLP) et Principal Certified Lotus Professional (PCLP). Titre IBM Certified Associate Developer 610 Examens IBM Certified Application Developer 610, 611, 612 IBM Certified Advanced Application Developer 513, 276, 516 Pour passer avec succès ces examens, la pratique est absolument indispensable parallèlement à la consultation de la base d aide d administration et des informations disponibles sur Internet. Consultez la liste des compétences requises disponibles sur le site Web de Lotus, AP-4 Tsoft Lotus Domino Designer 6 : Accéder aux données

7 Avant-propos Mettez en pratique les connaissances acquises pour construire une application opérationnelle, Consultez les RedBooks d IBM qui sont l œuvre de groupes de spécialistes d horizons divers et qui contiennent des informations pratiques parfois absentes de la documentation officielle, Consultez le site LDD Lotus Developer Domain Tsoft Lotus Domino Designer 6 : Accéder aux données AP-5

8

9 Table des matières AVANT-PROPOS... AP-1 PREAMBULE...P-1 Plan : Atelier accès aux données... P-3 Parcours pédagogiques... P-4 Ateliers... P-5 Timing : Atelier accès aux données... P-6 MODULE 1 : ACCEDER AUX DONNEES EXTERNES Accéder à des données par ODBC Référence. Configuration ODBC avec ODBC avec ODBC avec ODBC DECS. Principe DB2. Installation du serveur DB2. Installation du client DECS. Installation et configuration DECS. Création d une connexion DECS. Relier un masque à une activité DECS. Options avancées de l activité Ressource de connexion de données (DCR) Lotus Enterprise Integrator (LEI) XML. Services Web XML. Terminologie Tsoft Lotus Domino Designer 6 : Accéder aux données T-1

10 Table des matières Domino XML (DXL) Rappel des objectifs ANNEXES...A-1 Annexe A : Installer la salle... A-3 Annexe B : Installer un poste isolé... A-29 Annexe C : A-39 Annexe D : A-57 Annexe E : Apports de la A-79 INDEX... I-1 T-2 Tsoft Lotus Domino Designer 6 : Accéder aux données

11 Module 3 : Préambule A l issue de ce cours, l utilisateur sait accéder aux données externes à Domino par formules et ODBC et avec DECS. Le cours a été écrit et testé avec la version CF1 française de Domino/Notes. Il peut être déroulé avec la version 6.5 de Domino/Notes sans modifications. Les nouveautés de la version 6.5 sont décrites en annexe. Elles concernent essentiellement une ergonomie améliorée de la messagerie depuis le client Notes et depuis un navigateur ainsi que l intégration de IBM Instant Messaging à la messagerie, autant de sujets qui n ont pas leur place dans ce cours. Support de formation Ce guide de formation est idéal pour être utilisé comme support élève dans une formation se déroulant avec un animateur dans une salle de formation, car il permet à l élève de suivre la progression pédagogique de l animateur sans avoir à prendre beaucoup de notes. L animateur, quant à lui, appuie ses explications sur les diapositives figurant sur chaque page de l ouvrage. Les procédures de mise en œuvre sont suffisamment détaillées pour que le formateur puisse concentrer ses explications sur l essentiel. Cet ouvrage peut aussi servir de manuel d auto-formation car il est rédigé à la façon d un livre, il est tout aussi complet. Il va beaucoup plus loin qu un simple support de cours. De plus, il inclut une quantité d ateliers conçus pour vous faire acquérir une bonne pratique du logiciel Lotus Notes Designer. Corrigés d ateliers et démonstrations Le fichier ExosDesigner6.zip téléchargé depuis contient les corrigés des ateliers, une base de démonstration, des feuilles de style CSS, des fichiers dbf. La base Designer 6.0 Démonstrations est comprise dans le fichier téléchargeable. Tsoft Lotus Domino Designer 6 : Accéder aux données P-1

12 Préambule Annexes Elle illustre certaines procédures du cours à l aide de masques, d agents, de vues ou d une combinaison de ces éléments. Un renvoi signale une démonstration disponible. Par exemple : Designer 6.0 Démonstrations/Masques/ ODBC\Dialogue affichant Customer.dbf renvoie au masque ODBC\Dialogue affichant Customer.dbf. Les annexes contiennent : L installation d une salle de cours, l installation du serveur Domino, sa configuration pas à pas et l installation des postes clients Notes et Designer, L installation d un poste isolé sans serveur Domino, Les listes de et de Les corrigés. P-2 Tsoft Lotus Domino Designer 6 : Accéder aux données

13 Préambule Plan : Atelier accès aux données Plan : Atelier accès aux données " M1 Accéder aux données externes # ODBC # DECS # DCR # LEI # XML Ce cours sous la forme d un atelier vient après Développer un workflow. Il aborde l ensemble des moyens utilisés pour accéder aux données externes depuis Domino. Les objectifs de connaissance et de savoir-faire sont indiqués pour chaque module. Module 1 : Accéder aux données externes Ce module aborde l accès aux données externes depuis Domino sous forme d un atelier pour la partie ODBC et DECS : les procédures sont détaillées et s appuient sur des exemples de la base Designer 6 Démonstrations. L installation d un serveur DB2 est également documentée pour que les exemples se rapprochent de cas réels. XML n étant pas utilisable avec le langage de formules, est simplement présenté dans le contexte de Domino. Les quelques manipulations simples disponibles depuis les menus de Designer sont décrites. Connaissance Echange de données par XML Lotus Enterprise Integrator (LEI) Savoir-faire Accéder aux données par ODBC en formules Mettre en œuvre DECS Mettre en œuvre une ressource d accès aux données Tsoft Lotus Domino Designer 6 : Accéder aux données P-3

14 Préambule Parcours pédagogiques Parcours pédagogique T1-1 Introduction T1-2 Méthodologie T1-3, 4, 5 Les bases T1-6 Fonctions avancées du masque A Initiation T2-1 Présenter l information T2-2 Gérer la navigation B Cosmétique T2-3 Gérer l accès à l application T2-4 Créer des agents T2-5 Développer un workflow T2-6 Mettre une base en production T2-7 Formules avancées C Workflow T3-1 Données externes D Accès données (C) TSOFT - Lotus Domino Designer 6 : Développer une base de partage Préambule - 4 Les modules peuvent être assemblés de diverses façons pour construire des cursus de formation adaptés. La numérotation des modules est celle des trois tomes des Bases du développement : Développer une base de partage (T1), Développer un Workflow (T2) et Accéder aux données (T3). Cursus Savoir-faire A B Initiation : développer une base simple de partage Améliorer la présentation de l information Cursus prérequis A Suivre les modules dans les différents titres Tsoft 1 à 6 de Développer une base de partage (2 est optionnel si UML est connu) 1 et 3 de Développer un Worflow C Développer un workflow A 3, 4, 5, 6, 7 de Développer un Workflow Compléments de programmation en langage de formules A 7 de Développer un Workflow Mettre une base en exploitation A 6 de Développer un Workflow D Accéder aux données externes A Accéder aux données Le module 2 est une présentation d UML et de sa mise en pratique dans le cadre d une application Lotus Domino développée en langage de formules. Les personnes qui connaissent la modélisation UML n ont pas besoin de le suivre. A partir du module A Initiation, tous les autres modules sont accessibles et peuvent être ordonnés selon les besoins et les préférences de chacun. La formation complète représente dix jours de formation en trois sessions. Le fil conducteur fourni donne un découpage de temps type correspondant à une formation animée par un instructeur. P-4 Tsoft Lotus Domino Designer 6 : Accéder aux données

15 Préambule Ateliers Des ateliers sont proposés à la fin de chacun des modules. La première page d un module annonce les objectifs, le plan et la place des ateliers dans le déroulement des modules. La place des ateliers est également mentionnée dans le fil conducteur du cours. Les fichiers nécessaires sont dans l auto-extractible ExosDesigner6.zip téléchargé depuis Les ateliers sont découpés en exercices avec : 1. L objectif général de l exercice et le temps approximatif alloué. Exercice 5 : Créer des tableaux, insérer des images 25 mn 2. Les étapes à suivre pour atteindre l objectif Etapes Instructions 3. Un renvoi aux procédures à appliquer Procédures Reportez-vous aux pages 9-20 à Tsoft Lotus Domino Designer 6 : Accéder aux données P-5

16 Préambule Timing : Atelier accès aux données Cet atelier se déroule en un jour. Le fil conducteur donné ici est indicatif. Il est adapté par chacun en fonction de son style personnel, et du niveau et des attentes des participants. L atelier développe l accès aux données externes. Le support ne comporte pas de paragraphe d atelier séparé, les exercices étant intégrés au cours. Le fil conducteur fait la part entre la partie théorique et la partie travaux pratiques. Etape Présentation, relevé des attentes 30 Présentation du plan de cours et des objectifs Module 1. Accéder aux données externes Introduction 5 Accéder aux données par ODBC 5 Durée Notes personnelles 15 Atelier Configuration ODBC 20 Fichers dbf à installer sur avec ODBC 5 avec ODBC avec ODBC 5 avec ODBC 15 Pause avec ODBC 5 avec ODBC 15 DECS : principe 10 Atelier DB2. Installation du serveur 20 Uniquement sur le serveur de la salle Atelier DB2. Installation du client 20 Atelier DECS. Installation et configuration Pause repas DECS. Création d une connexion 5 Atelier DECS. Création d'une connexion DECS. Relier un masque à une activité 5 Atelier DECS. Relier un masque à une activité 15 Uniquement sur le serveur de la salle DECS. Options avancées de l activité 10 Ressource de connexion de données (DCR) Atelier Ressource de connexion de données (DCR) P-6 Tsoft Lotus Domino Designer 6 : Accéder aux données

17 Préambule Etape Durée Notes personnelles Pause 15 Lotus Enterprise Integrator (LEI) 10 XML. Services Web 10 XML. Terminologie 20 Domino XML (DXL) 15 Conclusion de l atelier 15 Tsoft Lotus Domino Designer 6 : Accéder aux données P-7

18

19 DCR DECS DTD DXL LEI XML XSL Module 4 : Accéder aux données externes Objectifs Ce module aborde l accès aux données externes depuis Domino sous forme d un atelier pour la partie ODBC et DECS : les procédures sont détaillées et s appuient sur des exemples de la base Designer 6 Démonstrations. L installation d un serveur DB2 est également documentée pour que les exemples se rapprochent de cas réels. XML n est pas utilisable avec le langage de formules. Il est simplement présenté dans le contexte de Domino ainsi que les quelques manipulations simples disponibles depuis les menus de Designer. Cette technologie est incontournable actuellement. Connaissance Echange de données par XML Lotus Enterprise Integrator (LEI) Savoir-faire Accéder aux données par ODBC en formules Mettre en œuvre DECS Mettre en œuvre une ressource d accès aux données Progression Accéder aux données par ODBC Référence. Configuration ODBC. avec ODBC avec ODBC DECS : principe DB2. Installation du serveur DB2. Installation du client DECS. Installation et configuration DECS. Création d'une connexion DECS. Relier un masque à une activité DECS. Options avancées de l'activité Ressource DCR Lotus Enterprise Integrator (LEI) XML. Services Web XML. Terminologie Domino XML (DXL) Tsoft Lotus Domino Designer 6 : Accéder aux données 1-1

20 Accéder aux données externes Accéder à des données par ODBC Accéder à des données par ODBC " Une formule accède à des données externes via pilote ODBC # En avant-plan (masque) depuis le poste client # En arrière-plan (agent sur serveur) depuis le serveur ont un format d accès ODBC permet d entrer un ordre SQL Base de données non-notes Base de données non-notes Pilote ODBC Pilote ODBC Les vues Notes utilisées représentent les informations sous forme de tableaux à la manière des bases relationnelles. Il est possible d utiliser la même logique d accès sur des bases de données non-notes : lecture du contenu de toute une lecture d une rangée d après une clé d La permet de passer directement des ordres SQL (Structured Query Language). Où installer ODBC ODBC s appuie sur des pilotes d accès aux bases de données DB2 ; Oracle, SQL Serveur C est une couche qui vient au-dessus de ces pilotes et qui a pour vocation de masquer les différences. ODBC sera installé pour plusieurs raisons : La base n est pas accessible autrement, par exemple s il s agit de fichiers DBF ou MDB (MS Access), Le programme est en langage de formules et est donc limité à ODBC. ODBC est accédé sur l ordinateur sur lequel s exécute la formule : Le client Notes pour les masques sauf si DECS est utilisé et les agents locaux, Le serveur Domino pour les agents en arrière-plan ou les agents lancés depuis le client Notes avec l option RunOnServer de LotusScript. Phases d installation L installation se déroule en trois étapes principales sur l ordinateur à partir duquel est accédé ODBC : Installation du client d accès à la base de données s il n est pas fourni en standard par Windows ou l OS : DB2 Client Access, par exemple, Configuration d ODBC dans Windows, Test de fonctionnement en lançant une requête depuis un logiciel d interrogation de bases de données. 1-2 Tsoft Lotus Domino Designer 6 : Accéder aux données

21 Accéder aux données externes Référence. Configuration ODBC La configuration est illustrée avec l accès à des fichiers Dbase qui ne nécessitent pas l installation préalable d un client. Base de données accédée La description de la procédure s appuie sur trois fichiers en format DBase (*.dbf) faisant partie de la suite Office de Microsoft. La figure indique l emplacement et le nom de ces trois fichiers : C:\Program Files\Microsoft Office\Office\1036. Source de données disponibles Sous Windows NT workstation : Commande Windows Démarrer/Paramètres/Panneau de configuration (Windows) Cliquer sur ce bouton. Sous Windows 2000 Professional : Commande Windows Démarrer/Paramètres/Panneau de configuration Cliquer (Outils d administration), puis Sources de données (ODBC) Les captures d écran sont en Windows 2000 Professional. Cliquer sur l onglet (Pilotes ODBC installés sur votre système) Les pilotes DBase sont installés par défaut avec une suite bureautique. Les pilotes ODBC DB2, Oracle sont installés avec les clients d accès DB2, Oracle Cliquer sur l onglet (Sources de données) Tsoft Lotus Domino Designer 6 : Accéder aux données 1-3

22 Accéder aux données externes Une source de données correspond à une base de données : Un répertoire sur le disque d un serveur de fichiers dans le cas de fichiers dbase : chaque fichier d extension.dbf représente une table de la base de données, Un fichier d extension.mdb repéré par son chemin complet pour une base MS Access. Une source de données système est accessible à tous les utilisateurs du poste, contrairement à une source de données utilisateur. Habituellement, la source de données est définie comme système. Configuration d une base de données ODBC Cliquer (Ajouter ) depuis l onglet (Source de données système) Pilote associé à la source de données Sélectionner le pilote, par exemple Driver do Microsoft dbase (*.dbf) Cliquer (Terminer) <Nom de la source de données> : taper le nom identifiant l ensemble des données à accéder, ici ExemplesMS <Description> : taper un texte explicatif <Version> : sélectionner la version du format des données, par exemple dbase 5.0 Vous connaissez normalement le format dans lequel sont vos données. Une erreur sur la version entraîne des erreurs à l exécution pas très simples à identifier. Ne pas cocher Utilisation du répertoire en cours Cliquer (Sélectionner le répertoire ) et sélectionner le répertoire contenant les fichiers à accéder, ICI C:\Progam Files\Microsoft Office\Office\1036 Cliquer (Options) et vérifier les choix proposés en fonction du pilote 1-4 Tsoft Lotus Domino Designer 6 : Accéder aux données

23 Accéder aux données externes Cliquer (OK) La nouvelle source de données est affichée dans l onglet (DSN système). Vérification de la configuration L accès aux fichiers contenus dans la source de données Exemples est vérifié depuis un tableur en construisant une requête sur des données externes. Depuis Microsoft Excel 2000, les commandes et écrans sont : Commande Données/Données externes/créer une requête Source de données définie dans DSN système Sélectionner la source de données, ici ExemplesMS Excel est capable d accéder des fichiers DBF directement et c est pourquoi ils apparaissent dans la liste à côté de la source de données ExemplesMS qui vient d être créée. Pour tester ODBC, il faut, bien entendu, sélectionner ExemplesMS. Cliquer (OK) Les tables de la base qui correspondent chacune à un fichier DBF sont affichées. Cliquer sur une table et sélectionner les colonnes voulues Cliquer (Suivant >) Conserver les options par défaut proposées Après quelques clics de souris, le résultat apparaît. Tsoft Lotus Domino Designer 6 : Accéder aux données 1-5

24 Accéder aux données externes avec ODBC La syntaxe est décrite en s appuyant sur le fichier Customer.dbf de la source ExemplesMS. Une formule typique d utilisation s écrit selon le modèle qui suit. classe := "ODBC" ; cache := "Cache" ; source := "Exemples" ; IdUtil := NULL ; MdP := NULL ; table := "Customer.dbf" ; col := "CODE_CLIEN" : "n/a" ; source ; IdUtil ; MdP ; table ; col) ; classe : cache source IdUtil MdP table col Distinct:tri classe : contient ODBC et indique le type de base accédée. cache : contient Cache ou NoCache comme pour l accès à des vues Notes. C est le nom de la source de données tel qu il est défini dans ODBC (DSN système). L identifiant de l utilisateur si la source de données est sécurisée. Ceci est applicable notamment avec des sources gérées par DB2, Oracle NULL indique qu il n y a pas de contrôle de ce genre. Mot de passe associé à l identifiant de l utilisateur. NULL indique qu il n y a pas de contrôle. C est le nom du fichier à accéder qui se trouve dans la source. Si la source est DB2, Oracle ce sera un nom de table ou de vue. Cette valeur est une liste : nom colonne : valeur si nul nom de la colonne accédée : ce nom doit être connu dans le fichier, valeur retournée si le contenu de la colonne est vide pour une rangée. Ici, le choix est de retourner la chaîne n/a (non applicable). Cet argument facultatif précise s il faut éliminer les doublons et l ordre de tri. Exemple d utilisation Designer 6.0 Démonstrations/Masque/ ODBC\Dialogue affichant Customer.dbf Le masque contient un champ Client de type Liste de dialogue. La liste de choix est accédée par ODBC sur le poste puis proposée à l utilisateur (la formule est celle de l exemple ci-dessus). 1-6 Tsoft Lotus Domino Designer 6 : Accéder aux données

25 Accéder aux données externes avec ODBC La syntaxe est décrite en s appuyant sur le fichier Customer.dbf de la source Exemples. L utilisateur a sélectionné un code client dans la liste champ Client et le nom de la société est accédé. Une formule typique d utilisation s écrit selon le modèle qui ; classe := "ODBC" ; cache := "Cache" ; source := "ExemplesMS" ; IdUtil := NULL ; MdP := NULL ; table := "Customer.dbf" ; col := "SOCIETE" : "n/a" ; colcle := "CODE_CLIEN" ; cle := Client classe : cache ; source ; IdUtil ; MdP ; table ; col ; colcle ; cle ) ; classe : cache source IdUtil MdP table classe : contient ODBC et indique le type de base accédée. cache : contient Cache ou NoCache comme pour l accès à des vues Notes. C est le nom de la source de données tel qu il est défini dans ODBC (DSN système). L identifiant de l utilisateur si la source de données est sécurisée. Ceci est applicable notamment avec des sources gérées par DB2, Oracle NULL indique qu il n y a pas de contrôle de ce genre. Mot de passe associé à l identifiant de l utilisateur. NULL indique qu il n y a pas de contrôle. C est le nom du fichier à accéder qui se trouve dans la source. Si la source est DB2, Oracle ce sera un nom de table ou de vue. col Cette valeur est une liste : nom de la colonne accédée : ce nom doit être connu dans le fichier, valeur retournée si le contenu de la colonne est vide pour une rangée. Ici, le choix est de retourner la chaîne n/a (non applicable). colcle cle Exemple d utilisation Nom de la colonne dans la table qui contient les clés d accès. cle contient la clé d accès qui sera comparée au contenu de la colonne des clés d accès. Les rangées qui contiennent cette valeur sont sélectionnées. Designer 6.0 Démonstrations/Masque/ ODBC\Dialogue affichant Customer.dbf Lorsque l utilisateur sélectionne un code client, la raison sociale, la ville et le pays du client sont accédés dans des champs calculés à l affichage. Tsoft Lotus Domino Designer 6 : Accéder aux données 1-7

26 Accéder aux données externes avec ODBC Les génèrent un ordre exécute un ordre SQL codé dans la formule. SQL SELECT Une formule typique d utilisation repris précédent s écrit selon le modèle qui ;@Return(Null) ;@Success) ; classe := "ODBC" ; cache := "Cache" ; source := "ExemplesMS" ; IdUtil := NULL ; MdP := NULL ; commande := "SELECT SOCIETE + '~' + VILLE + '~' + PAYS FROM CUSTOMER WHERE CODE_CLIEN = '" + Client + "'"; tmp classe : cache ; source ; IdUtil ; MdP ; commande:"n/a"); FIELD Pays FIELD Ville FIELD RaisonSociale La syntaxe est proche de celle la différence essentielle étant que le nom de la table accédée et de la ou des colonnes est codé directement dans l ordre SQL au lieu d être fourni dans des champs séparés. Designer 6.0 Démonstrations/Masque/ ODBC\Commandes SQL sur Customer.dbf L exemple indique comment récupérer plusieurs colonnes dans un ordre SQL SELECT. Il s écrit SELECT SOCIETE + '~' + VILLE + '~' + PAYS qui retourne une seule chaîne de caractères résultat de l expression calculée. Ce résultat est ensuite analysé parsing in english pour séparer les valeurs. L écriture SQL plus classique SELECT SOCIETE, VILLE, PAYS ne retourne que la colonne SOCIETE. Étudiez le chapitre complet dans l ouvrage Tsoft référence TS Tsoft Lotus Domino Designer 6 : Accéder aux données