Name
OPEN
Syntax
kanal = OPEN ("DATA", Dateiname, ParameterString)
kanal: Ergebnis ist positiver Integerwert; (einzusetzen ist eine Variable wie ch1)
"DATA": String, interner Name des Add-Ons, hier "DATA"
Dateiname: Name der zu öffnenden Datei, z.B. "Terra_Tisch_Liste.txt"
ParameterString: Add-On-spezifischer Parameter, enthält Trennzeichen und Parameter zum Öffnen der Datei
"DATA": String, interner Name des Add-Ons, hier "DATA"
Dateiname: Name der zu öffnenden Datei, z.B. "Terra_Tisch_Liste.txt"
ParameterString: Add-On-spezifischer Parameter, enthält Trennzeichen und Parameter zum Öffnen der Datei
Mit diesem Befehl wird die externe Datenbank in Form einer Textdatei mit beliebiger Endung geöffnet.
Existiert der Dateiname nicht, wird die Datei im Falle von zu schreibenden oder zu modifizierenden Daten neu erstellt, im Falle von zu lesenden Daten erfolgt eine Fehlermeldung.
Der String "DATA" ist obligatorisch ebenso wie der Dateiname der zu öffnenden Datei incl. Endung.
Der ParameterString kann aus mehreren z.T. optionalen Einzelkomponenten bestehen.
Die Syntax für den ParameterString könnte man wie folgt definieren:
"MODE=Öffnungsart [SEPARATOR='sep'[,ÖFFNUNGSHILFE]"
Folgende Werte können hierbei angenommen werden:
Öffnungsart:
- RO (read only) nur lesen
- WA (write after) öffnet die Datenbank, falls vorhanden und hängt am Ende des Textes der Datenbank etwas an
- WO (write only) öffnet die Datenbank, falls vorhanden, und überschreibt alles
SEPARATOR: sep gibt den Separator in einfachen Anführungszeichen an z.B. ',' oder '.' oder '-' oder ein Tabulator '\t', welches der Standardwert ist (in diesem Fall kann der Ausdruck SEPARATOR='\t' weggelassen werden)
ÖFFNUNGSHILFE:
- wenn dieser Wert leergelassen und der Dateiname ohne Pfad ist, sucht das Addon die Datei im ArchiCAD-Verzeichnis
- DIALOG: Ist die Öffnungsmethode RO (read only), startet das Add-On einen Dialog um das Dokument auszuwählen. Andernfalls startet das Add-On einen Warndialog mit den Optionen 'Erstellen' und 'Suchen'. Suchen: sucht eine vorhandene Datei (Öffnungsdialog). Erstellen: erstellt eine neue Datei (Dialog speichern als).
- LIBRARY: wird der Ausdruck LIBRARY als Öffnungshilfe verwendet, muss sich die Datei in der geladenen Bibliothek befinden.
- FULLPATH: bei diesem Ausdruck ist nicht nur der Dateiname, sondern der komplette Dateipfad anzugeben (man achte auf die unterschiedlichen Pfadangaben bei Windows und Mac).
Bei nicht existierenden Zeichenfolgen, falschen Trennzeichen oder leerem Parameterstring wird intern folgende Standardsyntax benutzt:
SEPARATOR = '\t', MODE = RO
Bei WO und WA wird ohne Pfadangabe eine nicht vorhandene Datei immer direkt im ArchiCAD-Ordner erzeugt.
Zwischen MODE, SEPARATOR und ÖFFNUNGSHILFE ist immer ein Komma zu setzen.
Vor MODE und vor der schließenden Klammer ist jeweils ein doppeltes Anführungszeichen zu setzen.
Existiert der Dateiname nicht, wird die Datei im Falle von zu schreibenden oder zu modifizierenden Daten neu erstellt, im Falle von zu lesenden Daten erfolgt eine Fehlermeldung.
Der String "DATA" ist obligatorisch ebenso wie der Dateiname der zu öffnenden Datei incl. Endung.
Der ParameterString kann aus mehreren z.T. optionalen Einzelkomponenten bestehen.
Die Syntax für den ParameterString könnte man wie folgt definieren:
"MODE=Öffnungsart [SEPARATOR='sep'[,ÖFFNUNGSHILFE]"
Folgende Werte können hierbei angenommen werden:
Öffnungsart:
- RO (read only) nur lesen
- WA (write after) öffnet die Datenbank, falls vorhanden und hängt am Ende des Textes der Datenbank etwas an
- WO (write only) öffnet die Datenbank, falls vorhanden, und überschreibt alles
SEPARATOR: sep gibt den Separator in einfachen Anführungszeichen an z.B. ',' oder '.' oder '-' oder ein Tabulator '\t', welches der Standardwert ist (in diesem Fall kann der Ausdruck SEPARATOR='\t' weggelassen werden)
ÖFFNUNGSHILFE:
- wenn dieser Wert leergelassen und der Dateiname ohne Pfad ist, sucht das Addon die Datei im ArchiCAD-Verzeichnis
- DIALOG: Ist die Öffnungsmethode RO (read only), startet das Add-On einen Dialog um das Dokument auszuwählen. Andernfalls startet das Add-On einen Warndialog mit den Optionen 'Erstellen' und 'Suchen'. Suchen: sucht eine vorhandene Datei (Öffnungsdialog). Erstellen: erstellt eine neue Datei (Dialog speichern als).
- LIBRARY: wird der Ausdruck LIBRARY als Öffnungshilfe verwendet, muss sich die Datei in der geladenen Bibliothek befinden.
- FULLPATH: bei diesem Ausdruck ist nicht nur der Dateiname, sondern der komplette Dateipfad anzugeben (man achte auf die unterschiedlichen Pfadangaben bei Windows und Mac).
Bei nicht existierenden Zeichenfolgen, falschen Trennzeichen oder leerem Parameterstring wird intern folgende Standardsyntax benutzt:
SEPARATOR = '\t', MODE = RO
Bei WO und WA wird ohne Pfadangabe eine nicht vorhandene Datei immer direkt im ArchiCAD-Ordner erzeugt.
Zwischen MODE, SEPARATOR und ÖFFNUNGSHILFE ist immer ein Komma zu setzen.
Vor MODE und vor der schließenden Klammer ist jeweils ein doppeltes Anführungszeichen zu setzen.
ch=OPEN("DATA","wimo_preise_AC.txt","MODE=RO, SEPARATOR=':'")
In diesem Fall muss sich die Datei direkt im ArchiCAD®-Ordner befinden.
ch=OPEN("DATA","wimo_preise.tpxt","MODE=RO, SEPARATOR=':', DIALOG")
In diesem Fall kann die Datei überall liegen, man wird per Dialogfeld (Windows-Browser) dazu aufgefordert, den Datenpfad anzugeben.
ch=OPEN("DATA","wimo_preise.txt","MODE=RO, SEPARATOR=':', LIBRARY")
In diesem Fall sollte sich die Datei in der zu ladenden Bibliothek befinden; funktioniert nicht bei ArchiCAD® 7.0
ch=OPEN("DATA","D:2005GDLWimoObjektewimo.lib wimo_preise.txt", "MODE=RO, SEPARATOR=':', FULLPATH")
In diesem Fall ist der komplette Pfad (kann auch in einer Variablen abgelegt werden) der Datei angegeben;
sie braucht sich deshalb nicht in der geladen Bibliothek zu befinden oder per Dialogfeld gesucht zu werden.
Die Ablage funktioniert auch bei Weglassen des Ausdruckes FULLPATH
In diesem Fall muss sich die Datei direkt im ArchiCAD®-Ordner befinden.
ch=OPEN("DATA","wimo_preise.tpxt","MODE=RO, SEPARATOR=':', DIALOG")
In diesem Fall kann die Datei überall liegen, man wird per Dialogfeld (Windows-Browser) dazu aufgefordert, den Datenpfad anzugeben.
ch=OPEN("DATA","wimo_preise.txt","MODE=RO, SEPARATOR=':', LIBRARY")
In diesem Fall sollte sich die Datei in der zu ladenden Bibliothek befinden; funktioniert nicht bei ArchiCAD® 7.0
ch=OPEN("DATA","D:2005GDLWimoObjektewimo.lib wimo_preise.txt", "MODE=RO, SEPARATOR=':', FULLPATH")
In diesem Fall ist der komplette Pfad (kann auch in einer Variablen abgelegt werden) der Datei angegeben;
sie braucht sich deshalb nicht in der geladen Bibliothek zu befinden oder per Dialogfeld gesucht zu werden.
Die Ablage funktioniert auch bei Weglassen des Ausdruckes FULLPATH
ab 6.0