MoveFiles-Aktion

Die MoveFiles-Aktion sucht vorhandene Dateien auf dem Computer des Benutzers oder der Benutzerin und verschiebt oder kopiert diese Dateien an einen neuen Speicherort. Die MoveFiles-Aktion fragt die Tabelle MoveFile ab und verschiebt die dort angegebenen Dateien, wenn die mit den Einträgen verknüpfte Komponente lokal installiert werden soll oder von der Quelle aus ausgeführt wird.

Sequenzeinschränkungen

Die MoveFiles-Aktion muss nach der InstallValidate-Aktion und vor der InstallFiles-Aktion erfolgen.

ActionData-Nachrichten

Feld	Beschreibung der Aktionsdaten
[1]	Bezeichner der verschobenen Datei.
[6]	Größe der installierten Datei in Byte.
[9]	Bezeichner des Verzeichnisses, in dem sich die verschobene Datei befindet.

 

Bemerkungen

Die Tabelle „MoveFiles“ enthält eine Spalte „options“, die die zu verschiebenden oder zu kopierenden Quelldateien angibt. Eine verschobene Quelldatei wird gelöscht, nachdem sie an einen neuen Speicherort kopiert wurde. Die genaue Syntax finden Sie in der Tabelle MoveFile.

Die Spalten „SourceFolder“ und „DestFolder“ der Tabelle „MoveFile“ sind Eigenschaftennamen, deren Werte in vollqualifizierte Pfade aufgelöst werden sollen. Bei diesen Eigenschaften kann es sich um einen Verzeichniseintrag in der Tabelle Directory, eine vordefinierte Ordnereigenschaft (z. B. FavoritesFolder) oder eine Eigenschaft handeln, die durch einen beliebigen Eintrag in der Tabelle AppSearch festgelegt wird. Diese Eigenschaften können einen vollständigen Pfad enthalten, der den Dateinamen zu einer bestimmten Datei enthält. Beispielsweise kann die Tabelle „AppSearch“ erstellt werden, um nach einer bestimmten Datei zu suchen und eine Eigenschaft auf den vollständigen Pfad zu dieser Datei festzulegen. In diesem Beispiel kann die Spalte „SourceName“ in der Tabelle „MoveFile“ leer bleiben, um anzugeben, dass der Wert in der SourceFolder-Eigenschaft einen vollständigen Dateipfad enthält. Das Semikolon ist das Listentrennzeichen für Transformationen, Quellen und Patches und sollte nicht in Dateinamen oder Pfaden verwendet werden.

Bei Einträgen in der Tabelle „MoveFile“, in denen eine der Eigenschaft „SourceFolder“ oder „DestFolder“ nicht in einen vollständigen Pfad ausgewertet werden können, wird die MoveFiles-Aktion nicht ausgeführt.

Die MoveFiles-Aktion versucht alle Dateien im Quellverzeichnis zu verschieben oder zu kopieren, die dem in der Spalte „SourceName“ der Tabelle „MoveFiles“ angegebenen Namen entsprechen. Der Name in der Spalte „SourceName“ kann die Platzhalter „*“ oder „?“ enthalten, über die eine Gruppe von Dateien verschoben oder kopiert werden kann. Wenn die Spalte „SourceName“ z. B. den Eintrag „*.xls“ enthält, verschiebt oder kopiert die MoveFiles-Aktion jede Microsoft Excel-Arbeitsmappe aus dem Quellverzeichnis an das Ziel.

Der Name der Zieldatei kann in der Spalte „DestName“ der Tabelle „MoveFile“ angegeben werden. Wenn diese Spalte leer ist, wird der Name der Quelldatei als Name der Zieldatei beibehalten.

Wenn der Platzhalter „*“ in die Spalte „SourceName“ der Tabelle MoveFile eingegeben wird und in der Spalte „DestName“ ein Zieldateiname angegeben ist, behalten alle verschobenen oder kopierten Dateien die Namen der Quellen bei.

Von der MoveFiles-Aktion verschobene oder kopierte Dateien werden beim Deinstallieren des Produkts nicht gelöscht.