Die Struktur in Textdateien exportieren

Home

4D v20 R7

Überblick

Sie können die Inhalte Ihrer Datenbankstruktur in eine Reihe einzelner Dateien exportieren. Auf Text basierende Elemente wie Methoden, Menüs, Formulare, Datenbank-Eigenschaften, etc. werden in einzelne Dateien im Textformat exportiert. Bilder werden in ihren nativen Formaten exportiert. Elemente vom gleichen Typ werden automatisch in spezifischen Ordnern gruppiert.

Die Datenbankstruktur wird in ihrem aktuellen Status exportiert. Die Exportfunktion ermöglicht, die Strukturdateien Ihrer Anwendung in einem Source Control Repository (i.e., Git, Perforce, etc.) zu speichern. Sie können die Datenbankstruktur z.B. einmal am Tag exportieren. Dann lassen sich anschließende Änderungen oder Änderungen von mehreren Entwicklern an der gleichen Datei über standardmäßige Source Control Tools mit der gespeicherten Struktur vergleichen.

Voraussetzungen

Die Strukturdatei lässt sich nur exportieren für:

4D im lokalen Modus oder 4D Server
64-bit Versionen
Anwendung im interpretierten Modus

Dateien exportieren

Um Elemente der Datenbankstruktur in Textdateien zu exportieren, können Sie folgendes ausführen:

Sie wählen im Menü Datei/Ablage den Eintrag Exportieren > Struktur in Text-Dateien (4D Developer):

Es erscheint ein Standard Dialogfenster, wo Sie den Zielordner für den Export der Dateien auswählen können. Klicken Sie auf die Schaltfläche Ordner auswählen, läuft automatisch der Export.
Mit diesem Menübefehl wird der Export mit den Standardoptionen ausgeführt (siehe unten). Wollen Sie spezifische Elemente exportieren, müssen Sie den Befehl Export structure file verwenden.
Hinweis: Der Menüeintrag ist deaktiviert, wenn die Designumgebung nicht verfügbar ist (z.B. die Anwendung ist kompiliert oder der Benutzer hat keine Zugriffsrechte für den Designmodus).

Oder Sie führen den Befehl Export structure file aus (4D Developer oder 4D Server). Er bietet Parameter, um Elemente für den Export zu filtern. Weitere Informationen dazu finden Sie unter diesem Befehl.

Hinweis: Zur Wahrung der Konsistenz zwischen den Versionen exportiert 4D Dateien immer mit den englischen Einstellungen für Programmiercode, Datum und Zeitformate, sowie Zahlenformate (dezimal und Gruppierungszeichen).

Beschreibung der exportierten Dateien

Im Zielordner für den Export erstellt oder verwendet 4D bei Bedarf entsprechende Unterordner. Nachfolgende Tabelle beschreibt die einzelnen exportierten Elemente:

Sources	Unterordner (falls vorhanden)	*Dateiname oder -pfad ()**	Beschreibung	Vom Menü Datei/Ablage exportiert
		catalog.4DCatalog	Tabellen- und Felddefinitionen (XML)	ja
		folders.json	Definitionen der Explorer Ordner	ja
		menus.json	Menüdefinitionen	ja
		settings.4DSettings	Datenbank-Eigenschaften (XML)	ja
		tips.json	Definierte Tipps	ja
		lists.json	Definierte Listen	ja
		filters.json	Definierte Filter	ja
	DatabaseMethods	<databaseMethodName>.4dm	In der Datenbank definierte Datenbankmethoden. Eine Datei pro Datenbankmethode	ja
	Methods	<methodName>.4dm	In der Datenbank definierte Projektmethoden. Eine Datei pro Methode	ja
	Forms	<formName>/form.4DForm	Beschreibung der Projektformulare im JSON Format	ja
		<formName>/method.4dm	Methode für Projektformular	ja
		<formName>/Images/<pictureName>	statische Bilder im Projektformular	ja
		<formName>/ObjectMethods/<objectName>.4dm	.4dm Datei für jede Objektmethode	ja
	TableForms	<n>/Input/<formName>/form.4DForm	Eingabeformular der Tabelle, Beschreibung im JSON Format (n ist die Tabellennummer)	ja
		<n>/Input/<formName>/Images/<pictureName>	statische Bilder des Eingabeformulars der Tabelle	ja
		<n>/Input/<formName>/method.4dm	Methode des Eingabeformulars der Tabelle	ja
		<n>/Input/<formName>/ObjectMethods/<objectName>.4dm	.4dm Datei für jede Objektmethode	ja
		<n>/Output/<formName>/form.4DForm	Ausgabeformular der Tabelle, Beschreibung im JSON Format (n ist die Tabellennummber)	ja
		<n>/Output/<formName>/Images/<pictureName>	statische Bilder des Ausgabeformulars der Tabelle	ja
		<n>/Output/<formName>/method.4dm	Methode des Ausgabeformulars der Tabelle	ja
		<n>/Output/<formName>/ObjectMethods/<objectName>.4dm	.4dm Datei für jede Objektmethode	ja
	Triggers	table_<n>.4dm	In der Datenbank definierte Triggermethoden. Eine Triggerdatei pro Tabelle	ja
Settings		BuildApp.4DSettings	Datei BuildApp.xml	ja
		Backup.4DSettings	Datei Backup.xml	ja
		directory.json	4D Benutzer und Gruppen	ja
Resources			Kopie des Ordners Resources	nein
	Images	<item>	Bilder aus der Bildbibliothek als separate Dateien. Namen der Einträge in der Bildbibliothek werden zu Dateinamen. Bei Duplikaten wird eine Nummer an den Namen angefügt.	nein
Trash	Methods	(<methodName>.4dm)	Methoden im Papierkorb	nein
	Forms	(<formName>.4DForm)	Formulare im Papierkorb	nein
userPreferences.<userName>		methodPreferences.json	Einstellungen des Methodeneditors	nein
		methodWindowPositions.json	Fensterpositionen des aktuellen Benutzers	nein
		preferences v15.4DPreferences	Pfad zur Datendatei	nein
Logs			Conversion Logfiles sind JSON Dateien mit Zeitstempel im Namen. Sie enthalten die gleiche Information wie das Objekt Ergebnis des Befehls Export structure file.	ja

(*) 4D codiert automatisch verbotene Zeichen für Pfadnamen auf Systemebene, so dass kein Fehler generiert wird. Beispiel: "Button/1" wird codiert als "Button%2F1". Die Liste der codierten Zeichen finden Sie im Abschnitt Pfadnamen erstellen.

Hinweise:

Die Endung .4dm ist ein textbasiertes Dateiformat mit dem Code einer 4D Methode. Sie ist mit Source Control Tools kompatibel.
Die automatische Höhenanpassung für Objekte in Stilvorlagen ist deaktiviert.
Formularobjekte oder Eigenschaften, die in Dynamische Formulare nicht unterstützt werden, erzeugen Fehler im Konvertierungsprotokoll. Weitere Informationen dazu finden Sie im Abschnitt .