Справка 1С/Платформа 1С:Предприятие 8/DumpConfigToFiles

DumpConfigToFiles

•

DumpConfigToFiles

/DumpConfigToFiles <каталог выгрузки> -Extension <имя расширения> -format[-force]-getChanges <имя файла>-configDumpInfoOnly-Archive <имя файла>[-ignoreUnresolvedReferences]

— выгрузка конфигурации в XML-файлы. При выгрузке будет создан файл версий (ConfigDumpInfo.xml). Допускается использование следующих параметров:

<каталог выгрузки> — каталог, в который будет выгружена конфигурация.

-Extension <Имя расширения> — выгрузка расширения с указанным именем. Если расширение успешно обработано возвращает код возврата 0, в противном случае (если расширение с указанным именем не существует или в процессе работы произошли ошибки) — 1.

-AllExtensions — выгрузка только расширений (всех). Для каждого расширения будет создан каталог, имя которого совпадает с именем расширения. Возможно использование с параметром archive <имя файла>.

-Format — указывает формат выгрузки файлов. По умолчанию выгрузка производится в иерархическом формате:

Hierarchical — выгрузка выполняется в иерархическом формате. В указанном каталоге создается структура каталогов, соответствующая структуре объектов конфигурации.
Plain — выгрузка выполняется в линейном формате. Все файлы будут выгружены в один каталог.

ВНИМАНИЕ! Линейный формат выгрузки является устаревшим. Для выгрузки рекомендуется использовать иерархический формат.

-update — указывает, что выгрузка будет обновлена (будут выгружены только файлы, версии которых отличаются от ранее выгруженных).
Файл версий (ConfigDumpInfo.xml) будет получен из текущего каталога выгрузки. Если текущая версия формата выгрузки не совпадает с версией формата в файле версий или если файл версий не найден, будет сгенерирована ошибка. По завершении выгрузки файл версий обновляется.
Возможно совместное использование с параметрами:

-force — Если текущая версия формата выгрузки не совпадает с версией формата в файле версий, будет выполнена полная выгрузка.
-configDumpInfoForChanges — Если текущий каталог выгрузки перед началом работы не пустой, будет сгенерирована ошибка. Соответствие текущей версии формата выгрузки и версии формата выгрузки в файле версий не проверяется. При выгрузке генерируется новый файл версий. Файл, указанный в параметре -configDumpInfoForChanges не изменяется.

-force — полная выгрузка, если при попытке обновления выгрузки было обнаружено, что текущая версия формата выгрузки не совпадает с версией формата, записанной в файл ConfigDumpInfo.xml. Возможно совместное использование с параметрами -update и -archive <имя файла>. В остальных случаях игнорируется. Возможно использование с параметром archive <имя файла>.

-getChanges <имя файла> — в указанный файл будут выведены изменения текущей конфигурации относительно выгрузки, каталог которой указан перед данным параметром. Изменения вычисляются относительно файла версий в текущем каталоге выгрузки. Имя файла должно быть указано.
Примечание. Может использоваться совместно с параметром configDumpInfoForChanges - изменения будут вычислены относительно переданного файла версий. Если при использовании параметром configDumpInfoForChanges файл версии не найден, будет сгенерирована ошибка.

-configDumpInfoForChanges <имя файла версий> — указывает файл версий, который будет использован для сравнения изменений. Имя файла версий должно быть указано.
Примечание. Данная опция используется только совместно с параметрами -update и -getChanges.

-configDumpInfoOnly  — если указан, производится выгрузка только файла состояния конфигурации ConfigDumpInfo.xml. Данная используется совместно с параметром -format. В этом случае файл ConfigDumpInfo.xml генерируется для соответствующего формата. Если формат не указан, по умолчанию используется иерархический формат.
Возможно совместное использование с параметром archive <имя файла>.

-Server — многопоточная выгрузка на  сервере "1С:Предприятия". Возможно использование со следующими параметрами:

-JobsCount N - указывает количество фоновых заданий при выгрузке конфигурации в файлы. По умолчанию: 0 - количество определяется платформой автоматически, в зависимости от количества ядер процессора на сервере "1С:Предприятия".

Пример:

1cv8.exe DESIGNER /S "localhost/BaseName" /DumpConfigToFiles c:/xml -Server -JobsCount 5

-Archive <имя файла> — если указан (имя файла обязательно), то результатом выгрузки будет ZIP-архив, содержащий XML-файлы конфигурации. Может быть использован как при однопоточной, так и при многопоточной выгрузке (с использованием параметра -Server).  Параметр может быть использован в следующих режимах:

  • полная выгрузка (-force),

  • частичная выгрузка (-listFile <имя файла со списком выгружаемых объектов>),

  • выгрузка только файла текущего состояния конфигурации (-configDumpInfoOnly),

  • выгрузка только файла расширений (всех) (-AllExtensions),

    • Примеры:

    1cv8.exe DESIGNER /DisableStartupDialogs /F "e:\base\demo" /N Администратор /DumpConfigToFiles "d:\demo" -archive dumpinfo.zip -configDumpInfoOnly

    1cv8.exe DESIGNER /S "localhost/BaseName" /DumpConfigToFiles c:/xml -Server -Archive configfiles.zip

    -listFile <имя файла со списком выгружаемых объектов> — указывает файл со списком объектов метаданных и/или внешних свойств, которые будут выгружены независимо от того, были ли они изменены или нет. Имя файла должно быть указано.

    Объекты из списка будут выгружены со всеми внешними свойствами, за исключением подчиненных объектов, являющихся отдельными объектами разработки. Для выгрузки таких подчиненных объектов их следует явно указать в списке:

  • Configuration — если за данным алиасом не следует имя корневого объекта конфиуграции, то при выгрузке будет он будет указывать на полное имя корневого объекта конфигурации, т.е Configuration.Help эквивалентно Configuration.ИмяКонфигурации.Help.

  • Можно использовать как имена, содержащие "Соnfiguration", так и содержащие полное имя корневого объекта конфигурации, т.е. для выгрузки двух внешних свойств корневого объекта конфигурации, например Help(Справка) и Splash(Заставка), содержимое файла для их выгрузки в XML, может выглядеть так:

Configuration.Help
Configuration.ИмяКонфигурации.Splash

Если объект из списка имеет подчиненные объекты, не являющиеся отдельными объектами разработки, но имеющие внешние свойства, то внешние свойства таких объектов также будут выгружены. 
Примечание. Данный параметр может использоваться совместно с параметром -archive <имя файла>.

-ignoreUnresolvedReferences — в выгрузке конфигурации не выгружаются ссылки к недостижимым объектам (которые были удалены в одной из предыдущих версий конфигурации).
При выгрузке конфигурации c игнорированием ссылок на недостижимые объекты будет наблюдаться следующее поведение:

  • Недостижимые ссылки на команды в управляемых формах заменяются на ссылку по умолчанию.

  • Недостижимые ссылки на группы команд в управляемых формах не выгружаются.

  • Недостижимые пути к данным в формах не выгружаются.

  • Недостижимые ссылки на предопределенные элементы не выгружаются.

  • Недостижимые ссылки в связях параметров выбора объектов метаданных не выгружаются.

  • Недостижимые ссылки в связях по типу объектов метаданных не выгружаются.

  • Недостижимые ссылки на команды в командном интерфейсе подсистем не выгружаются.

  • Недостижимые ссылки на группы команд в командном интерфейсе подсистем заменяются на ПанельНавигацииОбычное.

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