Convenções gerais

Este artigo descreve as funções auxiliares do XML.

Diretrizes gerais de XML

Antes de modificar os arquivos .xml , familiarize-se com as seguintes diretrizes:

  • esquema XML.

    O esquema XML da USMT (Ferramenta de Migração de Estado do Usuário), MigXML.xsd, pode ser usado para gravar e validar arquivos de.xml de migração.

  • Conflitos.

    Em geral, quando há conflitos no esquema XML, o padrão mais específico tem precedência. Para obter mais informações, consulte Conflitos e precedência.

  • Elementos necessários.

    Os elementos necessários para um arquivo de.xml de migração são <migração>, <componente>, <função> e <regras>.

  • Elementos filho necessários.

    • A USMT não falhará com um erro se os elementos filho necessários não forem especificados. No entanto, os elementos filho necessários devem ser especificados para que o elemento pai afete a migração.

    • Os elementos filho necessários se aplicam somente à primeira definição do elemento. Se esses elementos forem definidos e, em seguida, referidos usando seu nome, os elementos filho necessários não se aplicarão. Por exemplo, se <detects name="Example"> for definido em <namedElements> e <detects name="Example"/> for especificado em <component> para se referir a esse elemento, a definição dentro <de namedElements> deve ter os elementos filho necessários, mas o <elemento component> não precisa ter os elementos filho necessários.

  • Nomes de arquivo entre colchetes.

    Se um arquivo que tem um caractere de colchete ([ ou ]) no nome do arquivo estiver sendo migrado, um caractere de circunflexo (^) deverá ser inserido. O caractere de circunflexo (^) deve estar diretamente antes do colchete para que o caractere de colchete seja válido. Por exemplo, se houver um arquivo chamado arquivo].txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> deve ser especificado em vez de <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • Usando aspas.

    Quando o código está entre aspas, as aspas duplas ("") ou simples (') podem ser usadas.

Funções auxiliares

As funções auxiliares de XML na biblioteca de elementos XML podem ser usadas para alterar o comportamento de migração. Antes de usar essas funções em um arquivo .xml , observe os seguintes itens:

  • Todos os parâmetros são cadeias de caracteres.

  • Os parâmetros NULL podem ser deixados em branco.

    Assim como acontece com parâmetros com uma convenção de valor padrão, se houver um parâmetro NULL no final de uma lista, ele poderá ser deixado de fora. Por exemplo, a função a seguir:

    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 inequívoca da cadeia de caracteres para o nome de um objeto.

O local codificado é composto pela parte do nó, opcionalmente seguida pela folha entre colchetes. Esse formato faz uma distinção clara entre nós e folhas.

Por exemplo, especifique o arquivo

C:\Windows\Notepad.exe

para

c:\Windows[Notepad.exe]

Da mesma forma, especifique o diretório

C:\Windows\System32

para

c:\Windows\System32

Observe a ausência dos caracteres [] no segundo exemplo.

O Registro é representado de maneira semelhante. O valor padrão de uma chave do Registro é representado como uma construção [] vazia. Por exemplo, o valor padrão para a HKLM\SOFTWARE\MyKey chave do Registro é HKLM\SOFTWARE\MyKey[].

  • Um padrão de local é especificado de maneira semelhante a como um local real é especificado.

    A exceção é que tanto o nó quanto a parte folha aceitam padrões. No entanto, um padrão do nó não se estende até a folha.

    Por exemplo, o padrão c:\Windows\\* corresponde ao \Windows diretório e a todos os subdiretórios, mas não corresponde a nenhum dos arquivos nesses diretórios. Para corresponder aos arquivos também, c:\Windows\*[*] deve ser especificado.

  • Last updated on