Allgemeine Konventionen
In diesem Thema werden die XML-Hilfsfunktionen beschrieben.
Inhalt dieses Themas
Allgemeine XML-Richtlinien
Hilfsfunktionen
Allgemeine XML-Richtlinien
Bevor Sie die XML-Dateien ändern, sollten Sie sich mit den folgenden Richtlinien vertraut machen:
XML-Schema
Sie können das XML-Schema von User State Migration Tool (USMT) 5.0 (MigXML.xsd) zum Erstellen und Überprüfen von XML-Migrationsdateien verwenden.
Konflikte
Im Allgemeinen hat das spezifischste Muster Vorrang, wenn Konflikte innerhalb des XML-Schemas vorliegen. Weitere Informationen finden Sie unter Konflikte und Rangfolge.
Erforderliche Elemente
Die erforderlichen Elemente für eine XML-Migrationsdatei sind <migration>, <component>, <role> und <rules>.
Erforderliche untergeordnete Elemente
USMT schlägt nicht mit einem Fehler fehl, wenn Sie die erforderlichen untergeordneten Elemente nicht angeben. Sie müssen die erforderlichen untergeordneten Elemente allerdings angeben, damit das übergeordnete Element auf die Migration angewendet wird.
Die erforderlichen untergeordneten Elemente gelten nur für die erste Definition des Elements. Wenn diese Elemente definiert werden und anschließend anhand ihres Namens auf sie verwiesen wird, gelten die erforderlichen untergeordneten Elemente nicht. Falls Sie z. B.
<detects name="Example">in <namedElements> definieren und<detects name="Example"/>in <component> angeben, um auf dieses Element zu verweisen, muss die Definition in <namedElements> die erforderlichen untergeordneten Elemente enthalten, das <component>-Element aber nicht.
Dateinamen mit Klammern
Wenn Sie eine Datei migrieren, deren Dateiname eine eckige Klammer ([ oder ]) enthält, müssen Sie das Caretzeichen (^) direkt vor der eckigen Klammer einfügen, damit das Klammerzeichen gültig ist. Für eine Datei mit dem Namen „file].txt“ müssen Sie z. B.
<pattern type="File">c:\documents\mydocs [file^].txt]</pattern>anstelle von<pattern type="File">c:\documents\mydocs [file].txt]</pattern>angeben.Verwenden von Anführungszeichen
Wenn Sie den Code in Anführungszeichen setzen, können Sie doppelte ("") oder einfache ('') Anführungszeichen verwenden.
Hilfsfunktionen
Sie können die XML-Hilfsfunktionen in der XML-Elementbibliothek verwenden, um das Migrationsverhalten zu ändern. Beachten Sie vor der Verwendung dieser Funktionen die folgenden Punkte:
Alle Parameter sind Zeichenfolgen
Es dürfen keine Parameter leer bleiben
Wie bei Parametern mit einer Standardwertkonvention können Sie einen NULL-Parameter am Ende einer Liste weglassen. Die folgende Funktion:
SomeFunction("My String argument",NULL,NULL)entspricht z. B.:
SomeFunction("My String argument")Der in allen Hilfsfunktionen verwendete codierte Speicherort ist eine eindeutige Zeichenfolgendarstellung für den Namen eines Objekts.
Er besteht aus dem Knotenteil, nach dem optional das Blatt in eckigen Klammern steht. Dies vereinfacht die Unterscheidung zwischen Knoten und Blättern.
Die Datei "C:\Windows\Notepad.exe" geben Sie z. B. wie folgt an: c:\Windows[Notepad.exe]. Das Verzeichnis "C:\Windows\System32" wird ähnlich angegeben: c:\Windows\System32. Beachten Sie, dass hier die []-Zeichen fehlen.
Die Registrierung wird auf ähnliche Weise dargestellt. Der Standardwert eines Registrierungsschlüssels wird als leeres []-Konstrukt dargestellt. Der Standardwert für den Registrierungsschlüssel "HKLM\SOFTWARE\MyKey" ist z. B. HKLM\SOFTWARE\MyKey[].
Ein Speicherortmuster wird in ähnlicher Weise angegeben wie ein tatsächlicher Speicherort.
Der Unterschied besteht darin, dass sowohl für den Knotenteil als auch für den Blattteil Muster verwendet werden können. Ein Muster aus dem Knoten gilt aber nicht auch für das Blatt.
Dem Muster c:\Windows\* entsprechen z. B. das Verzeichnis "\Windows" und alle zugehörigen Unterverzeichnisse, aber keine der Dateien in diesen Verzeichnissen. Um auch die Dateien zuzuordnen, müssen Sie c:\Windows\*[*] angeben.