Condividi tramite

Convenzioni generali

Questo articolo descrive le funzioni helper XML.

Linee guida XML generali

Prima di modificare i file.xml , acquisire familiarità con le linee guida seguenti:

  • XML Schema.

    L'XML Schema USMT (User State Migration Tool), , MigXML.xsdpuò essere usato per scrivere e convalidare la migrazione .xml file.

  • Conflitti.

    In generale, quando si verificano conflitti all'interno dello schema XML, il modello più specifico ha la precedenza. Per altre informazioni, vedere Conflitti e precedenza.

  • Elementi obbligatori.

    Gli elementi necessari per una migrazione .xml file sono <migrazione>, <componente>, <ruolo> e <regole>.

  • Elementi figlio obbligatori.

    • USMT non ha esito negativo con un errore se non vengono specificati gli elementi figlio necessari. È tuttavia necessario specificare gli elementi figlio necessari affinché l'elemento padre influisca sulla migrazione.

    • Gli elementi figlio obbligatori si applicano solo alla prima definizione dell'elemento. Se questi elementi sono definiti e quindi fanno riferimento all'uso del relativo nome, gli elementi figlio necessari non si applicano. Ad esempio, se <detects name="Example"> è definito in <namedElements> e <detects name="Example"/> viene specificato nel <componente> per fare riferimento a questo elemento, la definizione all'interno <di namedElements> deve avere gli elementi figlio necessari, ma l'elemento <componente> non deve avere gli elementi figlio necessari.

  • Nomi di file con parentesi quadre.

    Se viene eseguita la migrazione di un file con un carattere parentesi quadre ([ o ]) nel nome del file, è necessario inserire un carattere carato (^). Il carattere carato (^) deve essere direttamente prima della parentesi quadre affinché il carattere parentesi quadre sia valido. Ad esempio, se è presente un file denominato file].txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> è necessario specificare anziché <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • Uso delle virgolette.

    Quando il codice è racchiuso tra virgolette, è possibile usare le virgolette double ("") o singole (').

Funzioni helper

Le funzioni helper XML nella libreria di elementi XML possono essere usate per modificare il comportamento di migrazione. Prima di usare queste funzioni in un file .xml , prendere nota degli elementi seguenti:

  • Tutti i parametri sono stringhe.

  • I parametri NULL possono essere lasciati vuoti.

    Come per i parametri con una convenzione di valore predefinita, se è presente un parametro NULL alla fine di un elenco, può essere escluso. Ad esempio, la funzione seguente:

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

    equivale a:

    SomeFunction("My String argument")

  • Il percorso codificato usato in tutte le funzioni helper è una rappresentazione di stringa non ambigua per il nome di un oggetto.

La posizione codificata è composta dalla parte del nodo, facoltativamente seguita dalla foglia racchiusa tra parentesi quadre. Questo formato distingue chiaramente tra nodi e foglie.

Ad esempio, specificare il file

C:\Windows\Notepad.exe

as

c:\Windows[Notepad.exe]

Analogamente, specificare la directory

C:\Windows\System32

as

c:\Windows\System32

Si noti l'assenza dei caratteri [] nel secondo esempio.

Il Registro di sistema è rappresentato in modo simile. Il valore predefinito di una chiave del Registro di sistema è rappresentato come costrutto [] vuoto. Ad esempio, il valore predefinito per la chiave del HKLM\SOFTWARE\MyKey Registro di sistema è HKLM\SOFTWARE\MyKey[].

  • Un modello di posizione viene specificato in modo simile al modo in cui viene specificata una posizione effettiva.

    L'eccezione è che sia il nodo che la parte foglia accettano modelli. Tuttavia, un modello dal nodo non si estende alla foglia.

    Ad esempio, il modello c:\Windows\\* corrisponde alla \Windows directory e a tutte le sottodirectory, ma non corrisponde ad alcun file in tali directory. Per corrispondere anche ai file, è necessario specificare c:\Windows\*[*].