MoveFiles (acción)

La acción MoveFiles localiza los archivos existentes en el equipo del usuario y mueve o copia esos archivos en una nueva ubicación. La acción MoveFiles consulta la tabla MoveFile y mueve los archivos especificados allí si se especifica que el componente vinculado a las entradas se instale localmente o se ejecute desde el origen.

Restricciones de secuencia

La acción MoveFiles debe ir después de la acción InstallValidate y antes de cualquier acción InstallFiles.

Mensajes de ActionData

Campo Descripción de los datos de acción
[1] Identificador del archivo movido.
[6] Tamaño del archivo instalado en bytes.
[9] Identificador del directorio que contiene el archivo movido.

 

Observaciones

La tabla MoveFiles contiene una columna denominada "options" que especifica los archivos de origen que se van a mover o copiar. Un archivo de origen movido se elimina después de copiarlo en una nueva ubicación. Para obtener la sintaxis exacta, consulte la tabla MoveFile.

Las columnas SourceFolder y DestFolder de la tabla MoveFile son nombres de propiedad cuyos valores se espera que se resuelvan en rutas de acceso completas. Estas propiedades pueden ser cualquiera de las entradas de directorio de la tabla Directory, cualquier propiedad de carpeta predefinida (FavoritesFolder, por ejemplo) o una propiedad establecida por cualquier entrada de la tabla AppSearch. Estas propiedades pueden incluir una ruta de acceso completa que contiene el nombre de archivo a un archivo específico. Por ejemplo, la tabla AppSearch se puede crear para buscar un archivo determinado y establecer una propiedad en la ruta de acceso completa a ese archivo. En este ejemplo, la columna SourceName de la tabla MoveFile se puede dejar en blanco para indicar que el valor de la propiedad SourceFolder contiene una ruta de acceso de archivo completa. El punto y coma es el delimitador de lista para transformaciones, orígenes y revisiones, y no debe usarse en los nombres de archivo o las rutas de acceso.

La acción MoveFiles no actúa en las entradas de la tabla MoveFile en la que la propiedad SourceFolder o DestFolder no se evalúa como una ruta de acceso completa.

La acción MoveFiles intenta mover o copiar todos los archivos del directorio de origen que coinciden con el nombre especificado en la columna SourceName de la tabla MoveFiles. El nombre de la columna SourceName puede incluir los caracteres comodín * o ? que permiten mover o copiar un grupo de archivos. Por ejemplo, la columna SourceName puede contener una entrada de "*.xls", y la acción MoveFiles mueve o copia todos los libros de Microsoft Excel del directorio de origen al destino.

El nombre que se va a asignar al archivo de destino se puede especificar en la columna DestName de la tabla MoveFile. El nombre del archivo de destino conserva el nombre del archivo de origen si esta columna se deja en blanco.

Si se escribe un carácter comodín "*" en la columna SourceName de la tabla MoveFile y se especifica un nombre de archivo de destino en la columna DestName, todos los archivos movidos o copiados conservan los nombres en los orígenes.

Los archivos que la acción MoveFiles mueve o copia no se eliminan cuando se desinstala el producto.