Akcja InstallFiles
Akcja InstallFiles kopiuje pliki określone w tabeli Plik z katalogu źródłowego do katalogu docelowego.
Ograniczenia sekwencji
Akcja InstallFiles musi pojawić się po akcji InstallValidate i przed wszystkimi akcjami zależnymi od pliku.
Komunikaty ActionData
Pole | Opis danych akcji |
---|---|
[1] | Identyfikator zainstalowanego pliku. |
[6] | Rozmiar zainstalowanego pliku w bajtach. |
[9] | Identyfikator katalogu zawierającego zainstalowany plik. |
Uwagi
Akcja InstallFiles działa na plikach określonych w tabeli plików . Każdy plik jest instalowany na podstawie stanu instalacji skojarzonego składnika pliku w tabeli składników . Tylko te pliki, których składniki są rozpoznawane jako msiInstallStatelocal stanu, kwalifikują się do kopiowania.
Akcja InstallFiles implementuje następujące kolumny tabeli Plik.
- Kolumna FileName określa docelową nazwę pliku.
- Kolumna Version (Wersja) określa wersję pliku.
- Kolumna Atrybuty określa bity flag atrybutu pliku i instalacji.
- Kolumna Plik określa unikatowy token pliku.
- Kolumna FileSize określa nieskompresowany rozmiar pliku w bajtach.
- Kolumna Language (Język) określa identyfikator języka pliku.
- Kolumna Sequence (Sekwencja) określa numer sekwencji na nośniku.
Akcja InstallFiles implementuje następujące kolumny tabeli Składnik.
- Kolumna Directory_ określa odwołanie do elementu tabeli Directory.
- Kolumna Składnik określa unikatową nazwę elementu składnika.
Określony plik jest kopiowany tylko wtedy, gdy spełniony jest jeden z następujących warunków:
- Plik nie jest obecnie zainstalowany na komputerze lokalnym.
- Plik znajduje się na komputerze lokalnym, ale ma niższy numer wersji niż plik w tabeli File.
- Plik znajduje się na komputerze lokalnym, ale nie ma skojarzonego numeru wersji.
Katalog źródłowy dla każdego pliku do skopiowania jest określany przez tryb sourceMode, który z kolei zależy od wartości w kolumnie Cabinet tabeli Media. Aby zapoznać się z pełnym omówieniem trybu źródłowego, zobacz tabelę Media.
Jeśli katalog źródłowy do skopiowania pliku znajduje się na nośniku wymiennym, takim jak dyskietka lub DYSK CD-ROM, akcja InstallFiles sprawdza, czy przed próbą skopiowania pliku zostanie wstawiony odpowiedni nośnik źródłowy. InstallFiles wyszukuje nośnik tego samego typu wymiennego z woluminem etykietą zgodną z wartością podaną w kolumnie VolumeLabel tabeli Media. Jeśli zostanie znaleziony pasujący zainstalowany wolumin, proces kopiowania plików będzie kontynuowany. Jeśli nie zostanie znalezione dopasowanie, zostanie wyświetlone okno dialogowe z prośbą o wstawienie odpowiedniego nośnika przez użytkownika. W takim przypadku okno dialogowe używa nazwy nośnika znajdującej się w kolumnie DiskPrompt tabeli Media w ramach monitu.
Należy zachować ostrożność, ponieważ akcja InstallFiles może usunąć oryginalny plik i nie zastąpić go. Dzieje się tak, gdy akcja InstallFiles napotyka błąd podczas zastępowania starszego pliku, a użytkownik wybierze zignorowanie błędu. Domyślnym zachowaniem instalatora jest usunięcie starego pliku przed upewnieniem się, że nowy plik zostanie skopiowany poprawnie.
Aby zapoznać się z regułami przechowywania wersji plików używanymi przez instalator, zobacz reguły przechowywania wersji plików.