MoveFiles アクション

MoveFiles アクションを使うと、ユーザーのコンピューター上にある既存のファイルを見つけて、それらのファイルを新しい場所に移動またはコピーすることができます。 エントリにリンクされたコンポーネントをローカルでインストールするか、ソースから実行するように指定されている場合、MoveFiles アクションを使うと、MoveFile テーブルに対してクエリを実行し、そこで指定されたファイルを移動できます。

シーケンスの制限

MoveFiles アクションは、InstallValidate アクションの後、かつ InstallFiles アクションの前に配置する必要があります。

ActionData メッセージ

解説

MoveFiles テーブルには、移動またはコピー対象のソース ファイルを指定する "options" という列があります。 移動対象のソース ファイルは、新しい場所にコピーされた後、削除されます。 正確な構文については、「MoveFile テーブル」を参照してください。

MoveFile テーブルの SourceFolder 列と DestFolder 列は、値が完全修飾パスに解決されることが想定されているプロパティ名です。 これらのプロパティは、Directory テーブルのディレクトリ エントリ、任意の定義済みフォルダー プロパティ (たとえば FavoritesFolder)、または AppSearch テーブルのエントリによって設定されるプロパティのいずれかです。 これらのプロパティには、特定のファイルの完全なパス (ファイル名を含む) が含まれる場合があります。 たとえば、特定のファイルを検索し、プロパティをそのファイルの完全なパスに設定するように AppSearch テーブルを作成することができます。 この例では、MoveFile テーブルの SourceName 列を空白のままにして、SourceFolder プロパティの値にファイルの完全なパスが含まれていることを示すことができます。 セミコロンは、変換、ソース、パッチのリスト区切り記号です。ファイル名またはパスには使用しないでください。

SourceFolder または DestFolder プロパティが完全なパスに評価されない MoveFile テーブル内のエントリに対しては、MoveFiles アクションは機能しません。

MoveFiles アクションは、ソース ディレクトリ内の、MoveFiles テーブルの SourceName 列で指定した名前と一致するすべてのファイルの移動またはコピーを試みます。 SourceName 列の名前には、* または? の ワイルドカードを含めて、ファイルのグループを削除またはコピー対象にすることができます。 たとえば、SourceName 列に "*.xls" というエントリを含め、MoveFiles アクションを使って、ソース ディレクトリから宛先にすべての Microsoft Excel ブックを移動またはコピーすることができます。

宛先ファイルに指定する名前は、MoveFile テーブルの DestName 列で指定できます。 この列を空白のままにすると、宛先ファイル名はソース ファイル名と同じになります。

MoveFile テーブルの SourceName 列に "*" ワイルドカードが入力され、DestName 列で移動先ファイル名が指定されている場合、移動またはコピーされたすべてのファイルは移動元の名前のままになります。

MoveFiles アクションによって移動またはコピーされたファイルは、製品をアンインストールしても削除されません。