Convenciones generales
En este tema se describen las funciones auxiliares XML.
En este tema
Instrucciones generales de XML
Funciones auxiliares
Instrucciones generales de XML
Antes de modificar los archivos .xml, familiarízate con las siguientes instrucciones:
Esquema XML
Puedes usar el esquema XML de la Herramienta de migración de estado de usuario (USMT) 5.0 (MigXML.xsd) para escribir y validar archivos .xml de migración.
Conflictos
En general, cuando hay conflictos en el esquema XML, tiene precedencia el patrón más específico. Para obtener más información, consulta Conflictos y prioridad.
Elementos obligatorios
Los elementos obligatorios de un archivo .xml de migración son <migration>, <component>, <role> y <rules>.
Elementos secundarios necesarios
USMT no muestra un error si no especificas los elementos secundarios obligatorios. Sin embargo, debes especificar los elementos secundarios obligatorios para que el elemento primario afecte a la migración.
Los elementos secundarios obligatorios solo se aplican a la primera definición del elemento. Si estos elementos se definen y después se hace referencia a ellos por su nombre, los elementos secundarios obligatorios no se aplicarán. Por ejemplo, si defines
<detects name="Example">en <namedElements> y especificas<detects name="Example"/>en <component> para hacer referencia a este elemento, la definición que está dentro de <namedElements> debe tener los elementos secundarios obligatorios, pero no es necesario que el elemento <component> contenga los elementos secundarios obligatorios.
Nombres de archivo con corchete
Si estás migrando un archivo cuyo nombre contiene un carácter de corchete ([ o ]), deberás insertar un carácter de acento circunflejo (^) directamente antes del corchete para que sea válido. Por ejemplo, si hay un archivo con el nombre File.txt, debes escribir
<pattern type="File">c:\documents\mydocs [file^].txt]</pattern>en lugar de<pattern type="File">c:\documents\mydocs [file].txt]</pattern>.Usar comillas
Cuando entrecomilles el código, puedes usar comillas dobles ("") o simples ('').
Funciones auxiliares
Puedes usar las funciones auxiliares XML de la Biblioteca de elementos XML para cambiar el comportamiento de la migración. Antes de usar estas funciones en un archivo .xml, ten en cuenta lo siguiente:
Todos los parámetros siguientes son cadenas
Puedes dejar los parámetros NULL en blanco
Al igual que con los parámetros con una convención de valor predeterminado, si tienes un parámetro NULL al final de la lista, puedes excluirlo. Por ejemplo, la siguiente función:
SomeFunction("My String argument",NULL,NULL)equivale a:
SomeFunction("My String argument")La ubicación codificada usada en todas las funciones auxiliares es una representación de cadena inequívoca del nombre de un objeto.
Consta de la parte del nodo, que puede ir seguida de la hoja entre corchetes. Esto marca una clara diferencia entre los nodos y las hojas.
Especifica, por ejemplo, el archivo C:\Windows\Notepad.exe: c:\Windows[Notepad.exe]. Asimismo, especifica el directorio C:\Windows\System32 de este modo: c:\Windows\System32. Ten en cuenta la ausencia de caracteres [].
El Registro se representa de una forma similar. El valor predeterminado de una clave del Registro se representa como una construcción [] vacía. Por ejemplo, el valor predeterminado de la clave del Registro HKLM\SOFTWARE\MyKey es HKLM\SOFTWARE\MyKey[].
La manera de especificar un patrón de ubicación y una ubicación en sí son parecidas.
La excepción es que tanto la parte del nodo como la de la hoja aceptan patrones. Sin embargo, un patrón del nodo no se extiende hasta la hoja.
Por ejemplo, el patrón c:\Windows\* coincidirá con el directorio \Windows y todos los subdirectorios, pero no con ninguno de los archivos de esos directorios. Para que los archivos también coincidan, debes especificar c:\Windows\*[*].