4D v11 SQL. Upgrade für Windows und Mac TM OS. 4D SAS/4D Inc.

Transkript

1 4D v11 SQL Upgrade für Windows und Mac TM OS 4D SAS/4D Inc.

2 4D v11 SQL Upgrade Copyright D SAS / 4D Inc. Alle Rechte vorbehalten Software und Handbuch unterliegen dem Copyright und dürfen weder ganz noch teilweise vervielfältigt werden. Davon ausgenommen ist die Nutzung durch den Lizenznehmer gemäß den Bestimmungen des 4D-Software Lizenzvertrags. 4th Dimension, 4D, 4D Server sowie das 4D Logo sind eingetragene Warenzeichen von 4D SAS. Windows, Windows XP, Vista und Microsoft sind eingetragene Warenzeichen von Microsoft Corporation. Apple, Macintosh, Mac, Power Macintosh und QuickTime sind Handelsnamen oder eingetragene Warenzeichen von Apple Computer, Inc ACROBAT Copyright , Secret Commercial Adobe Systems Inc. Alle Rechte vorbehalten. ACROBAT ist eingetragenes Warenzeichen von Adobe Systems Inc. Alle anderen Produktnamen sind Handelsnamen, eingetragene Warenzeichen oder Copyrights der jeweiligen Hersteller. Mac2Win Software Copyright ist ein Produkt von Altura Software, Inc. Dieses Produkt enthält Software, die von der Apache Software Foundation entwickelt wurde ( Wichtig Für die Verwendung der Software gilt der bei der Installation aufgerufene Software-Lizenzvertrag. Durch Installation der Software erklären Sie sich an die Bestimmungen dieses Vertrags gebunden. Bitte lesen Sie daher den Vertragstext vollständig und genau durch, bevor Sie die Software installieren.

3 Inhalt Kapitel 1 Einleitung th Dimension wird 4D Überblick Inhalt dieses Handbuchs Mindestanforderungen Kapitel 2 Konvertierung Frühere Datenbanken konvertieren: Allgemein Konvertierungs-parameter ansehen bzw. ändern Die Dateien konvertierter Datenbanken Frühere Datenbanken konvertieren: Spezifische Fälle Kompatibilität der Plug-Ins Kompatibilität der 4D Anwendungen Kapitel 3 Architektur von 4D Datenbanken v Erweiterte Leistungsstärke Neue Feldtypen Tabellen und Felder löschen Kompatibilität bei Transaktionen Temporäre Ordner Universal Binary Architektur - Universal Programme (Mac OS).. 30 Indizes verwalten Architektur für Standardindizes auswählen Volltext-Index Zusammengesetzte Indizes Befehle By Formula Indizes nach Import neu aufbauen Felder vom Typ BLOB, Bild und Text speichern Option zum Speichern von Textfeldern Untertabellen konvertieren Operationen beim Konvertieren Konvertierte Untertabelle in verknüpfte Standard tabelle umwandeln Ressourcen verwalten Kompatibilität vorhandener Ressourcen Neue Vorgehensweise bei Ressourcen D v11 Upgrade 1

4 Inhalt Neue Architektur für Komponenten Überblick Neue Konzepte (Definitionen) Komponenten durch Kompilieren schützen Komponente installieren Komponente entwickeln Interaktion zwischen Komponenten und Host Datenbanken.. 52 Unterstützung von Unicode Was ist Unicode? Ordner.4dbase Kapitel 4 Oberfläche und Navigation im Designmodus Datenbanken erstellen und öffnen Dialogfenster öffnen Menü Datei/Ablage Neuer Designmodus Neue Oberfläche für Designmodus Anwendungsmodus Umstrukturierte Menüs Werkzeugleiste Information über Formularobjekte Explorer Anzeige Tabellen & Felder Nach Aufrufen suchen Projektmethoden duplizieren oder kopieren Seite Methoden Compiler Kompilierten Code löschen Datenbankmethoden ausführen Objekte im Designmodus bewegen Bewegbare Objekte Arbeitsweise Kopieren-Dialog Einstellungen für Bewegen Suchen und Ersetzen in der Datenbank Neue Suchkriterien Reichweite der Suchläufe Neues Ergebnisfenster Präfix und Umbenennung Tastenkürzel verwalten Editor für Stilvorlagen Unterstützung von Windows Vista D v11 Upgrade

5 Datenbanken lokalisieren Was ist XLIFF? XLIFF Strings aus 4D Datenbank aufrufen Angepasste XLIFF Dateien installieren Neuer Suchoperator Kapitel 5 Struktureditor Werkzeugleiste und Neuer Inspektor Direktes Bearbeiten im grafischen Modus Oberfläche und Anzeige Zoom Scrollen Objekttypen anzeigen Tabellen ein-/ausblenden Tabellen anpassen Reihenfolge der Datenfelder Farbe Tabellen ausrichten Grafische Qualität der Struktur Unterstützung von SQL Attributen Option Nie Null SQL Bereich Ganzzahl 64 bits und Fließkomma Index Explorer Index erstellen Editorfenster anpassen Verknüpfungen Darstellung Verknüpfungseigenschaften Kontextmenü Verknüpfung über die Werkzeugleiste hinzufügen Verknüpfung entfernen Suche in der Struktur Strukturdefinitionen exportieren und importieren Format einer 4D Strukturdefinition Strukturdefinition exportieren Eine Datenbank aus der Strukturdefinition erstellen Kapitel 6 Methodeneditor SQL Code im Methodeneditor eingeben Fehlersuche im SQL Code Namensänderung Kontextuelle Konstanten D v11 Upgrade 3

6 Inhalt Suchläufe Suche Aufrufe Selektives Ersetzen Neue Makro Architektur Übertragung früherer Makros Im XML Standard nicht kompatible Elemente Neue Attribute für das Element <macro> Variablen zur Textauswahl für Methoden Kapitel 7 Formulare und Objekte Projektformulare Warum Projektformulare verwenden? Merkmale Erstellen Eigenschaften Listboxen Felder und Ausdrücke mit Listboxen verbinden Ergebnis einer SQL-Anfrage anzeigen Optimierung von Bildfeldern und -variablen Rollbalken Unterstützung nativere Formate Automatisches Drag & Drop Kontextmenü Optimierungen Bildvariablen in Formularen typisieren Neue Features in Formularen Unterformulare im Seitenmodus Metallische Darstellung Neue Drag&Drop Optionen Neue Erkennungszeichen Animiertes Thermometer Anzeigeformate für Datum und Uhrzeit Datumsformate Zeitformate Systemeinstellungen für Zahlenformate Kapitel 8 Menüeditor Oberfläche Kontextmenü und Menüassistent Menüverwaltung Menü anfügen Unabhängige Menüs Hierarchische Untermenüs Menü/Untermenü entfernen Titel als Referenz D v11 Upgrade

7 Neue Eigenschaften Referenz auf Menüeintrag Native Hintergrundbilder Standardaktionen Markierungszeichen Icon für Eintrag Menü Bearbeiten (Kompatibilität) Kapitel 9 Wartungs- und Sicherheits-Center Maintenance und Security Center anzeigen Anzeige im Wartungsmodus Anzeige im Standardmodus Zugriffsrechte Seite Information Programm und Tabellen Daten und Struktur Seite Analyse Aktivität Seite Prüfen Aktionen Statusanzeige Details Seite Backup Seite Komprimieren Warum Dateien komprimieren? Daten oder Strukturdatei komprimieren Erweiterter Modus Seite Zurückfahren Seite Wiederherstellen Seite Reparieren Kapitel 10 4D SQL Engine einsetzen Auf die 4D SQL Engine zugreifen Anfragen an die 4D SQL Engine senden Daten zwischen 4D und der SQL Engine übertragen D SQL Server konfigurieren Extern auf SQL Server zugreifen D SQL Server starten und stoppen SQL Server Voreinstellungen D Datenbank Zugriffskontrolle Implementierung und Einschränkung der 4D SQL Engine Allgemeine Einschränkungen Datentypen NULL Werte in 4D Eigenschaft Zugang per SQL Auto commit D v11 Upgrade 5

8 Inhalt SQL DML SQL TCL (Transaktionen) SQL DDL SQL DCL (Sicherheit) Anbindung an SQL Quellen Mit SQL Einschränkungen programmieren Unterstützung von SQL Funktionen Statistische Funktionen System Funktionen Standard Funktionen String Funktionen Bits Funktion Numerische Funktionen Zeitfunktionen Arithmetische Operatoren Logische und binäre Operatoren Vergleichsoperatoren Prädikat Operatoren Datenbearbeitung Datendefinition Datensortierung Join Bedingte Ausdrücke Unterabfragen Index Transaktionen SQL Engine Fehlermeldungen Kapitel 11 Web Server Authentifizierung im Digest Modus Überblick Implementation in 4D Web Logbuch konfigurieren (logweb.txt) Log Format Periodische Backups Kapitel 12 Programmiersprache Änderungen bezüglich Unicode Variablen deklarieren und typisieren Befehle im Kapitel String Befehle im Kapitel BLOB Befehle im Kapitel Kommunikation Externe Datenquelle SQL Direkte Verbindung mit SQL Datenquellen Suchen D v11 Upgrade

9 Projektformulare Kompatibilität mit Befehlen und Ereignissen Projektformulare aufrufen Drag and Drop Drag&Drop Optionen für native Textbereich Neue Einstellung für Kompatibilität Neues Formularereignis On Begin Drag Over Neue Datenbankmethode On Drop Pasteboard Copy-paste und Drag&Drop Pasteboards Befehls- und Konstantennamen Datentypen Geänderte Befehle Neue Befehle Menüs Überblick Neue Befehle Geänderte Befehle Hierarchische Listen Mehrfache Darstellung Neue Syntax für Befehle mit Position Priorität bei Befehlen für Eigenschaften Vorhandene Befehle für hierarchische Listen Geänderter Befehl Neue Befehle Listboxen Geänderte Befehle Neue Befehle Fenster Drucken Neue Befehle Geänderte Befehle D Umgebung Geänderte Befehle Systemumgebung Mehrfache Bildschirme unter Windows Geänderter Befehl Benutzeroberfläche Kriterien für Zugriff auf die virtuelle Struktur Systemdokumente Bilder Überholte Befehle in 4D Pack Diagramme String BLOB Programmiersprache Zeiger auf Prozessvariablen D v11 Upgrade 7

10 Inhalt Ressourcen Kommunikation Strukturzugriff Tabellen und Felder zählen Web Server Werkzeuge Eingabe Auswahl Transaktionen Datensätze während einer Transaktion XML Neue Befehle Geänderte Befehle Web Services (Client) Verschiedene Änderungen Unterdatensätze Systemvariable Document Konstanten für Anzeigeformate Zweidimensionale Arrays Geänderte Namen Geänderte Kapitel Überholte Befehle Anhang A Programmiersprache Codes Anhang B Entsprechung der SQL Datentypen D SQL and ORACLE D SQL and MySQL D SQL and PostgreSQL D SQL and Access D SQL and MS SQL Server D SQL and Sybase D SQL and IBM DB Anhang C 4D Pack v What s New Obsolete Commands Deleted Commands D v11 Upgrade

11 1 Einleitung Willkommen zu 4D v11, der neuen Version der 4D Entwicklungsumgebung. 4 th Dimension wird 4D Das Unternehmen 4D hat die Produktnamen für die neue Version v11 SQL in den verschiedenen Sprachen vereinheitlicht: Der generische Name 4 th Dimension wird ersetzt durch 4D. 4 th Dimension single user heißt jetzt 4D Developer. Die Produktreihe 4D v11 SQL besteht jetzt aus den Programmen 4D Developer, 4D Server und 4D Client. Die bisherigen Bezeichnungen werden nach und nach in allen technischen und vertrieblichen 4D Dokumenten aktualisiert. Überblick Version 11 von 4D bietet viele neue Features sowohl in der internen Architektur des Programms als auch für Entwickler. Es gibt folgende Themenbereiche: Die wichtigste Neuerung ist, dass Teile der Datenbank-Engine für 4D Version 11 komplett neu geschrieben wurden. Sie ist leistungsstärker und effizienter und bietet zahlreiche Vorteile, die direkt Ihren Anwendungen zugute kommen. Dennoch sind dafür keine Änderungen im Code notwendig. 4D v11 Upgrade 9

12 Kapitel 1 Einleitung 4D enthält nun eine komplette SQL-Engine, mit der sich SQL-Anfragen abwickeln lassen. Die SQL-Programmiersprache wurde in den Kernel der neuen 4D-Datenengine integriert und ermöglicht so direkten Zugriff auf die Struktur und die Daten. 4D v11 hat viele neue Funktionen zur Wartung und Verwaltung erhalten, wie z.b. ein Wartungs- und Sicherheitscenter, Suchen-und- Ersetzen in der Datenbank. Folglich sind die Zusatzprogramme 4D Tools und 4D Insider nicht länger erforderlich, da die Funktionen in die neue 4D Version integriert sind. Oberfläche und Struktur der 4D Arbeitsumgebung wurden verändert, um den Einstieg noch einfacher zu machen und den Zugriff auf die Programmfunktionen zu erleichtern. Die Menüs von Benutzer- und Designmodus wurden zusammengelegt. 4D hat nun eine umstrukturierte Designumgebung (mit den Funktionalitäten der bisherigen Benutzerumgebung) und die Anwendungsumgebung (entspricht der bisherigen Runtime-Umgebung). Auch die Entwicklerebene wurde verbessert: Sowohl der Designmodus als auch die 4D Programmiersprache haben einige Neuerungen und Veränderungen erhalten. Das betrifft insbesondere die Verwaltung der 4D Komponenten, den Struktureditor, hierarchische Listen, Menüs, Listboxen, u.v.m. 10 4D v11 Upgrade

13 Inhalt dieses Handbuchs Dieses Handbuch ist in folgende Kapitel gegliedert: Inhalt dieses Handbuchs Konvertierung: Dieses Kapitel beschreibt die Grundlagen und Schritte zur Konvertierung früherer Datenbanken in 4D v11, sowie nicht mehr verwendete Funktionsweisen. Architektur der 4D v11 Datenbanken: Dieses Kapitel beschreibt die neuen Funktionalitäten zum Einstellen und zur Arbeitsweise der neuen Datenbank-Engine, die neuen Komponenten sowie die Änderungen in der Dateiverwaltung. Oberfläche und Navigation im Designmodus: Dieses Kapitel stellt die umstrukturierte Arbeitsumgebung von 4D v11 vor, sowie die neu verfügbaren Funktionalitäten. Dazu gehören das neue Maintenance- und Security-Center, Änderungen im Struktureditor, die Funktion Suchenund Ersetzen in der Struktur, Anpassungen in der Bildverwaltung, im Formulareditor und im Methodeneditor sowie die neue Komponenten- Verwaltung. Struktureditor: Dieses Kapitel zeigt die Änderungen im Struktureditor von 4D v11. Methodeneditor: Dieses Kapitel erläutert die Änderungen im Methodeneditor von 4D v11. Formulare und Objekte: Dieses Kapitel listet die neuen Funktionalitäten in den Formularen und dazugehörigen Objekten auf. Menüeditor: Dieses Kapitel erläutert die Änderungen im Menüeditor von 4D v11. Maintenance- und Security-Center: Dieses Kapitel beschreibt das neue Dialogfenster zum Überprüfen und Durchführen von Backups der 4D Datenbank. 4D SQL-Engine: Dieses Kapitel zeigt, wie die neue SQL-Engine von 4D funktioniert. Web Server: Dieses Kapitel beschreibt die Änderungen in der Funktionsweise des integrierten Web Server. Programmiersprache: Dieses Kapitel beschreibt die neuen und geänderten Befehle der 4D Programmiersprache. 4D v11 Upgrade 11

14 Kapitel 1 Einleitung Mindestanforderungen Anwendungen der Produktreihe von 4D v11 benötigen folgende Mindestkonfiguration: Windows Mac OS Rechner PC kompatibel mit Pentium III MIkroprozessor Macintosh, basierend auf Intel oder Power PC Betriebssystem Windows Vista, Windows XP Mac OS Version oder höher Freier Mindestspeicher 512 MB 512 MB Empfohlener Speicher 1 GB 1 GB Bildschirmauflösung 1280 * 1024 Pixel 12 4D v11 Upgrade

15 2 Konvertierung Datenbanken, die mit Version 6.x, 2003.x oder 2004.x von 4th Dimension oder 4D Server erstellt wurden, sind mit Version 11 kompatibel (Struktur und Datendatei). Sie müssen jedoch in Version 11 konvertiert werden und lassen sich dann nicht länger mit der ursprünglichen Version öffnen. Strukturänderungen in der Datenbank-Engine von 4D v11 machen tiefgreifende Umwandlungen in der Struktur und in der Datendatei erforderlich. Dafür gibt es einen speziellen Assistenten (siehe nächster Abschnitt). Er erstellt als Vorsichtsmaßnahme vor dem Konvertieren eine Kopie der ursprünglichen Datenbank, so dass Sie jederzeit auf das Original zurückgreifen können. Darüberhinaus werden einige überholte oder frühere Arbeitsweisen nicht mehr unterstützt. Sie werden während der Umwandlung entfernt oder ersetzt. Weitere Informationen dazu finden Sie im Abschnitt Nicht mehr unterstützte Arbeitsweisen auf Seite 20. Frühere Datenbanken konvertieren: Allgemein Sie können jede interpretierte Strukturdatei konvertieren. Enthält die Datei kompilierten Code, müssen Sie die Datenbank anschließend erneut kompilieren. Wir empfehlen, zuvor mit dem Hilfsprogramm 4D Tools die Integrität der Datenbank zu überprüfen (Komprimieren, Prüfen und bei Bedarf Datenbank reparieren). Treten nämlich während der Umwandlung Unregelmäßigkeiten auf, stoppt der Vorgang und Sie werden aufgefordert, 4D Tools zu verwenden. 4D v11 Upgrade 13

16 Kapitel 2 Konvertierung Um eine ältere Datenbank zu konvertieren, wählen Sie diese im Öffnen-Dialog von 4D v11 aus. Auf dem Bildschirm erscheint automatisch der Konvertierungsassistent: Klicken Sie auf die Schaltfläche Konvertiere Datenbank, um die Datenbank und die dazugehörigen Daten mit den Standardvorgaben zu konvertieren. Wollen Sie diese Vorgaben anzeigen bzw. verändern, klicken Sie auf die Schaltfläche Details (siehe nächster Absatz). Der Konvertierungsassistent macht als Vorsichtsmaßnahme zuerst systematisch eine vollständige Kopie der Datenbank (Struktur und Daten). Schlägt die Konvertierung fehl, sind Sie so weiterhin in der Lage, auf die ursprüngliche Datenbank zuzugreifen. Zum Duplizieren der Datenbank ist zusätzlicher Speicher erforderlich. Sollte der Platz auf der Festplatte nicht ausreichen, erscheint eine Meldung und die Operation wird abgebrochen. Die Originaldateien werden in einen Ordner mit Namen Ersetzte Dateien gelegt, der neben den ursprünglichen Dateien angelegt wird. Liegt die Datendatei im gleichen Ordner wie die Strukturdatei, enthält der Ordner Ersetzte Dateien ebenfalls beide Dateien. Liegt die Datendatei in einem anderen Ordner bzw. Volume, wird beim Konvertieren für jede Datei ein eigener Ordner angelegt. 14 4D v11 Upgrade

17 Frühere Datenbanken konvertieren: Allgemein Hinweis: Das aktuelle Logbuch der konvertierten Datenbank wird ebenfalls in den Ordner Ersetzte Dateien kopiert und es wird ein neues leeres Logbuch angelegt. Treten beim Konvertieren nicht-kritische Fehler auf, werden sie in einem Konvertierungslogbuch mit Namen import.log gespeichert, das neben die konvertierte Strukturdatei gelegt wird. Die Benutzereinstellungen für den Debugger, wie Unterbrechungspunkte, gesicherte Ausdrücke, etc. werden während der Konvertierung neu initialisiert. Konvertierungsparameter ansehen bzw. ändern Wollen Sie vor dem Konvertieren bestimmte Parameter verändern, klicken Sie auf die Schaltfläche Details. Auf dem Bildschirm erscheint das Dialogfenster mit den einzelnen Parametern. Im unteren Bereich können Sie mehrere Seiten öffnen: Andere Seite mit weiteren Informationen öffnen Strukturdatei Information: Diese Seite zeigt Größe und Speicherort der Strukturdatei der ursprünglichen Datenbank sowie den neuen Speicherort der Sicherheitskopie, die von dieser Datei angelegt wird. 4D v11 Upgrade 15

18 Kapitel 2 Konvertierung Datendatei Information: Diese Seite zeigt Größe und Speicherort der Datendatei der ursprünglichen Datenbank sowie den neuen Speicherort der Sicherheitskopie. Hier können Sie auch die Datendatei bestimmen, die konvertiert werden soll. Standardmäßig wird die aktuelle Datei ausgewählt. Mit der Option Erstelle neue Datendatei können Sie eine neue leere Datendatei anlegen. Klicken Sie auf Wähle andere Datendatei, können Sie eine andere Datendatei konvertieren. Weitere Informationen dazu finden Sie im Abschnitt Datenbanken mit mehreren Datendateien konvertieren auf Seite 17. Über die Schaltfläche Ziel ändern... können Sie den Speicherort der konvertierten Datendatei verändern. Segmentinformation: Diese Seite zeigt die Segmente der Datendatei, die zu dieser Datenbank gehören. Weitere Informationen dazu finden Sie im Abschnitt Datenbanken mit mehreren Segmenten konvertieren auf Seite 18. Festplatteninformation: Diese Seite gibt den für die Datenbank verfügbaren Platz auf der Festplatte an. Optionen: Diese Seite zeigt die für die Konvertierung verfügbaren Optionen. Beim Öffnen der Datenbank keinen Code ausführen: Ist diese Option markiert, wird Code, der normalerweise beim Starten der Datenbank ausgeführt wird, beim ersten Start der konvertierten Datenbank deaktiviert. Das gilt für Code, der über die Datenbankmethode On Startup oder die Methode Startup (Kompatibilitätsmodus) ausgeführt wird. Auf diese Weise können Sie Initialisierungsfehler vermeiden, die evtl. nach der Konvertierung auftreten können. 16 4D v11 Upgrade

19 Die Dateien konvertierter Datenbanken Die Dateien konvertierter Datenbanken 4D Datenbanken enthalten nach der Konvertierung in Version 11 mehrere zusätzliche Dateien: Datenbankname.4DIndy: Enthält den Index der Struktur. Datenbankname.4DIndx (optional): Enthält den Index der Datendatei. Hinweis: In 4D v11 werden Indizes standardmäßig außerhalb der Datenbank gespeichert. Weitere Informationen dazu finden Sie im Abschnitt Indizes verwalten auf Seite 32. Import.log: Diese Datei speichert Unregelmäßigkeiten, die während der Konvertierung der Datenbank auftreten. Ordner Ersetzte Dateien: Dieser Ordner enthält Kopien der Originaldateien der Datenbankordner vor der Konvertierung (Struktur-, Datendatei und Logbuch). Frühere Datenbanken konvertieren: Spezifische Fälle Datenbanken mit mehreren Datendateien konvertieren Verwendet die Datenbank, die Sie konvertieren wollen, mehrere unterschiedliche Datendateien, wird die Umwandlung der Datenbank und der einzelnen Datendateien separat ausgeführt. Zusätzliche Datendateien konvertieren Sie im Menü Datei/Ablage mit dem Befehl Öffnen>Datendatei. 1 Konvertieren Sie die Datenbank mit der aktuellen Datendatei in Version 11. Die Beschreibung dazu finden Sie im Abschnitt Frühere Datenbanken konvertieren: Allgemein auf Seite Wählen Sie in der konvertierten Struktur im Menü Datei/Ablage den Befehl Öffnen>Datendatei. Auf dem Bildschirm erscheint der Standard-Öffnen Dialog, in dem Sie auswählen können, welche Datendatei konvertiert werden soll. 3 Wählen Sie die gewünschte Datendatei und klicken Sie auf die Schaltfläche Öffnen. Auf dem Bildschirm erscheint das Konvertierungsfenster. Die Information zur Datendatei wird je nach der gewählten Datei aktualisiert. Die zu konvertierende Datendatei wird zuerst dupliziert und gemäß den Standardvorgaben in den Ordner Ersetzte Dateien gelegt. 4D v11 Upgrade 17

20 Kapitel 2 Konvertierung Weitere Informationen dazu finden Sie im Abschnitt Frühere Datenbanken konvertieren: Allgemein auf Seite Bestätigen Sie das Dialogfenster, um die Konvertierung zu starten. Ist die Konvertierung abgeschlossen, wird die konvertierte Datei zur aktuellen Datendatei der Datenbank. Datenbanken mit Komponenten konvertieren Es ist nicht möglich, eine Strukturdatei mit einer früheren Generation von Komponenten, also vor Version 11, zu konvertieren. Sie müssen zuerst alle Komponenten mit der entsprechenden Version von 4D Insider deinstallieren, bevor Sie eine Strukturdatei in Version 11 konvertieren. Sie müssen dann eine v11-kompatible Version der Komponenten haben, damit Sie diese in der v11 Umgebung verwenden können. Weitere Informationen dazu finden Sie im Abschnitt Neue Architektur für Komponenten auf Seite 44. Datenbanken mit mehreren Segmenten konvertieren In 4D v11 ist die Größe der Datendatei nun virtuell unbegrenzt. Die Grenzen sind lediglich durch das Betriebssystem vorgegeben. Von daher ist es nicht länger möglich, Datensegmente zu erstellen oder zu verwenden. Beim Umwandeln einer Datenbank mit Segmenten fasst der Konvertierungsassistent den Inhalt aller Segmente in eine neue Datendatei zusammen. Stellen Sie sicher, dass auf der Festplatte genügend freier Platz für die neue Datendatei vorhanden ist. Die Segmente einer Datenbank können Sie im Konvertierungsfenster auf der Seite Segmentinformation ansehen. Weitere Informationen dazu finden Sie im Abschnitt Konvertierungs-parameter ansehen bzw. ändern auf Seite 15. Fehlt bei der Konvertierung ein Segment, können Sie im Assistenten seine Position manuell eingeben. Wird das Segment nicht gefunden, lässt sich die Konvertierung nicht ausführen. 18 4D v11 Upgrade

21 Frühere Datenbanken konvertieren: Spezifische Fälle Datenbanken mit mehrsprachigen Feldern konvertieren Beim Konvertieren einer Datenbank in Version 11 werden Textdaten in Unicode umgewandelt. Für eine korrekte Konvertierung muss 4D den Ausgangszeichensatz kennen. Standardmäßig wird der Zeichensatz der aktuellen Sprache des Betriebssystems verwendet. In bisherigen Versionen von 4D war es möglich, Formularobjekten über die Eigenschaft Tastaturlayout einen spezifischen Zeichensatz zuzuweisen. In diesem Fall kann 4D v11 den Quellzeichensatz nicht mit Gewissheit zuordnen, da die Eigenschaft mit dem Formular gespeichert ist und die Dateneingabe über zwischengeschaltete Variablen erfolgen kann. Von daher sollte der Entwickler vor der Konvertierung explizit die spezifischen Datensätze angeben, und zwar in einer Textdatei auf derselben Ebene wie die zu konvertierende Datendatei. Diese Datei muss folgende Merkmale haben: Name: mulitlang.txt Codierung: ANSI oder Mac Roman (Unicode nicht verwenden) Format: Tabellennummer Trenner Feldnummer Trenner Unterfeldnummer (optional) Trenner dialect_code CRLF der Trenner ist ;. Jede Zeile muss mit einer Zeilenschaltung (CR oder CRLF) enden, Leerzeilen und -zeichen sind erlaubt. Beispiel: Wir gehen von einer Datenbank mit 4 Tabellen aus (TABELLE_1 bis TABELLE_4). - TABELLE_3 enthält 4 alphanumerische Felder (Feld_1 bis Feld_4). - TABELLE_4 enthält 6 Felder vom Typ Lange Ganzzahl und eine Untertabelle SUBFIELD mit 2 alphanumerischen Feldern - Die Eigenschaft Tastaturlayout (dialect) wurde geändert, so dass es möglich ist, Griechisch in [TABELLE_3]Feld_3 und [TABELLE_4][SUB- FIELD]Feld_1 und Russisch in [TABELLE_3]Feld_4 und [TABELLE_4][SUBFIELD]Feld_2 einzugeben. - Die Datei multilang.txt muss folglich enthalten: 3;3;1049 3;4;1032 4;7;1;1049 4;7;2;1032 4D v11 Upgrade 19

22 Kapitel 2 Konvertierung Codes für Dialekte finden Sie in der Datei KeyboardMapping.XML im Unterordner 4D Extensions. Kompatibilität der Plug-Ins Plug-Ins von Version 2004 (4D Plug-Ins oder Plug-Ins von Drittherstellern) sind in der Regel mit 4D v11 kompatibel und können in dieser Umgebung weiterverwendet werden. Beachten Sie jedoch, dass Sie die Plug-Ins updaten müssen, damit sie die Leistungsstärke der neuen Engine in 4D v11 nutzen können. Weitere Informationen dazu finden Sie im Abschnitt Erweiterte Leistungsstärke auf Seite 25. Auf Mac OS müssen Plug-Ins der universal binary Architektur entsprechen, damit Sie 4D in diesem Modus ausführen und die Vorteile dieser Performance nutzen können. Sonst können Sie Plug-Ins in 4D auch noch im Rosetta Modus verwenden. Weitere Informationen dazu finden Sie im Abschnitt Universal Binary Architektur - Universal Programme (Mac OS) auf Seite 30. Kompatibilität der 4D Anwendungen Nicht mehr unterstützte Arbeitsweisen In 4D Version 11 werden einige Funktionsweisen, die inzwischen überholt sind, nicht mehr unterstützt. Sie werden während der Konvertierung ignoriert bzw. ersetzt. Das betrifft folgende Optionen und Funktionsweisen: Komponenten im früheren Modus: Diese Komponenten müssen mit 4D Insider deinstalliert werden, bevor die Datenbank in Version 11 konvertiert wird. Weitere Informationen dazu finden Sie im Abschnitt Datenbanken mit Komponenten konvertieren auf Seite 18. Datensegmente: Datensegmente werden beim Konvertieren in einer Datei zusammengefasst. Weitere Informationen dazu finden Sie im Abschnitt Datenbanken mit mehreren Segmenten konvertieren auf Seite 18. Untertabellen: Untertabellen werden nicht mehr unterstützt. Sie werden in Standardtabellen umgewandelt, die über eine automatische Verknüpfung mit der Originaltabelle verknüpft sind; in der neuen Tabelle wird ein Feld hinzugefügt. Die bisherige Funktionsweise zum Verwal- 20 4D v11 Upgrade

23 Kompatibilität der 4D Anwendungen ten von Untertabellen funktioniert jedoch weiter, solange an Tabellen, Feldern oder Verknüpfungen, die von Untertabellen stammen, keine Änderungen vorgenommen werden. Weitere Informationen dazu finden Sie im Abschnitt Untertabellen konvertieren auf Seite 38. Direkter Zugriff auf 4D Ressourcen und Systemressourcen: Der Zugriff auf die internen Ressourcen von 4D und die Systemressourcen über die Befehle im Kapitel Ressourcen ist nicht mehr möglich. Es wurde ein Mechanismus zur Substitution eingerichtet, um die Auswirkung bei Datenbanken mit diesen Ressourcen, zu begrenzen. Weitere Informationen dazu finden Sie im Abschnitt Ressourcen verwalten auf Seite 40. 4D 2003/2004 Makros: Makros, die mit den Versionen 2003 und 2004 von 4D verwendet wurden, sind nicht kompatibel mit 4D v11. Dafür wurde ein automatischer Konvertierungsmechanismus integriert. Unter Umständen müssen jedoch lokale Anpassungen vorgenommen werden, damit sie zu XML Standards passen. Weitere Informationen dazu finden Sie im Abschnitt Neue Makro Architektur auf Seite 135. Icon des Anmeldedialogs anpassen: Das Icon des Anmeldedialogs (Name auswählen und Kennwort eingeben) ließ sich bisher mit einer Kopie der Ressource anpassen. Diese Arbeitsweise funktioniert nicht mehr. Sie wurde durch einfaches Kopieren einer Datei ersetzt. Weitere Informationen dazu finden Sie im Abschnitt Icon im Anmeldedialog ersetzen auf Seite 66. Modus Auswahl für Hintergrundbilder: Die Anpassung der Farben eines Bildes an den Hintergrund (im Format Auf Hintergrund ) über den Dialog Modus Auswahl ist nicht mehr möglich. Diese Funktionsweise wurde ursprünglich für monochrome Bilder eingeführt und passt nicht mehr zur nativen Verwaltung von Bildformaten. Weitere Informationen dazu finden Sie im Abschnitt Optimierungen auf Seite 163. Standardaktionen in Menüs der Design-, Benutzer- und Runtime- Umgebung: Diese Aktionen lassen sich in konvertierten Datenbanken nicht mehr auswählen. Sie sind in neuen Datenbanken nicht mehr verfügbar. Weitere Informationen dazu finden Sie im Abschnitt Standardaktionen in konvertierten Datenbanken auf Seite D v11 Upgrade 21

24 Kapitel 2 Konvertierung Entfernte Optionen zu Kompatibilität In den Voreinstellungen wurden unter dem Thema Anwendung auf der Seite Kompatibilität folgende Optionen entfernt: Dateiprozeduren wie Version 3 Zeichenglättung kompatibel zu V6.8 Diese Optionen emulieren frühere Funktionsweisen, die nun obsolet sind. Altes System für Bearbeiten Menü (v 6.8) Diese Option des Menüeditors wurde entfernt. Bei konvertierten Datenbanken mit dieser Option muss ein standardmäßiges Menü Bearbeiten hinzugefügt werden. Weitere Informationen dazu finden Sie im Abschnitt Menü Bearbeiten (Kompatibilität) auf Seite 185. Startup System wie Version 3 Diese ältere Operation wird in 4D v11 nicht mehr berücksichtigt, Projektmethoden mit Namen Debut oder Startup werden nicht mehr automatisch ausgeführt. Der Code für Startup muss in die Datenbankmethoden On Startup bzw. On Server Startup gelegt werden. Gelöschte Befehle Veränderte Syntax Die folgenden Befehle gibt es nicht mehr in 4D v11, da sie zu Technologien gehören, die nicht länger unterstützt werden. SEARCH BY INDEX SAVE OLD RELATED ONE SORT BY INDEX Dieser Abschnitt erläutert die Weiterentwicklung in 4D v11, die in konvertierten Anwendungen zu Syntaxfehlern führen kann. Aus strukturellen Gründen ist der Parameter Tabelle für die Befehle QUERY BY FORMULA, QUERY SELECTION BY FORMULA und APPLY TO SELECTION nun zwingend. Verwenden sie diesen Parameter nicht, erzeugt 4D v11 einen Syntaxfehler. Im Vergleich zu früheren 4D Versionen ist der Interpreter der Programmiersprache von 4D v11 strikter geworden. Insbesondere das implizierte Retyping sowie die Verwendung von Arrays anstatt Variablen und umgekehrt kann in Version 11 Syntaxfehler auslösen, während dies in bisherigen Versionen toleriert wurde. 22 4D v11 Upgrade

25 Kompatibilität der 4D Anwendungen Hinweis: Die interne Funktionsweise von einigen Befehlen hat sich in 4D v11 geändert, wodurch u.u. Anpassungen in konvertierten Anwendungen notwendig sind. Weitere Informationen dazu finden Sie im Abschnitt Verschiedene Änderungen auf Seite 433. Dokumentformate Das interne Dokumentformat, das die Befehle SAVE SET/LOAD SET und SEND RECORD/RECEIVE RECORD verwenden, hat sich geändert. Die aufsteigende Kompatibilität ist jedoch garantiert. Die Befehle LOAD SET und RECEIVE RECORD von 4D v11 können Dokumente lesen, die mit früheren Versionen erstellt wurden. Im Gegensatz dazu können Sie jedoch Dokumente, die mit 4D Version 11 erstellt wurden, nicht mit älteren Versionen öffnen. 4D v11 Upgrade 23

26 Kapitel 2 Konvertierung 24 4D v11 Upgrade

27 3 Architektur von 4D Datenbanken v11 Die Datenbank-Engine von 4D v11 wurde umgeschrieben und bietet noch mehr Leistungsstärke und Stabilität. Diese neue Generation nutzt die derzeit fortschrittlichste Technologie zur Datenverwaltung und sprengt alle Grenzen bisheriger Versionen. Auch die Datenbank-Architektur hat sich verändert, und zwar sowohl auf Datei-Ebene als auch für Komponenten. Die Ordner mit den Datenbanken in 4D v11 wurden ebenfalls neu strukturiert. Erweiterte Leistungsstärke Viele Einschränkungen früherer 4D Versionen wurden in 4D v11 aufgehoben oder auf ein Minimum reduziert. Nachfolgende Tabelle vergleicht die neuen Features der Datenbank- Engine in 4D v11 mit der Engine früherer 4D Versionen: Feature 4th Dimension 200x 4D v11 Größe der Datendatei 127 Segmente mit je 2 Gb Unbegrenzt (keine Segmentierung) Anzahl der Tabellen Anzahl Felder pro Tabelle Anzahl Datensätze pro Tabelle 16 Millionen 1 Milliarde Anzahl Indizes pro Tabelle 16 Millionen 1 Milliarde Länge alphanumerischer Felder Länge von Textfeldern Zeichen 2 GB Text 1 Ebene für Transaktionen 1 Unbegrenzt 2 4D v11 Upgrade 25

28 Kapitel 3 Architektur von 4D Datenbanken v11 1. Zur Verdeutlichung wurde die Konstante MAXTEXTLEN (Wert ) in MAXTEXTLENBEFOREV11 umbenannt. In Version 11 macht die Verwendung dieser Konstanten keinen Sinn mehr. 2. Zur Wahrung der Kompatibilität bleibt bei konvertierten Datenbanken die Anzahl der Transaktionsebenen auf 1 beschränkt (siehe unten). Neue Feldtypen Im Struktureditor sind zwei neue Feldtypen verfügbar: Ganzzahl 64 bits und Fließkomma. Ganzzahl 64 bits: Über Ganzzahlen mit 8 Bytes können Sie Werte zwischen -2^63...(2^63)-1 verwalten. Fließkomma: Fließkommazahlen dienen zum Speichern von Zahlen ohne Verlust der Genauigkeit. In der derzeitigen Version von 4D v11 verwendet nur die SQL-Engine von 4D Felder dieses Typs. Weitere Informationen dazu finden Sie im Kapitel 10. Bei Verwendung in der 4D Programmiersprache werden sie intern in den Typ Zahl umgewandelt. Tabellen und Felder löschen In 4D v11 können Sie Tabellen und Felder physikalisch löschen. Diese Operation lässt sich über die SQL-Engine von 4D oder über den Struktureditor ausführen. Weitere Informationen dazu finden Sie im Kapitel 10. Um eine Tabelle oder ein Feld im Struktureditor zu löschen, wählen Sie einfach das entsprechende Objekt aus und drücken die Löschen- bzw. Rückschritt-Taste (kein Element im Inspektor darf den Fokus haben). Eine Meldung informiert Sie über die Folgen dieser Operation: Klicken Sie auf die Schaltfläche OK, führt 4D folgendes aus: Die Tabelle oder das Feld wird unwiderruflich aus der Struktur entfernt. Alle damit verknüpften Daten werden unwiderruflich aus der Datendatei gelöscht. Alle mit der Tabelle verknüpften Trigger-Methoden werden gelöscht. 26 4D v11 Upgrade

29 Erweiterte Leistungsstärke Die der Tabelle zugeordneten Formulare werden in Projektformulare umgewandelt und in den Papierkorb des Explorers gelegt. Weitere Informationen dazu finden Sie im Abschnitt Projektformulare auf Seite 141. Nummerierung verbleibender Tabellen und Felder Wird eine Tabelle oder ein Feld gelöscht, werden die anderen Tabellen und Felder der Datenbank nicht umnummeriert, damit die Stabilität der Datenbank gewahrt bleibt. So kann eine Datenbank z.b. drei Tabellen mit den Nummern 2, 4 und 5 haben, eine weitere Tabelle kann vier Felder mit den Nummern 1, 4, 6 und 8 haben. Folglich ist das Vorgehen zum Zählen von Tabellen und Feldern mit den bisherigen Funktionen Count tables und Count fields überholt, da diese mögliche Löcher in der Nummerierung nicht berücksichtigen. Deshalb wurden die bestehenden Funktionen umbenannt und neue hinzugefügt. Weitere Informationen dazu finden Sie im Abschnitt Tabellen und Felder zählen auf Seite 408. Beachten Sie, dass die Nummern gelöschter Tabellen und Felder beim Anlegen neuer Objekte wieder verwendet werden. Dieses Verfahren ist ähnlich wie für Datensatznummern. Kompatibilität bei Transaktionen 4D v11 akzeptiert nun verschachtelte Transaktionen auf einer unbegrenzten Anzahl von Ebenen. Da diese Option jedoch die Funktionsweise von Datenbanken älterer Versionen beeinträchtigen kann, ist sie in konvertierten Datenbanken standardmäßig inaktiv, d.h. hier sind Transaktionen auf eine Ebene begrenzt. 4D v11 Upgrade 27

30 Kapitel 3 Architektur von 4D Datenbanken v11 Um in einer konvertierten Datenbank Transaktionen auf mehreren Ebenen durchzuführen, müssen Sie in den Voreinstellungen auf der Seite Anwendung>Kompatibilität die Option Verschachtelte Transaktionen markieren: In konvertierten Datenbanken verschachtelte Transaktionen ausführen Diese Option erscheint nur für konvertierte Datenbanken. Sie ist standardmäßig nicht markiert und gilt spezifisch für jede Datenbank. Hinweis: Die Option Verschachtelte Transaktionen hat keine Auswirkung auf Transaktionen, die mit der SQL-Engine von 4D v11 ausgeführt werden. Weitere Informationen dazu finden Sie im Kapitel 10. SQL-Transaktionen sind immer mehrschichtig. Temporäre Ordner 4D v11 bietet neue Optionen zum Speichern des temporären Ordners. Das Programm verwendet diesen Ordner bei Bedarf, um die Daten vorübergehend im Speicher auf der Festplatte abzulegen. 28 4D v11 Upgrade

31 Erweiterte Leistungsstärke In den Einstellungen der Datenbank auf der Seite Anwendung>Optionen legen Sie fest, wo dieser Ordner liegt: Ort für temporären Ordner festlegen Die aktuelle Position des Ordners erscheint in der DropDown-Liste neben Aktuell. Klicken Sie in die Liste, um den vollständigen Pfadnamen zu sichten oder zu kopieren. Es gibt drei Optionen: System: Ist diese Option markiert, werden die temporären Ordner von 4D in einem Ordner an der von Windows bzw. Mac OS angegebenen Stelle abgelegt. Mit der Funktion Temporary folder können Sie herausfinden, welcher Ort in Ihrem System definiert wurde. Die Dateien werden in einen Unterordner gelegt mit dem Namen der Datenbank und einem einmaligen Identifizierer. Ordner der Datendatei (Standardoption): Ist diese Option markiert, werden die temporären Ordner von 4D in einen Ordner mit Namen temporary files auf derselben Ebene wie die Datendatei der Datenbank gelegt. Benutzerdefiniert: Mit dieser Option legen Sie einen eigenen Ort fest. 4D v11 Upgrade 29

32 Kapitel 3 Architektur von 4D Datenbanken v11 Verändern Sie diese Einstellung, müssen Sie die Datenbank neu starten, damit die neue Option berücksichtigt wird. 4D prüft, ob sich der gewählte Ordner im Schreibmodus öffnen lässt. Ist dies nicht der Fall, versucht die Anwendung andere Optionen, bis ein gültiger Ordner gefunden wird. Diese Option wird in den Extra Eigenschaften der Struktur gespeichert, die verfügbar ist, wenn die Strukturdefinition in XML exportiert wird. Weitere Informationen dazu finden Sie im Abschnitt Strukturdefinitionen exportieren und importieren auf Seite 125. Universal Binary Architektur - Universal Programme (Mac OS) Die Mac OS Version von 4D v11 ist von universal binary Architektur, d.h. 4D Programme laufen auf neueren Apple Rechnern, die auf Intel Prozessoren basieren (Mac Intel) im native Modus. Das steigert die Performance in beträchtlicher Weise. Die Programme von 4D v11 laufen auf Mac OS standardmäßig im native Modus. Sie können aber auch die Ausführung im emulierten Modus (Rosetta Modus) erzwingen, insbesondere wenn Sie Plug-Ins verwenden, die keine universal Architektur haben. Dazu wählen Sie das 4D Programm auf dem Desktop aus und wählen im Menü Ablage den Befehl Information. Auf dem Bildschirm erscheint das Info-Fenster, in dem Sie die Option Mithilfe von Rosetta öffnen wählen können. 30 4D v11 Upgrade

33 Universal Binary Architektur - Universal Programme (Mac OS) Das Programm wird dann im emulierten Modus ausgeführt: Ausführung im emulierten Modus (Rosetta) 4D v11 Upgrade 31