Ação MoveFiles
A ação MoveFiles localiza os arquivos existentes no computador do usuário e move ou copia esses arquivos para um novo local. A ação MoveFiles consulta a tabela MoveFile e move os arquivos especificados para ela se o componente vinculado às entradas é especificado para ser instalado localmente ou está sendo executado por meio da origem.
Restrições de sequência
A ação MoveFiles precisa vir após a ação InstallValidate e antes da ação InstallFiles.
Mensagens de ActionData
Campo | Descrição dos dados de ação |
---|---|
[1] | Identificador do arquivo movido. |
[6] | Tamanho do arquivo instalado em bytes. |
[9] | Identificador do diretório que contém o arquivo movido. |
Comentários
A tabela MoveFiles contém uma coluna chamada "options" que especifica os arquivos de origem a serem movidos ou copiados. Um arquivo de origem movido é excluído depois que ele é copiado para um novo local. Para obter a sintaxe exata, confira a tabela MoveFile.
As colunas SourceFolder e DestFolder da tabela MoveFile são nomes de propriedades cujos valores devem ser resolvidos como caminhos totalmente qualificados. Essas propriedades podem ser uma das entradas de diretório na tabela Directory, qualquer propriedade de pasta predefinida (FavoritesFolder, por exemplo) ou uma propriedade definida por qualquer entrada na tabela AppSearch. Essas propriedades podem conter um caminho completo que contém o nome do arquivo para um arquivo específico. Por exemplo, a tabela AppSearch pode ser criada para pesquisar um arquivo específico e definir uma propriedade como o caminho completo para esse arquivo. Neste exemplo, a coluna SourceName da tabela MoveFile pode ser deixada em branco para indicar que o valor da propriedade SourceFolder contém um caminho de arquivo completo. O ponto e vírgula é o delimitador de lista para transformações, fontes e patches e não deve ser usado em nomes de arquivos ou caminhos.
A ação MoveFiles não funciona em entradas na tabela MoveFile na qual a propriedade SourceFolder ou DestFolder não é avaliada como um caminho completo.
A ação MoveFiles tenta mover ou copiar todos os arquivos no diretório de origem que correspondem ao nome fornecido na coluna SourceName da tabela MoveFiles. O nome na coluna SourceName pode incluir os curingas * ou ? que permitem que um grupo de arquivos seja movido ou copiado. Por exemplo, a coluna SourceName pode conter uma entrada "*.xls", e a ação MoveFiles move ou copia todas as pastas de trabalho do Microsoft Excel do diretório de origem para o destino.
O nome a ser dado ao arquivo de destino pode ser especificado na coluna DestName da tabela MoveFile. O nome do arquivo de destino manterá o nome do arquivo de origem se essa coluna for deixada em branco.
Se um curinga "*" for inserido na coluna SourceName da tabela MoveFile e um nome de arquivo de destino for especificado na coluna DestName, todos os arquivos movidos ou copiados manterão os nomes nas origens.
Os arquivos movidos ou copiados pela ação MoveFiles não são excluídos quando o produto é desinstalado.