Conventions générales
Cette rubrique décrit les fonctions d’assistance XML.
Dans cette rubrique
Instructions générales relatives à XML
Fonctions d’assistance
Instructions générales relatives à XML
Avant de modifier les fichiers XML, familiarisez-vous avec les instructions suivantes :
Schéma XML
Vous pouvez utiliser le schéma XML de l’Outil de migration utilisateur (USMT) 5.0, MigXML.xsd, pour écrire et valider des fichiers XML de migration.
Conflits
En général, lorsque des conflits apparaissent dans le schéma XML, le modèle le plus spécifique a priorité. Pour plus d’informations, voir Conflits et priorité.
Éléments requis
Les éléments requis pour un fichier XML de migration sont <migration>, <component>, <role> et <rules>.
Éléments enfants requis
L’USMT n’échoue pas et n’affiche pas de message d’erreur si vous ne spécifiez pas d’éléments enfants requis. En revanche, vous devez spécifier les éléments enfants requis pour que l’élément ait une incidence sur 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 et désignés ensuite par leur nom, les éléments enfants requis ne s’appliquent pas. Par exemple, si vous définissez
<detects name="Example">
dans <namedElements>, puis spécifiez<detects name="Example"/>
dans <component> pour désigner cet élément, la définition dans <namedElements> doit contenir les éléments enfants requis mais l’élément <component> n’a pas obligatoirement besoin de ces éléments.
Noms de fichiers avec des crochets
Si vous migrez un fichier dont le nom comporte un crochet ([ ou ]), vous devez insérer un signe ^ directement avant le crochet pour que ce dernier soit valide. Par exemple, si un fichier s’appelle File.txt, vous devez spécifier
<pattern type="File">c:\documents\mydocs [file^].txt]</pattern>
au lieu de<pattern type="File">c:\documents\mydocs [file].txt]</pattern>
.Utilisation de guillemets
Lorsque vous mettez du code entre guillemets, vous pouvez utiliser soit des guillemets doubles (""), soit des guillemets simples ('').
Fonctions d’assistance
Vous pouvez appliquer les fonctions d’assistance XML incluses dans la Bibliothèque d’éléments XML pour modifier le comportement de la migration Avant d’utiliser ces fonctions dans un fichier XML, notez les points suivants :
Tous les paramètres sont des chaînes.
Vous pouvez laisser les paramètres NULL vides.
Tout comme pour les paramètres avec une convention de valeur par défaut, si un paramètre NULL apparaît à la fin d’une liste, vous pouvez l’ignorer. Par exemple, dans la fonction suivante :
SomeFunction("My String argument",NULL,NULL)
est l’équivalent de :
SomeFunction("My String argument")
L’emplacement encodé utilisé dans toutes les fonctions d’assistance est une représentation non ambiguë sous forme de chaîne du nom d’un objet.
Il se compose de la partie nœud, suivie de façon facultative de la feuille mise entre crochets. La distinction entre nœuds et feuilles est très nette.
Par exemple, spécifiez le fichier C:\Windows\Notepad.exe : c:\Windows[Notepad.exe]. De même, spécifiez le répertoire C:\Windows\System32 comme ceci : c:\Windows\System32 ; remarquez l’absence de crochets ([ ]).
Le Registre est représenté de manière similaire. La valeur par défaut d’une clé de Registre est représentée sous la forme d’une composition vide ([ ]). Par exemple, la valeur par défaut de la clé de Registre HKLM\SOFTWARE\MyKey est HKLM\SOFTWARE\MyKey[].
Un modèle d’emplacement est spécifié de la même manière qu’un emplacement réel.
La seule différence est que la partie nœud et la partie feuille acceptent toutes deux des modèles. Toutefois, un modèle du nœud ne peut s’étendre jusqu’à la feuille.
Par exemple, le modèle c:\Windows\* correspond au répertoire \Windows et à tous ses sous-répertoires mais ne correspondra pas aux fichiers de ces répertoires. Pour qu’il corresponde aussi aux fichiers, vous devez spécifier c:\Windows\*[*].