Поделиться через

Общие соглашения

  • Статья
  • Применяется к:
    ✅ Windows 11, ✅ Windows 10

В этой статье описаны вспомогательные функции XML.

Общие рекомендации по XML

Перед изменением файлов .xml ознакомьтесь со следующими рекомендациями:

  • Схема XML.

    Схема MigXML.xsdXML средства миграции пользовательской среды (USMT) может использоваться для записи и проверки файлов миграции .xml .

  • Конфликтов.

    Как правило, при наличии конфликтов в схеме XML приоритет имеет наиболее конкретный шаблон. Дополнительные сведения см. в разделе Конфликты и приоритет.

  • Обязательные элементы.

    Обязательными элементами для .xmlфайла миграции являются< миграция>, <компонент>, <роль> и <правила>.

  • Обязательные дочерние элементы.

    • USMT не завершается ошибкой, если не указаны необходимые дочерние элементы. Однако для родительского элемента необходимо указать необходимые дочерние элементы, чтобы повлиять на миграцию.

    • Обязательные дочерние элементы применяются только к первому определению элемента. Если эти элементы определены, а затем ссылаются на них с помощью их имени, необходимые дочерние элементы не применяются. Например, если <detects name="Example"> задано в <namedElements> и <detects name="Example"/> указано в <компоненте> для ссылки на этот элемент, определение внутри <namedElements> должно содержать обязательные дочерние элементы, но <элемент компонента> не должен содержать необходимые дочерние элементы.

  • Имена файлов в квадратных скобках.

    Если файл с символом в скобках ([ или ]) в имени файла переносится, необходимо вставить символ карата (^). Символ в каратах (^) должен находиться непосредственно перед скобкой, чтобы символ скобки был допустимым. Например, если есть файл с именем file].txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> должен быть указан вместо <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • Использование кавычек.

    Если код заключен в кавычки, можно использовать двойные ("") или одиночные (') кавычки.

Вспомогательные функции

Вспомогательные функции XML в библиотеке XML-элементов можно использовать для изменения поведения миграции. Прежде чем использовать эти функции в файле.xml , обратите внимание на следующие элементы:

  • Все параметры являются строками.

  • Параметры NULL можно оставить пустыми.

    Как и в случае с параметрами с соглашением о значении по умолчанию, если в конце списка есть параметр NULL, его можно исключить. Например, следующая функция:

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

    эквивалентен:

    SomeFunction("My String argument")

  • Закодированное расположение, используемое во всех вспомогательных функциях, является однозначным строковым представлением для имени объекта.

Закодированное расположение состоит из части узла, за которой при необходимости следует конечный элемент, заключенный в квадратные скобки. В этом формате делается четкое различие между узлами и листьями.

Например, укажите файл

C:\Windows\Notepad.exe

as

c:\Windows[Notepad.exe]

Аналогичным образом укажите каталог

C:\Windows\System32

as

c:\Windows\System32

Обратите внимание на отсутствие символов [] во втором примере.

Реестр представлен аналогичным образом. Значение по умолчанию раздела реестра представлено в виде пустой конструкции [] . Например, значение по умолчанию для HKLM\SOFTWARE\MyKey раздела реестра — HKLM\SOFTWARE\MyKey[].

  • Шаблон расположения указывается таким образом, как указано фактическое расположение.

    Исключение заключается в том, что и узел, и конечная часть принимают шаблоны. Однако шаблон из узла не распространяется на конечный элемент.

    Например, шаблон c:\Windows\\* соответствует каталогу \Windows и всем подкаталогам, но не соответствует ни одному из файлов в этих каталогах. Чтобы также соответствовать файлам, необходимо указать c:\Windows\*[*] .