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

  • Статья

В этом разделе рассматриваются вспомогательные функции XML.

В этом разделе

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

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

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

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

  • Схема XML

    Схема XML (MigXML.xsd) средства миграции пользовательской среды (USMT) 10.0 позволяет составлять и проверять XML-файлы переноса.

  • Конфликты

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

  • Необходимые элементы

    Для переноса XML-файла необходимы элементы <migration>, <component>, <role> и <rules>.

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

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

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

  • Имена файлов в скобках

    Если вы переносите файл, в имени которого присутствует символ скобки ([ или ]), непосредственно перед скобкой необходимо вставить символ (^), чтобы код был допустимым. Например, для файла 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 следует определить таким образом: c:\Windows[Notepad.exe]. Аналогичным образом укажите каталог C:\Windows\System32: c:\Windows\System32; обратите внимание на отсутствие символов [].

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

  • Шаблон расположения определяется почти так же, как фактическое расположение.

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

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

Связанные разделы

Справочник по XML для средства миграции пользовательской среды