BLOB TO DOCUMENT

Version 6.0

BLOB TO DOCUMENT (Dokument; Blob{; *})

Der Befehl BLOB TO DOCUMENT schreibt den gesamten Inhalt von Dokument mit den in Blob gespeicherten Daten neu. Sie müssen den Namen eines bestehenden Dokuments übergeben, das noch nicht geöffnet ist, da sonst ein Fehler generiert wird. Wollen Sie den Benutzer das Dokument auswählen lassen, verwenden Sie die Funktionen Open document oder Create document und die Prozessvariable Dokument, (siehe Beispiel).

Hinweis zu Macintosh: Macintosh Dokumente können aus zwei Forks bestehen: Data Fork und Ressource Fork. Der Befehl BLOB TO DOCUMENT schreibt standardmäßig das Data Fork des Dokuments neu. Wollen Sie dagegen das Ressource Fork des Dokuments neu schreiben, übergeben Sie den optionalen Parameter *. Dieser Parameter wird unter Windows ignoriert. Beachten Sie, dass die 4D Umgebung unter Windows die Entsprechung des MacOS Ressource Fork zur Verfügung stellt. Ist zum Beispiel das Data Fork einer 4D Datenbank in einer Datei mit der Endung .4DB gespeichert, wird das Ressource Fork in einer gleichnamigen Datei mit der Endung .RSR gespeichert. Erstellen Sie unter Windows eine 4D Anwendung mit Data Fork und Ressource Fork, die in BLOBs gespeichert sind, müssen Sie lediglich auf die Datei mit dem gewünschten Fork zugreifen.

Sie schreiben ein Informationsystem, mit dem Sie Dokumente schnell speichern bzw. wieder finden können. Im Eingabeformular legen Sie eine Schaltfläche an, mit der Sie ein Dokument mit den in ein BLOB Feld geladenen Daten sichern können. Die dazugehörige Methode lautet:

   $vhDocRef:=Create document("") ` Sichere Dokument Ihrer Wahl
   If (OK=1) ` Wurde ein Dokument erstellt
      CLOSE DOCUMENT($vhDocRef) ` Es muss nicht länger offen bleiben
      BLOB TO DOCUMENT (Document;[YourTable]YourBLOBField) 
                                 ` Schreibe Dokumentinhalt
      If (OK=0)
         ` Verwalte Fehler
      End if
   End if

Create document, DOCUMENT TO BLOB, Open document.

OK wird auf 1 gesetzt, wenn das Dokument korrekt geschrieben wurde, andernfalls auf 0. Es wird ein Fehler generiert.

• Versuchen Sie ein BLOB in ein Dokument zu schreiben, das nicht vorhanden ist oder bereits von einem anderen Prozess bzw. einer anderen Anwendung geöffnet wurde, erhalten Sie einen entsprechenden OS Systemfehler.

• Beim Schreiben können Eingabe-/Ausgabefehler auftreten.

• Unter Umständen reicht der Speicher nicht aus, um den neuen Inhalt des Dokuments zu schreiben.

Sie können die Fehler in allen Fällen mit der Unterbrechungsmethode ON ERR CALL ausfindig machen