Convenciones generales
En este artículo se describen las funciones auxiliares XML.
Instrucciones XML generales
Antes de modificar los archivos .xml , familiarícese con las siguientes directrices:
Esquema XML.
El esquema
MigXML.xsdXML de la Herramienta de migración de estado de usuario (USMT), , se puede usar para escribir y validar la migración .xml archivos.Conflictos.
En general, cuando hay conflictos dentro del esquema XML, el patrón más específico tiene prioridad. Para obtener más información, vea Conflictos y prioridad.
Elementos necesarios.
Los elementos necesarios para una migración .xml archivo son <la migración>, <el componente>, <el rol> y <las reglas>.
Elementos secundarios necesarios.
USMT no produce un error si no se especifican los elementos secundarios necesarios. Sin embargo, se deben especificar los elementos secundarios necesarios para que el elemento primario afecte a la migración.
Los elementos secundarios necesarios solo se aplican a la primera definición del elemento. Si estos elementos se definen y, a continuación, se hace referencia a ellos con su nombre, no se aplican los elementos secundarios necesarios. Por ejemplo, si
<detects name="Example">se define en <namedElements> y<detects name="Example"/>se especifica en <el componente> para hacer referencia a este elemento, la definición dentro <de namedElements debe tener los elementos secundarios> necesarios, pero el <elemento component> no necesita tener los elementos secundarios necesarios.
Nombres de archivo con corchetes.
Si se migra un archivo que tiene un carácter de corchete ([ o ]) en el nombre de archivo, se debe insertar un carácter de quilate (^). El carácter de quilate (^) debe estar directamente delante del corchete para que el carácter de corchete sea válido. Por ejemplo, si hay un archivo denominado file].txt,
<pattern type="File">c:\documents\mydocs [file^].txt]</pattern>debe especificarse en lugar de<pattern type="File">c:\documents\mydocs [file].txt]</pattern>.Uso de comillas.
Cuando el código está entre comillas, se pueden usar las comillas dobles ("") o las comillas simples (').
Funciones auxiliares
Las funciones auxiliares XML de la biblioteca de elementos XML se pueden usar para cambiar el comportamiento de la migración. Antes de usar estas funciones en un archivo .xml , tenga en cuenta los siguientes elementos:
Todos los parámetros son cadenas.
Los parámetros NULL se pueden dejar en blanco.
Al igual que con los parámetros con una convención de valor predeterminada, si hay un parámetro NULL al final de una lista, se puede dejar fuera. Por ejemplo, la siguiente función:
SomeFunction("My String argument",NULL,NULL)es equivalente a:
SomeFunction("My String argument")La ubicación codificada utilizada en todas las funciones auxiliares es una representación de cadena inequívoca para el nombre de un objeto.
La ubicación codificada se compone de la parte del nodo, seguida opcionalmente de la hoja entre corchetes. Este formato hace una distinción clara entre nodos y hojas.
Por ejemplo, especifique el archivo
C:\Windows\Notepad.exe
as
c:\Windows[Notepad.exe]
Del mismo modo, especifique el directorio
C:\Windows\System32
as
c:\Windows\System32
Observe la ausencia de los caracteres [] en el segundo ejemplo.
El registro se representa de 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 HKLM\SOFTWARE\MyKey Registro es HKLM\SOFTWARE\MyKey[].
Se especifica un patrón de ubicación de forma similar a cómo se especifica una ubicación real.
La excepción es que tanto el nodo como la parte hoja aceptan patrones. Sin embargo, un patrón del nodo no se extiende a la hoja.
Por ejemplo, el patrón c:\Windows\\* coincide con el
\Windowsdirectorio y todos los subdirectorios, pero no coincide con ninguno de los archivos de esos directorios. Para que coincidan también con los archivos, se debe especificar c:\Windows\*[*] .