4D Doc Center : BLOB TO DOCUMENT

4D v13.4

BLOB

BLOB TO DOCUMENT


BLOB TO DOCUMENT ( documento ; BLOB {; *} )

Parámetro	Tipo	Descripción
documento	Cadena	Nombre del documento
BLOB	BLOB	Nuevo contenido del documento
*	Operador	Macintosh únicamente: Resource fork es escrito si se pasa *; de lo contrario, Data fork es escrito

Descripción

BLOB TO DOCUMENT escribe los datos de documento utilizando los datos almacenados en blob. Puede pasar el nombre de un documento existente en documento. Si el documento no existe, el comando lo crea. Si pasa el nombre de un documento existente, asegúrese de que el documento no esté abierto, de lo contrario se generará un error. Si quiere permitir que el usuario elija el documento, utilice los comandos Open document o Create document y utilice la variable sistema documento (ver ejemplo).

Nota para usuarios Macintosh:

Los documentos Macintosh pueden estar compuestos de dos elementos: Data fork y Resource fork. Por defecto, el comando BLOB TO DOCUMENT reescribe el Data fork del documento. Para reescribir el Resource fork del documento, pase el parámetro opcional *. En Windows, se ignora el parámetro opcional *.
Los documentos generados por este comando no tienen un "tipo". Si desea establecer al documento un tipo, debe usar el comando SET DOCUMENT TYPE.

Ejemplo

Usted escribe un sistema de información que le permite guardar y buscar rápidamente documentos. En un formulario de entrada de datos, usted crea un botón que le permite guardar un documento que contiene datos cargados previamente en un campo BLOB. El método para este botón puede ser el siguiente:

 $vhDocRef:=Create document("") ` Guardar el documento de su elección

 If(OK=1) ` Si un documento ha sido creado

    CLOSE DOCUMENT($vhDocRef) ` No necesitamos mantenerlo abierto

    BLOB TO DOCUMENT(Document;[SuTabla]SuCampoBLOB) ` Escribir el contenido del documento

    If(OK=0)

  ` Gestionar error

    End if

 End if

Variables y conjuntos del sistema

La variable sistema OK toma el valor 1 si el documento está escrito correctamente, de lo contrario toma el valor 0 y se genera un error.

Manejo de errores

Si trata de reescribir un documento que no existe o que ha sido abierto por otro proceso o aplicación, se genera un error File Manager.
El espacio del disco puede ser insuficiente para escribir los nuevos contenidos del documento.
Los errores E/S pueden ocurrir mientras escribe el documento.

En todos los casos, puede interceptar el error utilizando un método de interrupción ON ERR CALL.