Die File-Tabelle enthält eine vollständige Liste der Quelldateien mit ihren verschiedenen Attributen, sortiert nach einem eindeutigen, nicht lokalisierten Bezeichner. Dateien können auf den Quellmedien als einzelne Dateien gespeichert oder in CAB-Dateien komprimiert werden. Weitere Informationen finden Sie unter Verwenden von CAB-Dateien und komprimierten Quellen.
Die MoveFile-Tabelle umfasst die folgenden Spalten.
Ein nicht lokalisiertes Token, das die Datei eindeutig identifiziert. Bei diesem Feld wird Groß-/Kleinschreibung nicht unterschieden. Weisen Sie Bezeichner nicht verschiedenen Dateien zu, die sich nur durch ihre Groß- und Kleinschreibung unterscheiden.
Component_
Der externe Schlüssel in die erste Spalte der Component-Tabelle. Dieses Feld identifiziert die Komponente, die die Datei steuert.
FileName
Der für die Installation verwendete Dateiname. Der Name kann lokalisiert werden.
Da bei einigen Webservern gegebenenfalls die Groß-/Kleinschreibung beachtet wird, muss FileName genau mit der Groß-/Kleinschreibung der Quelldateien übereinstimmen, damit die Unterstützung von Internetdownloads gewährleistet ist.
FileSize
Dies ist die Größe der Datei in Byte. Dies muss eine nicht negative Zahl sein.
Version
Dieses Feld ist die Versionszeichenfolge für eine versionierte Datei. Dieses Feld ist für Dateien ohne Version leer. Die in dieses Feld eingegebene Dateiversion muss mit der Version der Datei identisch sein, die im Installationspaket enthalten ist.
Das Feld „Version“ kann auch so festgelegt werden, dass es den Primärschlüssel eines anderen Datensatzes in der File-Tabelle enthält. Die Datei, auf die verwiesen wird, bestimmt dann die Versionsverwaltungslogik für diese Datei. Weitere Informationen finden Sie unter Begleitdateien. Beachten Sie, dass diese Datei nicht als Begleitdatei angegeben werden darf, wenn sie der Schlüsselpfad für die Komponente ist.
Language
Eine Liste von dezimalen Sprach-IDs, die durch Kommas getrennt sind.
Schriftartdateien sollten nicht mit einer Sprach-ID erstellt werden, da Schriftarten keine eingebettete Sprach-ID-Ressource aufweisen. Daher sollte diese Spalte für Schriftartdateien NULL enthalten.
Attributes
Die ganze Zahl, die Bitflags enthält, die Dateiattribute darstellen.
Die folgende Tabelle zeigt die Definition des Bitfelds.
Konstant
Hexadezimal
Decimal
BESCHREIBUNG
msidbFileAttributesReadOnly
0x000001
1
Schreibgeschützt
msidbFileAttributesHidden
0x000002
2
Ausgeblendet
msidbFileAttributesSystem
0x000004
4
System
msidbFileAttributesVital
0x000200
512
Die Datei ist für den genauen Betrieb der Komponente entscheidend, zu der sie gehört. Wenn bei der Installation einer Datei mit dem Attribut msidbFileAttributesVital ein Fehler auftritt, wird die Installation gestoppt und ein Rollback ausgeführt. In diesem Fall zeigt das Installationsprogramm ein Dialogfeld ohne die Schaltfläche „Ignorieren“ an. Wenn dieses Attribut nicht festgelegt ist, und bei der Installation der Datei ein Fehler auftritt, zeigt der Installer ein Dialogfeld mit der Schaltfläche „Ignorieren“ an. In diesem Fall können Benutzer*innen den Fehler bei der Installation der Datei ignorieren und fortfahren.
msidbFileAttributesChecksum
0x000400
1024
Die Datei enthält eine gültige Prüfsumme. Eine Prüfsumme ist erforderlich, um eine beschädigte Datei zu reparieren.
msidbFileAttributesPatchAdded
0x001000
4096
Dieses Bit darf nur von einem Patch hinzugefügt werden, und nur dann, wenn die Datei vom Patch hinzugefügt wird.
msidbFileAttributesNoncompressed
0x002000
8192
Der Quelltyp der Datei ist unkomprimiert. Falls festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt ist, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie entweder nur msidbFileAttributesNoncompressed oder nur msidbFileAttributesCompressed fest.
msidbFileAttributesCompressed
0x004000
16384
Der Quelltyp der Datei ist komprimiert. Falls festgelegt, ignorieren Sie die Word Count Summary-Eigenschaft. Wenn weder msidbFileAttributesNoncompressed noch msidbFileAttributesCompressed festgelegt ist, wird der Komprimierungsstatus der Datei durch die Word Count Summary-Eigenschaft angegeben. Legen Sie entweder nur msidbFileAttributesNoncompressed oder nur msidbFileAttributesCompressed fest.
Wenn das msidbFileAttributesVital-Bit in der Spalte „Attributes“ festgelegt ist, und die Komponente, zu der die Datei gehört, für die Installation ausgewählt ist, muss das Installationsprogramm in der Lage sein, diese Datei zu installieren, damit die Installation erfolgreich abgeschlossen werden kann. Wenn das Installationsprogramm die Datei aus beliebigem Grund nicht installieren kann (z. B. wenn die Quelldatei nicht innerhalb des Quellimages gefunden werden kann), wird ein Fehlerdialogfeld mit der Option „Wiederholen“ oder „Abbrechen“ angezeigt. Für eine Datei, für die msidbFileAttributesVital nicht festgelegt ist, sind im Falle eines Installationsfehlers die Optionen „Abbrechen“, „Wiederholen“ und „Ignorieren“ (d. h. Benutzer*innen haben die Möglichkeit, die Installation erfolgreich abzuschließen, ohne diese Datei zu installieren) verfügbar.
Das msidbFileAttributesChecksum-Bit in der Spalte „Attributes“ sollte für jede ausführbare Datei in der Installation festgelegt werden, die über eine gültige Prüfsumme verfügt, die im PE-Dateiheader (Portable Executable) gespeichert ist. Nur die Dateien, für die dieses Bit festgelegt ist, werden jemals während einer Neuinstallation auf eine gültige Prüfsumme überprüft. Weitere Informationen finden Sie unter REINSTALLMODE.
Sequence
Sequenzposition dieser Datei in den Medienimages. Diese Reihenfolge muss der Reihenfolge der Dateien in der CAB-Datei entsprechen, wenn die Dateien komprimiert werden. Die ganzen Zahlen in diesem Feld müssen gleich 1 oder größer sein.
Die Sequenznummern in der Spalte „Sequence“ werden verwendet, um sowohl die Reihenfolge der Installation für Dateien als auch das Quellmedium anzugeben, auf dem sich die Datei befindet (in Verbindung mit der Media-Tabelle). Angenommen, eine Datei hat die Sequenznummer 92. Um den Quelldatenträger zu ermitteln, auf dem sich diese Datei befindet, suchen Sie in der Media-Tabelle nach dem Eintrag mit dem kleinsten Wert für „Letzte Sequenz“, der größer als 92 ist.
Obwohl komprimierten Dateien interne Sequenznummern innerhalb von CAB-Dateien zugewiesen werden, müssen diese absoluten Nummern nicht mit den Sequenznummern in der File-Tabelle übereinstimmen. Es ist jedoch wichtig, dass die Sequenz der Dateien in der File-Tabelle mit der Sequenz der Dateien in den CAB-Dateien identisch ist.
Für Dateien, die nicht komprimiert sind, müssen die Sequenznummern nicht eindeutig sein. Wenn z. B. alle Ihre Dateien nicht komprimiert sind, und sich alle auf einem Datenträger befinden, können Sie für alle Dateien die gleiche Sequenznummer festlegen.
Der maximale Grenzwert beträgt 32.767 Dateien. Informationen zum Erstellen eines Windows Installer-Pakets mit weiteren Dateien finden Sie unter Erstellen eines großen Pakets.
Die Tabelle wird zunächst aus der Dateiliste generiert, aber wenn die CAB-Dateikomprimierung verwendet wird, wird die Tabelle aus der Ausgabe der Komprimierungsengine neu generiert. Weitere Informationen finden Sie unter CAB-Dateien.
Um eine vorhandene Datei auf dem Computer der Benutzerin/des Benutzers während der Installation zu verschieben, verwenden Sie die MoveFiles-Aktion und die MoveFile-Tabelle. Um eine Datei an mehreren Speicherorten zu installieren, verwenden Sie die DuplicateFiles-Aktion und die DuplicateFile-Tabelle.
In der folgenden Tabelle sind die möglichen Kombinationen von Werten in der Spalte „Version“ und der Spalte „Language“ zusammengefasst. Weitere Informationen finden Sie unter Dateiversionsverwaltungsregeln.
Version
Sprache
BESCHREIBUNG
1.2.3.4
1033
Die Version und Sprache.
1.2.3.4
(NULL)
Die Version, aber keine Sprache.
1.2.3.4
0
Version und Sprache sind neutral.
Testdb
(NULL)
Die Begleitdatei, der keine Sprache zugeordnet ist.
Testdb
1033
Die Begleitdatei und Sprache.
(NULL)
1033
Keine Version, aber es ist eine Sprache zugeordnet (z. B. typelib, helpfile).
Erkunden Sie den Dateidatentyp, die Codeunit „Dateiverwaltung“, die Codeunit „Temp Blob“ und Streamfunktionen zur Bearbeitung von Dateien in Dynamics 365 Business Central.