Compartilhar via

Convenções gerais

Este artigo descreve as funções auxiliares XML.

Diretrizes gerais de XML

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

  • Esquema XML.

    O esquema MigXML.xsdXML da User State Migration Tool (USMT), , pode ser utilizado para escrever e validar a migração .xml ficheiros.

  • Conflitos.

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

  • Elementos necessários.

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

  • Elementos subordinados necessários.

    • O USMT não falha com um erro se os elementos subordinados necessários não forem especificados. No entanto, os elementos subordinados necessários têm de ser especificados para que o elemento principal afete a migração.

    • Os elementos subordinados necessários aplicam-se apenas à primeira definição do elemento. Se estes elementos forem definidos e, em seguida, referidos com o respetivo nome, os elementos subordinados necessários não se aplicam. Por exemplo, se <detects name="Example"> estiver definido em <namedElements> e <detects name="Example"/> for especificado no <componente> para fazer referência a este elemento, a definição dentro <de namedElements tem de ter os elementos subordinados necessários> , mas o <elemento do componente> não precisa de ter os elementos subordinados necessários.

  • Nomes de ficheiros com parênteses retos.

    Se um ficheiro com um caráter de parêntese reto ([ ou ]) no nome do ficheiro estiver a ser migrado, tem de inserir um caráter de carateres (^). O caráter de carateres (^) tem de estar diretamente à frente do parêntese reto para que o caráter de parêntese reto seja válido. Por exemplo, se existir um ficheiro com o nome file].txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> tem de ser especificado em vez de <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • Utilizar aspas.

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

Funções auxiliares

As funções auxiliares XML na biblioteca de elementos XML podem ser utilizadas para alterar o comportamento da migração. Antes de utilizar estas funções num ficheiro .xml , tenha em atenção os seguintes itens:

  • Todos os parâmetros são cadeias.

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

    Tal como acontece com os parâmetros com uma convenção de valor predefinida, se existir um parâmetro NULL no final de uma lista, pode ficar de fora. Por exemplo, a seguinte função:

    SomeFunction("My String argument",NULL,NULL)

    é equivalente a:

    SomeFunction("My String argument")

  • A localização codificada utilizada em todas as funções auxiliares é uma representação de cadeia inequívoca para o nome de um objeto.

A localização codificada é composta pela parte do nó, opcionalmente seguida pela folha entre parênteses retos. Este formato faz uma distinção clara entre nós e folhas.

Por exemplo, especifique o ficheiro

C:\Windows\Notepad.exe

para

c:\Windows[Notepad.exe]

Da mesma forma, especifique o diretório

C:\Windows\System32

para

c:\Windows\System32

Repare na ausência dos carateres [] no segundo exemplo.

O registo é representado de forma semelhante. O valor predefinido de uma chave de registo é representado como uma construção vazia [ ]. Por exemplo, o valor predefinido da chave de HKLM\SOFTWARE\MyKey registo é HKLM\SOFTWARE\MyKey[].

  • Um padrão de localização é especificado de uma forma semelhante à forma como uma localização real é especificada.

    A exceção é que tanto o nó como a parte de folha aceitam padrões. No entanto, um padrão do nó não se estende até à 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 ficheiros nesses diretórios. Para corresponder também aos ficheiros, c:\Windows\*[*] tem de ser especificado.