Contexto global

BeginPutFileToServer

Variante de sintaxis: Por ruta al archivo

Sintaxis:

BeginPutFileToServer(<CallbackDescriptionOnFinish>, <CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <RutaAlArchivo>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará si los archivos se colocan correctamente, y un procedimiento que se llamará si se produce un error.
Después de que el archivo se coloque correctamente en el almacenamiento, se llamará al procedimiento especificado en el parámetro <CallbackDescriptionOnFinish> con los siguientes parámetros:

• <PlacedFileDescription> – tipo: StoredFileDescription,Undefined. Descripción del archivo colocado en el almacenamiento temporal, o Undefined si se canceló la colocación del archivo en el almacenamiento.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Number. Porcentaje de la parte del archivo colocada.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo en el almacenamiento. Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Enlace al archivo listo para colocarse en un almacenamiento temporal.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: String.
Contiene una dirección de archivo en el almacenamiento temporal, por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena vacía, se creará un nuevo archivo.

Tipo: String.
Ruta a un archivo en el disco duro.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto del formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Inicia la colocación del archivo establecido por la ruta en el disco duro desde el sistema de archivos local en el almacenamiento temporal.
Se requiere la extensión de operación de archivo para trabajar en el cliente web.
El controlador <NotificationOfExecutionProgressDescription> se llama en el cliente web solo dos veces: cuando la cantidad de bytes colocados en el almacenamiento temporal es igual a 0 o al tamaño completo del archivo.

Variante de sintaxis: Por enlace a un archivo

Sintaxis:

BeginPutFileToServer(<CallbackDescriptionOnFinish>, <CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <FileRef>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará si los archivos se colocan correctamente, y un procedimiento que se llamará si se produce un error.

Si no se encuentra un archivo pasado en el disco duro, se produce una excepción.
Después de que se complete correctamente la colocación del archivo, se llama al procedimiento especificado en el parámetro
<CallbackDescriptionOnFinish> con los siguientes parámetros:

• <PlacedFileDescription> – tipo: StoredFileDescription,Undefined. Descripción del archivo colocado en el almacenamiento temporal, o Undefined si se canceló la colocación del archivo en el almacenamiento.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Number. Porcentaje de la parte del archivo colocada.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo en el almacenamiento. Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Enlace al archivo listo para colocarse en un almacenamiento temporal.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: String.
Contiene una dirección de archivo en el almacenamiento temporal, por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena vacía, se creará un nuevo archivo.

Tipo: FileRef.
Enlace al archivo.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto del formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Inicia la colocación del archivo establecido por referencia al archivo desde el sistema de archivos local en el almacenamiento temporal.
No se requiere la extensión de operación de archivo en el cliente web.

Variante de sintaxis: Usando el cuadro de diálogo de selección de archivos

Sintaxis:

BeginPutFileToServer(<CallbackDescriptionOnFinish>, <CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <DialogParameters>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará si los archivos se colocan correctamente, y un procedimiento que se llamará si se produce un error.
Después de que el archivo se coloque correctamente en el almacenamiento, se llamará al procedimiento especificado en el parámetro <CallbackDescriptionOnFinish> con los siguientes parámetros:

• <PlacedFileDescription> – tipo: StoredFileDescription,Undefined. Descripción del archivo colocado en el almacenamiento temporal, o Undefined si se canceló la colocación del archivo en el almacenamiento.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Number. Porcentaje de la parte del archivo colocada.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo en el almacenamiento. Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <FileToBePlaced> – tipo: FileRef Enlace al archivo listo para colocarse en un almacenamiento temporal.
• <CancelPuttingFiles> – tipo: Boolean. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en True en el módulo del procedimiento del controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). Valor predeterminado: False. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: String.
Contiene una dirección de archivo en el almacenamiento temporal, por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena vacía, se creará un nuevo archivo.

Tipo: PutFilesDialogParameters.
La estructura que contiene los parámetros del cuadro de diálogo que se mostrará al usuario.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto del formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Inicia la colocación de archivos y muestra el cuadro de diálogo para seleccionar un archivo que se colocará desde el sistema de archivos local en el almacenamiento temporal.
No se requiere la extensión de operación de archivo en el cliente web.

Descripción:

Inicia la colocación de archivos en el almacenamiento temporal.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Nota:

Después de llamar a este método, puede llamar a un método similar sin esperar a que se complete el anterior.

Disponible desde:

Disponible desde la versión 8.3.15.

---