Conventions générales

Cet article décrit les fonctions d’assistance XML.

Instructions xml générales

Avant de modifier les fichiers .xml , familiarisez-vous avec les instructions suivantes :

  • Schéma XML.

    Le schéma XML de l’outil de migration de l’état utilisateur (USMT), , MigXML.xsdpeut être utilisé pour écrire et valider la migration.xml fichiers.

  • Conflits.

    En général, en cas de conflits au sein du schéma XML, le modèle le plus spécifique est prioritaire. Pour plus d’informations, consultez Conflits et priorité.

  • Éléments obligatoires.

    Les éléments requis pour un fichier de.xml de migration sont <la migration>, <le composant>, <le rôle> et les <règles>.

  • Éléments enfants requis.

    • L’outil USMT n’échoue pas avec une erreur si les éléments enfants requis ne sont pas spécifiés. Toutefois, les éléments enfants requis doivent être spécifiés pour que l’élément parent affecte la migration.

    • Les éléments enfants requis s’appliquent uniquement à la première définition de l’élément. Si ces éléments sont définis puis référencés à l’aide de leur nom, les éléments enfants requis ne s’appliquent pas. Par exemple, si <detects name="Example"> est défini dans <namedElements> et <detects name="Example"/> est spécifié dans <component> pour faire référence à cet élément, la définition à l’intérieur <de namedElements> doit avoir les éléments enfants requis, mais l’élément <component> n’a pas besoin d’avoir les éléments enfants requis.

  • Noms de fichiers entre crochets.

    Si un fichier qui a un caractère entre crochets ([ ou ]) dans le nom de fichier est en cours de migration, un caractère carat (^) doit être inséré. Le caractère carat (^) doit se trouver directement avant le crochet pour que le caractère de crochet soit valide. Par exemple, s’il existe un fichier nommé file].txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> doit être spécifié au lieu de <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • À l’aide de guillemets.

    Lorsque le code est entouré de guillemets, les guillemets doubles («  ») ou simples (') peuvent être utilisés.

Fonctions d’assistance

Les fonctions d’assistance XML dans la bibliothèque d’éléments XML peuvent être utilisées pour modifier le comportement de migration. Avant d’utiliser ces fonctions dans un fichier .xml , notez les éléments suivants :

  • Tous les paramètres sont des chaînes.

  • Les paramètres NULL peuvent être laissés vides.

    Comme avec les paramètres avec une convention de valeur par défaut, s’il existe un paramètre NULL à la fin d’une liste, il peut être exclu. Par exemple, la fonction suivante :

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

    équivaut à :

    SomeFunction("My String argument")

  • L’emplacement encodé utilisé dans toutes les fonctions d’assistance est une représentation sous forme de chaîne non ambiguë pour le nom d’un objet.

L’emplacement encodé est composé de la partie de nœud, éventuellement suivie de la feuille entre crochets. Ce format fait une distinction claire entre les nœuds et les feuilles.

Par exemple, spécifiez le fichier

C:\Windows\Notepad.exe

as

c :\Windows[Notepad.exe]

De même, spécifiez le répertoire

C:\Windows\System32

as

c :\Windows\System32

Notez l’absence des caractères [] dans le deuxième exemple.

Le registre est représenté de la même façon. La valeur par défaut d’une clé de Registre est représentée sous la forme d’une construction [] vide. Par exemple, la valeur par défaut de la clé de HKLM\SOFTWARE\MyKey Registre est HKLM\SOFTWARE\MyKey[].

  • Un modèle d’emplacement est spécifié d’une manière similaire à la façon dont un emplacement réel est spécifié.

    L’exception est que le nœud et la partie feuille acceptent des modèles. Toutefois, un modèle du nœud ne s’étend pas à la feuille.

    Par exemple, le modèle c :\Windows\\* correspond au \Windows répertoire et à tous les sous-répertoires, mais il ne correspond à aucun des fichiers de ces répertoires. Pour correspondre également aux fichiers, c :\Windows\*[*] doit être spécifié.