RAD Studio - Benutzerbeiträge [de]

GetIt-Abhängigkeiten

2016-06-02T15:05:58Z

Pial: 1 Version: Updated with WM. LOC-22823

{{Parent|Projektoptionen (Dialogfeld)}}

[[File:GetItDependenciesDialog.png|thumb|300px]]

{{Menu|Projekt > Optionen > GetIt-Abhängigkeiten}}

In diesem Dialogfeld können Sie die Abhängigkeiten Ihres Projekts in Packages, die in der Ablage vom '''[[GetIt-Package-Manager|GetIt-Package-Manager]]''' bereitstehen, festlegen.

{{Product}} speichert konfigurierte GetIt-Abhängigkeiten in der {{Path|.dproj}}-Datei Ihres Projekts. Dies ermöglicht '''[[MSBuild|MSBuild]]''' jede fehlende GetIt-Abhängugkeit mit dem [[GetItCmd.exe|Befehlszeilen-Schnittstelle des GetIt-Package-Manager]] zu installieren.

Das '''GetIt Dependencies''' Dialogfeld enthält die folgenden Elemente:

{| class="wikitable"
|-
! Element
! Beschreibung
|- valign="top"
|
'''Erforderlich'''
|
Die aktivierten Kontrollkästchen legen fest, welche Packages für das Projekt erforderlich sind.

Um anzugeben, dass ein Package für das Projekt erforderlich ist, wählen Sie das entsprechende Kontrollkästchen aus und klicken auf '''OK'''.
|- valign="top"
|
'''Status'''
|
Packages können die folgenden Status annehmen:
* '''Verfügbar''': Wenn das Package installiert ist. Dies weist nicht auf einen Zusammenhang mit dem Projekt hin.
* '''Fehlt''': Wenn das Package vom Projekt benötigt wird, aber nicht installiert ist.
* '''Nicht verfügbar''': Wenn das Package vom Projekt benötigt wird, aber nicht mehr in GetIt verfügbar ist.
|- valign="top"
|
'''Name'''
|
Name des Package.
|- valign="top"
|
'''Beschreibung'''
|
Beschreibung des Package.
|- valign="top"
|
Schaltfläche '''Installieren'''
|
Mit dieser Schaltfläche können Sie Packages mit dem Status '''Fehlt''' installieren; d. h. Packages, die nicht installiert, aber für das Projekt erforderlich sind.
|- valign="top"
|
Schaltfläche '''Alle fehlenden Packages installieren'''
|
Mit dieser Schaltfläche können Sie alle Packages installieren, die nicht installiert, aber für das Projekt erforderlich sind.

Über diese Schaltfläche installieren Sie ein oder mehrere '''Fehlende''' Packages, die vom Projekt benötigt werden.
|}

==Öffnen eines Projekts mit fehlenden GetIt-Abhängigkeiten==

Wenn Sie ein Projekt öffnen, das nicht installierte "GetIt-Abhängigkeiten" enthält, werden Sie von {{Product}} benachrichtigt, mit der Option, sie herunterzuladen:

: [[File:GetItDependenciesInfo.png]]

Sie können entweder '''Yes''' auswählen, um die fehlenden Abhängigkeiten zu installieren, oder '''No''', und diese Abhängigkeiten später von der '''GetIt-Abhängigkeiten'''-Seite zu installieren, unter der Verwendung der Schaltfläche '''Installieren aller fehlenden Packages'''.

==Siehe auch==

* [[GetIt-Package-Manager|GetIt-Package-Manager]]
* [[Fenster "GetIt-Package-Manager"|Fenster "GetIt-Package-Manager"]]
* [[Installieren eines Package mit dem Getlt-Package-Manager|Installieren eines Package mit dem Getlt-Package-Manager]]

[[Category:RAD Studio – Referenz]]
[[Category:Berlin]]

GetIt-Abhängigkeiten

2016-06-02T15:05:24Z

Pial: Updated with WM. LOC-22823

Position von DLL-Dateien

2016-06-01T08:33:40Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Installationsprogramme verwenden}}

DLL-Dateien, die nur von einer einzigen Anwendung verwendet werden, können in demselben Verzeichnis wie die Anwendung installiert werden. Wird eine DLL jedoch von mehreren Anwendungen genutzt, muss sie sich an einer Position befinden, auf die alle Anwendungen zugreifen können. Häufig werden derartige DLLs entweder im Verzeichnis WINDOWS oder in WINDOWS\SYSTEM bereitgestellt. Besser ist es aber, wenn ein separates Verzeichnis für gemeinsam genutzte DLLs angelegt wird, ähnlich wie dies bei der Installation der BDE (Borland Database Engine) geschieht.

==Siehe auch==

* [[Installationsprogramme verwenden|Installationsprogramme verwenden]]
* [[Anwendungsdateien identifizieren|Anwendungsdateien identifizieren]]
*[[Hilfsanwendungen|Hilfsanwendungen]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:C++]]
[[Category:Delphi]]

DESIGNONLY-Direktive (Delphi)

2016-06-01T08:33:39Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Liste der Delphi-Compiler-Direktiven - Index}}

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
'''Typ'''
| style="text-align: left; vertical-align: top;" |
Option
|-
| style="text-align: left; vertical-align: top;" |
'''Syntax'''
| style="text-align: left; vertical-align: top;" |
{$DESIGNONLY ON} oder {$DESIGNONLY OFF}
|-
| style="text-align: left; vertical-align: top;" |
'''Vorgabe'''
| style="text-align: left; vertical-align: top;" |
{$DESIGNONLY OFF}
|-
| style="text-align: left; vertical-align: top;" |
'''Bereich'''
| style="text-align: left; vertical-align: top;" |
Lokal
|}

'''Anmerkungen'''

Die Direktive '''{DESIGNONLY ON}''' bewirkt, dass das entsprechende Package für die Installation in der Entwicklungsumgebung compiliert wird.

Verwenden Sie die Direktive '''DESIGNONLY''' nur in [[Delphi Package Source File|Package-Quelldateien]].

==Siehe auch==

*[[Spezielle Compiler-Direktiven für Packages|Spezielle Compiler-Direktiven für Packages]]

[[Category:Delphi]]

DbExpress-Treiber und Framework-Unterstützung für SQL Anywhere 11

2016-06-01T08:33:37Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Datenbankanwendungen für die Win32-Plattform entwickeln - Index}}
{{DISPLAYTITLE:dbExpress-Treiber und Framework-Unterstützung für SQL Anywhere 11}}
{{Product}} XE unterstützt SQL Anywhere 11 von Sybase iAnywhere. Leistungsmerkmale:

* Zu den neuen von SQL Anywhere 11 unterstützten Datentypen zählen '''NCHAR''', '''NVARCHAR''' und '''LONG NVARCHAR'''.
* Neue Verbindungseigenschaften und -attribute, wie '''UNICODE-Metadaten''', '''include TABLE''', '''FIELD''' und '''INDEX-Name'''.
* Unterstützung von '''NLS / UNICODE''' für Adaptive Server Anywhere (ASA) 11.

==Vom neuen ASA-11-Treiber unterstützte Datentypen==

{{Product}} XE führt neues Verhalten für alte Datentypen und die Unterstützung für neue Datentypen ein. Die folgende Tabelle enthält die Datentypen und deren gekapselte ASA-11-Feldtypen, die von der Version 11 des iAnywhere-Treibers unterstützt werden:

{| border="1" frame="hsides" rules="rows"
|-
! '''Datentyp'''
! '''Gekapselter Feldtyp'''
! '''Nennung'''
|-
| style="text-align: left; vertical-align: top;" |
SQL_TYPE_NULL
| style="text-align: left; vertical-align: top;" |
fldASANULL
| style="text-align: left; vertical-align: top;" |
// 0
|-
| style="text-align: left; vertical-align: top;" |
SQL_UNKNOWN_TYPE
| style="text-align: left; vertical-align: top;" |
fldASAUNKNOWN
| style="text-align: left; vertical-align: top;" |
// 0
|-
| style="text-align: left; vertical-align: top;" |
SQL_CHAR
| style="text-align: left; vertical-align: top;" |
fldASACHAR 
fldASAUNIQUEIDENTIFIERSTR
| style="text-align: left; vertical-align: top;" |
// 1 
// maximale Größe = 36
|-
| style="text-align: left; vertical-align: top;" |
SQL_NUMERIC
| style="text-align: left; vertical-align: top;" |
fldASANUMERIC 
fldASAMONEY 
fldASASMALLMONEY
| style="text-align: left; vertical-align: top;" |
// 2 
// 2 
// 2
|-
| style="text-align: left; vertical-align: top;" |
SQL_DECIMAL
| style="text-align: left; vertical-align: top;" |
fldASADECIMAL
| style="text-align: left; vertical-align: top;" |
// 3
|-
| style="text-align: left; vertical-align: top;" |
SQL_INTEGER
| style="text-align: left; vertical-align: top;" |
fldASAINTEGER
| style="text-align: left; vertical-align: top;" |
// 4
|-
| style="text-align: left; vertical-align: top;" |
SQL_SMALLINT
| style="text-align: left; vertical-align: top;" |
fldASASMALLINT
| style="text-align: left; vertical-align: top;" |
// 5
|-
| style="text-align: left; vertical-align: top;" |
SQL_FLOAT
| style="text-align: left; vertical-align: top;" |
fldASAFLOAT
| style="text-align: left; vertical-align: top;" |
// 6
|-
| style="text-align: left; vertical-align: top;" |
SQL_REAL
| style="text-align: left; vertical-align: top;" |
fldASAREAL
| style="text-align: left; vertical-align: top;" |
// 7
|-
| style="text-align: left; vertical-align: top;" |
SQL_DOUBLE
| style="text-align: left; vertical-align: top;" |
fldASADOUBLE
| style="text-align: left; vertical-align: top;" |
// 8
|-
| style="text-align: left; vertical-align: top;" |
SQL_DATE
| style="text-align: left; vertical-align: top;" |
fldASADATE
| style="text-align: left; vertical-align: top;" |
// 91
|-
| style="text-align: left; vertical-align: top;" |
SQL_TIMESTAMP
| style="text-align: left; vertical-align: top;" |
fldASATIMESTAMP
| style="text-align: left; vertical-align: top;" |
// 93
|-
| style="text-align: left; vertical-align: top;" |
SQL_VARCHAR
| style="text-align: left; vertical-align: top;" |
fldASAVARCHAR
| style="text-align: left; vertical-align: top;" |
Keine
|-
| style="text-align: left; vertical-align: top;" |
SQL_DATETIME
| style="text-align: left; vertical-align: top;" |
fldASADATETIME 
fldASASMALLDATETIME
| style="text-align: left; vertical-align: top;" |
// 9 
// DOMAIN
|-
| style="text-align: left; vertical-align: top;" |
SQL_TIME
| style="text-align: left; vertical-align: top;" |
fldASATIME
| style="text-align: left; vertical-align: top;" |
// 92
|-
| style="text-align: left; vertical-align: top;" |
SQL_TYPE_DATE
| style="text-align: left; vertical-align: top;" |
Keine
| style="text-align: left; vertical-align: top;" |
Keine
|-
| style="text-align: left; vertical-align: top;" |
SQL_INTERVAL
| style="text-align: left; vertical-align: top;" |
fldASAINTERVAL
| style="text-align: left; vertical-align: top;" |
// 10 für ODBCVER >= 0x0300
|-
| style="text-align: left; vertical-align: top;" |
SQL_TYPE_TIME
| style="text-align: left; vertical-align: top;" |
Keine
| style="text-align: left; vertical-align: top;" |
Keine
|-
| style="text-align: left; vertical-align: top;" |
SQL_TYPE_TIMESTAMP
| style="text-align: left; vertical-align: top;" |
Keine
| style="text-align: left; vertical-align: top;" |
Keine
|-
| style="text-align: left; vertical-align: top;" |
SQL_DEFAULT
| style="text-align: left; vertical-align: top;" |
fldASADEFAULT
| style="text-align: left; vertical-align: top;" |
// 99 für ODBCVER >= 0x0300
|-
| style="text-align: left; vertical-align: top;" |
SQL_ARD_TYPE
| style="text-align: left; vertical-align: top;" |
fldASAARD
| style="text-align: left; vertical-align: top;" |
// -99 für ODBCVER >= 0x0300
|-
| style="text-align: left; vertical-align: top;" |
SQL_BIT
| style="text-align: left; vertical-align: top;" |
fldASABIT 
fldASALONGVARBIT 
fldASAVARBIT 
| style="text-align: left; vertical-align: top;" |
// -7
|-
| style="text-align: left; vertical-align: top;" |
SQL_TINYINT
| style="text-align: left; vertical-align: top;" |
fldASATINYINT
| style="text-align: left; vertical-align: top;" |
// -6
|-
| style="text-align: left; vertical-align: top;" |
SQL_BIGINT
| style="text-align: left; vertical-align: top;" |
fldASABIGINT
| style="text-align: left; vertical-align: top;" |
// -5
|-
| style="text-align: left; vertical-align: top;" |
SQL_LONGVARBINARY
| style="text-align: left; vertical-align: top;" |
fldASALONGVARBINARY 
fldASALONGBINARY 
fldASAIMAGE
| style="text-align: left; vertical-align: top;" |
// -4 
// maximale Größe = 2 GB
|-
| style="text-align: left; vertical-align: top;" |
SQL_VARBINARY
| style="text-align: left; vertical-align: top;" |
fldASAVARBINARY
| style="text-align: left; vertical-align: top;" |
// -3
|-
| style="text-align: left; vertical-align: top;" |
SQL_BINARY
| style="text-align: left; vertical-align: top;" |
fldASABINARY
| style="text-align: left; vertical-align: top;" |
// -2
|-
| style="text-align: left; vertical-align: top;" |
SQL_LONGVARCHAR
| style="text-align: left; vertical-align: top;" |
fldASALONGVARCHAR 
fldASATEXT 
fldASAXML
| style="text-align: left; vertical-align: top;" |
// -1
|-
| style="text-align: left; vertical-align: top;" |
SQL_WCHAR
| style="text-align: left; vertical-align: top;" |
fldASANCHAR 
fldASAWCHAR
| style="text-align: left; vertical-align: top;" |
// UTF-8 
// -8
|-
| style="text-align: left; vertical-align: top;" |
SQL_WVARCHAR
| style="text-align: left; vertical-align: top;" |
fldASANVARCHAR 
fldASAWVARCHAR
| style="text-align: left; vertical-align: top;" |
// UTF-8 
// -9
|-
| style="text-align: left; vertical-align: top;" |
SQL_WLONGVARCHAR
| style="text-align: left; vertical-align: top;" |
fldASALONGNVARCHAR 
fldASANTEXT 
fldASAWLONGVARCHAR
| style="text-align: left; vertical-align: top;" |
// UTF-8 
// Unicode 
// -10
|-
| style="text-align: left; vertical-align: top;" |
SQL_GUID
| style="text-align: left; vertical-align: top;" |
fldASAUNIQUEIDENTIFIER 
fldASAGUID
| style="text-align: left; vertical-align: top;" |
// -11 (UUID), maximale Größe = 36 
// -11 für ODBCVER >= 0x0350
|}

==Verbindungsattribute==

Ein weiteres neues Leistungsmerkmal für die Unterstützung von SQL Anywhere 11 stellen neue Verbindungsattribute dar. Die in diesem Release enthaltenen Verbindungsattribute sind in der folgenden Tabelle aufgeführt:

{| border="1" frame="hsides" rules="rows"
|-
! '''Verbindungsattribut'''
! '''ODBC-Version'''
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_ACCESS_MODE
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_AUTOCOMMIT
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_CONNECTION_DEAD
| style="text-align: left; vertical-align: top;" |
ODBC 3.5
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_LOGIN_TIMEOUT
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_METADATA_ID
| style="text-align: left; vertical-align: top;" |
ODBC 3.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_TRACE
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_TRACEFILE
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_TRANSLATE_LIB
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_TRANSLATE_OPTION
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|-
| style="text-align: left; vertical-align: top;" |
SQL_ATTR_TXN_ISOLATION
| style="text-align: left; vertical-align: top;" |
ODBC 1.0
|}

==Zukünftige Implementierungen==

Bei Kundenanforderungen könnten die folgenden Attribute zukünftig implementiert werden:

{| border="1" frame="hsides" rules="rows"
|-
! '''Verbindungsattribut'''
|-
| style="text-align: left; vertical-align: top;" |
allow_read_client_file
|-
| style="text-align: left; vertical-align: top;" |
allow_write_client_file
|-
| style="text-align: left; vertical-align: top;" |
AuthType
|-
| style="text-align: left; vertical-align: top;" |
CacheReadWorkTable
|-
| style="text-align: left; vertical-align: top;" |
ClientNodeAddress
|-
| style="text-align: left; vertical-align: top;" |
DiskReadWorkTable
|-
| style="text-align: left; vertical-align: top;" |
DiskSyncRead
|-
| style="text-align: left; vertical-align: top;" |
DiskSyncWrite
|-
| style="text-align: left; vertical-align: top;" |
DiskWaitRead
|-
| style="text-align: left; vertical-align: top;" |
DiskWaitWrite
|-
| style="text-align: left; vertical-align: top;" |
DiskWriteHint
|-
| style="text-align: left; vertical-align: top;" |
DiskWriteHintPages
|-
| style="text-align: left; vertical-align: top;" |
LockIndexID
|-
| style="text-align: left; vertical-align: top;" |
LockRowID
|-
| style="text-align: left; vertical-align: top;" |
max_priority
|-
| style="text-align: left; vertical-align: top;" |
OSUser
|-
| style="text-align: left; vertical-align: top;" |
priority
|-
| style="text-align: left; vertical-align: top;" |
query_mem_timeout
|-
| style="text-align: left; vertical-align: top;" |
QueryMemActiveCurr
|-
| style="text-align: left; vertical-align: top;" |
QueryMemExtraAvail
|-
| style="text-align: left; vertical-align: top;" |
QueryMemGrantFailed
|-
| style="text-align: left; vertical-align: top;" |
QueryMemGrantGranted
|-
| style="text-align: left; vertical-align: top;" |
QueryMemGrantWaiting
|-
| style="text-align: left; vertical-align: top;" |
QueryMemGrantRequested
|-
| style="text-align: left; vertical-align: top;" |
QueryMemWaited
|-
| style="text-align: left; vertical-align: top;" |
ServerNodeAddress
|-
| style="text-align: left; vertical-align: top;" |
ReadHint
|-
| style="text-align: left; vertical-align: top;" |
ReadHintScatter
|}

==Siehe auch==

* [[Von dbExpress unterstützte Datenbankmanagementsysteme|Von dbExpress unterstützte Datenbankmanagementsysteme]]
* [[DbExpress Framework-Kompatibilität|dbExpress Framework-Kompatibilität]]
* [[DbExpress-Datenbankanwendungen weitergeben|dbExpress-Datenbankanwendungen weitergeben]]

[[Category:Mit Delphi für Windows arbeiten]]
[[Category:Delphi]]

Datenbankspezifische Informationen zu DbExpress

2016-06-01T08:33:32Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{DISPLAYTITLE:Datenbankspezifische Informationen zu DbExpress}}
{{Parent|Datenbankanwendungen für die Win32-Plattform entwickeln - Index}}

dbExpress ist ein Datenbank-Framework, das Verbindungen zu einer Vielzahl unterstützter Datenbanken ermöglicht. Die Datenbanken können sich in vielerlei Hinsicht (z.B. bezüglich der Datentypen) unterscheiden. Dieses Thema enthält grundlegende Informationen zur Arbeit mit verschiedenen Datenbanken.

=InterBase=

==Unterstützung==

Es wird sowohl InterBase 2009 als auch InterBase 2007 unterstützt. Dies umfasst die Unterstützung von Treiber, TField-Objekten und des Daten-Explorers.

==To-Go==

dbExpress unterstützt auch die InterBase To-Go Edition, eine kleine, portable Version der Desktop Edition. Zu den Zielanwendungen der To-Go Edition gehören neben Software für Kleingeräte und Public Kiosks auch VAR-Anwendungen (Value Added Reseller), die mit InterBase erstellt wurden. Für die To-Go Edition muss InterBase nicht eigens auf dem Server oder dem Endbenutzer-Arbeitsplatz installiert werden.

==dbxdrivers.ini-Einstellung==

Im [Interbase]-Abschnitt muss die Eigenschaft VendorLib zugewiesen werden.

InterBase:

VendorLib=GDS32.DLL

To-Go:

VendorLib=IBTOGO.DLL

=MS SQL=

==Unterstützung==

MS SQL Server 2008 wird vollständig unterstützt. Es muss der native MS SQL Server 2008-Client installiert werden (nicht MS SQL Server 2005). Dieser Client verwendet die Datei sqlncli10.dll anstelle von oledb.dll. Sie können den Client unter der Adresse [http://msdn.microsoft.com/en-us/sqlserver/ff658533.aspx [1]] herunterladen (Abschnitt "Microsoft SQL Server 2008 Native Client").

==MSSQL-Treiber benötigt für Konsolenanwendungen und Worker Threads Aufrufe von CoInitialize und CoUninitialize==

Der MSSQL-Treiber ruft '''CoInitialize''' und '''CoUninitialize''' nicht auf. Frühere Versionen des MSSQL-Treibers (ein COM-Treiber) haben CoInitialize und CoUninitialize direkt aufgerufen. Dieses Verfahren hat aber viele Nachteile. Bei VCL-Anwendungen erfolgt der Aufruf von CoInitialize und CoUninitialize automatisch.

Bei Anwendungen, die den MSSQL-Treiber in Konsolenanwendungen oder in Worker Threads verwenden, müssen Sie jedoch selbst für den Aufruf von CoInitialize/CoUninitialize sorgen. Wird dieser Aufruf nicht ausgeführt, wird die folgende Fehlermeldung angezeigt: "DBX Error: Driver could not be properly initialized. Client library may be missing, not installed properly, of the wrong version, or the driver may be missing from the system path."

"Cannot load libraryName library (error code nnn).
The libraryName library may be missing from the system path
or you may have an incompatible version of the library installed."

Hilfe zu CoInitialize finden Sie unter [http://msdn.microsoft.com/de-de/library/ms678543%28v=VS.85%29.aspx CoInitialize Function (MSDN)].

=MYSQL=

==Unterstützung==

MYSQL Client 5.1 wird unterstützt und ist erforderlich. Wenn Sie versuchen, eine Verbindung zu einer früheren Version des Clients herzustellen, schlägt der Verbindungsaufbau fehl, und es wird folgende Fehlermeldung angezeigt:

"Cannot load libraryName library (error code nnn).
The libraryName library may be missing from the system path
or you may have an incompatible version of the library installed."

==Siehe auch==

* [[DbExpress-Framework|dbExpress-Framework]]
* [[DbExpress-Datentypzuordnung für unterstützte Datenbanken|dbExpress-Datentypzuordnung für unterstützte Datenbanken]]
*[[Von dbExpress unterstützte Datenbankmanagementsysteme|Von dbExpress unterstützte Datenbankmanagementsysteme]]

[[Category:Delphi]]
[[Category:C++]]

DbExpress-Datentypzuordnung für unterstützte Datenbanken

2016-06-01T08:33:30Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{DISPLAYTITLE:dbExpress-Datentypzuordnung für unterstützte Datenbanken}}
{{Parent|Datenbankanwendungen für die Win32-Plattform entwickeln - Index}}

Datentypen der unterstützten Datenbanken sind dbExpress-Datentypen zugeordnet. Bei Bedarf sorgt dbExpress für:

* Eine konsistente Datentypzuordnung zwischen den Datenbanken.
* Eine Zuordnung logischer Datentypen zu dbExpress-Typen.

=Verwendung von Datentypen=

dbExpress enthält ein breites Spektrum logischer Datentypen. dbExpress unterstützt die Zuordnung logischer Datentypen für Adaptive Server Anywhere, DB2, Informix, InterBase, MS SQL, MSDE, MYSQL, Oracle und Sybase.

Die Zuordnungstabellen geben an, welche Datentypen an Datenbanken gesendet und von diesen abgerufen werden können (Ausnahmen siehe Anmerkungen). Diese Zuordnungen funktionieren korrekt, aber es können durchaus auch andere Zuordnungen möglich sein. Eine Datenbank könnte diese Typen beim Abfragen einer Tabelle per Vorgabe einem anderen Typ zuordnen. Der Typ Geometry gibt beispielsweise per Vorgabe ein Feld des Typs TDBXDataTypes.VarBytesType zurück.

Für die folgende Abfrage:

Select * from table

erhalten Sie im Allgemeinen Daten des Typs zurück, der in den Zuordnungstabellen angegeben ist.

In manchen Fällen ist es wünschenswert, den Rückgabetyp festzulegen. Zum Beispiel bei einer Tabelle mit der Spalte geometryCol (Typ: Geometry) könnten Sie

Select geometryCol.ToString() from table

angeben, um die Daten als String abzurufen und um zu verhindern, dass der zugeordnete Datentyp für diese Daten verwendet wird.

Die Daten, die Sie an eine Datenbank senden, lassen sich mithilfe von Parametern ebenfalls spezifizieren. Für eine Tabelle mit der Spalte intCol des Typs int und der Spalte geometryCol des Typs Geometry könnten Sie beispielsweise die folgende Anweisung verwenden:

insert into table (intCol, geometryCol) values (?, ?)

und dann die Parameterwerte, wie z.B. 3, 'Point(1 1)', übergeben.

=InterBase=

dbExpress stellt Datentypzuordnungen für InterBase 2009, einschließlich To-Go, bereit In der folgenden Tabelle finden Sie die Datentypzuordnungen zwischen dbExpress und InterBase 2009.

{|
|-
! style="text-align: left;" |InterBase-Typ
! style="text-align: left;" |dbExpress-Typ
|-
| integer
| TDBXDataTypes.Int32Type
|-
| smallint
| TDBXDataTypes.Int16Type
|-
| blob
| TDBXDataTypes.BlobType
|-
| blob-Untertyp text
| TDBXDataTypes.BlobType mit dem Untertyp TDBXSubDataTypes.MemoSubType oder TDBXSubDataTypes.WideMemoSubType für eine UTF-8-Datenbank
|-
| numeric
| TDBXDataTypes.BcdType
|-
| decimal
| TDBXDataTypes.BcdType
|-
| float
| TDBXDataTypes.DoubleType
|-
| double precision
| TDBXDataTypes.DoubleType
|-
| date
| TDBXDataTypes.DateType
|-
| time
| TDBXDataTypes.TimeType
|-
| timestamp
| TDBXDataTypes.TimeStampType
|-
| boolean
| TDBXDataTypes.BooleanType
|-
| char
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|-
| varchar
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|}

=MS SQL und MSDE=

Beachten Sie bitte, dass dbExpress alle MS SQL 2008-Datentypen unterstützt. In der folgenden Tabelle finden Sie die Datentypzuordnungen für MS SQL und MSDE.

{|
|-
! style="text-align: left;" |MS SQL-Typ
! style="text-align: left;" |dbExpress-Typ
|-
| int
| TDBXDataTypes.Int32Type
|-
| bigint
| TDBXDataTypes.Int64Type
|-
| smallint
| TDBXDataTypes.Int16Type
|-
| tinyint
| TDBXDataTypes.UInt8Type
|-
| char
| TDBXDataTypes.AnsiStringType
|-
| varchar
| TDBXDataTypes.AnsiStringType
|-
| text
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.MemoSubType
|-
| nchar
| TDBXDataTypes.WideStringType
|-
| nvarchar
| TDBXDataTypes.WideStringType
|-
| ntext
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.WideMemoSubType
|-
| geometry
| TDBXDataTypes.AnsiStringType. Benutzen Sie diesen Typ, wenn Sie Parameter verwenden. Die Datenbank gibt TDBXDataTypes.VarBytesType zurück.
|-
| geography
| TDBXDataTypes.AnsiStringType. Benutzen Sie diesen Typ, wenn Sie Parameter verwenden. Die Datenbank gibt TDBXDataTypes.VarBytesType zurück.
|-
| money
| TDBXDataTypes.BcdType
|-
| smallmoney
| TDBXDataTypes.BcdType
|-
| float
| TDBXDataTypes.DoubleType
|-
| real
| TDBXDataTypes.DoubleType
|-
| decimal
| TDBXDataTypes.BcdType
|-
| numeric
| TDBXDataTypes.BcdType
|-
| xml
| TDBXDataTypes.WideStringType
|-
| sysname
| TDBXDataTypes.WideStringType
|-
| date
| TDBXDataTypes.DateType
|-
| time
| TDBXDataTypes.TimeType
|-
| datetime
| TDBXDataTypes.TimeStampType
|-
| datetime2
| TDBXDataTypes.TimeStampType
|-
| smalldatetime
| TDBXDataTypes.TimeStampType
|-
| datetimeoffset
| TDBXDataTypes.TimeStampOffsetType
|-
| binary
| TDBXDataTypes.BytesType
|-
| varbinary
| TDBXDataTypes.VarBytesType
|-
| image
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.BinarySubType
|-
| bit
| TDBXDataTypes.BooleanType
|-
| hierarchyid
| TDBXDataTypes.WideStringType. Verwenden Sie den Parameter TDBXDataTypes.WideStringType, die Datenbank gibt aber TDBXDataTypes.VarBytesType zurück.
|-
| uniqueidentifier
| TDBXDataTypes.WideStringType
|-
| sql_variant
| TDBXDataTypes.VarBytesType
|}

=MYSQL=

dbExpress stellt die folgenden MYSQL-Datentypzuordnungen bereit:

{|
|-
! style="text-align: left;" |MYSQL-Typ
! style="text-align: left;" |dbExpress-Typ
|-
| int
| TDBXDataTypes.Int32Type
|-
| tinyint
| TDBXDataTypes.Int8Type
|-
| smallint
| TDBXDataTypes.Int16Type
|-
| mediumint
| TDBXDataTypes.Int32Type
|-
| bigint
| TDBXDataTypes.Int64Type
|-
| float
| TDBXDataTypes.DoubleType
|-
| double
| TDBXDataTypes.DoubleType
|-
| decimal
| TDBXDataTypes.BcdType
|-
| numeric
| TDBXDataTypes.BcdType
|-
| timestamp
| TDBXDataTypes.TimeStampType
|-
| datetime
| TDBXDataTypes.TimeStampType
|-
| date
| TDBXDataTypes.DateType
|-
| time
| TDBXDataTypes.TimeType
|-
| year
| TDBXDataTypes.Int16Type
|-
| binary
| TDBXDataTypes.AnsiStringType
|-
| varbinary
| TDBXDataTypes.AnsiStringType
|-
| tinytext
| TDBXDataTypes.AnsiStringType
|-
| text
| TDBXDataTypes.AnsiStringType
|-
| mediumtext
| TDBXDataTypes.AnsiStringType
|-
| longtext
| TDBXDataTypes.AnsiStringType
|-
| tinyblob
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.BinarySubType
|-
| blob
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.BinarySubType
|-
| mediumblob
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.BinarySubType
|-
| longblob
| TDBXDataTypes.BlobType, Untertyp TDBXSubDataTypes.BinarySubType
|-
| bit
| TDBXDataTypes.VarBytesType
|-
| bool
| TDBXDataTypes.Int8Type
|-
| enum
| TDBXDataTypes.AnsiStringType
|-
| set
| TDBXDataTypes.AnsiStringType
|-
| char
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|-
| varchar
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|}

=Firebird=

dbExpress unterstützt nun auch alle Firebird-Datentypen. In der folgenden Tabelle finden Sie die Datentypzuordnungen zwischen dbExpress und Firebird.

{|
|-
! style="text-align: left;" |Firebird-Typ
! style="text-align: left;" |dbExpress-Typ
|-
| integer
| TDBXDataTypes.Int32Type
|-
| bigint
| TDBXDataTypes.Int64Type
|-
| smallint
| TDBXDataTypes.Int16Type
|-
| char
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|-
| varchar
| TDBXDataTypes.WideStringType, wenn der Server UTF-8 verwendet; ansonsten TDBXDataTypes.AnsiStringType
|-
| float
| TDBXDataTypes.DoubleType
|-
| double
| TDBXDataTypes.DoubleType
|-
| decimal
| TDBXDataTypes.BcdType
|-
| numeric
| TDBXDataTypes.BcdType
|-
| date
| TDBXDataTypes.DateType
|-
| time
| TDBXDataTypes.TimeType
|-
| timestamp
| TDBXDataTypes.TimeStampType
|-
| blob
| TDBXDataTypes.BlobType
|}

=Oracle=

dbExpress unterstützt jetzt alle Oracle 11g-Datentypen, einschließlich der neuen Typen XMLType, Binary_Float und Binary_Double.
In der folgenden Tabelle finden Sie die Datentypzuordnungen zwischen dbExpress und Oracle 11g.

{|
|-
! style="text-align: left;" |Oracle-Typ
! style="text-align: left;" |dbExpress-Typ
|-
| bfile
| TDBXDataTypes.BlobType
|-
| blob
| TDBXDataTypes.BlobType
|-
| char
| TDBXDataTypes.AnsiStringType
|-
| clob
| TDBXDataTypes.AnsiStringType
|-
| date
| TDBXDataTypes.TimeStampType
|-
| float
| TDBXDataTypes.BcdType
|-
| binary_float
| TDBXDataTypes.SingleType
|-
| binary_double
| TDBXDataTypes.DoubleType
|-
| interval day to second
| TDBXDataTypes.IntervalType
|-
| interval year to month
| TDBXDataTypes.IntervalType
|-
| long
| TDBXDataTypes.AnsiStringType
|-
| long raw
| TDBXDataTypes.BytesType
|-
| nchar
| TDBXDataTypes.WideStringType
|-
| nclob
| TDBXDataTypes.WideStringType
|-
| number
| TDBXDataTypes.BcdType
|-
| nvarchar2
| TDBXDataTypes.WideStringType
|-
| raw
| TDBXDataTypes.BytesType
|-
| timestamp
| TDBXDataTypes.TimeStampType
|-
| timestamp with local time zone
| TDBXDataTypes.TimeStampType
|-
| timestamp with time zone
| TDBXDataTypes.TimeStampType
|-
| varchar2
| TDBXDataTypes.AnsiStringType
|-
| xmltype
| TDBXDataTypes.AnsiStringType
|}

==See Also==

* [[Von dbExpress unterstützte Datenbankmanagementsysteme|Von dbExpress unterstützte Datenbankmanagementsysteme]]

[[Category:Delphi]]
[[Category:C++]]

DbExpress-Komponenten

2016-06-01T08:33:28Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{DISPLAYTITLE:dbExpress-Komponenten}}
{{Parent|Datenbankanwendungen für die Win32-Plattform entwickeln - Index}}
dbExpress setzt sich aus mehreren "schlanken" Datenbankkomponenten zusammen, die schnellen Zugriff auf SQL-Datenbankserver bieten. dbExpress stellt für jede unterstützte Datenbank ein Treiber-Framework zur Verfügung, das die serverspezifische Software an einheitliche dbExpress-Interfaces anpasst. Wenn Sie eine Datenbankanwendung weitergeben, die dbExpress verwendet, nehmen Sie eine DLL (den serverspezifischen Treiber) in die von Ihnen erstellten Anwendungsdateien auf.

dbExpress ermöglicht Ihnen den schnellen Zugriff auf Datenbanken unter Verwendung unidirektionaler Datenmengen. Unidirektionale Datenmengen sind auf schnellen, unaufwendigen Zugriff auf Datenbankinformationen ausgelegt, wobei nur ein minimaler Zusatzaufwand entsteht. Wie andere Datenmengen können sie einen SQL-Befehl an den Datenbankserver senden und, falls der Befehl mehrere Datensätze zurückgibt, diese Datensätze entgegennehmen. Unidirektionale Datenmengen nehmen keine Zwischenspeicherung der Daten vor, wodurch sie schneller und weniger ressourcenaufwendig als andere Datenmengentypen werden. Weil sie jedoch die Datensätze nicht zwischenspeichern, sind unidirektionale Datenmengen weniger flexibel als andere Datenmengen.

dbExpress-Verbindungen, -Tabellen, -Ansichten und -Stored Procedures, die in einer Datenstrukturansicht angezeigt werden, lassen sich per Drag&Drop in native und verwaltete VCL-Formulare platzieren.

Die Kategorie '''dbExpress''' der '''Tool-Palette''' enthält Komponenten, die mittels '''dbExpress''' auf Datenbankinformationen zugreifen. Dies sind:

{| border="1" frame="hsides" rules="rows"
|-
! '''Komponenten'''
! '''Funktion'''
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLConnection'''
| style="text-align: left; vertical-align: top;" |
Kapselt eine dbExpress-Verbindung zu einem Datenbankserver.
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLDataSet'''
| style="text-align: left; vertical-align: top;" |
Repräsentiert alle über '''dbExpress''' verfügbaren Daten oder sendet Befehle an eine Datenbank, auf die über '''dbExpress''' zugegriffen wird.
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLQuery'''
| style="text-align: left; vertical-align: top;" |
Eine Abfrage-Datenmenge, die eine SQL-Anweisung kapselt und es Anwendungen ermöglicht, auf die Ergebnisdatensätze zuzugreifen.
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLTable'''
| style="text-align: left; vertical-align: top;" |
Eine Tabellen-Datenmenge, die alle Zeilen und Spalten einer einzelnen Datenbanktabelle darstellt.
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLStoredProc'''
| style="text-align: left; vertical-align: top;" |
Eine auf Stored Procedures basierende Datenmenge, die eine auf einem Datenbankserver definierte Stored Procedure ausführt.
|-
| style="text-align: left; vertical-align: top;" |
'''TSQLMonitor'''
| style="text-align: left; vertical-align: top;" |
Fängt die zwischen einer SQL-Verbindungskomponente und einem Datenbankserver gesendeten Informationen ab und speichert diese in einer Stringliste.
|-
| style="text-align: left; vertical-align: top;" |
'''TSimpleDataSet'''
| style="text-align: left; vertical-align: top;" |
Eine Client-Datenmenge, die mit internen Objekten des Typs '''TSQLDataSet''' und '''TDataSetProvider''' Daten abruft und Aktualisierungen einträgt.
|}

==Siehe auch==

* [[DbExpress verwenden|dbExpress verwenden]]
* [[DbExpress-Datenmengen verwenden|dbExpress-Datenmengen verwenden]]
* [[TSQLConnection konfigurieren|TSQLConnection konfigurieren]]
*[[Mit dem Daten-Explorer Verbindungsinformationen ermitteln|Mit dem Daten-Explorer Verbindungsinformationen ermitteln]]

[[Category:Delphi]]
[[Category:C++]]

Daylight

2016-06-01T08:33:26Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Time.h - Index|time.h}}
{{DISPLAYTITLE:_daylight}}

'''Header-Datei'''

time.h

'''Syntax'''

extern int _daylight;

'''Beschreibung'''

_daylight wird von den Uhrzeit- und Datumsroutinen verwendet. Sie legt fest, ob die Laufzeitfunktionen (mktime und localtime) die Sommerzeit berücksichtigen müssen, wenn Sie einen Datumswert bearbeiten, der normalerweise von dieser Einstellung betroffen wird. _daylight wird mit den Werten der Umgebungsvariablen TZ initialisiert und auf 1 gesetzt, wenn die Sommerzeit bei Datums- und Zeitkonvertierungen berücksichtigt werden muss. Ist TZ nicht gesetzt, wird der Wert für _daylight vom Betriebssystem bezogen.

[[Category:C++-Referenz]]
[[Category:C++]]
[[Category:AMMigrate]]

Makro-Funktionen für Datums- und Uhrzeitwerte (FireDAC)

2016-06-01T08:33:24Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Vorverarbeiten von Anweisungstext (FireDAC)}}

__TOC__

Die folgende Tabelle enthält die Makro-Funktionen für Datums- und Uhrzeitwerte:

{| border="1" frame="hsides" rules="rows"
|-
! '''Funktion'''
! '''Beschreibung'''
! '''Lokale Ausdrucks-Engine'''
|-
| style="text-align: left; vertical-align: top;" | CURRENT_DATE( )
| style="text-align: left; vertical-align: top;" | Gibt das aktuelle Datum zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | CURRENT_TIME[(Zeitgenauigkeit)]
| style="text-align: left; vertical-align: top;" | Gibt die aktuelle lokale Uhrzeit zurück. Das Argument Zeitgenauigkeit bestimmt die Sekundengenauigkeit des zurückgegebenen Wertes.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | CURRENT_TIMESTAMP [(Zeitstempelgenauigkeit)]
| style="text-align: left; vertical-align: top;" | Gibt das aktuelle lokale Datum und die lokale Uhrzeit als Zeitstempelwert zurück. Das Argument Zeitstempelgenauigkeit bestimmt die Sekundengenauigkeit des zurückgegebenen Zeitstempels.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | CURDATE( )
| style="text-align: left; vertical-align: top;" | Gibt das aktuelle Datum zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | CURTIME( )
| style="text-align: left; vertical-align: top;" | Gibt die aktuelle lokale Uhrzeit zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | DAYNAME(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt einen Zeichen-String zurück, der den datenquellenspezifischen Namen des Tages (z. B. Sunday bis Saturday oder Sun. bis Sat. für eine Datenquelle, die Englisch verwendet, oder Sonntag bis Samstag für eine Datenquelle, die Deutsch verwendet) für den Tagesanteil von Datumsausdr zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | DAYOFMONTH(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt den Tag des Monats auf Basis des Monatsfeldes in Datumsausdr als Integerwert im Bereich von 1 – 31 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | DAYOFWEEK(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt den Tag der Woche auf Basis des Wochenfeldes in Datumsausdr als Integerwert im Bereich von 1 – 7 zurück, wobei 1 für Sonntag steht.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | DAYOFYEAR(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt den Tag des Jahres auf Basis des Jahresfeldes in Datumsausdr als Integerwert im Bereich von 1 – 366 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | EXTRACT(Extrakt-Feld, Extrakt-Quelle)
| style="text-align: left; vertical-align: top;" |Gibt den Extrakt-Feld-Anteil aus Extrakt-Quelle zurück. Das Argument Extrakt-Quelle ist ein Datums/Zeit- oder Intervallausdruck. Das Argument Extrakt-Feld kann eines der folgenden Schlüsselwörter sein:
* YEAR
* MONTH
* DAY
* HOUR
* MINUTE
* SECOND

Die Genauigkeit des zurückgegebenen Wertes wird durch die Implementierung festgelegt. Die Skalierung ist 0, außer wenn SECOND angegeben ist. In diesem Fall ist die Skalierung nicht kleiner als die minimale Sekundengenauigkeit des "Extrakt-Quelle"-Feldes.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | HOUR(Zeitausdr)
| style="text-align: left; vertical-align: top;" | Gibt die Stunde auf Basis des Stundenfeldes in Zeitausdr als Integerwert im Bereich von 0 – 23 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | MINUTE(Zeitausdr)
| style="text-align: left; vertical-align: top;" | Gibt die Minute auf Basis des Minutenfeldes in Zeitausdr als Integerwert im Bereich von 0 – 59 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | MONTH(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt den Monat auf Basis des Monatsfeldes in Datumsausdr als Integerwert im Bereich von 1 – 12 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | MONTHNAME(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt einen Zeichen-String zurück, der den datenquellenspezifischen Namen des Monats (z. B. January bis December oder Jan. bis Dec. für eine Datenquelle, die Englisch verwendet, oder Januar bis Dezember für eine Datenquelle, die Deutsch verwendet) für den Monatsanteil von Datumsausdr zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | NOW( )
| style="text-align: left; vertical-align: top;" | Gibt das aktuelle Datum und die aktuelle Uhrzeit als Zeitstempelwert zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | QUARTER(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt das Quartal in Datumsausdr als Integerwert im Bereich von 1 – 4 zurück, wobei 1 für das Quartal vom 1. Januar bis zum 31. März steht.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | SECOND(Zeitausdr)
| style="text-align: left; vertical-align: top;" | Gibt die Sekunde auf Basis des Sekundenfeldes in Zeitausdr als Integerwert im Bereich von 0 – 59 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | TIMESTAMPADD(Intervall, Integer-Ausdr, Zeitstempel-Ausdr)
| style="text-align: left; vertical-align: top;" |Gibt den Zeitstempel zurück, der durch Addieren von Integer-Ausdr Intervallen vom Typ Intervall mit Zeitstempel-Ausdr berechnet wird. Gültige Werte von Intervall sind die folgenden Schlüsselwörter:
* FRAC_SECOND (*)
* SECOND
* MINUTE
* HOUR
* DAY
* WEEK
* MONTH
* QUARTER
* YEAR

FRAC_SECOND (Sekundenbruchteil) wird als Milliardstel einer Sekunde ausgedrückt. Die folgende SQL-Anweisung gibt beispielsweise den Namen aller Mitarbeiter zurück und das Datum ihrer einjährigen Betriebszugehörigkeit: SELECT NAME, {fn TIMESTAMPADD(‘YEAR’, 1, HIRE_DATE)} FROM EMPLOYEES. Wenn Zeitstempel-Ausdr ein Zeitwert ist und Intervall Tage, Wochen, Monate, Quartale oder Jahre angibt, wird der Datumsanteil von Zeitstempel-Ausdr auf das aktuelle Datum gesetzt, bevor der Ergebnis-Zeitstempel berechnet wird. Wenn Zeitstempel-Ausdr ein Datumswert ist und Intervall Sekundenbruchteile, Sekunden, Minuten oder Stunden angibt, wird der Zeitanteil von Zeitstempel-Ausdr auf 0 gesetzt, bevor der Ergebnis-Zeitstempel berechnet wird.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | TIMESTAMPDIFF(Intervall, Zeitstempel-Ausdr1, Zeitstempel-Ausdr2)
| style="text-align: left; vertical-align: top;" |Gibt die ganzzahlige Anzahl der Intervalle vom Typ Intervall zurück, um die Zeitstempel-Ausdr2 größer als Zeitstempel-Ausdr1 ist. Gültige Werte von Intervall sind die folgenden Schlüsselwörter:
* FRAC_SECOND (*)
* SECOND
* MINUTE
* HOUR
* DAY
* WEEK
* MONTH
* QUARTER
* YEAR

FRAC_SECOND (Sekundenbruchteil) wird als Milliardstel einer Sekunde ausgedrückt. Die folgende SQL-Anweisung gibt beispielsweise den Namen aller Mitarbeiter zurück und die Anzahl der Jahre ihrer Betriebszugehörigkeit: SELECT NAME, {fn TIMESTAMPDIFF(‘YEAR’, {fn CURDATE()}, HIRE_DATE)} FROM EMPLOYEES. Wenn der Zeitstempelausdruck ein Zeitwert ist und Intervall Tage, Wochen, Monate, Quartale oder Jahre angibt, wird der Datumsanteil dieses Zeitstempels auf das aktuelle Datum gesetzt, bevor die Differenz zwischen den beiden Zeitstempeln berechnet wird. Wenn einer der beiden Zeitstempelausdrücke ein Datumswert ist und Intervall Sekundenbruchteile, Sekunden, Minuten oder Stunden angibt, wird der Zeitanteil dieses Zeitstempels auf 0 gesetzt, bevor die Differenz zwischen den beiden Zeitstempeln berechnet wird.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | WEEK(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt die Woche des Jahres auf Basis des Wochenfeldes in Datumsausdr als Integerwert im Bereich von 1 – 53 zurück.
| style="text-align: left; vertical-align: top;" | +
|-
| style="text-align: left; vertical-align: top;" | YEAR(Datumsausdr)
| style="text-align: left; vertical-align: top;" | Gibt das Jahr auf Basis des Jahresfeldes in Datumsausdr als Integerwert zurück. Der Bereich ist von der Datenquelle abhängig.
| style="text-align: left; vertical-align: top;" | +
|}

(*) Einige DBMSs können nicht mit FRAC_SECOND arbeiten.

[[Category:FireDAC]]
[[Category:AMMigrate]]

DataSnap-Server-Anwendung

2016-06-01T08:33:21Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{parent|DataSnap-Anwendungen entwickeln}}

<blockquote>'''Hinweis:''' Wenn Sie auf TObject basierte Typen auf einem C++-DataSnap-Server bereitstellen möchten, müssen sich die Typen in einem {{Delphi}}-Package befinden. Wechseln Sie zum Aktivieren von {{Delphi}}-Packages zu '''Projekt > Optionen > Packages''', und wählen Sie die Option '''Laufzeit-Packages verwenden''' aus. </blockquote>

==Themen==

* [[Erstellen eines DataSnap-Servers|Erstellen eines DataSnap-Servers]]
* [[DataSnap-Server-Experte|DataSnap-Server-Experte]]
* [[Experte für DataSnap-REST-Anwendungen|Experte für DataSnap-REST-Anwendungen]]
* [[Experte für DataSnap WebBroker-Anwendungen|Experte für DataSnap WebBroker-Anwendungen]]
* [[Erstellen von DataSnap-Servermethoden-Proxies|Erstellen von DataSnap-Servermethoden-Proxies]]
* [[Bereitstellen von DataSnap-Servermethoden|Bereitstellen von DataSnap-Servermethoden]]
* [[Verwendung von Callback-Funktionen|Verwendung von Callback-Funktionen]]
* [[Eigenschaft LifeCycle der Serverklasse|Eigenschaft LifeCycle der Serverklasse]]
* [[Überwachen und Steuern von DataSnap-TCP/IP-Verbindungen|Überwachen und Steuern von DataSnap-TCP/IP-Verbindungen]]

==Siehe auch==

* [[Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden#Client-Anwendung erstellen|Tutorial: DataSnap-Server/Client]]
* [[Steuerelemente für DataSnap-Server|Steuerelemente für DataSnap-Server]][[en:DataSnap Server Application|en:DataSnap Server Application]]

[[Category:Delphi]]
[[Category:C++]]
[[Category:DataSnap-Referenz]]

DataSnap-REST-Nachrichtenprotokoll

2016-06-01T08:33:19Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|DataSnap-REST}}

Dieses Thema beschreibt das REST-Nachrichtenprotokoll für DataSnap, das den Remote-Aufruf von Servermethoden sowie die Registrierung von Heavyweight-Callbacks ermöglicht. Anhand der Informationen in diesem Thema können Sie in jeder beliebigen Sprache Clients implementieren, die mit einem DataSnap-Server über HTTP-Anforderungen kommunizieren können.

==Remote-Methodenaufruf==

Wenn ein DataSnap-Server über eine aktive Komponente zur Behandlung von HTTP-Verbindungen verfügt, wird ein Nachrichtenprotokoll bereitgestellt, wobei HTTP-Anforderungen an den Server gesendet werden können, um public-Methoden einer für den Server mit einer TDSServerClass-Komponente registrierten Klasse aufzurufen. Am einfachsten rufen Sie eine Servermethode über eine GET-Anforderung mit dem folgenden URL und ohne Inhalt im Nachrichtenrumpf auf:

http://host:port/datasnap/rest/[ClassName]/[MethodName]/[ParamValue]

<code>Port</code> und <code>ParamValue</code> sind optional. "datasnap" und "rest" sind gewissermaßen auch optional und müssten – abhängig von den Werten der Eigenschaften DSContext und RESTContext für die HTTP-Verbindung auf dem Server – geändert werden.

===Parameter in dem URL===

<code>ParamValue</code> repräsentiert eine durch Schrägstrich (/) getrennte Liste mit Parameterwerten, die den für die aufzurufende Servermethode erforderlichen Eingabeparametern entsprechen. Wenn die Servermethode (Funktion/Prozedur) keine Eingabeparameter hat, dann darf hinter dem Methodennamen in dem URL nichts mehr stehen. Durch zwei Schrägstriche (//) im Abschnitt des URLs, der die Parameterwerte repräsentiert, wird der Wert des Parameters an dieser Indexposition auf einen leeren String gesetzt.

Die auf diese Weise übergebenen Werte müssen URL-sicher verschlüsselt sein, was auch für die Verschlüsselung von Unicode-Zeichen gilt. Werte mit einer JSON-Objekt- oder JSON-Array-Repräsentation dürfen nicht auf diese Weise übergeben werden: sie müssen im Rumpf der HTTP-Anforderung übergeben werden, und der Anforderungstyp muss POST oder PUT sein.

===Parameter im Anforderungsrumpf===

Wenn Sie eine Servermethode aufrufen möchten, die einen nicht von einer GET- oder DELETE-Anforderung unterstützten Eingabeparameter hat (z.B. ein Parameter, der nicht als String, Zahl, Boolean oder Null dargestellt werden kann), oder wenn Sie einfach einen oder mehrere Parameter im Inhalt der Anforderung übergeben möchten, müssen Sie den Anforderungstyp POST oder PUT verwenden.

Wenn Sie beispielsweise eine Servermethode wie die folgende aufrufen möchten:

function TServerMethods1.updateEchoAttribute(Key: String; Obj: TJSONObject): String;

Dann sollte Ihre Anforderung folgendermaßen lauten:

POST /datasnap/rest/TServerMethods1/EchoAttribute/Attr1 HTTP/1.1
....*additional headers*...
Accept: application/json
Content-Type: text/plain;charset=UTF-8

{"Attr1":"ValueToReturn"}

Diese Anforderung enthält einige Einträge, die näher erläutert werden müssen. Beachten Sie zunächst, dass der übergebene Methodenname "EchoAttribute" und nicht "updateEchoAttribute" lautet. Standardmäßig wird nämlich das Präfix "update" jeder Methode zugeordnet, die mit POST aufgerufen wird. Ebenso wird das Präfix "cancel" für DELETE-Anforderungen und das Präfix "accept" für PUT-Anforderungen verwendet. Diese Art der Präfixverwendung kann durch Setzen des Methodennamens in Anführungszeichen vermieden werden. Die erste Zeile der Anforderung würde dann folgendermaßen lauten:

POST /datasnap/rest/TServerMethods1/%22updateEchoAttribute%22/Attr1 HTTP/1.1

Diese Anforderung ruft auch die updateEchoAttribute-Servermethode auf, aber die Anführungszeichen verhindern, dass ein zusätzliches "update" vor den angegebenen Servernamen gesetzt wird. Das Setzen des Methodennamens in Anführungszeichen ermöglicht zudem den Aufruf von Servermethoden mit POST, PUT oder DELETE, denen keine dem Anforderungstyp entsprechenden Namen vorangestellt werden. Falls die Servermethode zum Beispiel folgendermaßen lautet:

function TServerMethods1.EchoAttribute(Key: String; Obj: TJSONObject): String;

Dann wäre das Setzen des Methodennamens in Anführungszeichen erforderlich, da der Wert eines TJSONObject in dem Anforderungs-URL nicht unterstützt wird. Das heißt, eine GET-Anforderung, der einzige Anforderungstyp, der standardmäßig kein Methodenpräfix voraussetzt, kann nicht verwendet werden. Die POST-Anforderung würde folgendermaßen lauten:

POST /datasnap/rest/TServerMethods1/%22EchoAttribute%22/Attr1 HTTP/1.1

All diese Beispiele haben dasselbe Ergebnis, wobei die Servermethode mit "Attr1" als Wert des Parameters <code>Key</code> aufgerufen wird und der Wert von Obj ein JSON-Objekt ist, das eine Eigenschaft "Attr1" und einen zugehörigen Wert hat. Der Inhalt der Antwort enthält das Ergebnis des Aufrufs der Servermethode, das in diesem Beispiel der String "ValueToReturn" wäre.

Wenn Sie mehrere Parameterwerte in dem Anforderungsinhalt übergeben möchten, müssen Sie sie in der richtigen Reihenfolge in ein JSON-Array setzen, und dieses Array als Wert eines JSON-Objektpaars mit dem Schlüsselwort "_parameters" angeben. Das JSON-Ergebnisobjekt muss als String dargestellt und folgendermaßen als Inhalt der Anforderung gesetzt werden:

{"_parameters":["Param1", "Param2"]}

Bei diesem Format werden zuerst die Eingabeparameter aus dem Anforderungs-URL und dann die übrigen Eingabewerte der Reihenfolge nach aus dem Array _parameters übernommen.

In der Anforderung sind Abfrageparameter zulässig. Der Benutzer erhält dann aus Servermethoden Zugriff auf die im URL übergebenen Abfrageparameter durch Abrufen der '''Aufrufs-Metadaten''' (mit einem Aufruf von '''GetInvocationMetadata()''' nach dem Hinzufügen der [[lib_de:Data.DBXPlatform|DBXPlatform]] zu der '''uses'''-Klausel) und Zugreifen auf die Liste der gespeicherten Parameter. Dem HTTP-Dienst des Servers wurde das Ereignis '''FormatResult''' hinzugefügt, mit dem die JSON-Antwort in einem beliebigen Format für Methodenaufrufe zurückgegeben werden kann.

===Aufrufantwort===

Die von einer Aufrufanforderung zurückgegebene Antwort hat einen Antworttext, der eine String-Repräsentation eines JSON-Objekts ist, das etwa folgendermaßen aussieht:

{"result":["ValueToReturn"]}

Bei korrektem Zerlegen in eine JSON-Objektinstanz können Sie für die Eigenschaft "result" das JSON-Array ermitteln. Dieses Array enthält die Werte für alle Parameter in der Reihenfolge ihrer Anordnung in der Signatur der Servermethode, die zurückgegeben werden (out, var, Ergebnistypen). Das Ergebnis ist immer der letzte Eintrag in dem Array, und in diesem Beispiel ist es ein JSON-String mit dem Wert, der von der Implementierung der Servermethode EchoAttribute zurückgegeben würde.

Wenn während des Aufrufs auf dem Server ein Fehler auftritt, wie z.B. eine abgelaufene Sitzung, ein unbefugter Benutzer oder ungültige Eingabewerte, dann enthält das zurückgegebene JSON-Objekt anstatt einer "result"-Eigenschaft eine "error"- oder "SessionExpired"-Eigenschaft, wie die folgende:

{"SessionExpired":"Die angegebene Sitzung ist abgelaufen, weil sie inaktiv war oder eine ungültige Sitzungs-ID hatte"}

===Festlegen des Stream-Antworttyps===

Wenn das Ergebnis eines Methodenaufrufs ein TStream-Objekt ist, dann kann der Stream entweder als JSON-Array oder als Inhalts-Stream der Antwort zurückgegeben werden. Mit dem URL-Parameter "json" können Sie folgendermaßen festlegen, ob ein JSON-Array oder ein Inhalts-Stream zurückgegeben werden soll:

http://host:port/datasnap/rest/[Class]/[Method]/?json=true

Sie können den Wert auf "True" oder "False" setzen. Bei "True" wird das Ergebnis immer als JSON-Array zurückgegeben. Bei "False" wird das Ergebnis als Inhalts-Stream zurückgegeben, sofern keine anderen var/out/result-Parameter zurückgegeben werden.

==Authentifizierung==

Wenn für den Server eine Authentifizierung erforderlich ist, dann müssen Sie im "Autorisierungs"-Header der Anforderung Ihre Authentifizierungsdaten (Benutzername und Passwort) korrekt formatiert übergeben. Dies ist aber nur erforderlich, wenn Sie keine Sitzungs-ID in der Anforderung angeben. Das Format des Wertes des Autorisierungs-Headers lautet:

Basic base64(Benutzer:Passwort)

Oder, falls der Benutzername beispielsweise "admin" und das Passwort ebenfalls "admin" ist:

Basic YWRtaW46YWRtaW4=

Der String für die base64-Kodierung muss ein einzelner String sein, der den Namen und das Passwort durch Doppelpunkt getrennt enthält.

==Anforderungsfilter==

DataSnap verwendet zum Filtern von Ergebnissen das Konzept der Anforderungsfilter. Diese vordefinierten Filter verbinden in eine API, mit der in dem URL die Filter für den jeweiligen Parameter und die an diesen Filter zu übergebenden Werte festgelegt werden können. Eine Serverfunktion könnte z.B. einen sehr großen String zurückgeben, wovon Sie aber möglicherweise nur die ersten Zeichen benötigen. In diesem Fall können Sie mit dem SubString-Filter den Bereich des Strings festlegen, an dem Sie interessiert sind. Das folgende Beispiel ist ein URL für eine Serverfunktion mit einem einzelnen Eingabeparameter und einem String-Ergebnis:

http://host:port/datasnap/rest/[Class]/[Method]/[ParamValue]?ss.r=1,3

Der Teil nach dem "?" definiert, welcher Filter für welche(n) Parameter verwendet werden soll. In diesem Fall wird für den Rückgabe-String (wenn kein Parameterindex angegeben ist, wird der Filter auf das Ergebnis angewendet) mit der Bereichsfunktion des SubString-Filters festgelegt, dass das Ergebnis ein aus drei Zeichen bestehender Teilstring sein soll, der mit dem zweiten Zeichen des Ergebnisses beginnt.

Weitere Informationen finden Sie unter [[Anforderungsfilter|Anforderungsfilter]].

==Sitzungsinformationen==

Wenn Sie eine Servermethode aufrufen, die Sie nicht in einer Sitzungs-ID der Anforderung übergeben haben, wird eine neue Sitzung auf dem Server erstellt, und die Sitzungs-ID wird in dem "Pragma"-Header bereitgestellt. Der für diesen Header gespeicherte Wert enthält zwei Schlüssel, "dssession" und "dssessionexpires". Der erste ist die ID der Sitzung auf dem Server und der zweite ist eine Schätzung der verbleibenden Millisekunden bis zum Ablauf der Sitzung. Wenn "dssessionexpires" nicht angegeben oder ein negativer Wert ist, dann läuft die Sitzung nicht ab und muss geschlossen werden, wenn sie vom Client nicht mehr benötigt wird. Die Sitzungs-ID müssen Sie in dem "Pragma"-Header jeder weiteren Anforderung im folgenden Format übergeben:

dssession=[Sitzungs-ID]

Anhand der Millisekunden bis zum Sitzungsablauf können Sie feststellen, ob die Sitzungs-ID nicht mehr gültig ist und entscheiden, sie nicht mit künftigen Anforderungen zu übergeben, weil sie wahrscheinlich ungültig wäre und einen SessionExpired-Fehler liefern würde. Wenn Sie ein SessionExpired-Ergebnis vom Server erhalten, müssen Sie die gespeicherte Sitzungs-ID löschen und zulassen, dass der Server bei der nächsten Anforderung eine neue ID vergibt.

Um die Sitzung vor deren Ablauf zu schließen, führen Sie eine GET-Anforderung mit dem folgenden URL aus und übergeben im Pragma-Header der Anforderung die Sitzungs-ID, wie oben erläutert:

http://host:port/datasnap/rest/CloseSession/

Damit wird die Sitzung mit der angegebenen ID beendet und bei Erfolg der folgende Antworttext zurückgegeben (bei Misserfolg wird die SessionExpired-Meldung zurückgegeben):

{"result":[true]}

==Zwischenspeicherung von Sitzungsparametern==

Eine Verwendung für Sitzungen auf dem Server ist die optionale Speicherung von Parameterwerten aus früheren Aufrufen, damit Ergebnisse eines Methodenaufrufs mehrfach abgerufen werden können, ohne dass die Methode selbst erneut aufgerufen werden muss. Parameter, für die eine JSON-Objekt- oder JSON-Array-Repräsentation erforderlich ist, wie z.B. Streams und benutzerdefinierte Typen, können im Zwischenspeicher gespeichert werden.

Um festzulegen, dass der Zwischenspeicher verwendet werden soll, müssen Sie in der Anforderung den Header-Wert "Accept" auf "application/rest" setzen. Wenn Sie eine Servermethode aufrufen, deren Ergebnis beispielsweise ein TJSONObject ist, wird ein neuer Zwischenspeichereintrag erstellt, der den Zugriff auf das JSON-Ergebnisobjekt ermöglicht. Der vom Aufruf zurückgegebene Wert hat die folgende Form:

{"result":["0/0/0"],"cacheId":0,"cmdIndex":0}

"0/0/0" steht an der Stelle, an der das tatsächliche Aufrufergebnis erscheinen würde. Dabei handelt es sich um den Bezeichner und den relativen Pfad zu dem jeweiligen Eintrag im Zwischenspeicher. Das Format dieses relativen Pfades kann folgendermaßen interpretiert werden:

[Zwischenspeicher-Eintrags-ID]/[Befehlsindex]/[Parameterindex]

<code>Zwischenspeicher-Eintrags-ID</code> ist der eindeutige Bezeichner für den Methodenaufruf, den Sie ausführen. Nur Ausführungen, die Ergebnisse im Zwischenspeicher speichern, erhalten eindeutige Bezeichner. <code>Befehlsindex</code> gibt an, zu welchem Befehl der Ausführung das Ergebnis gehört. Dies ist nur ein Wert ungleich Null, wenn es sich um eine Stapelausführung (gleichzeitig mehrere Servermethoden) handelt. <code>Parameterindex</code> ist der Index des komplexen Parameters, der zurückgegeben werden soll. Der Index beginnt bei Null und basiert auf den komplexen Parametern des Befehls, nicht auf allen Parametern des Befehls.

Die weiteren Werte von "cacheId" und "cmdIndex" sind dieselben Werte, die als die ersten beiden Zahlen in "0/0/X" erscheinen. Wenn für den Methodenaufruf mehr als ein zwischengespeichertes Ergebnis vorhanden ist, enthält das Array "result" mehrere Einträge, die aber alle die "cacheId"- und "cmdIndex"-Werte gemeinsam nutzen, da sie Teil desselben zwischengespeicherten Eintrags und Ergebnisse desselben Methodenaufrufs sind.

Mit diesen relativen Pfaden erstellen Sie einen Zwischenspeicher-URL. Der Zwischenspeicher-URL verwendet "cache" (CacheContext) anstelle von "rest" (RESTContext), und ihm wird dann der im Aufrufergebnis zurückgegebene relative URL nachgestellt.

Zwischenspeicher-URLs unterstützen die Anforderungstypen GET und DELETE. Wenn GET gesendet wird, sind die folgenden URLs verfügbar:

{|
|-
|
<nowiki>http://host:port/datasnap/cache</nowiki>
| Gibt ein JSON-Objekt zurück, das den Inhalt des Zwischenspeichers beschreibt.
|-
|
<nowiki>http://host:port/datasnap/cache/(CacheID)</nowiki>
| Gibt ein JSON-Objekt zurück, das das Zwischenspeicherungsobjekt mit der angegebenen ID beschreibt.
|-
|
<nowiki>http://host:port/datasnap/cache/(CacheID)/(CmdIndex)</nowiki>
| Gibt eine JSON-Repräsentation des angegebenen Befehls zurück.
|-
|
<nowiki>http://host:port/datasnap/cache/(CacheID)/(CmdIndex)/(ParameterIndex)</nowiki>
| Gibt den tatsächlichen Parameter als JSON oder Stream zurück.
|}

Bei einem DELETE-Befehl werden die folgenden URLs unterstützt:

{|
|-
| <nowiki>http://host:port/datasnap/cache</nowiki>
| Löscht alle zwischengespeicherten Einträge.
|-
| <nowiki>http://host:port/datasnap/cache/(CacheID)</nowiki>
| Löscht den zwischengespeicherten Eintrag und alle zugehörigen Befehle/Parameter.
|}

Wenn Sie den Zwischenspeicher nicht leeren, wird er beim Ablauf der Sitzung geleert und freigegeben.
Weitere Informationen finden Sie unter [[Zwischenspeicherung von DBX-Parametern|Zwischenspeicherung von DBX-Parametern]].

==Heavyweight-Callbacks==

Heavyweight-REST-Callbacks ermöglichen einem Client eine HTTP-Anforderung mit langen Ausführungszeiten zu senden, die sich wie eine beim Server registrierte Callback-Funktion verhält. Der Anforderung sind Informationen zugeordnet, die dem Server mitteilen, wie er zu antworten hat. Wird eine Antwort abgerufen, wird eine neue Anforderung an den Server gesendet, um die Callback-Funktion zurück in einen empfangsbreiten Zustand zu versetzen.

===Registrieren einer Heavyweight-Callback-Funktion (Client-Kanal)===

Die ursprüngliche Anforderung, die das Heavyweight-Callback-Handshake startet, sollte folgendermaßen formatiert und als GET-Anforderung gesendet werden:

http://host:port/datasnap/rest/DSAdmin/ConsumeClientChannel/[SCN]/[CHID]/[CBID]/[SCNS]/[ST]//

Mit diesem Handshake wird eigentlich eine Callback-Funktion registriert, die selbst eine oder mehrere Callbacks enthält, zu denen sie verzweigt. SCN ist der Name des Serverkanals, für den diese Callback-Funktion empfangsbereit sein soll. Dieser Wert kann alles sein, was der Server möglicherweise senden oder mitteilen kann. SCNS ist eine durch Komma getrennte Liste der Kanalnamen des Servers für die registrierte Callback-Funktion. Diese Liste kann leer (die Callback-Funktion verwendet einfach den <code>ServerChannelName</code> des Kanals) oder eine Liste sein, die dem <code>ServerChannelName</code> des Kanals hinzugefügt wird. Weitere Informationen dazu finden Sie in der DocWiki-Dokumentation über Heavyweight-REST-Callbacks. Wenn der Server etwa folgendermaßen sendet:

Val := TJSONString.Create(Memo1.Text);
[DSServer].BroadcastMessage('MemoChannel', Val);

Dann soll der Wert von SCN als "MemoChannel" übergeben werden, damit Sie diesen speziellen Broadcast empfangen können.

CHID ist eine eindeutige ID für den Callback-Kanal des Clients. Dies kann Verschiedenes sein, aber der Aufruf schlägt fehl, wenn CHID nicht für die bereits auf dem Server vorhandenen Werte eindeutig ist. CBID ist eine eindeutige ID für die erste Callback-Funktion des Callback-Kanals des Clients. Weil ein Callback-Kanal immer mindestens eine Callback-Funktion enthalten muss, ist dieser Parameter erforderlich. Weitere untergeordnete Callbacks können später registriert werden. ST ist ein Sicherheits-Token, das Sie hier definieren. In allen künftigen Aufrufen zur Änderung des Client-Kanals, wie z.B. Hinzufügen oder Entfernen von Callbacks, müssen Sie dieses Sicherheits-Token angeben, um sich bei dem zu modifizierenden Kanal zu validieren. Der letzte Parameter (//) wird beim Registrieren des Kanals als leerer String übergeben.

Wenn die Registrierung erfolgreich erstellt wurde, wird sofort eine Antwort zurückgegeben, die etwa folgendermaßen aussieht:

{"result":[{"invoke":["cb12345",{"created":true},1]}]}

"cb12345" ist dabei die eindeutige ID der Callback-Funktion, die bei der Erstellung des Client-Kanals (CBID) registriert wurde. Senden Sie sofort eine weitere Anforderung (siehe dazu die Schritte weiter unten), damit die Callback-Funktion aktiv bleibt.

===Stoppen von Heavyweight-Callbacks===

Senden Sie zum Stoppen einer zuvor erstellten Heavyweight-Callback-Funktion eine GET-Anforderung an den folgenden URL:

http://host:port/datasnap/rest/DSAdmin/CloseClientChannel/[SCN]/[CHID]/[ST]

SCN, CHID und ST sind dabei dieselben Werte, die beim ersten Erstellen übergeben wurden.

===Hinzufügen einer Callback-Funktion zu einem Client-Kanal===

Ein Client-Kanal kann mehrere verschachtelte Callback-Funktionen enthalten. Es muss aber mindestens eine vorhanden sein. Senden Sie zum Registrieren einer weiteren Callback-Funktion bei dem Client-Kanal den folgenden URL mit einer GET-Anforderung:

http://host:port/datasnap/rest/DSAdmin/RegisterClientCallbackServer/[SCN]/[CHID]/[CBID]/[SCNS]/[ST]/

SCN, CHID, SCNS und ST sind dabei dieselben Werte, die Sie beim Erstellen des Client-Kanals angegeben haben, und CBID ist eine für den Client-Kanal eindeutige ID für die neue Callback-Funktion.

===Entfernen einer Callback-Funktion aus einem Client-Kanal===

Callbacks können aus einem Client-Kanal entfernt werden. Wenn Sie die letzte Callback-Funktion entfernen, wird der Kanal geschlossen. Senden Sie zum Entfernen einer Callback-Funktion den folgenden URL mit einer GET-Anforderung:

http://host:port/datasnap/rest/DSAdmin/UnregisterClientCallback/[SCN]/[CHID]/[CBID]/[SCNS]/[ST]/

SCN, CHID, SBID, SCNS und ST sind dabei dieselben Werte, die Sie beim Registrieren der Callback-Funktion (entweder mit der ConsumeClientChannel- oder der RegisterClientCallbackServer-Methode) übergeben haben.

===Antworten vom Server===

Eine Antwort auf eine Heavyweight-Callback-Anforderung kann in verschiedenen Situationen auftreten. Wie bereits weiter oben erwähnt, erfolgt eine, wenn der Kanal erfolgreich erstellt wurde. Eine weitere, wenn die Heavyweight-Callback-Funktion geschlossen wird. Die häufigste Antwort ist jedoch ein Broadcast oder eine Nachricht. Nachrichten von einem Server zielen auf eine einzelne Callback-Funktion eines Client-Kanals ab, während Broadcasts an alle Callbacks ausgegeben werden sollten.

Bei einer Callback-Funktion mit der ID "cd12345" könnte ein Antworttext einer gesendeten Anforderung folgendermaßen aussehen:

{"result":[{"invoke":["cb12345","Hello World" ,1]}]}

Dieser Antworttext bedeutet, dass ein Aufruf (Nachricht) vom Server mit dem Inhalt gesendet wurde, dass die Callback-Funktion mit der ID "cd12345" aufgerufen und der String-Wert "Hello World" vom Typ 1 übergeben werden soll. Typ 1 bedeutet, dass der Wert als JSON behandelt werden soll. Typ 2 bedeutet, dass er eine JSON-Objektrepräsentation eines Benutzerobjekts ist. Typ 1 ist vermutlich gebräuchlicher. Der Wert muss kein String sein, er kann ein beliebiger JSON-Wert sein.

Sendet der Server einen Broadcast, dann wird er an alle Callbacks des Client-Kanals gerichtet und enthält daher keine ID. Der Antworttext würde folgendermaßen lauten:

{"result":[{"broadcast":["Hello World",1]}]}

Wird die Heavyweight-Callback-Funktion geschlossen, wird der folgende Antworttext zurückgegeben:

{"result":[{"close":true}]}

===Beantworten einer Antwort vom Server===

Wenn die Heavyweight-Callback-Anforderung eine Antwort vom Server erhält, müssen Sie die Botschaft so schnell wie möglich behandeln und dann eine neue Anforderung ausführen. Die Anforderung, die Sie senden, ist fast identisch mit der Anforderung zum Registrieren des Client-Kanals, mit nur einigen kleinen Unterschieden. Erstens muss der Befehl als POST gesendet werden. Der URL der Anforderung würde folgendermaßen aussehen:

http://host:port/datasnap/rest/DSAdmin/ConsumeClientChannel/[SCN]/[CHID]//[ST]

CBID ist ein leerer String (weil keine neuen Callbacks registriert werden) und weil es sich um ein POST handelt, wird der letzte Parameter (ein leerer String; zwei Schrägstriche für die Registrierung des Client-Kanals) weggelassen. Dieser wird im Anforderungsrumpf übergeben.

Der Anforderungsrumpf muss das vom Client-Kanal zurückgegebene Ergebnis (das ein JSON-Wert im String-Format sein kann) enthalten. Im Allgemeinen hat es sich bewährt entweder "True" oder "False" zurückzugeben. Wenn die Benachrichtigung ausgeführt wurde, sollte das Ergebnis der Wert sein, der für die spezifische, aufzurufende Callback-Funktion zurückgegeben wurde. Wenn der Broadcast ausgeführt wurde, sollte der zurückgegebene Wert auf allen von den Callbacks gelieferten Werten basieren (z.B. "False" außer alle Callbacks haben "True" zurückgegeben).

Weitere Informationen finden Sie unter [[Codeintensive REST-Callback-Funktionen|Codeintensive REST-Callback-Funktionen]].

==Ein Beispiel für Übertragungen mit PHP DataSnap REST==

Das folgende native PHP-Codebeispiel verwendet DataSnap REST für die Übergabe eines Arrays.

<source lang="php">

<?php
// type -> unit name (uCidade) . object name (TCidade)
// fileds -> fields must be the same in declared class
$cidade = array( "type" => "uCidade.TCidade" , "id" => 1 , "fields" => array ( "FId" => 41000 , "FDescricao" => "LINS" , "FUF" => "SP" ) );
$url = 'http://localhost:8080/datasnap/rest/TServerMethodsMain/%22AddCidade%22/' ;
$ch = curl_init() ;
curl_setopt( $ch , CURLOPT_HTTPHEADER, array ( "Accept: application/json" , "Content-Type: text/xml; charset=utf-8" ) ) ;
curl_setopt( $ch , CURLOPT_HEADER , FALSE ) ;
curl_setopt( $ch , CURLOPT_RETURNTRANSFER , true ) ;
curl_setopt( $ch , CURLOPT_POST , TRUE ) ;
curl_setopt( $ch , CURLOPT_URL , $url ) ;
curl_setopt( $ch , CURLOPT_POSTFIELDS , json_encode( $cidade ) ) ;
$result = curl_exec( $ch ) ;

echo '<pre>';
print_r ($result);
echo '</pre>';
?>

</source>

<blockquote>'''Hinweis:''' RAD PHP hat einen eigenen Proxy-Generator, es generiert aber kein [[lib_de:System.JSON.TJSONObject|TJSONObject]], wie aus dem obigen Beispiel ersichtlich.</blockquote>

[[Category:Delphi]]
[[Category:DataSnap-Referenz]]

Experte für DataSnap-REST-Client-Module

2016-06-01T08:33:13Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Menü Datei|Datei (Menü)}}
<ideTag id="">hcDDataSnapRESTClientModule</ideTag>
 '''Datei > Neu > Weitere > {{Delphi}}-Projekte > DataSnap-Server > DataSnap-REST-Client-Modul''' 
 '''Datei > Neu > Weitere > {{CBuilderUI}} > DataSnap-Server > DataSnap-REST-Client-Modul''' 

<blockquote>'''Tipp:''' Der Experte für DataSnap-Client-Module ist nur verfügbar, nachdem Sie einen DataSnap-Server erstellt haben.</blockquote>

==Experte für DataSnap-REST-Client-Module==

DataSnap-REST-Client-Module ermöglichen von der IDE aus eine einfache Verbindung zu einem DataSnap-Server. Erstellen Sie zuerst eine neue VCL-Formularanwendung, und wählen Sie dann über das Menü '''Datei > Neu''' den Eintrag '''DataSnap-REST-Client-Modul''' aus.

Der Experte für DataSnap-REST-Client-Module ist dem Experten für DataSnap-Client-Module sehr ähnlich, enthält aber standardmäßig nur drei Schritte. Die folgenden Bildern zeigen die drei Schritte dieses Experten.

[[File:DSRESTClientModule1.png]]

Der erste Schritt des Experten für DataSnap-REST-Client-Module ist fast identisch mit dem Experten für DataSnap-Client-Module. Sie wählen hier den Speicherort des Computers aus, auf dem der DataSnap-Server ausgeführt wird.

[[File:DSRESTClientModule2.png]]

IIm zweiten Schritt des Experten müssen Sie Informationen zu dem Typ des DataSnap-Servers für die konfigurierte Verbindung angeben. Wie bei den anderen Schritten ist jede Option selbsterklärend: Klicken Sie darauf, und der Experte zeigt einen Hinweis zu der ausgewählten Option an.

[[File:DSRESTClientModule3.png]]

Im dritten Schritt des Experten für DataSnap-REST-Client-Module müssen Sie den Kommunikations-Port, den DataSnap-Kontext, den Benutzernamen und das Passwort angeben, um zur das Client-Modul fertigzustellen. Der Experte bietet auch die Möglichkeit, die Verbindung mit der Schaltfläche '''Verbindung testen''' zu überprüfen. Damit wird gewährleistet, dass die Verbindung erfolgreich eingerichtet wurde.

==Weitere Hinweise==

Weder der Experte für DataSnap-Client-Module noch der Experte für DataSnap-REST-Client-Module kann aufgerufen werden, wenn nicht zuerst eine VCL-Formularanwendung erstellt wurde oder bereis in der IDE geöffnet ist. Wenn keine VCL-Formularanwendung in der IDE geladen ist, sind die beiden Einträge DataSnap-Client-Modul und DataSnap-REST-Client-Modul im Dialogfeld Objektgalerie ( '''Datei > Neu > Weitere''') deaktiviert, so dass Sie sie nicht auswählen können.

==Siehe auch==

* [[DataSnap-Anwendungen entwickeln|DataSnap-Anwendungen entwickeln]]
* [[Mehrschichtige Anwendungen erstellen - Index|Mehrschichtige Anwendungen erstellen - Index]]
* [[DataSnap-Server-Experte|DataSnap-Server-Experte]]
* [[Experte für DataSnap-REST-Anwendungen|Experte für DataSnap-REST-Anwendungen]]
* [[Experte für DataSnap WebBroker-Anwendungen|Experte für DataSnap WebBroker-Anwendungen]]

[[Category:Delphi]]
[[Category:C++]]

DataSnap Überblick und Architektur

2016-06-01T08:33:08Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|DataSnap-Anwendungen entwickeln}}

DataSnap (früher bekannt als MIDAS) ist eine {{Delphi}}-Technologie für die Entwicklung von mehrschichtigen Anwendungen, vor allem von mehrschichtigen Datenbankanwendungen. {{CBuilder}} wird auch vollständig unterstützt. DataSnap ist nicht von MIDAS abhängig. DataSnap ermöglicht das Entwickeln von Client-Serveranwendungen, die über das Internet, das lokale Netzwerk oder den lokalen Host kommunizieren.

Die wesentlichste Funktion von DataSnap ist die Möglichkeit, von Client-Anwendungen aus Methoden aufzurufen, die auf einem Server implementiert sind. DataSnap erzeugt automatisch das erforderliche Interface für den Client zur Kommunikation mit dem Server, der die Prototypen der Servermethoden enthält.

[[Image:DataSnapCloud.png]]

DataSnap ermöglicht es dem Client mithilfe einer abgesicherten Übertragung von JSON-Daten (JavaScript Object Notation) über TCP/IP oder HTTP, sicher mit dem Server zu kommunizieren. Die Sicherheit wird durch die Definition von Filtern an beiden Enden des Kommunikationskanals zur Verschlüsselung und Komprimierung weiter erhöht.

Ein weiterer Vorteil der DataSnap-Technologie ist die Möglichkeit, alle Client-Anwendungen asynchron über auf dem Server vorgenommene Änderungen zu informieren, so dass Clients entsprechende Aktionen ausführen können. Das Callback erfordert nicht, dass Clients Servermethoden aufrufen.

Ein Beispiel für das Erstellen einer DataSnap-Anwendung finden Sie auf den folgenden Seiten: {{f|datasnap|

* [[Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden|Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden]]}}
* [[Tutorial: Einen DataSnap-REST-Server mit einer Anwendung verwenden|Tutorial: Einen DataSnap-REST-Server mit einer Anwendung verwenden]]{{f|dbexpress|
* [[Tutorial: Eine InterBase-Datenbank in einer Delphi- oder C++-Anwendung verwenden|Tutorial: Eine InterBase-Datenbank in einer {{Delphi}}- oder C++-Anwendung verwenden]] (mit einem DataSnap-Server)}}

==DataSnap-Architektur==

Die DataSnap-Technologie ermöglicht die Entwicklung von Client-Serveranwendungen, wobei entweder der Client oder der Server oder beide {{Delphi}}- oder {{CBuilder}}-Anwendungen ausführen. Die Kommunikation zwischen dem Client und dem Server kann über den lokalen Host, über das lokale Netzwerk oder über das Internet erfolgen. Sie legen den Verbindungstyp während des Entwurfs durch Setzen der Eigenschaft '''CommunicationProtocol''' einer TSQLConnection-Komponente auf TCP/IP oder HTTP fest.

Die Client-Serverkommunikation wird durch den Austausch von JSON-Daten (JavaScript Object Notation) erreicht. {{f|webbroker|Die Serverantwort kann im HTML-Format unter Verwendung der WebBroker-Technologie gesendet werden.}}

Wenn entweder auf dem Client oder dem Server eine Firewall ausgeführt wird, bietet DataSnap die Option, den Datentransfer durch einen Tunnel zu lenken, so dass die Firewall außer Kraft gesetzt wird, und die Kommunikation zwischen dem Client und dem Server stattfinden kann.

DataSnap ermöglicht die Implementierung von Client und Server in derselben Anwendung. Dieser Ansatz ist auch als In-Process-Konnektivität bekannt.

==Siehe auch==

* [[Grundlagen der mehrschichtigen Datenbank-Anwendungen|Grundlagen der mehrschichtigen Datenbank-Anwendungen]]
* [[DataSnap-Konnektoren für mobile Geräte|DataSnap-Konnektoren für mobile Geräte]]{{f|datasnap|
* [[Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden|Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden]]}}
* [[Tutorial: Einen DataSnap-REST-Server mit einer Anwendung verwenden|Tutorial: Einen DataSnap-REST-Server mit einer Anwendung verwenden]]{{f|dbexpress|
* [[Tutorial: Eine InterBase-Datenbank in einer Delphi- oder C++-Anwendung verwenden|Tutorial: Eine InterBase-Datenbank in einer {{Delphi}}- oder C++-Anwendung verwenden]]}}{{f|webbroker|
* [[Tutorial: DataSnap-Anwendung mit einem ISAPI-DLL-Server|Tutorial: DataSnap-Anwendung mit einem ISAPI-DLL-Server]]}}{{f|vcl|
* [[Steuerelemente für DataSnap-Server|Steuerelemente für DataSnap-Server]]}}{{f|datasnap|
* [[Erstellen eines DataSnap-Servers|Erstellen eines DataSnap-Servers]]}}
* [[Filtern des DataSnap-Byte-Streams|Filtern des DataSnap-Byte-Streams]]{{f|datasnap|
* [[DataSnap-Server-Experte|DataSnap-Server-Experte]]}}{{f|webbroker|
* [[Experte für DataSnap WebBroker-Anwendungen|Experte für DataSnap WebBroker-Anwendungen]]}}

{{f|radstudio|

* [http://www.embarcadero.com/rad-in-action/delphi-labs Videos: {{Delphi}} Labs von Paweł Głowacki]
* [http://www.embarcadero-info.com/in_action/radstudio/db.html#xx Let the experts show you how...mit Bob Swart]
* [http://edn.embarcadero.com/article/41189 DataSnap XE: Multitier Database Application]
* [https://channel-e.embarcadero.com/index.php?option=com_jvideodirect&x=1&v=5Cn0scEzYQ9nF REST and Thin Client Development with DataSnap]
* [https://channel-e.embarcadero.com/index.php?option=com_jvideodirect&x=1&v=GzfVDuNpt3uzc Using JavaScript and {{Delphi}} REST Servers]
* [https://channel-e.embarcadero.com/index.php?option=com_jvideodirect&x=1&v=7S1VFt1153jb3 DataSnap: Features and Integration with User Types]
* [http://channel-e.embarcadero.com/index.php?option=com_jvideodirect&x=1&v=Qxne3uhuP1k1T DataSnap Server Application Types]
* [http://edn.embarcadero.com/article/41176 DataSnap Simple Calculator Service Example]}}

[[Category:Delphi]]
[[Category:DataSnap-Referenz]]

Experte für DataSnap-Client-Module

2016-06-01T08:33:05Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Menü Datei|Datei (Menü)}}
<ideTag id="">hcDDataSnapClientModule</ideTag>
 '''Datei > Neu > Weitere > {{Delphi}}-Projekte > DataSnap-Server > DataSnap-Client-Modul''' 
 '''Datei > Neu > Weitere > {{CBuilderUI}} > DataSnap-Server > DataSnap-Client-Modul''' 

<blockquote>'''Tipp:''' Der Experte für DataSnap-Client-Module ist nur verfügbar, nachdem Sie einen DataSnap-Server erstellt haben.</blockquote>

==Experte für DataSnap-Client-Module==

DataSnap-Client-Module ermöglichen von der IDE aus eine einfache Verbindung zu einem DataSnap-Server. Erstellen Sie zuerst eine neue VCL-Formularanwendung, und wählen Sie dann über das Menü '''Datei > Neu''' den Eintrag '''DataSnap-Client-Modul''' aus.

<blockquote>'''Hinweis:''' Wenn für den [[DataSnap-Server-Experte|DataSnap-Server]], mit dem dieser Client eine Verbindung herstellt, Filter angewendet werden (nämlich '''Verschlüsselung''', '''Komprimierung''' oder beides), werden diese für den Client automatisch angewendet und ausgeführt.</blockquote>

Der Experte für DataSnap-Client-Module besteht aus vier Schritten, die auf den folgenden Bildern dargestellt sind.

[[File:DSClientModule1.png]]

Im ersten Schritt des Experten für DataSnap-Client-Module wählen Sie den Speicherort des DataSnap-Servers aus. Ein DataSnap-Server kann ein lokaler (auf '''localhost''' ausgeführt) oder ein Remote-Server (auf einen anderen Computer mit einer gültigen IP-Adresse ausgeführt) sein.

[[File:DSClientModule2.png]]

Im zweiten Schritt des Experten wählen Sie den Typ des DataSnap-Servers für die aktuelle Verbindung aus. Sie legen eine Option fest, indem Sie auf das zugehörige Optionsfeld klicken. Um nähere Informationen zu einer bestimmten Option zu erhalten, klicken Sie auf die Option. Der Experte zeigt daraufhin einen Hinweis an. Beachten Sie bitte, dass Sie auf das blaue Ausrufezeichen klicken müssen, falls kein Hinweis angezeigt wird.

[[File:DSClientModule3.png]]

Im dritten Schritt des Experten für DataSnap-Client-Module wählen Sie das Verbindungsprotokoll aus. Beachten Sie bitte, dass der Server das ausgewählte Verbindungsprotokoll unterstützen muss.

[[File:DSClientModule4.png]]

<br Im vierten Schritt des Experten geben Sie den Kommunikations-Port, den Benutzernamen und das Passwort an. Diese Seite enthält auch die Schaltfläche '''Verbindung testen''', mit der Sie überprüfen können, ob die Verbindung korrekt konfiguriert ist.

==Siehe auch==

* [[DataSnap-Anwendungen entwickeln|DataSnap-Anwendungen entwickeln]]
* [[Mehrschichtige Anwendungen erstellen - Index|Mehrschichtige Anwendungen erstellen - Index]]
* [[DataSnap-Server-Experte|DataSnap-Server-Experte]]
* [[Experte für DataSnap-REST-Anwendungen|Experte für DataSnap-REST-Anwendungen]]
* [[Experte für DataSnap WebBroker-Anwendungen|Experte für DataSnap WebBroker-Anwendungen]]

[[Category:Delphi]]
[[Category:C++]]

DataSnap-Client-Anwendung

2016-06-01T08:33:01Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{parent|DataSnap-Anwendungen entwickeln}}

==Themen==

* [[Verbinden des Clients mit dem DataSnap-Server|Verbinden des Clients mit dem DataSnap-Server]]
* [[Filtern des DataSnap-Byte-Streams|Filtern des DataSnap-Byte-Streams]]
* [[HTTPS-Zertifikatsverifizierung|HTTPS-Zertifikatsverifizierung]]

==Siehe auch==

* [[Tutorial: Einen DataSnap-Server mit einer Anwendung verwenden#Client-Anwendung erstellen|Tutorial: DataSnap-Server/Client]]
* [[Steuerelemente für DataSnap-Clients|Steuerelemente für DataSnap-Clients]]

[[Category:Delphi]]
[[Category:C++]]
[[Category:DataSnap-Referenz]]

Eigenschaften der Datenmenge

2016-06-01T08:33:00Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Datenbanken (Dialogfelder)}}
Use this dialog to examine the tables, columns, and other properties of a dataset.

Im linken Bereich des Dialogfeldes wird die Datenmenge mit ihren Tabellen angezeigt. Markieren Sie im linken Bereich ein Objekt, um dessen Eigenschaften in einem schreibgeschützten Gitter im rechten Bereich anzuzeigen.[[en:Dataset Properties|Eigenschaften von en:Dataset]]

[[Category:RAD Studio – Referenz]]
[[Category:AMMigrate]]

Daten-Explorer-Unterstützung für DataSnap

2016-06-01T08:32:58Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{parent|DataSnap-Anwendungen entwickeln}}

Die Daten-Explorer-Unterstützung für DataSnap wurde eingeführt, um Stored Procedures und Funktionen, Sichten und Tabellen einer laufenden [[DataSnap-Server-Anwendung|DataSnap-Server-Anwendung]] zu überwachen.

==Verwendung und Beispiele==

Um den Daten-Explorer mit DataSnap zu verwenden, müssen Sie zuerst eine DataSnap-Serveranwendung auf Ihrem lokalen Computer ausführen. Wenn die Serveranwendung ausgeführt wird, wechseln Sie in der {{Delphi}}-Benutzeroberfläche zur Registerkarte '''Daten-Explorer'''. Diese Registerkarte sollte in etwa wie folgende Abbildung aussehen:

[[Image:DSDataExplorer1.png]]

Im '''Daten-Explorer''' werden unter dem Abschnitt '''DATASNAP''' die folgenden Kategorien angezeigt: Tabellen, Sichten, Prozeduren, Funktionen, Synonyme. Für dieses Beispiel sind die '''Stored Procedures''' von DataSnap interessant. Wenn Sie auf den Eintrag '''Prozeduren''' klicken, wird eine Baumstruktur mit allen in der DataSnap-Serveranwendung enthaltenen Stored Procedures angezeigt. Angenommen, für eine Serveranwendung wird eine Stored Procedure namens '''TMyClass.Sum''' untersucht, die folgendermaßen definiert ist:

<source lang="delphi">
function TMyClassClient.Sum(A: Double; B: Double): Double;
begin
if FSumCommand = nil then
begin
FSumCommand := FDBXConnection.CreateCommand;
FSumCommand.CommandType := TDBXCommandTypes.DSServerMethod;
FSumCommand.Text := 'TMyClass.Sum';
FSumCommand.Prepare;
end;
FSumCommand.Parameters[0].Value.SetDouble(A);
FSumCommand.Parameters[1].Value.SetDouble(B);
FSumCommand.ExecuteUpdate;
Result := FSumCommand.Parameters[2].Value.GetDouble;
end;
</source>

Wie Sie aus der Deklaration von '''TMyClassClient.Sum''' ersehen können, akzeptiert die Methode zwei Double-Werte und gibt deren Summe zurück. Die folgende Abbildung zeigt die Liste der Stored Procedures für eine Serveranwendung, die die oben beschriebene Methode enthält:

[[Image:DSDataExplorer2.png]]

[[Image:DSDataExplorer2.png]]

Durch Klicken auf eine Stored Procedure wird dieser Eintrag erweitert und zeigt die ''Eingabe''- und ''Ausgabe''-Parameter an, in diesem Fall '''A''', '''B''' und '''ReturnValue'''. Wenn Sie auf den Namen einer Stored Procedure doppelklicken, wird ein '''Parameter'''-Fenster eingeblendet, in dem Sie die Parameter dieser Stored Procedure überwachen können.

[[Image:DSDataExplorer3.png]]

==Siehe auch==

* [[DataSnap-Server-Anwendung|DataSnap-Server-Anwendung]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]

Datenbanksicherheit

2016-06-01T08:32:55Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Datenbanken verwenden}}

Datenbanken enthalten häufig sensible Informationen. Verschiedene Datenbanken unterstützen Sicherheitsschemas für den Schutz dieser Information. Einige Datenbanken, wie beispielsweise Paradox und dBASE, bieten nur Sicherheit auf Tabellen- oder Feldebene. Wenn Benutzer versuchen, auf geschützte Tabellen zuzugreifen, müssen sie ein Passwort dafür angeben. Nachdem die Benutzer authentifiziert wurden, sehen sie nur die Felder (Spalten), für die sie eine Berechtigung besitzen.

Die meisten SQL-Server fordern ein Passwort und einen Benutzernamen an, bevor sie überhaupt eine Nutzung des Datenbankservers zulassen. Nachdem sich der Benutzer bei der Datenbank angemeldet hat, legen der Benutzername und das Passwort fest, welche Tabellen zur Verfügung gestellt werden. Weitere Informationen für die Übergabe von Passwörtern an SQL-Server finden Sie unter [[Server-Anmeldungen steuern|Server-Anmeldungen steuern]].

Beim Entwurf von Datenbankanmeldungen müssen Sie berücksichtigen, welchen Authentifizierungstyp Ihr Datenbankserver verwendet. Häufig werden Anwendungen so entworfen, dass sie die explizite Datenbankanmeldung vor den Benutzern verbergen, die sich nur bei der eigentlichen Anwendung anmelden müssen. Wenn Sie Ihre Benutzer nicht zur Eingabe eines Passworts auffordern wollen, müssen Sie entweder eine Datenbank verwenden, für die kein Passwort erforderlich ist, oder Sie müssen dem Server das Passwort und den Benutzernamen programmgesteuert übergeben. Falls das Passwort vom Programm aus übergeben wird, muss darauf geachtet werden, dass keine Sicherheitslücke entsteht, weil das Passwort aus der Anwendung gelesen werden könnte.

Falls Sie von Ihren Benutzern fordern, dass diese ein Passwort eingeben, müssen Sie festlegen, wann das Passwort benötigt wird. Wenn Sie eine lokale Datenbank verwenden, aber vorhaben, später einen größeren SQL-Server einzurichten, sollten Sie das Passwort abfragen, sobald sich der Benutzer an der SQL-Datenbank anmeldet, und nicht erst, wenn er einzelne Tabellen öffnet.

Falls für Ihre Anwendung mehrere Passwörter erforderlich sind, weil Sie sich an mehreren geschützten Systemen oder Datenbanken anmelden müssen, können Sie ein Hauptpasswort bereitstellen, das wiederum verwendet wird, um auf eine Tabelle mit den Passwörtern für die geschützten Systeme zuzugreifen. Die Anwendung stellt die Passwörter dann programmgesteuert bereit, ohne dass der Benutzer mehrere Passwörter eingeben muss.

In mehrschichtigen Anwendungen können Sie aber auch ein ganz anderes Sicherheitsmodell verwenden. Sie können Protokolle wie beispielsweise HTTPs oder COM+ einsetzen, um den Zugriff auf mittlere Schichten zu steuern und den mittleren Schichten die Details für die Anmeldung bei Datenbankservern überlassen.

==Siehe auch==

* [[Datenbanktypen|Datenbanktypen]]
* [[Transaktionen|Transaktionen]]
* [[Das Data Dictionary|Das Data Dictionary]]
*[[Referentielle Integrität, Stored Procedures und Trigger|Referentielle Integrität, Stored Procedures und Trigger]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]
[[Category:C++]]

Datenbank-Editor

2016-06-01T08:32:53Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Datenbanken (Dialogfelder)}}
Vewrwenden Sie dieses Dialogfeld zum Einrichten der Verbindung zu einer Datenbank.

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
Name
|
Der Name der Datenbank. Über diesen Namen wird die Datenbankkomponente im Anwendungscode angesprochen.
|- valign="top"
|
Aliasname
|
Der BDE-Alias der Datenbank. Wählen Sie einen Alias aus der Dropdown-Liste. Die Liste enthält alle Aliase, die derzeit bei der BDE registriert sind. Wenn Sie keine Verbindung zu einer als BDE-Alias registrierten Datenbank herstellen möchten, weisen Sie statt dessen der Eigenschaft Treiber einen Wert zu. Wenn Sie der Eigenschaft Alias einen Wert zuweisen, wird die Eigenschaft Driver gelöscht, da der Treibertyp im BDE-Alias integriert ist.
|- valign="top"
|
Treibername
|
Der Datenbanktyp, den die Datenbankkomponente repräsentiert. Wählen Sie in der Dropdown-Liste einen der Treibertypen STANDARD, ORACLE, SYBASE oder INTERBASE. Wenn der Datenbankserver als Alias bei der BDE registriert ist, können Sie statt dessen die Option Alias verwenden. Wenn Sie einen '''Treiber''' wählen, wird die Eigenschaft Alias gelöscht, damit keine Konflikte mit dem im Alias integrierten Treiber auftreten.
|- valign="top"
|
Parameter überschreibt
|
Die Werte aller Anmeldeparameter, die beim Herstellen der Verbindung benötigt werden. Die einzelnen Parameter hängen vom Typ der Datenbank ab. Eine Liste aller Parameter und ihrer Standardwerte erhalten Sie mit der Schaltfläche '''Vorgabe'''. In der Liste können Sie die Standardwerte ändern.
|- valign="top"
|
Vorgaben
|
Setzt die Parameter auf die Standardwerte für den Treibertyp.
|- valign="top"
|
Löschen
|
Entfernt alle überschriebenen Parameter.
|- valign="top"
|
Anmeldeaufforderung
|
Bewirkt, dass ein Anmeldedialogfeld automatisch eingeblendet wird, wenn der Benutzer eine Verbindung zu der Datenbank herstellt. Deaktivieren Sie die Option, wenn Sie den automatischen Anmeldedialog unterdrücken möchten. Die meisten Datenbankserver (mit Ausnahme der dateibasierten STANDARD-Typen) verlangen vom Benutzer bei der Anmeldung ein Kennwort. Wenn Sie bei diesen Servern auf den automatischen Anmeldedialog verzichten, muss die Anwendung den Benutzernamen und das Kennwort auf andere Weise bereitstellen. Dazu eignen sich beispielsweise hart codierte Parameter oder eine Ereignisbehandlungsroutine für OnLogin, in der den entsprechenden Parametern Werte zugewiesen werden.
|- valign="top"
|
Inaktive Verbindung halten
|
Legt fest, dass die Anwendung auch dann mit der Datenbank verbunden bleibt, wenn keine Datenmengen geöffnet sind. Bei Verbindungen zu externen Datenbankservern oder bei Anwendungen, die häufig Datenmengen öffnen und schließen, sollten Sie das Kontrollkästchen aktivieren. Sie verringern dadurch den Netzwerkverkehr, beschleunigen die Anwendung und umgehen die ständige Neuanmeldung beim Wiederherstellen der Verbindung. Wenn Sie das Kontrollkästchen deaktivieren, wird die Verbindung beendet, sobald die letzte Datenmenge geschlossen wird. Dieses Vorgehen spart Systemressourcen, hat jedoch den Nachteil, dass die Verbindung neu eingerichtet und initialisiert werden muss, wenn wieder eine Datenmenge geöffnet wird.
|}

[[Category:RAD Studio – Referenz]]

Datenbankarchitektur

2016-06-01T08:32:52Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Datenbankanwendungen entwerfen - Index}}

Datenbankanwendungen setzen sich aus Elementen der Benutzeroberfläche, Komponenten zur Anzeige von Datenbankinformationen (Datenmengen) und Komponenten, die diese miteinander und mit der Quelle der Datenbankinformation verbinden, zusammen. Die Anordnung dieser Bausteine bildet die Architektur einer Datenbankanwendung.

Es gibt zwar verschiedene Methoden, die Komponenten in einer Datenbankanwendung anzuordnen, aber die meisten folgen dem in der nachfolgenden Abbildung gezeigten allgemeinen Schema:

[[Image:DBDARCH1.jpg]]

==Das Formular für die Benutzeroberfläche==

Wenn Sie Ihre Benutzeroberfläche in einem eigenen Formular isoliert haben, können Sie ein [[Standard-Datenmodule erstellen und bearbeiten|Datenmodul]] verwenden, das die Komponenten aufnimmt, die Datenbankinformationen (Datenmengen) anzeigen, ebenso wie die Komponenten, die diese Datenmengen mit anderen Bereichen Ihrer Anwendung verbinden. Wie die Formulare für die Benutzeroberfläche können Sie Datenmodule in der Objektablage freigeben, sodass sie wiederverwendet oder von Anwendungen gemeinsam genutzt werden können.

==Das Datenmodul==

Das erste Element in dem Datenmodul ist eine [[Datensensitive Steuerelemente einer Datenmenge zuordnen|Datenquelle]]. Die Datenquelle agiert als Leitung zwischen der Benutzeroberfläche und einer Datenmenge, die Informationen aus einer Datenquelle repräsentiert. Mehrere datensensitive Steuerelemente auf einem Formular können eine einzelne Datenquelle gemeinsam nutzen. In diesem Fall wird die Anzeige in jedem Steuerelement synchronisiert, sodass, wenn der Benutzer die Datensätze durchsieht, der entsprechende Wert aus den Feldern für den aktuellen Datensatz in jedem Steuerelement angezeigt wird.

==Die Datenquelle==

Die Seele Ihrer Datenbankanwendung ist die Datenmenge. Diese Komponente repräsentiert eine Gruppe von Datensätzen aus der zugrunde liegenden Datenbank. Bei diesen Datensätzen kann es sich um die Daten aus einer einzelnen Datenbanktabelle handeln, um eine Untermenge der Felder oder Datensätze in einer Tabelle oder um Informationen aus einer Verknüpfung von mehreren Tabellen in einer einzelnen Ansicht. Durch die Verwendung von Datenmengen wird Ihre Anwendungslogik vor Neustrukturierungen der physischen Tabellen in Ihren Datenbanken geschützt. Wenn sich die zugrunde liegende Datenbank ändert, müssen Sie vielleicht die Methode ändern, wie die Datenmengenkomponente die enthaltenen Daten abruft, aber Ihre restliche Anwendung kann unverändert weiterarbeiten. Weitere Informationen über allgemeine Eigenschaften und Methoden von Datenmengen finden Sie unter [[Datenmengen: Übersicht|Datenmengen]].

==Die Datenmenge==

Unterschiedliche Datenmengentypen verwenden unterschiedliche Mechanismen, um eine Verbindung zu den zugrunde liegenden Datenbankinformationen einzurichten. Diese unterschiedlichen Mechanismen wiederum bedingen die Verwendung unterschiedlicher Architekturen für die von Ihnen entwickelten Datenbankanwendungen. Es gibt vier grundlegende Mechanismen, um Verbindungen zu den Daten einzurichten:

==Die Datenverbindung==

Unterschiedliche Datenmengentypen verwenden unterschiedliche Mechanismen, um eine Verbindung zu den zugrunde liegenden Datenbankinformationen einzurichten. Diese unterschiedlichen Mechanismen wiederum bedingen die Verwendung unterschiedlicher Architekturen für die von Ihnen entwickelten Datenbankanwendungen. Es gibt vier grundlegende Mechanismen, um Verbindungen zu den Daten einzurichten:

* [[Eine direkte Verbindung zu einem Datenbankserver einrichten|Direkte Verbindung zu einem Datenbankserver]]. Die meisten Datenmengen verwenden eine Ableitung von ''TCustomConnection'', um die Verbindung zu einem Datenbankserver darzustellen.
* [[Eine dedizierte Datei auf der Festplatte verwenden|Verwendung einer dedizierten Datei auf der Festplatte]]. Client-Datenbanken unterstützen die Möglichkeit, mit einer dedizierten Datei auf der Festplatte zu arbeiten. Bei der Arbeit mit einer dedizierten Datei ist keine separate Verbindungskomponente erforderlich, weil die Client-Datenmenge selbst weiß, wie sie aus der Datei liest und in diese schreibt.
* [[Verbindungen zu anderen Datenmengen einrichten|Verbindungen zu anderen Datenmengen einrichten]]. Client-Datenmengen können mit Daten arbeiten, die von einer anderen Datenmenge bereitgestellt werden. Eine ''TDataSetProvider''-Komponente dient als Mittler zwischen der Client-Datenmenge und ihrer Quelldatenmenge. Dieser Datenmengen-Provider kann sich im selben Datenmodul wie die Client- Datenmenge befinden, kann aber auch Teil eines Anwendungsservers sein, der auf einer anderen Maschine ausgeführt wird. Falls der Provider Teil eines Anwendungsservers ist, brauchen Sie auch eine spezielle Ableitung von ''TCustomConnection'', um die Verbindung zum Anwendungsserver darzustellen.
* Daten aus einem RDS DataSpace-Objekt abrufen. ADO-Datenmengen können eine [[lib_de:Data.Win.ADODB.TRDSConnection|ADOdb.TRDSConnection]]-Komponente verwenden, um Daten in mehrschichtigen Datenbankanwendungen zu verpacken, die mithilfe von ADO-basierten Anwendungsservern erstellt wurden.

Manchmal können alle diese Mechanismen [[Ansätze kombinieren|innerhalb einer einzigen Anwendung kombiniert]] werden.

==Siehe auch==

* [[Die Benutzeroberfläche gestalten|Die Benutzeroberfläche gestalten]]
* [[Die Borland Database Engine|Die Borland Database Engine]]
* [[Datenbanken verwenden|Datenbanken verwenden]]
*[[Datenbanktypen|Datenbanktypen]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]
[[Category:C++]]

Datenhaltepunkt ist an einer Stack-Position gesetzt

2016-06-01T08:32:49Z

Pial: 1 Version: Updated with Recovery tool. LOC-22808

{{Parent|Fehlermeldungen - Index}}
Der Stack-Speicher ist unbeständig und ändert sich oft. Wenn ein Datenhaltepunkt an einer Adresse im Stack gesetzt wird, wird der Haltepunkt möglicherweise sehr oft getroffen, nämlich jedes Mal, wenn etwas in den Stack gelegt oder daraus entfernt wird.

Sie können diesen Haltepunkt weiterhin setzen. Sie sollten sich aber darüber im Klaren sein, dass er so oft angelaufen werden könnte, dass die Anwendung nicht korrekt ausgeführt werden kann.

==Siehe auch==

* [[Überblick zum Debuggen|Überblick zum Debuggen]]
* [[Haltepunkte setzen und bearbeiten|Haltepunkte setzen und bearbeiten]][[en:Data Breakpoint is set on a stack location|en:Data Breakpoint is set on a stack location]]

[[Category:RAD Studio – Referenz]]
[[Category:AMMigrate]]

Position von DLL-Dateien

2016-06-01T08:32:19Z