4D Doc Center : DOCUMENT TO BLOB

4D v13.4

BLOB

DOCUMENT TO BLOB


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

Parámetro	Tipo	Descripción
documento	Cadena	Nombre del documento
BLOB	BLOB	Campo o variable de tipo BLOB a recibir el documento
		Contenido del documento
*	Operador	En Macintosh únicamente: Resource fork se carga si se pasa * de lo contrario se carga Data fork

Descripción

DOCUMENT TO BLOB carga el contenido de documento en blob. Debe pasar el nombre de un documento existente que no esté abierto, de lo contrario se generará un error. Para dejar que el usuario seleccione el documento a cargar en el BLOB, utilice el comando Open document y la variable sistema document (ver ejemplo).

Nota para los usuarios Macintosh: los documentos Macintosh pueden estar compuestos de dos elementos: Data fork y Resource fork (compartimento de datos y de recursos). Por defecto, el comando DOCUMENT TO BLOB carga el Data fork del documento. Para cargar el Resource fork del documento, pase el parámetro opcional *.

En Windows, se ignora el parámetro *. Note que el entorno 4D ofrece el equivalente del resource fork de Mac OS en Windows. Por ejemplo, el data fork de una base 4D se guarda en un archivo con la extensión .4DB; el resource fork se guarda en un archivo con el mismo nombre y con extensión .RSR. En Windows, si usted escribe una aplicación 4D con el data fork y el resource fork almacenados en los BLOBs, sólo necesita acceder al archivo correspondiente al fork con el cual quiere trabajar.

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 cargar un documento en un campo tipo BLOB. El método para este botón puede ser:

 $vhDocRef:=Open document("") ` Seleccionar un documento

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

    CLOSE DOCUMENT($vhDocRef) ` No necesitamos mantenerlo abierto

    DOCUMENT TO BLOB(Document;[SuTabla]SuCampoBLOB) ` Cargar el documento

    If(OK=0)

  ` Manejar error

    End if

 End if

Variables y conjuntos del sistema

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

Manejo de errores

Si trata de cargar (en un BLOB) un documento que no existe o que ya ha sido abierto por otro proceso o aplicación, se genera un error File Manager.
Un error de E/S puede ocurrir si el documento está bloqueado, si está ubicado en un volumen bloqueado, o si hay un problema en la lectura del documento.
Si no hay suficiente memoria para cargar el documento, se genera un error -108.

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