Export structure file

Home

4D v20 R7


Export structure file ( OrdnerPfad {; Optionen} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
OrdnerPfad	String	Pfad des Zielordners für die Projektdateien
Optionen	Objekt	Exportoptionen
Funktionsergebnis	Objekt	Status der Bestätigung und Meldungen (falls vorhanden)

Beschreibung

Der Befehl Export structure file exportiert die Struktur der aktuellen 4D Anwendung in mehrere textbasierte Dateien oder native Bilddateien und speichert sie im angegegebenen Ordner OrdnerPfad. Standardmäßig wird die gesamte Struktur der Anwendung exportiert (Methoden, Formulare, Katalog, etc.). Über den Parameter Optionen lässt sich der Inhalt filtern (siehe unten).

Damit können Sie die Strukturdateien der Anwendung in einem Source Control Repository (i.e., Git, Perforce, etc.) speichern. Über standardmäßige Source Control Tools ist dann der Vergleich mit anschließenden Änderungen oder Änderungen aus verschiedenen Quellen möglich.

Dieser Befehl gilt nur für:

4D im lokalen Modus oder 4D Server (bei Aufruf in remote 4D wird ein Fehler zurückgegeben)
Interpretierte Anwendung (bei Aufruf in einer .4DC Anwendung führt der Befehl nichts aus)

Wird Export structure file von einer Komponente aufgerufen, exportiert er immer die Struktur der Host Anwendung.

In OrdnerPfad geben Sie den Systempfad des Ordners an, in dem die Exportdateien gespeichert werden sollen.

Mit dem Parameter Optionen können Sie den Übertragungsprozess anpassen. Das Objekt Optionen kann folgende Eigenschaften enthalten:

Name der Eigenschaft

Wertetyp

Beschreibung

withLog

Boolean oder String

wahr oder "always": Im Zielordner Logs ein Übertragungsprotokoll (Conversion file) anlegen.

"ifNotEmpty": Ein Übertragungsprotokoll (Conversion file) nur anlegen, wenn es Meldungen enthält

falsch oder weggelassen (Standard): kein Übertragungsprotokoll anlegen

makeProject

Boolean

wahr zum Erstellen einer Datei .4DProject im Ordner "Project"

filter

Objekt

Inhalt zum Exportieren. Ohne filter (Standard) wird alles exportiert

projectMethods

Boolean

wahr zum Exportieren von Projektmethoden

databaseMethods

Boolean

wahr zum Exportieren von Datenbankmethoden

triggerMethods

Boolean

wahr zum Exportieren von Triggermethoden

forms

Boolean

wahr zum Exportieren von Formularen

catalog

Boolean

wahr zum Exportieren von Tabellen und Felddefinitionen

folders

Boolean

wahr zum Exportieren von Explorer Ordner Definitionen

settings

Boolean

wahr zum Exportieren von Struktur Einstellungen

menus

Boolean

wahr zum Exportieren von Menüs

tips

Boolean

wahr zum Exportieren von Tipps

lists

Boolean

wahr zum Exportieren von Listen

filters

Boolean

wahr zum Exportieren von Filtern

pictures

Boolean

wahr zum Exportieren von Bildern aus der Bildbibliothek

resources

Boolean

wahr zum Exportieren des Ordners Resources

trash

Boolean

wahr zum Exportieren von Methoden und Formularen im Papierkorb (*)

windowPositions

Boolean

wahr zum Exportieren von Fensterpositionen

methodPreferences

Boolean

wahr zum Exportieren von Einstellungen des Methodeneditors

buildSettings

Boolean

wahr zum Exportieren der Datei buildApp.xml

dataPath

Boolean

wahr zum Kopieren des Pfads der zuletzt geöffneten Datendatei in die Projektdatei Benutzer-Einstellungen

Ergebnis

Der Befehl gibt ein Objekt mit dem Endstatus des Exports zurück und enthält Angaben zu aufgetretenen Problemen oder Fehlern, falls vorhanden. Es gibt folgende Eigenschaften:

Name der Eigenschaft		Wertetyp	Beschreibung
success		Boolean	Wahr bei erfolgreich abgeschlossenen Export, sonst falsch.
messages		Collection	Collection von Objekten, die beim Export aufgetretene Probleme beschreiben
	[ ].severity	Text	Problemstufe. Mögliche Werte: "info", "error". Nur die Stufe "error" setzt die Eigenschaft "success" auf falsch.
	[ ].message	Text	Beschreibung des Problems oder Fehlers, z.B. "Typ Objekt wird nicht unterstützt"
	[ ].errors	Collection	Fehlerstapel (falls vorhanden)

Hinweis: Objekte in Form von Problemen können je nach Kontext weitere Eigenschaften enthalten.

Fehler können auftreten bei:

Doppelten Elementen
Fehlerhafter Datenverwaltung (Datei bereits vorhanden, Datei gesperrt, Festplatte voll, etc.)
nicht unterstütztem Formularobjekt oder Eigenschaft (siehe auch unter )

Beispiel 1

Die Strukturdatei der Anwendung mit den Standardeinstellungen in einen Ordner "Export" exportieren:

 C_OBJECT($result)

 $result:=Export structure file("Export")

 If($result.success=True)

    ALERT("Export erfolgreich")

 Else

    ALERT("Fehler beim Export")

 End if

Beispiel 2

Nur die Projekt- und Datenbankmethoden und Logbuch exportieren:

 C_OBJECT($option;$result)

 $option:=New object("filter";New object)

 $option.filter.projectMethods:=True

 $option.filter.databaseMethods:=True

 $option.withLog:="immer"

 $result:=Export structure file("exportWithLog";$option)

Siehe auch

FORM Convert to dynamic