TPSQL/de: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		### Über
2	2
3	3		TPSQL ist ein modifizierte-LGPL Package für Lazarus. Es definiert zwei Komponenten, TPSQLDatabase und TPSQLDataset, welche Anwendungen die Verbindung zu PostgreSQL Datenbankservern über TCP/IP Netzwerke erlauben.
4	4
5	5		Der Download enthält die Komponenten-Pascal-Dateien, die Lazarus Package Datei, Ressourcendateien und die modifizierte-LGPL Lizenz-Textdateien.
6	6
7	7		Diese Komponenten wurden entwickelt für Anwendungen, die auf Linux oder Win32 Plattformen laufen.
8	8
9	9		### Autor
10	10
11	11		Antonio d'Avino
12	12
13	13		### Lizenz
14	14
15	15		Modifizierte LGPL (lesen sie COPYING.modifiedLGPL und COPYING.LGPL die im Package enthalten sind).
16	16
17	17		### Download
18	18
19	19		Das letzte stabile Release ist zu finden auf der [Lazarus CCR Files Seite](http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=98986) oder auf den Internetseiten des Autors [<http://infoconsult.homelinux.net>](http://infoconsult.homelinux.net).
20	20
21	21		### Änderungs Log
22	22
23	23		- Version 0.4.0 2005/06/01
24	24		- Version 0.4.1 2005/06/02
25	25
26	26		` - ClientEncoding Eigenschaft zur TPSQLDatabase class hinzugefügt. `
27	27
28	28		- Version 0.4.2 2005/06/03
29	29
30	30		` - Einige Änderungen an der destroy Methode von TPSQLDatabase/TPSQLDataset zur Vermeidung von Exceptions`\
31	31		` when closing IDE/project with components in Active/Connected status.`\
32	32		` - Base path in archived files geändert von 'usr/share/lazarus/components/psql' zu 'psql'`
33	33
34	34		- Version 0.4.6 2005/06/06
35	35
36	36		` - Executing queries that doesn't return data column now raises an exception.`\
37	37		` - commandQuery Funktion hinzugefügt (siehe Verwendung Abschnitt).`\
38	38		` - beginTransaction/commitTransaction/rollbackTransaction Unterstützung hinzugefügt (siehe Verwendung Abschnitt).`\
39	39		` - Weitere ClientEncoding Entitäten hinzugefügt.`
40	40
41	41		### Abhängigkeiten / Systemvoraussetzungen
42	42
43	43		- Lazarus 0.9.6 (FPC 1.9.8)
44	44
45	45		Status: Stabil
46	46
47	47		Sachverhalte: Getestet unter Windows (Win2K) und Linux (Mdk 10.1). Datenbankserver: PostgreSQL 8.0.3 (laufend auf beiden Plattformen).
48	48
49	49		### Installation
50	50
51	51		- Im lazarus/components Verzeichnis entpacken sie die Dateien aus der psql-laz-package-\<version\>.tar.gz Datei. Der psql Ordner wird erzeugt.
52	52		- Öffnen sie Lazarus
53	53		- Öffnen sie das Package psql_laz.lpk unter Komponenten -\> Paketdatei (.lpk) öffnen ...
54	54		- (Klicken sie auf Kompilieren nur dann, wenn sie das Package nicht in die IDE installieren wollen)
55	55		- Klicken sie auf Installieren und antworten mit 'Ja' wenn sie gefragt werden, ob Lazarus neu erstellt werden soll. Ein neuer Tab namens 'PSQL' wird in der Komponentenpalette erzeugt.
56	56
57	57		Wichtige Anmerkung für Win32 Benutzer.
58	58
59	59		`In dem Fall, dass sie einige Schwierigkeiten beim Kompilieren der Pascal Dateien im Package erleben, mögen sie den folgenden Pfad: `\
60	60		` `\
61	61		`<some-drive>:<some-path>\lazarus\lcl\units\i386-win32 `\
62	62		`(d.h.: c:\programs\lazarus\lcl\units\i386-win32)`\
63	63		` `\
64	64		`zu 'Andere Unitdateien' in 'Pfade' der 'Compilereinstellungen' des Lazarus Packagemanager Fenster hinzufügen.`
65	65
66	66		### Verwendung
67	67
68	68		Legen sie eine TPSQLDatabase Komponente auf einem Formular ab, für jede verschiedene PostgreSQL Datenbank, mit der sich ihre Anwendung verbinden muss. Zwingende Eigenschaften dieser Komponente, die sie setzen müssen, sind:
69	69
70	70		- DatabaseName : Der Name der PostgreSQL Datenbank, mit der sich ihre Anwendung verbinden muss.
71	71		- HostName : Die IP Adresse oder die URL des PC's, auf dem der PostgreSQL Server gehostet ist.
72	72		- UserName : Der Name eines Benutzers, der Zugriffsrechte auf Host/Datenbank hat.
73	73
74	74		Optional müssen sie evtl. die Password Eigenschaft setzen für eine korrekte Verbindung zum Server. Dann, um die Verbindung zu aktivieren, müssen sie die Connected Eigenschaft auf 'True' setzen. Eine Exception wird ausgelöst, wenn die Verbindung fehlgeschlagen ist (falsche Parameter, Benutzer ohne Zugriffsrechte, Netzwerkfehler oder der PostgreSQL Server ist nicht aktiv). Setzen sie die Eigenschaft auf 'False' um die Verbindung zu schließen.
75	75
76	76		- Anmerkung über die ClientEncoding Eigenschaft.
77	77
78	78		`Die ClientEncoding Eigenschaft erlaubt dem Benutzer to set a character set for the client`\
79	79		`application different from the one defined for the database. The PostgreSQL server`\
80	80		`make a 'translation' between the two sets. However a "ClientEncoding change failed" `\
81	81		`exception may be the result of a ClientEncoding property change. This may be due to`\
82	82		`a database character set incompatible with the clientencoding you selected. IE, `\
83	83		`the char set 'LATIN9' is not compatible with a 'WIN1250'. You select the default`\
84	84		`char set for the whole database cluster when you create it mit dem Kommando`\
85	85		`'initdb', unter Verwendung der -E Option: d.h. 'initdb -E UNICODE'. Also, you can define a`\
86	86		`different character set for any database you create (different from the `\
87	87		`default one of the whole db cluster), auch mit der -E Option:`\
88		-	\
	88	+
89	89		`d.h. 'createdb -E UNICODE Test' `\
90	90		` `\
91	91		` oder`\
92		-	\
	92	+
93	93		`CREATE DATABASE TEST WITH ENCODING 'UNICODE';`\
94		-	\
	94	+
95	95		`(Anmerkung: Sie müssen den character set Namen in Anführungszeichen setzen in dem 'CREATE DATABASE' Kommando).`\
96		-	\
	96	+
97	97		`Ich empfehle, den UNICODE character set als Vorgabe einzustellen für your db cluster (oder für die Datenbank, `\
98	98		`die sie erzeugen), weil es kompatibel ist mit the whole set of charset available`\
99	99		`for the client, except the MULE_INTERNAL.`
100	100
101	101		Now you may drop a TPSQLDataset component on the form for any table connection you need. The main property to set on this component type is the Database one. A dropdown menu allows you to select one of any TDatabase descendant component present on form (natürlich müssen sie eine TPSQLDatabase Komponente wählen).
102	102
103	103		You also need to provide a valid SQL statement in SQL property. Now, you are able to open the TPSQLDataset, setting to 'True' the Active property. Several exceptions are provided for signaling failing conditions. Please, refer to TDataSet documentation für Infos und Beispiele über die Verwendung der TPSQLDataset Komponente in order to access to SQL retrieved data rows as well as conneting to Data Controls components. However, procedures and functions added to parent class sind hier beschrieben:
104	104
105	105		\- function commandQuery ( query : String) : ShortInt.
106	106
107	107		`Verwenden sie diese Funktion für submit queries that doesn't returns data columns, as update queries`\
108	108		`(d.h. update, insert, delete etc.). Current dataset is not affected, however it will reflect `\
109	109		`changes made by execution of commandQuery itself, if it has some influence on current `\
110	110		`dataset. Die Funktion gibt 0 zurück, wenn sie erfolgreich war, -1 bei einem Fehlschlag. Exceptions werden nicht unterstütz.`
111	111
112	112		\- procedure beginTransaction
113	113
114	114		` Startet eine SQL transaction session. Changes to table may be submitted`\
115	115		` using the commandQuery function.`
116	116
117	117		\- procedure commitTransaction
118	118
119	119		` Beendet eine SQL transaction session, commiting changes submitted starting`\
120	120		` from last beginTransaction execution.`
121	121
122	122		\- procedure rollbackTransaction
123	123
124	124		` Beendet eine SQL transaction session, aborting changes.`
125	125
126	126		---
127	127		From the Free Pascal wiki, page "TPSQL/de", as it stood on 2010-10-19 after a change by Mischi, 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).

Back to history