Freigeben über

Allgemeine Konventionen

In diesem Artikel werden die XML-Hilfsfunktionen beschrieben.

Allgemeine XML-Richtlinien

Machen Sie sich vor dem Ändern der .xml-Dateien mit den folgenden Richtlinien vertraut:

  • XML-Schema.

    Das USMT-XML-Schema MigXML.xsd(User State Migration Tool) kann zum Schreiben und Überprüfen der Migration.xml Dateien verwendet werden.

  • Konflikte.

    Im Allgemeinen hat bei Konflikten innerhalb des XML-Schemas das spezifischste Muster Vorrang. Weitere Informationen finden Sie unter Konflikte und Rangfolge.

  • Erforderliche Elemente.

    Die erforderlichen Elemente für eine Migration .xml Datei sind <Migration>, <Komponente>, <Rolle> und <Regeln>.

  • Erforderliche untergeordnete Elemente.

    • USMT schlägt nicht mit einem Fehler fehl, wenn die erforderlichen untergeordneten Elemente nicht angegeben sind. Allerdings müssen die erforderlichen untergeordneten Elemente angegeben werden, damit sich das übergeordnete Element auf die Migration auswirkt.

    • Die erforderlichen untergeordneten Elemente gelten nur für die erste Definition des Elements. Wenn diese Elemente definiert und dann mit ihrem Namen darauf verwiesen wird, gelten die erforderlichen untergeordneten Elemente nicht. Wenn <detects name="Example"> beispielsweise in <namedElements> definiert ist und <detects name="Example"/> in <der Komponente> angegeben wird, um auf dieses Element zu verweisen, muss die Definition in <namedElements über die erforderlichen untergeordneten Elemente verfügen, aber das Komponentenelement muss nicht über die erforderlichen untergeordneten> Elemente verfügen.><

  • Dateinamen mit Klammern.

    Wenn eine Datei mit Klammern ([ oder ]) im Dateinamen migriert wird, muss ein Karatzeichen (^) eingefügt werden. Das Karatzeichen (^) muss direkt vor der Klammer stehen, damit das Klammerzeichen gültig ist. Wenn beispielsweise eine Datei namens file].txtvorhanden ist, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> muss anstelle von <pattern type="File">c:\documents\mydocs [file].txt]</pattern>angegeben werden.

  • Verwenden von Anführungszeichen.

    Wenn Code in Anführungszeichen eingeschlossen ist, können entweder die doppelten ("") oder die einfachen (') Anführungszeichen verwendet werden.

Hilfsfunktionen

Die XML-Hilfsfunktionen in der XML-Elementbibliothek können verwendet werden, um das Migrationsverhalten zu ändern. Bevor Sie diese Funktionen in einer .xml-Datei verwenden, beachten Sie Folgendes:

  • Alle Parameter sind Zeichenfolgen.

  • NULL-Parameter können leer gelassen werden.

    Wie bei Parametern mit einer Standardwertkonvention kann ein NULL-Parameter am Ende einer Liste weggelassen werden. Beispielsweise die folgende Funktion:

    SomeFunction("My String argument",NULL,NULL)

    entspricht:

    SomeFunction("My String argument")

  • Der codierte Speicherort, der in allen Hilfsfunktionen verwendet wird, ist eine eindeutige Zeichenfolgendarstellung für den Namen eines Objekts.

Die codierte Position besteht aus dem Knotenteil, optional gefolgt von dem Blatt, das in eckigen Klammern eingeschlossen ist. Dieses Format unterscheidet deutlich zwischen Knoten und Blättern.

Geben Sie beispielsweise die Datei an.

C:\Windows\Notepad.exe

as

c:\Windows[Notepad.exe]

Geben Sie auf ähnliche Weise das Verzeichnis an.

C:\Windows\System32

as

c:\Windows\System32

Beachten Sie das Fehlen der Zeichen [] im zweiten Beispiel.

Die Registrierung wird auf ähnliche Weise dargestellt. Der Standardwert eines Registrierungsschlüssels wird als leeres []- Konstrukt dargestellt. Der Standardwert für den HKLM\SOFTWARE\MyKey Registrierungsschlüssel lautet z. B. HKLM\SOFTWARE\MyKey[].

  • Ein Standortmuster wird in einer Weise angegeben, die der Angabe eines tatsächlichen Standorts ähnelt.

    Die Ausnahme besteht darin, dass sowohl der Knoten als auch der Blattteil Muster akzeptieren. Ein Muster vom Knoten erstreckt sich jedoch nicht auf das Blatt.

    Beispielsweise stimmt das Muster c:\Windows\\* mit dem \Windows Verzeichnis und allen Unterverzeichnissen überein, aber es stimmt mit keiner der Dateien in diesen Verzeichnissen überein. Damit auch die Dateien übereinstimmen, muss c:\Windows\*[*] angegeben werden.