Convenções gerais
Este tópico descreve as funções auxiliares de XML.
Neste tópico
Diretrizes gerais de XML
Funções auxiliares
Diretrizes gerais de XML
Antes de modificar os arquivos .xml, familiarize-se com estas diretrizes:
Esquema XML
Você pode usar o esquema XML da USMT (Ferramenta de Migração de Estado do Usuário) 5.0, MigXML.xsd, para gravar e validar arquivos .xml de migração.
Conflitos
Em geral, quando há conflitos dentro do esquema XML, o padrão mais específico tem prioridade. Para saber mais, veja Conflitos e precedência.
Elementos necessários
Os elementos necessários para um arquivo .xml de migração são <migration>, <component>, <role> e <rules>.
Elementos filho necessários
A USMT não falha com um erro se você não especifica os elementos filho necessários. No entanto, você deve especificar os elementos filho necessários para o elemento pai para afetar a migração.
Os elementos filho necessários aplicam-se somente à primeira definição do elemento. Se esses elementos são definidos e depois referenciados usando seu nome, os elementos filho necessários não se aplicam. Por exemplo, se você definir
<detects name="Example">em <namedElements> e especificar<detects name="Example"/>em <component> para se referir a esse elemento, a definição dentro de <namedElements> deverá ter os elementos filho necessários, mas o elemento <component> não precisará ter os elementos filho necessários.
Nomes de arquivo entre colchetes
Se você está migrando um arquivo que tem um caractere de colchete ([ ou ]) no nome do arquivo, deverá inserir um caractere de circunflexo (^) diretamente antes do caractere de colchete para validá-lo. Por exemplo, se existe um arquivo chamado File.txt, você deve especificar
<pattern type="File">c:\documents\mydocs [file^].txt]</pattern>em vez de<pattern type="File">c:\documents\mydocs [file].txt]</pattern>.Usando aspas
Ao colocar o código entre aspas, você pode usar aspas duplas ("") ou simples (").
Funções auxiliares
Você pode usar as funções auxiliares de XML na Biblioteca de elementos XML para mudar o comportamento de migração. Antes de usar essas funções em um arquivo .xml, observe o seguinte:
Todos os parâmetros são cadeias de caracteres
Você pode deixar parâmetros NULL em branco
Nos parâmetros com convenção de valor padrão, se existe um parâmetro NULL no final de uma lista, você pode removê-lo. Por exemplo, a função abaixo:
SomeFunction("My String argument",NULL,NULL)é equivalente a:
SomeFunction("My String argument")O local codificado usado em todas as funções auxiliares é uma representação de cadeia de caracteres inequívoca para o nome de um objeto.
É composto por parte do nó, seguido opcionalmente pela folha entre colchetes. Isso faz uma distinção clara entre nós e folhas.
Por exemplo, especifique o arquivo C:\Windows\Notepad.exe: c:\Windows[Notepad.exe]. Da mesma forma, especifique o diretório C:\Windows\System32 como: c:\Windows\System32; observe a ausência dos caracteres [].
O Registro é representado de forma semelhante. O valor padrão de uma chave do Registro é representado como uma construção [] vazia. Por exemplo, o valor padrão da chave do Registro HKLM\SOFTWARE\MyKey é HKLM\SOFTWARE\MyKey[].
Você especifica um padrão de localização de uma forma semelhante como especifica uma localização real
A exceção é que tanto a parte do nó quanto da folha aceita padrões. No entanto, um padrão do nó não se estende à folha.
Por exemplo, o padrão c:\Windows\* corresponde ao diretório \Windows e a todos os subdiretórios, mas não corresponde a nenhum arquivo nesses diretórios. Para corresponder também aos arquivos, você deve especificar c:\Windows\*[*].