Eine bestehende Datenbank in ein Projekt umwandeln

Ab 4D v17 R5 können Sie ein Datenbankprojekt erstellen. Einer der größten Vorteile von Projekten besteht darin, dass sie die Zusammenarbeit in verteilten Teams erleichtern … indem sie den Quellcode in einem Quellkontrollsystem in einfachen Textdateien speichern. Ob Sie nun ein einzelner Entwickler oder Teil eines Teams sind, dies eröffnet Ihnen eine neue Welt der Möglichkeiten.

Aber was ist mit bestehenden Datenbanken? Können sie in Projekte umgewandelt werden? Ja! Dieser Blogbeitrag zeigt Ihnen, wie das geht, und macht Sie auf einige Dinge aufmerksam, die Sie wissen sollten, bevor Sie fortfahren.

Konvertieren Sie Ihre Datenbank

Bei der Konvertierung wird die Datei.4DB (die binäre Datenbankstrukturdatei) nicht verändert. Es wird ein neuer „Projekt“-Ordner neben Ihrer .4DB erstellt. Auf diese Weise können Sie Ihre binäre Datenbank mehrmals konvertieren (dies kann zu Testzwecken nützlich sein). Beachten Sie, dass die Konvertierung nur in eine Richtung erfolgt. Das heißt, wenn Sie einmal in ein Projekt konvertiert haben und Änderungen vornehmen, können Sie diese Änderungen nicht automatisch wieder in Ihre .4DB integrieren.

Die Konvertierung ist sehr einfach: Klicken Sie einfach auf den Menüpunkt „Datei > Exportieren > Struktur in Projekt“:

Sie können wählen, ob Sie das Projekt über eine Schaltfläche „Projekt öffnen“ (die im Konvertierungsdialog angezeigt wird) oder über die herkömmliche Methode zum Öffnen einer Datenbank öffnen möchten.

Was passiert nun wirklich bei der Konvertierung?

Neben der .4DB wird ein neuer Ordner .4DProject erstellt. Er enthält Ihren gesamten Code, Formulare, Strukturen, Methoden, Trigger, Menüs, Tipps, Listen usw.:

Im Ordner .4DProject verwendet das Projekt dieselben Ressourcen- und Web-Ordner wie die .4DB. Das macht das Testen Ihres Projekts einfacher. Öffnen Sie Ihre .4DB-Datenbank, nehmen Sie einige Änderungen vor, exportieren Sie sie dann erneut und testen Sie die Ergebnisse. Sie können diesen Vorgang wiederholen, bis Sie mit der Konvertierung zufrieden sind.

Hinweise zur Kompatibilität

In Projekten haben wir einige veraltete Funktionen entfernt und planen, andere zu aktualisieren:

• Die Bildbibliothek gibt es in Projekten nicht mehr. Bei der Konvertierung exportiert 4D alle Bilder in den Ressourcen-Ordner.
• Eine neue und modernere Implementierung zur Erweiterung der Möglichkeiten für Stilvorlagen wird in einer zukünftigen Version zur Verfügung gestellt.
• Als Reaktion auf Ihre Kommentare ist eine neue Benutzerverwaltung für Benutzer und Gruppen in Arbeit.
• Es wurden Änderungen an den Formularobjekten und ihren Eigenschaften vorgenommen. Sie verwenden die gleiche Grammatik wie dynamische Formulare.
• Die Kompatibilitätseinstellungen werden zurückgesetzt (wie bei einer neuen Binärdatenbank). Wenn Sie überprüfen möchten, ob Ihr Code auf dem neuesten Stand ist, lesen Sie bitte Thomas Mauls Blogpost-Serie über Kompatibilitätseinstellungen.

Überprüfen Sie Ihre Konvertierung

Sie müssen sich keine Sorgen um die Konvertierung Ihrer Datenbank machen. Die Konvertierung ändert weder Ihre Struktur (.4DB) noch Ihre Daten (.4DD). Während der Konvertierung wird eine Protokolldatei erstellt, in der die Meldungen in drei Kategorien eingeteilt sind: Info, Warnung und Fehler.

Wenn Sie zum Beispiel Bilder in der Bildbibliothek haben, exportiert 4D diese in den Ressourcen-Ordner Ihres Projekts. In der Protokolldatei wird die Entsprechung zwischen der ID des Bildes und dem Namen der Datei aufgezeichnet:

{
   "message": "Exporting picture id:1, name:logo.png, types:.png to <...>:Resources:Images:library:logo.png",
   "severity": "info"
}

Bei manchen Fehlern müssen Sie eingreifen (z. B. wenn Ihre Datenbank alte Formularobjekte verwendet, die nicht mehr unterstützt werden, wie z. B. Markierungsschaltflächen). In diesem Fall müssen Sie die Schaltfläche manuell in eine 3D-Schaltfläche umwandeln.

{
   "table": 3,
   "tableName": "Name",
   "form": "Form",
   "object": "button",
   "message": "Highlight buttons are unsupported. Please convert them to 3D buttons.",
   "severity": "error"
}

Wie auch immer, 4D informiert Sie über alles, was es tut. Alles, was Sie tun müssen, ist, das Protokoll zu lesen, um besser zu verstehen, was während der Konvertierung passiert ist (oder um einfach nur nützliche Informationen zu haben).

Was ist zu erwarten?

Dies ist die allererste (Beta-)Version des Projekts. Die zugehörigen Funktionen werden bald für unsere Partner verfügbar sein, beginnend mit 4D v17 R5 Beta. Im Gegensatz zu anderen Funktionen, die erst in R-Releases enthalten sind (nachdem sie vollständig getestet und als produktionsreif eingestuft wurden), befindet sich Projects noch in der Entwicklung und dient nur zu Testzwecken. Es sollte noch nicht in der Produktion eingesetzt werden, da es noch nicht 100%ig vollständig und fehlerfrei ist. Daher ist Ihr Feedback jetzt mehr denn je gefragt.

Die Tests werden mit 4D v17 R6 Beta fortgesetzt. In den kommenden 6 Monaten der Tests und mit Ihrer Hilfe wird 4D v18 ein Meilenstein in der Geschichte von 4D sein.

Beteiligen Sie sich an der Diskussion in unserem Forum „Beta-Version“ (zugänglich für alle 4D Partner).