Version 6.0
BK OPEN PROJECT (ProjektName)
| Parameter | Typ | Beschreibung | |
| ProjektName | Alpha | Name des zu öffnenden Projekts |
Beschreibung
Der Befehl BK OPEN PROJECT öffnet das Dokument mit Namen Projektname. Dieses Dokument muß von 4D Backup erstellt sein, entweder über die Oberfläche von 4D Backup oder über den Befehl BK SAVE PROJECT.
Liegt das Projekt im Ordner der Datenbank, genügt es, nur den Dokumentnamen anzugeben, z.B. unter Windows "TagSich.4BP", auf MacOS "Tagessicherung". Andernfalls geben Sie den vollständigen Pfad an: unter Windows "C:\Ordner\TagSich.4BP" oder auf MacOS "Festplatte:Ordner:Tagessicherung".
Über die Funktion BK Get error number können Sie die Fehler verwalten, die evtl. im zu öffnenden Projekt auftreten.
Rufen Sie diese Funktion nach dem Befehl BK OPEN PROJECT auf, sind folgende Werte möglich:
0: Kein Fehler beim Öffnen des Dokuments.
1101: Dieses Projekt gehört nicht zur geöffneten Datenbank. Es wurde mit einer anderen Datenbank erstellt, es kann nicht auf die derzeit geöffnete Datenbank angewendet werden.
1102: Das geöffnete Dokument ist kein Projekt. Das Dokument ist von einem anderen Typ, es konnte nicht als Projekt geöffnet werden.
Negative Fehlernummer: Fehler im Betriebssystem.
Hinweis: Die vollständige Liste der Fehlermeldungen finden Sie im Anhang A, Fehlermeldungen von 4D Backup.
Mit der 4D Backup Funktion BK Get state können Sie Fehler innerhalb der Volumes in der Projektdatei genauer verwalten. Rufen Sie diese Funktion nach dem Befehl BK OPEN PROJECT auf, sind folgende Werte möglich:
Status 1: Kein Volume ausgewählt. Das ausgewählte Volume existiert nicht mehr im Projekt.
Status 2: Dieses Volume kann nicht verwendet werden. Es hat beispielsweise nicht genügend Platz für die Sicherungskopie.
Status 3: Fertig zum Kopieren. Die Sicherung kann gestartet werden.
In den beiden ersten Fällen müssen Sie steuern, daß ein Volume mit ausreichend Speicherplatz gesucht wird bzw. den Benutzer informieren und die Sicherung über den Befehl BK END BACKUP abbrechen und z.B. das Standardfenster Volles Backup anzeigen.
Hinweis 4D Server: Das Projekt wird auf dem Server-Rechner, nicht auf dem Client-Rechner gelesen. Name und Zugriffspfad beziehen sich also auf ein Projekt auf einem Server-Rechner bzw. einem verteilten Volume, auf welches der Server-Rechner zugreifen kann.
Beispiel
Wir gehen aus von 7 verschiedenen Backup-Projekten für die sieben Wochentage. Jede Tagessicherung wird auf einem anderen Volume gesichert. Am Wochenende werden die Zusatzdateien gesichert.
Die Projekte heißen unter Windows "Tag1.4BP ... Tag7.4BP", auf MacOS "Tag1" ... "Tag7" und liegen im gleichen Ordner wie die Daten der Datenbank. Die Projekte werden über das Standardfenster zum Sichern mit 4D Backup erstellt. Zur Erinnerung: Für 4th Dimension ist Sonntag=1, Montag=2... Samstag=7).
C_INTEGER($Error)
If(BK Begin full backup #0)
ALERT("Backup kann nicht gestartet werden")
Else
BK OPEN PROJECT("Tag"+String(Day number(Current date)))
$Error:=BK Get error number
If($Error#0) `Tritt ein Fehler auf
ALERT("Fehler beim Öffnen des Projekts: "+BK Get error text($Error))
Else
If(BK Get state#3) `Ist der Status nicht "Fertig zum Kopieren"
ALERT("Projekt ist nicht mehr gültig. Es wurde kein Backup der
Datenbank erstellt.")
Else
If(Start copy=0) `Wenn der Kopiervorgang startet
Repeat
Until (BK Get state#4) `Warte Ende des Kopiervorgangs ab
End if
End if
End if
bk_END BACKUP
End if
Referenz
BK Get error number, BK Get error text, BK Get state, BK SAVE PROJECTS.