Name
OPEN
Syntax
OPEN ( erweiterung, dateiname, parametertext )
Wertebereicheerweiterung, Name eines aktiven GDL-AddOn, Typ string
dateiname, Typ string
parametertext, Typ string
dateiname, Typ string
parametertext, Typ string
ErläuterungÖffnet die Datei dateiname mit einer bestimmten Datenschnittstelle. Die Datenschnittstelle ist eine Erweiterung des GDL Befehlsinterpreters und befindet sich im Programmverzeichnis unter AddOns/GDL. ArchiCAD wird mit verschiedenen Schnittstellen ausgeliefert, Schnittstellen von Drittanbietern sind möglich. Die Funktionsweise und Syntax der verschiedenen Schnittstellen wird unter AddOns beschrieben.
Welche Schnittstelle verwendet werden soll, wird mit ihrem Namen in erweiterung vorgegeben. Danach richtet sich auch die Beschreibung der Art und Funktion (parametertext), mit der und wie die Datei geöffnet wird.
Der OPEN-Befehl funktioniert wie eine Funktion. Das Öffnen selbst wird durch das AddOn durchgeführt, welches auch die Syntaxprüfung übernimmt. War die Aktion erfolgreich, wird der in der Folge geöffneten Datei eine eindeutige Kanalnummer als positive Integerzahl zugewiesen und als Ergebnis des OPEN-Befehls zurückgegeben. War das Öffnen nicht erfolgreich, ist das Ergebnis 0.
Da mehrere Dateien gleichzeitig geöffnet sein können, kann mit der Kanalnummer zwischen diesen differenziert werden.
Geöffnete Dateien müssen, wenn nicht mehr benötigt unbedingt wieder mit CLOSE geschlossen werden.
Welche Schnittstelle verwendet werden soll, wird mit ihrem Namen in erweiterung vorgegeben. Danach richtet sich auch die Beschreibung der Art und Funktion (parametertext), mit der und wie die Datei geöffnet wird.
Der OPEN-Befehl funktioniert wie eine Funktion. Das Öffnen selbst wird durch das AddOn durchgeführt, welches auch die Syntaxprüfung übernimmt. War die Aktion erfolgreich, wird der in der Folge geöffneten Datei eine eindeutige Kanalnummer als positive Integerzahl zugewiesen und als Ergebnis des OPEN-Befehls zurückgegeben. War das Öffnen nicht erfolgreich, ist das Ergebnis 0.
Da mehrere Dateien gleichzeitig geöffnet sein können, kann mit der Kanalnummer zwischen diesen differenziert werden.
Geöffnete Dateien müssen, wenn nicht mehr benötigt unbedingt wieder mit CLOSE geschlossen werden.
Beispielkanal1 = OPEN ("TEXT", "Bestelliste.txt", "WO")
kanal2 = OPEN ("DateTime", "", "%H:%M")
kanal2 = OPEN ("DateTime", "", "%H:%M")
BesonderheitenBeim Erstellen eines Projektarchives werden zur Darstellung des Projektes notwendige Dateien in die PLA-Datei integriert. Leider berücksichtigt das nicht mit OPEN extern angebundene Dateien. Egal ob der dateiname in Klartext oder als Variable angegeben wird. Ab ArchiCAD® 9 kann man mit dem Befehl FILE_DEPENDENCE die Einbindung erzwingen. In den ArchiCAD®-Versionen davor müssen die Dateien der PLA zur Archivierung "manuell" beigelegt werden.
Tipps und TricksIn den meisten Fällen werden Dateiaufrufe mit OPEN initiiert. Diese Dateien müssen für ArchiCAD® zugänglich sein. Also entweder in der Bibliothek geladen (=nicht nur dort abgelegt!) oder im Datenordner des Programmverzeichnisses. Ist dies nicht der Fall kann normalerweise über den optinalen Schalter DIALOG im Parameterstring ein Dateidialog vorgesehen werden. Beim Öfnnen einer Datei kann dann die Datei dann dezidiert zugeordnet werden. Diese Zuordnung "merkt" sich ArchiCAD dann in der Folge dieser "session". Soll eine Datei geschrieben werden, kann so auch die Zieldatei angegeben werden. Vorsicht bei mehreren OPEN-Befehlen in einem Skript: Die Benennung in den Dialogen ist nicht sehr aufschlußreich.
Wird als Zieldatei eine ArchiCAD® (noch) nicht bekannte gewählt und ist kein Pafd angegeben, so wird diese in jedem Fall in den Datenordner des Programmverzeichnisses gelegt.
Wird als Zieldatei eine ArchiCAD® (noch) nicht bekannte gewählt und ist kein Pafd angegeben, so wird diese in jedem Fall in den Datenordner des Programmverzeichnisses gelegt.
ArchiCADab 5.0