Udostępnij za pośrednictwem

Akcja InstallFiles

  • Artykuł

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.