Zeos tutorial/fr: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | # Avant-propos | |
| 2 | 2 | ||
| 3 | 3 | Ce tutoriel concerne le téléchargement, l'installation et l'utilisation de [Zeoslib](http://zeoslib.sourceforge.net/) avec [[Glossary/fr|Lazarus]] et [[Glossary/fr|FPC]]. Cette traduction est partielle. Elle ne prend pas en compte ce qui est trop vieux (versions anciennes des logiciels).\ | |
| 4 | 4 | ||
| 5 | 5 | **Les développeurs de Zeos mettent à disposition un forum. Pour plus d'informations sur ZeosLib, pour poser (ou répondre à) des questions sur l'utilisation de Zeos et pour des rapports de bugs, veuillez vous rendre sur [le forum ZeosLib](http://zeoslib.sourceforge.net/).** | |
| 6 | 6 | ||
| 7 | 7 | # Téléchargement de Zeos | |
| 8 | 8 | ||
| 9 | 9 | Zeos a été porté sur [[Glossary/fr|Lazarus]]. Il n'y a pas de distribution officielle mais vous pouvez aisément le télécharger via SVN en suivant les étapes suivantes : | |
| 10 | 10 | ||
| 11 | 11 | ## SVN | |
| 12 | 12 | ||
| 13 | 13 | ### Windows | |
| 14 | 14 | ||
| 15 | 15 | - Installez un client SVN [TortoiseSVN](http://tortoisesvn.tigris.org) | |
| 16 | 16 | - La documentation : [Getting Started with TortoiseSVN](http://tortoisesvn.net/docs/release/TortoiseSVN_fr/help-onepage.html#tsvn-dug-general) | |
| 17 | 17 | - Téléchargez le code : <http://svn.code.sf.net/p/zeoslib/code-0/trunk> | |
| 18 | 18 | ||
| 19 | 19 | (Tortoise SVN est une extension shell de l'Explorateur Windows : clic droit sur le dossier destination -\> SVN Checkout dans le menu shell, adresse du dépôt dans "URL Repository"). | |
| 20 | 20 | ||
| 21 | 21 | ### Linux/BSD | |
| 22 | 22 | ||
| 23 | 23 | - installez un client SVN quelconque (svn, esvn, kdesvn, etc.) | |
| 24 | 24 | - créez un répertoire zeosdbo, allez dans ce répertoire et faites un | |
| 25 | 25 | - svn checkout <http://svn.code.sf.net/p/zeoslib/code-0/trunk> | |
| 26 | 26 | ||
| 27 | 27 | ## ZIP | |
| 28 | 28 | ||
| 29 | 29 | Vous pouvez télécharger la dernière version en fichier ZIP depuis sourceforge.net : | |
| 30 | 30 | ||
| 31 | 31 | - [<http://sourceforge.net/projects/zeoslib/>](http://sourceforge.net/projects/zeoslib/) | |
| 32 | 32 | ||
| 33 | 33 | # Installation des composants | |
| 34 | 34 | ||
| 35 | 35 | Nous supposons que vous avez Lazarus \>= 1.0.2 (et donc FPC \>= 2.6.0) C'est une partie astucieuse, donc vous devrez avoir un peu de patience et lire ceci attentivement cette partie. | |
| 36 | 36 | ||
| 37 | 37 | - Démarrez Lazarus. | |
| 38 | 38 | ||
| 39 | 39 | 1. Allez dans **Paquet/Ouvrir un fichier paquet(.lpk)** dans le menu principal. | |
| 40 | 40 | 2. Allez dans **\<votre répertoire zeosdbo\>/trunk/packages/lazarus/** et ouvrez **zcomponent.lpk** | |
| 41 | 41 | 3. Cliquez sur **\[Compiler\]** si vous ne voulez pas installer les composants dans l'IDE | |
| 42 | 42 | 4. Cliquez sur **\[Installer\]** | |
| 43 | 43 | 5. On va vous demander si vous voulez reconstruire Lazarus. | |
| 44 | 44 | ||
| 45 | 45 | - Répondez **\[Oui\]**. | |
| 46 | 46 | - Attendez un moment. Si tout va bien, Lazarus devrait redémarrer. | |
| 47 | 47 | - Maintenant, vous devriez voir l'onglet **\[Zeos Access\]** dans la palette de composants. | |
| 48 | 48 | ||
| 49 | 49 |  | |
| 50 | 50 | ||
| 51 | 51 | Si vous obtenez une erreur "Cannot find unit ZClasses" ou quelque chose de semblable, vous devez alors vérifier précisément la casse des noms ds fichier dans les sources de votre distribution Zeos. | |
| 52 | 52 | ||
| 53 | 53 | - Même si la casse correspond exactement, le fichier source du paquet auto généré peut générer la mauvaise casse de nom dans la clause Uses (Lazarus 0.9.18), i.e.: | |
| 54 | 54 | ||
| 55 | 55 | ``` pascal | |
| 56 | 56 | { This file was automatically created by Lazarus. Do not edit! | |
| 57 | 57 | This source is only used to compile and install the package. | |
| 58 | 58 | } | |
| 59 | 59 | unit Zcore; | |
| 60 | 60 | interface | |
| 61 | 61 | uses | |
| 62 | 62 | Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression, | |
| 63 | 63 | Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables, | |
| 64 | 64 | Zvariant; | |
| 65 | 65 | implementation | |
| 66 | 66 | end. | |
| 67 | 67 | ``` | |
| 68 | 68 | ||
| 69 | 69 | - Remarquez que Lazarus a nommé ZClasses Zclasses, ce qui débouche sur un conflit de nom. On peut supposer que c'est un bug à Lazare, non pas du paquet Zeos. Une façon de contourner consiste à renommer tous les fichiers source de Zeos en minuscules. Allez à la pêche dans chaque sous-répertoire sous src/ et exécutez cette commande dans une fenêtre bash: | |
| 70 | 70 | ||
| 71 | - | ||
| 71 | + | ```text | |
| 72 | + | rename -v 'y/A-Z/a-z/' * | |
| 73 | + | ``` | |
| 72 | 74 | ||
| 73 | 75 | - Ensuite, dans Lazarus, rouvrez le paquet (.lpk) et corriger la casse des noms de fichier en cliquant sur "More..."/"Fix Files Case" | |
| 74 | 76 | - Le paquet devrait compiler maintenant. | |
| 75 | 77 | ||
| 76 | 78 | # Créez votre première application Zeos | |
| 77 | 79 | ||
| 78 | 80 | - Ajoutez une **ZConnection**. | |
| 79 | 81 | - Remplissez les champs User, Password, Host, Port et Protocol (ainsi que les autres paramètres nécessaires). | |
| 80 | 82 | - Positionnez Connected à True. | |
| 81 | 83 | ||
| 82 | 84 | - Ajoutez une **ZQuery** (ne confondez pas avec ZReadOnlyQuery). | |
| 83 | 85 | - Faites pointer Connection vers votre ZConnection active. | |
| 84 | 86 | - Mettez dans les propriétés de Sql quelque chose comme **SELECT * FROM MyTable** | |
| 85 | 87 | - Positionnez Active à True. | |
| 86 | 88 | ||
| 87 | 89 | - Ajoutez une **DataSource** de l'onglet **\[Data Access\]**. | |
| 88 | 90 | - Faites pointer le DataSet vers votre ZQuery active. | |
| 89 | 91 | ||
| 90 | 92 | - Ajoutez une **DBGrid** de l'onglet **\[Data Controls\]**. | |
| 91 | 93 | - Faite pointer Datasource vers votre DataSource. | |
| 92 | 94 | - Si tout est en ordre, vous devriez voir vos données dans le tableau. | |
| 93 | 95 | ||
| 94 | 96 | ## Plus d'informations sur l'utilisation de Zeos | |
| 95 | 97 | ||
| 96 | 98 | Voici quelques articles très utiles expliquant l'utilisation de Zeos ainsi que ses rouages internes. Certains sont spécifiques à Delphi mais les mêmes techniques peuvent être utilisées avec Lazarus.\ | |
| 97 | 99 | ||
| 98 | 100 | - [The ZeosLib DBOs 6.1.5 - With Delphi 7 and Firebird 1.5](http://zeos.firmos.at/kb.php?mode=article&k=6) | |
| 99 | 101 | - [Overview of the Zeos Database Objects Architecture](http://zeos.firmos.at/kb.php?mode=article&k=4) | |
| 100 | 102 | - [An Introduction To ZDBC API](http://zeos.firmos.at/kb.php?mode=article&k=5) | |
| 101 | 103 | - Consultez aussi la section [Downloads](http://zeos.firmos.at/downloads.php) pour des exemples qui peuvent être facilement portés sous Lazarus. | |
| 102 | 104 | ||
| 103 | 105 | Attention tous les liens précédents affichent une page 404\ | |
| 104 | 106 | **Complétez SVP :)** | |
| 105 | 107 | ||
| 106 | 108 | # Bugs et problèmes possibles | |
| 107 | 109 | ||
| 108 | 110 | 1. J'ai remparqué que parfois, quand je fais un rebuild de Lazarus, il ne trouve pas certains fichiers de Zeos. Essayez ce qui suit : | |
| 109 | 111 | - Utilisez **Paquet/Graphe des paquets** dans le menu principal. | |
| 110 | 112 | - Ouvrez le paquet **ZComponent**. | |
| 111 | 113 | - Bouton de droite sur l'élément **Fichier** dans la liste. | |
| 112 | 114 | - Choisissez **\[Recompiler tout ce qui est requis\]**. | |
| 113 | 115 | - Quand il demande "Re-compiler ceci et tous les paquets requis?", répondez **\[Oui\]**. | |
| 114 | 116 | - Recompilez Lazarus normalement (avec les paquets).\ | |
| 115 | 117 | \ | |
| 116 | 118 | ||
| 117 | 119 | *Je ne sais pas si le point suivant est toujours d'actualité...* | |
| 118 | 120 | ||
| 119 | 121 | - - There is a bug in [[Glossary|FPC's]] [AnsiStrComp](http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/ansistrcomp.html) wich causes unreliable PChar comparison, this is obvious when using a DBGrid to edit data, **AnsiStrComp('abc', 'abcd')** can't detect them as being different but it detects **AnsiStrComp('abd', 'abcd')** ignoring multiple chars from the second string. This bug was found by Jesusrmx. It will probably be fixed soon, see [Bug Report](http://www.freepascal.org/bugs/showrec.php3?ID=4325). | |
| 120 | 122 | ||
| 121 | 123 | # Voir aussi | |
| 122 | 124 | ||
| 123 | 125 | - [Forum pour ZeosLib](http://zeoslib.sourceforge.net/index.php) | |
| 124 | 126 | - [[ZeosDBO/fr|ZeosDBO]] | |
| 125 | 127 | ||
| 126 | 128 | --- | |
| 127 | 129 | *From the Free Pascal wiki, page "Zeos tutorial/fr", as it stood on 2020-03-03 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |