наверх
Главная -
- Статьи

Параметры командной строки запуска "1С:Предприятия"

12.10.2023



Параметры командной строки запуска «1С:Предприятия»


Общая информация об интерфейсе командной строки системы 1С:Предприятие

Программные продукты системы «1С:Предприятие» предоставляют возможность выполнять определенные действия с помощью интерфейса командной строки. Некоторые приложения предоставляют интерфейс командной строки как дополнительный инструмент к графическому интерфейсу, например, интерактивная программа запуска. Некоторые приложения управляются только с помощью интерфейса командной строки. Такими приложениями являются, например, не интерактивная программа запуска или сервер «1С:Предприятия».

В общем случае интерфейс командной строки «1С:Предприятие» выглядит следующим образом:

Приложение|URL [Режим] [Команда1 [Команда2 […]]]

Где:

  • Приложение ‑ это имя используемого приложения. Необходимость указания полного пути к запускаемому приложению, регистр используемых символов и прочие особенности зависят от того, в какой операционной системе или среде используется приложение. Для запуска веб-клиента в качестве имени приложения будет выступать URL информационной базы, опубликованной на веб-сервере.
  • Режим ‑ необязательный параметр запуска некоторых приложений.
  • Команда1, Команда 2, ... ‑ одна или несколько команд, которые должно выполнить приложение (включая уточняющие параметры команды). Команда ‑ это какое-либо определенное действие. Каждая команда, в общем случае, обладает обязательными и необязательными параметрами, а также некоторым необязательным значением. Возможность комбинации нескольких команд в одной командной строке зависит от запускаемого приложения, режима запуска (если есть) и самих команд. Возможна ситуация, когда некоторые команды являются взаимоисключающими, т. е. можно использовать только одну команду из определенного перечня.

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

  • Символ " " (пробел) ‑ таким символом разделяются все элементы интерфейса командной строки запуска.
  • Указание команд и параметров может выполняться несколькими разными способами:

    • 1-й способ:

      • Символ "/" (прямой слэш) ‑ таким символом начинается каждая команда. Исключение составляет веб-клиент, где команда не предваряется таким символом. Команды веб-клиента разделяются символом "&".
      • Символ "-" (тире) ‑ таким символом предваряется параметр команды.
      • По такой схеме указываются параметры, например, при запуске сервера «1С:Предприятия» (ragent) или в случае пакетного запуска конфигуратора (1cv8).

    • 2-й способ:

      • Команда указывается без указания каких-либо предваряющих символов. Параметр начинается с символа "--" (двойное тире) в случае указания полного имени параметра или "-" (тире) в случае указания сокращенного имени параметра.
      • По такой схеме указываются параметры, например, при использовании утилиты ring.

    • 3-й способ:

      • Команда предваряется символом "--" (двойное тире) в случае полного указания имени команды и символом "-" (тире) если указывается сокращенное имя команды.
      • По такой схеме указываются параметры, например, утилита cnvdbfl.

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

  • Символы "[" и "]" ‑ в такие символы заключаются необязательный текст. Например, указание /команда [-параметр] означает, что возможно указывать такую команду как таким образом: /команда, так и таким /команда -параметр. Причем в первом случае (без указания параметра), команда будет использовать некоторое значение по умолчанию для данного параметра.
  • Символ "|" ‑ таким символом разделяются элементы, которые не могут быть в данном месте одновременно. Например, описание /команда1|/команда2 означает, что в данном месте можно использовать либо Команда1 либо Команда2. Однако одновременно использовать эти команды не допускается.
  • Символы "<" и ">" ‑ в такие символы, как правило, заключается краткое описание параметра команды. В описании команды приводится указание на реальные значения параметра. Очевидно, что переносить эти символы в реальную командную строку не требуется. Также стоит отметить, что эти символы в большинстве командных интерпретаторов означают переадресацию стандартных потоков ввода/вывода, и прямой перенос этих символов в реальную командную строку приводит к радикальному изменению сути вводимой команды.
  • Также следует отметить, что значения могут присутствовать не только у команд, но и у параметров команд.

Если значение команды или параметра содержит пробелы, то такое значение необходимо заключать в кавычки. При этом символ «"» в тексте параметра следует записывать как «\"», а символ «\» в тексте значения параметра перед символом «"» следует записывать как «\\», например, значение параметра «ef \abc \\" " \» следует записать так: «ef \abc \\\\\" \" \\».

Если у Вас используется лицензионная программа 1С версии ПРОФ или КОРП, но закончилась подписка ИТС, то для получения доступа к дистрибутивам Вы можете оформить договор ИТС напрямую в нашей компании, даже если приобретали программу и раньше оформляли подписку в другом месте. Минимальный вариант подписки ИТС при непрерывном продлении на 1 месяц - 5232 руб., а на 3 месяца - 11309 руб. Если же после окончания предыдущего договора ИТС прошло более месяца, то возобновление будет стоить немного дороже: на 1 месяц - 6278 руб, а на 3 месяца 13569 руб. При оформлении договора ИТС через нашу компанию Вы получите доступ к дистрибутивам уже через несколько часов после оплаты.


Описание команд интерфейса командной строки запуска системы "1С:Предприятие".


ПараметрОписание
1. Выбор режима запуска

При запуске может использоваться один из режимов запуска, перечисленных ниже. Одновременное использование нескольких режимов не допускается.
ENTERPRISE
Запуск системы в режиме 1С:Предприятие

Формат: 1cv8 ENTERPRISE [<параметры запуска>]
Пример: "C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F<Путь к базе данных> /N<Имя пользователя> /P<Пароль>
DESIGNERЗапуск системы в режиме Конфигуратор

Формат: 1cv8 DESIGNER [<команды >]
Пример: "C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /F <Путь к базе данных> /N <Имя пользователя> /P <Пароль> /DeleteCfg -AllExtension
CREATEINFOBASEЗапуск системы в режиме создания информационной базы

Формат: 1cv8 CREATEINFOBASE <строка соединения> [/AddToList [<Имя ИБ>]] [/UseTemplate <имя файла шаблона>] [/Out <имя файла>] [/L<код языка>] [/VL<код локализации>] [/O<скорость соединения>] [/DumpResult <имя файла>]
2. Общие команды запуска
2.1. Параметры подключения
/F <Каталог информационной базы>Параметр задает путь к каталогу файловой базы данных (указывается каталог где хранится файл 1Cv8.1CD, имя файла указывать не нужно). Строку рекомендуется заключить в кавычки.

Пример: /F С:\Base1C\Accounting
/S <Адрес информационной базы>Параметр задает адрес клиент-серверной информационной базы, хранящейся на сервере «1С:Предприятия». Формируется как <Имя компьютера, работающего сервером приложений>\<Ссылочное имя информационной базы, известное в рамках сервера "1С:Предприятия">.

Пример: /S srv1c\Buh
/WS <URL информационной базы>Параметр задает URL-адрес информационной базы опубликованной на веб-сервере.

Пример: /WS https://1cfresh.com/a/ea/1234567
/IBName <Имя информационной базы>Параметр запуска информационной базы по ее имени в списке информационных баз. При необходимости имя должно быть взято в двойные кавычки. При этом если имя содержит двойные кавычки, то нужно заменить каждые двойные кавычки на две двойные кавычки. Если в списках баз будет найдено более чем одна база с указанным именем, то пользователю будет выдана ошибка.

Пример: /IBName "Бухгалтерия предприятия"
/IBConnectionStringПараметр задает строку соединения с информационной базой целиком в том виде, в котором ее возвращает функция СтрокаСоединенияИнформационнойБазы(). Части строки соединения могут быть переопределены ранее существовавшими параметрами. Для этого нужно, чтобы /IBConnectionString находился в командной строке раньше них. Передавая строку соединения в качестве параметра командной строки, нужно помнить о том, что строка соединения содержит кавычки. Поэтому требуется взять всю строку в кавычки, а содержащиеся внутри кавычки удвоить. 
/O<скорость соединения>Параметр определяет скорость соединения (используется в тонком клиенте). Команда используется для настройки элемента списка информационных баз. Парамметр <скорость соединения> может принимать следующие значения:

  • Normal ‑ обычная скорость соединения (значение по умолчанию);
  • Low ‑ низкая скорость соединения.

Пример: /OLow
/TComp [-None|-Deflate|-SDC]Устанавливает режим сжатия трафика между сервером и тонким клиентом. Для команды может быть указан один из следующих параметров:

  • -None ‑ сжатие отключено.
  • -Deflate ‑ используется стандартное (для протокола HTTP) сжатие трафика по алгоритму deflate.
  • -SDC ‑ используется собственный алгоритм сжатия (используется по умолчанию).

Пример: /TComp -None
/UsePrivilegedModeПараметр запуска клиентского приложения в привилегированном режиме. Разрешен аутентифицированному пользователю, имеющему административные права. Журнал регистрации фиксирует установку или отказ в возможности установки режима привилегированного сеанса.
/SLev<Уровень>Определяет уровень защищенности соединения клиента с сервером «1С:Предприятия». Для команды могут быть задано одно из следующих значений:

  • 0 ‑ незащищенное соединение;
  • 1 ‑ защищенное соединение только в процессе выполнения аутентификации;
  • 2 ‑ защищенное соединение в течение всего сеанса.

Если команда указана без своего значения, то это эквивалентно указанию команды со значением 0 ‑ /SLev0.
/Z "<Общий реквизит 1>,<Общий реквизит 2>,...,<Общий реквизит N>"Установка разделителей при запуске клиентского приложения.
2.2. Пареметры аутентификации
/N<имя>Параметр задает имя пользователя. Должно быть указано так же, как в списке пользователей информационной базы. Если в базе данных список пользователей не ведется, данный ключ игнорируется. Если такого пользователя нет в списке пользователей, будет выдано окно авторизации доступа. Если в имени пользователя есть пробел, то значение параметра необходимо взять в кавычки.

Пример: /N"Иванов Иван"
/P<пароль>Параметр задает пароль пользователя. Если ключ /N не указан или в базе не ведется список пользователей, данный ключ игнорируется. Если пароль пользователя указан неверно, будет выдано окно авторизации доступа. Если в пароле есть пробел, то значение параметра необходимо взять в кавычки.

Пример: /P"Parol 123"
/ModifyPassword <пароль>Команда "Изменить пароль", может использоваться только совместно с командами /N и /P и приводит к установке пользователю, указанному в команде /N, нового пароля, указанного в качестве параметра команды ModifyPassword. Если в команде /P указан корректный пароль, то пользователь аутентифицируется в информационной базе, затем выполняется смена пароля и затем пользователь продолжает работу в сеансе. Если в новом пароле есть пробел, то значение параметра необходимо взять в кавычки.

Пример: /N"Иванов Иван" /P"Old Parol" /ModifyPassword"New Parol"
/WA<режим>Параметр определяет режим использования аутентификации операционной системы при запуске «1С:Предприятие». Если команда /WA не указывается, то подразумевается, что используется команда командной строки /WA+.
Пареметр <режим> может принимать следующие значения:

  • "+" ‑ установка обязательного применения аутентификации операционной системы при старте «1С:Предприятие».
  • "–" ‑ запрет применения аутентификации операционной системы при старте «1С:Предприятия».

Пример: /WA-
/WSA<режим>Пареметр определяет режим использования аутентификации операционной системы на веб-сервере. Если параметр /WSA не указывается, то подразумевается, что используется параметр командной строки /WSA+.
Параметр <режим> может принимать следующие значения:

  • + ‑ принудительное выполнение аутентификации средствами операционной системы на веб-сервере (по умолчанию).
  • – ‑ запрет применения аутентификации средствами операционной системы на веб-сервере.

Пример: /WSA-
/WSN <имя>Параметр задает имя пользователя операционной системы, которое будет использовано системой для выполнения аутентификации на веб-сервере в случае указания параметра /WSA+. Пароль пользователя указывается в параметре /WSP. Если в имени пользователя есть пробел, то значение параметра необходимо взять в кавычки.

Пример: /WSN"Ivanov Ivan"
/WSP <пароль>Параметр задает пароль пользователя, имя которого указано в параметре /WSN, для аутентификации на веб-сервере. Если в новом пароле есть пробел, то значение параметра необходимо взять в кавычки.

Пример: /WSP"Web Parol"
/NoProxyЗапретить использование прокси (только для ws-соединения).

Пример: /NoProxy
/Proxy -PSrv <адрес прокси> -PPort <порт> [-PUser <имя пользователя прокси> [-PPwd <пароль>]]Использовать указанные настройки прокси, игнорируя умолчания (только для ws-соединения).
/OIDA<режим>Пареметр Вкл./Выкл. сквозной аутентификации OpenID пользователя между разными информационными базами и/или внешними ресурсами для тонкого и веб-клиентов. Если при запуске клиента параметр /OIDA не задан, или задан параметр /OIDA+, то производится попытка аутентификации через OpenID-провайдера, адрес которого задан в файле default.vrd публикации этой информационной базы.

Если OpenID-провайдер требует интерактивной аутентификации (происходит первое обращение или истекло время жизни признака аутентифицированности), клиент отображает диалог для ввода имени и пароля пользователя.

Аутентификация происходит по списку пользователей информационной базы OpenID-провайдера.

Аутентифицируемый пользователь информационной базы, использующих OpenID-аутентификацию, должен соответствовать по имени пользователю информационной базы OpenID-провайдера.

Пареметр <режим> может принимать следующие значения:

  • + ‑ использовать OpenID-аутентификацию (по умолчанию).
  • – ‑ не использовать OpenID-аутентификацию.

Пример: /OIDA-
/AuthoffКоманда выполняет операцию OpenID logout (завершение сеанса работы пользователя). Завершение сеанса работы выполняется вне зависимости от используемого в дальнейшем метода аутентификации.

Пример: /Authoff
/AccessTokenПараметр позволяет указать JWT-токен для выполнения аутентификации пользователя.
/SAOnRestartПараметр указывает на то, что при перезапуске клиентского приложения из данного сеанса будет обязательно запрошены имя пользователя и пароль. По умолчанию пароль не запрашивается. Не используется в тонком клиенте.

Пример: /SAOnRestart
/ResetSavedAuthПараметр сбрасывает имена всех предыдущих запомненных пользователей информационной базы, которые выполняли аутентификацию с этого компьютера, а также удаляет из хранилища сохраненный токен для повторного входа.

Пример: /ResetSavedAuth
/EmailAuth <email>Параметр позволяет выполнить аутентификацию через электронную почту. На указанный email будет отправлен код подтверждения и будет открыто окно для ввода этого кода.

Пример: /EmailAuth online@online-ufa.ru
2.3. Параметры режима запуска
/AppAutoCheckVersion<режим>Выполнять автоматический подбор нужной версии для каждой информационной базы. Подробнее см. здесь.
Параметр <режим> может принимать следующие значения:

  • "+" ‑ выполнять подбор версий при запуске (значение по умолчанию).
  • "–" ‑ не выполнять подбор версий при запуске.

По умолчанию подбор выполняется. Команда /AppAutoCheckVersion эквивалентна команде /AppAutoCheckVersion+.

Пример: /AppAutoCheckVersion-
/RunModeOrdinaryApplicationПараметр запуска толстого клиента в обычном режиме, несмотря на настройки конфигурации и пользователя, от имени которого будет выполняться запуск. Не используется в тонком клиенте.

Пример: /RunModeOrdinaryApplication
/RunModeManagedApplicationЗапуск толстого клиента в режиме управляемого приложения, при этом учитывается настройка клиента в списке информационных баз:

  • Выбирать автоматически ‑ запускается тонкий клиент;
  • Тонкий клиент ‑ запускается тонкий клиент;
  • Веб-клиент ‑ запускается веб-клиент;
  • Толстый клиент ‑ запускается толстый клиент в режиме управляемого приложения.

При этом при запуске клиента, отключается механизм автоматического подбора клиентского приложения.

Пример: /RunModeManagedApplication
/AppArch <разрядность>Параметр позволяет указать разрядность используемого клиентского приложения.
Параметр <разрядность> может принимать одно из следующих значений:

  • x86 ‑ использовать только 32-разрядные версии.
  • x86_prt ‑ использовать преимущественно 32-разрядные версии.
  • x86_64 ‑ использовать только 64-разрядные версии.
  • x86_64_prt ‑ использовать преимущественно 64-разрядные версии.

Пример: /AppArch x86_64_prt
/MainWindowMode <режим запуска>Параметр позволяет явным образом указать режим запуска основного окна клиентского приложения. Параметр <режим запуска> может принимать одно из следующих значений:

  • -Normal ‑ обычный режим запуска.
  • -Workplace ‑ режим рабочего места.
  • -EmbeddedWorkplace ‑ режим встроенного рабочего места (для встраивания веб-клиента в сторонний сайт).
  • -FullscreenWorkplace ‑ режим полноэкранного рабочего места.
  • -Kiosk ‑ режим киоск.

Пример: /MainWindowMode -FullscreenWorkplace
2.4. Работа с сертификатами
/HttpsCert [-windows] [-linux] [-macos] [-recent] [-auto] [-choose] [-file <path>] [-pwd <password>] [-none]Параметр указывает источник клиентского сертификата.
Параметры команды:

  • -windows ‑ указывает, что при соединении нужно использовать клиентский сертификат из системного хранилища сертификатов ОС Windows. Данный параметр игнорируется, если указан хотя бы один из следующих параметров команды: -file или -none.
  • -linux ‑ указывает, что при соединении необходимо использовать сертификат из специального каталога ОС Linux, в котором хранятся сертификаты. Подробнее см. здесь. Данный параметр игнорируется, если указан хотя бы один из следующих параметров команды: -file или -none.
  • -macos ‑ указывает, что при соединении нужно использовать клиентский сертификат из системного хранилища сертификатов ОС macOS. Данный параметр игнорируется, если указан хотя бы один из следующих параметров команды: -file или -none.
  • -recent ‑ выбирать или использовать ранее выбранный клиентский системный сертификат при работе в ОС Windows или macOS.

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

Данный способ выбора клиентского сертификата выбран по умолчанию для параметра команд –windows и -macos, если параметры -auto и -choose не указаны.

  • -auto ‑ использовать автоматически выбранный клиентский сертификат из установленных в системном хранилище сертификатов ОС Windows или macOS. Данный параметр игнорируется, если у команды отсутствует параметр –windows или –macos (соответственно).
  • -choose ‑ всегда выбирать используемый клиентский сертификат ОС Windows или macOS.

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

Данный параметр можно указать, если необходимо избежать автоматического использования ранее выбранного клиентского сертификата из системного хранилища сертификатов ОС Windows или macOS, и выбрать новый сертификат из установленных в системе сертификатов подходящих для данного соединения. Данный параметр игнорируется, если у команды отсутствует параметр –windows/-macos или установлен параметр -auto.

  • -file <path> ‑ указывает, что необходимо использовать клиентский сертификат и приватный ключ из указанного файла. Данный параметр игнорируется, если у команды установлен параметр -none.
  • -pwd <password> ‑ указывает пароль файла, содержащего клиентский сертификат и его приватный ключ. Если сервер требует предоставления клиентского сертификата и файл сертификата защищен паролем, то соединение возможно только при правильно указанном пароле. Данный параметр игнорируется, если у данной команды не указан параметр -file.
  • -none ‑ указывает, что клиентский сертификат не используется. Соединение возможно только с серверами, не требующими проверки клиентского сертификата.

Если ни один из параметров -windows, -linux, -macos, -file или -none не указан, то команда /HttpsCert игнорируется.
/HttpsCA [-windows] [-linux] [-macos] [-file <path>] [-pwd <password>] [-none] Указывает источник сертификатов удостоверяющих центров, используемых для проверки сертификата сервера.
Параметры команды:

  • -windows ‑ указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров из системного хранилища сертификатов ОС Windows. Данный параметр игнорируется, если установлен хотя бы один из параметров команды -file или -none.
  • -linux ‑ указывает, что для проверки сертификата сервера при соединении необходимо использовать сертификаты удостоверяющих центров из специального каталога ОС Linux, в котором хранятся сертификаты. Подробнее см. здесь. Данный параметр игнорируется, если указан хотя бы один из следующих параметров команды: -file или -none.
  • -macos ‑ указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров из системного хранилища сертификатов ОС macOS. Данный параметр игнорируется, если указан хотя бы один из следующих параметров команды: -file или -none.
  • -file <path> ‑ указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты удостоверяющих центров, загружаемые из указанного файла. Данный параметр игнорируется, если установлен параметр команды -none.
  • -pwd <password> ‑ пароль файла, содержащего корневые сертификаты. Если файл сертификата защищен паролем, то соединение возможно только при правильно указанном пароле. Данный параметр игнорируется, если у данной команды не указан параметр -file.
  • -none ‑ указывает, что корневые сертификаты не используются, и сертификат сервера не проверяется.

Если ни один из параметров -windows, -linux, -macos, -file или -none не установлен, то команда /HttpsCA игнорируется.
/HttpsForceSSLv3Параметр указывает на необходимость принудительного использования протокола SSL версии 3.0 тонким клиентом при работе через веб-сервер с помощью протокола HTTPS.

Запрещено одновременное использование параметров /HttpsForceSSLv3 и /HttpsForceTLS1_0. При одновременном указании поведение не определено.
/HttpsForceTLS1_0Параметр указывает на необходимость принудительного использования протокола TLS версии 1.0 системой «1С:Предприятие» при работе через веб-сервер с помощью протокола HTTPS.

Запрещено одновременное использование параметров /HttpsForceSSLv3 и /HttpsForceTLS1_0. При одновременном указании поведение не определено.
2.5. Параметры настройки интерфейса
/i85Запуск в режиме интерфейса Версия 8.5.
/Theme <тема>Параметр позволяет указать светлую или темную тему интерфейса, при запуске в режиме Версия 8.5. Может принимать следующие значения:

  • Dark ‑ темная тема интерфейса.
  • Light ‑ светлая тема интерфейса.
/iTaxiЗапуск в режиме интерфейса Такси.
/itdiЗапуск в режиме интерфейса с использованием закладок.
/TechnicalSpecialistModeПараметр включает команду меню "Функции для технического специалиста".
2.6. Параметры настройки локализации
/L<код языка>Параметр задает код языка интерфейса платформы.

Пример: /Lru
/VL<код локализации сеанса>Параметр задает код локализации сеанса, используемый при форматировании данных типа Число и Дата, а также в методах ЧислоПрописью() и ПредставлениеПериода().

Пример: /VLru_RU
2.7. Параметры настройки отладки
/debug [<режим>] [-attach]Означает, что данное клиентское приложение будет запущено в режиме отладки. Протокол, используемый для работы отладчика, определяет параметром <режим>:

  • -tcp ‑ для отладки используется протокол TCP/IP;
  • -http ‑ для отладки используется протокол HTTP.

Если в командной строке указан параметр -attach, то это означает, что отладчик будет автоматически подключать предметы отладки (клиентский и серверный) запускаемого приложения, которые будут зарегистрированы на сервере отладки. Параметр используется только для отладки по протоколу HTTP.
/debuggerURL <адрес отладчика>Данная команда указывает адрес отладчика (при отладке по протоколу TCP/IP) или адрес сервера отладки (при отладке по протоколу HTTP) при работе в режиме отладки. При указании сервера отладки необходимо указать не только имя компьютера, на котором работает сервер отладки, но и порт, по которому происходит взаимодействие с ним.
/DisplayPerformanceВключает отображение количества вызовов сервера и объем данных, отправляемых на сервер и принимаемых с сервера.
/EmulateServerCallDelay [-Call<задержка>] [-Send<задержка>] [-Recevie<задержка>]Данная команда имитирует работу клиентского приложения в условиях медленного соединения.
Допустимо использовать следующие параметры:

  • -Call<задержка> ‑ указывает величину задержки при вызове сервера в секундах. Если параметр не указан, то значение задержки принимается равной 1.45 секунды.
  • -Send<время> ‑ указывает величину задержки в секундах в расчете на каждые 1 Кбайт данных, отправляемых на сервер. Если параметр не указан, то значение задержки принимается равной 0.45 секунды.
  • -Recevie<задержка> ‑ указывает величину задержки в секундах в расчете на каждые 1 Кбайт данных, принятых с сервера. Если параметр не указан, то значение задержки принимается равной 0,15 секунды.

Максимальное значение временных задержек ‑ 9.99 секунды.
2.8. Параметры настройки тестирования
/TestManagerПараметр запуск толстого или тонкого клиента для управления клиентами тестирования с помощью специализированной объектной модели.
/TestClient [-TPort<Номер сетевого порта>] [-TestClientID<Идентификатор>] [-TURL=<АдресПубликации>]Параметр запуска клиентского приложения (тонкий клиент, толстый клиент, веб-клиент, мобильный клиент и мобильное приложение) как клиента тестирования.
Параметры команды:

  • -TPort<Номер сетевого порта> ‑ указывает номер сетевого порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538. Не используется при запуске в мобильном клиенте.
  • -TestClientID<Идентификатор> ‑ указывает уникальный идентификатор тестируемого клиентского приложения. Параметр используется для веб-клиента или мобильного клиента. Параметр используется в том случае, когда необходимо различить несколько различных клиентов тестирования, одновременно используемых через одно приложение менеджера тестирования. Значение по умолчанию для параметра отсутствует.
  • -TURL=<АдресПубликации> ‑ позволяет указать адрес публикации информационной базы для случая запуска клиента тестирования в приложении на мобильной платформе.
/UILogRecorder [–TPort<Номер сетевого порта>] [-File<Путь>]Параметр позволяет в клиентском приложении (тонкий клиент, толстый клиент, веб-клиент, мобильный клиент) выполнять запись журнала интерактивных действий пользователя. Журнал действий, в дальнейшем, может быть использован для формирования, на его основе, программы на встроенном языке «1С:Предприятие», которая позволит воспроизвести записанные действия. Может совмещаться с параметром /TestClient.
Параметры команды:

  • -TPort<Номер сетевого порта> ‑ указывает номер сетевого порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538. Не используется при запуске в мобильном клиенте.
  • -File<Путь> ‑ имя файла, в который будет сохраняться журнал действий пользователя после завершения записи, если к клиенту не подключён менеджер тестирования.
2.9. Параметры проверки работы клиентского приложения
/EnableCheckModalПараметр включает режим строгой проверки использования модальных методов.
/EnableCheckExtensionsAndAddInsSyncCallsПараметр включает режим строгой проверки использования синхронных вызовов расширений работы с файлами и криптографией и внешних компонент. Игнорируется при запуске толстого клиента.
/EnableCheckServerCallsПараметр включает режим проверки использования контекстных серверных вызовов формы в обработчиках событий, в которых такие вызовы запрещены. Если параметр указан, то при контекстном серверном вызове в обработчиках, в которых такие вызовы запрещены, в окно сообщений будет выведено сообщение. Это же сообщение будет доступно в диалоге Информация для технической поддержки.
/EnableCheckScriptCircularRefsПараметр включает поиск циклических ссылок при выполнении кода на встроенном языке.
2.10. Вспомогательные параметры
/C <строка текста>Передача параметра в прикладное решение.
/ClearCacheВыполняется очистка кеша клиент-серверных вызовов, в котором хранятся метаданные форм, модули и т. д., а также сохраненный индекс поиска по текстам модулей.
/AllowExecuteScheduledJobs <-Off/-Force>Управление запуском регламентных заданий. Регламентные задания начинают выполняться на первом запущенном по порядку клиенте, у которого не /AllowExecuteScheduledJobs –Off. После завершения сеанса этого клиента, выполнение переходит к какому-либо из других запущенных сеансов. Если запускается сеанс с /AllowExecuteScheduledJobs –Force, то регламентные задания начинают выполняться на нем, не зависимо от наличия других сеансов.
/UC <код доступа>Позволяет выполнить установку соединения с информационной базой, на которую установлена блокировка установки соединений. Если при установке блокировки задан непустой код доступа, то для установки соединения необходимо в параметре /UC указать этот код доступа.
/RunShortcut <имя файла>Параметр позволяет запустить систему «1С:Предприятие» со списком информационных баз, который помещен в указанный файл. В качестве файла может быть указан файл списка общих информационных баз (*.v8i), или файл ярлыка информационных баз (*.v8l).
/AppAutoInstallLastVersion<режим>Параметр управляет возможностью автоматической установки новых версий клиентского приложения.
Пареметр <режим> может принимать следующие значения:

  • + ‑ установка новых версий включена.
  • – ‑ установка новых версий выключена.
/Execute <имя файла внешней обработки>Предназначен для запуска внешней обработки, полный путь к которой указан в качестве значения команды, в режиме «1С:Предприятие» непосредственно после старта системы. При указании параметра /Execute параметр /URL игнорируется.
/URL <адрес>Параметр указывает необходимость перехода по ссылке. Поддерживаются ссылки формата e1c и http(s):

  • Если указана внешняя ссылка ‑ выполняется поиск запущенного клиентского приложения с той же строкой соединения, которая указана в параметре. В найденном клиентском приложении не должно быть открыто модальное или блокирующее окно. После этого выполняется попытка перехода по локальной ссылке из исходной навигационной ссылки и активизируется основное окно приложения. В случае неудачи клиентское приложение продолжает работу. Если исходная навигационная ссылка не содержит локальной ссылки (содержит только адрес информационной базы), то попытка перехода не выполняется, активируется основное окно найденного клиентского приложения.
  • Если подходящего клиентского приложения не найдено, строка соединения определяется из параметра командной строки /URL.
  • Если указана локальная ссылка ‑ клиентское приложение запускается в общем порядке. После запуска выполнится попытка перехода по переданной локальной ссылке.

Для ссылок формата http(s) всегда запускается (или находится активный) тонкий клиент.
2.11. Прочие параметры
/@ <файл с командой>Параметр позволяет указать командную строку запуска в файле, который будет указан значением команды (<файл с командой>). Команда /@ предназначена для обхода ограничения длины командной строки используемой операционной системы. В данном файле команда должна быть записана целиком (со всеми своими параметрами), в одну строку. Кодировка файла должна соответствовать кодировке командного интерпретатора, в котором выполняется запуск клиентского приложения.

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

  • Команда /@ должна быть первой или единственной командой командной строки запуска приложения.
  • Если команда /@ указана не первой ‑ поведение является неопределенным.
/Out <имя файла> [-NoTruncate]Установка файла для вывода служебных сообщений. Если задан параметр -NoTruncate (через пробел), файл не очищается (не используется в тонком клиенте).

Во время исполнения пакетных команд файл сообщений можно открыть для просмотра. В пакетном режиме запуска запись сообщений в файл не буферизуется (сообщения записываются сразу).

Файл формируется в кодировке UTF-8.
/DisableStartupMessagesПараметр отключает стартовые сообщения:

  • Конфигурация базы данных не соответствует сохраненной конфигурации. Продолжить?;
  • Возможностей Вашего компьютера недостаточно для редактирования справки по конфигурации. Для редактирования справки необходимо установить Microsoft Internet Explorer версии 7.0 или выше.;
  • Возможностей Вашего компьютера недостаточно для редактирования html-документов, в том числе разделов справки. Для редактирования html-документов необходимо установить Microsoft Internet Explorer версии 7.0 или выше. В данном запуске редактирование html-документов будет недоступно..
/DisableStartupDialogsПараметр отключает вызов стартового диалога и диалогов аутентификации. При этом:

Выдается ошибка в следующих случаях:

  • Если командной строки недостаточно для выбора информационной базы или определения режима запуска.
  • Если командной строки недостаточно для авторизации пользователя в информационной базе.
  • Если в командной строке ошибочная авторизация в хранилище конфигурации.
  • Выполняется попытка создания информационной базы (CREATEINFOBASE), но для кластера серверов задан администратор.
  • Если в командной строке отсутствует авторизация в хранилище конфигурации, конфигуратор запускается без связи с хранилищем.

Команда поддерживается конфигуратором, тонким и толстым клиентскими приложениями. При использовании данной команды в командной строке запуска клиентского приложения включается пакетный режим запуска клиентского приложения
/DisableSplashПараметр отключает отображение заставки при запуске «1С:Предприятия», если заставка была полностью заменена. Для того чтобы полностью заменить заставку, необходимо обращаться в фирму «1С».
/DisableUnrecoverableErrorMessageПараметр позволяет указать специальное поведение при возникновении невосстановимой ошибки (в том числе аварийного завершения):

  • Окно об ошибке показано не будет.
  • При аварийном завершении дамп сформируется в соответствии с настройками в файле logcfg.xml (в ОС Windows) или настройками операционной системы (в ОС Linux и macOS).
  • Отчет об ошибке будет отправлен, если настроена автоматическая отправка отчета об ошибке и размер отчета не превышает ограничение на отправку без вопроса о большом размере отчета (5 Мбайт).
  • Приложение будет завершено с кодом возврата, отличным от нуля.

Рекомендуется указывать эту команду, если нужно запустить клиентское приложение в окружении, где не будет пользователя, который отреагирует на сообщение о невосстановимой ошибке.
/DisableHomePageFormsПри открытии тонкого клиента запрещает открытие форм начальной страницы прикладного решения.
/DisableLocalSpeechToTextПри использовании файлового варианта информационной базы, указание данной команды при запуске клиентского приложения блокирует возможность локального распознавания речи в данном клиентском приложении.
/UseHwLicenses<режим>Определяет режим поиска аппаратного ключа защиты.
Параметр <режим> может принимать следующие значения:

  • + ‑ поиск ключа защиты выполняется.
  • – ‑ поиск ключа защиты не выполняется.
/DisplayUserNotificationListПараметр вызывает показ непрочитанных сообщений из системы взаимодействия и центра оповещений при старте клиентского приложения.
3. Команды пакетного режима запуска конфигуратора
Параметры, перечисленные в данном разделе (и его подразделах) не могут комбинироваться в рамках одной командной строки запуска, если об этом явно не сказано обратного. Для включения пакетного режима запуска в командной строке необходимо выбрать режим запуска Конфигуратора (DESIGNER) и затем указать необходимые для работы общие команды запуска, а также требуемую команду пакетного запуска. Так, команда выгрузки информационной базы может выглядеть следующим образом:

1cv8 DESIGNER /IBName "My db" /DumpIB c:\temp\dump.dt

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

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

В том случае, если команда командной строки поддерживает параметры –Extension и –AllExtensions, одновременное указание обоих параметров не поддерживается и поведение системы в таком случае не определено.

При работе с расширениями (параметры –Extension и –AllExtensions) при успешном завершении работы код возврата будет установлен в значение 0, в противном случае код возврата будет принимать значение 1.
3.1. Выгрузка/загрузка информационной базы
/DumpIB <имя файла>Параметр запускает выгрузку информационной базы в файл.
/RestoreIB <имя файла> [-JobsCount <Количество>]Выполнить загрузку информационной базы из файла. Допустимо использовать следующие параметры:

  • -JobsCount ‑ количество системных фоновых заданий, используемых для загрузки информационной базы. Значение по умолчанию ‑ 0. В этом случае используется столько фоновых заданий, сколько процессоров на компьютере, выполняющем загрузку информационной базы.

Ускорение процесса загрузки достигается в следующих случаях:

  • При расположении кластера серверов системы «1С:Предприятие» и сервера СУБД на одном компьютере.
  • Компьютер сервера СУБД и кластера серверов «1С:Предприятие» связан каналом связи с высокой пропускной способностью (1 Гбит и более).
3.2. Восстановление структуры информационной базы
/IBRestoreIntegrityПроисходит попытка восстановления структуры информационной базы. При обнаружении других параметров они будут игнорироваться.

Для того чтобы получить результат восстановления, следует указать параметр командной строки /Out. В файле, который указан в качестве значения параметра /Out, будет записана следующая информация:

  • Восстановление информационной базы не требуется. Это означает, что структура информационной базы не нарушена. Код возврата в этом случае равен 0.
  • Информационная база успешно восстановлена. Это означает, что структура информационной базы успешно восстановлена. Код возврата в этом случае равен 0.
  • Если в процессе попытки восстановления произошла любая ошибка ‑ текст ошибки будет помещен в файл и код возврата в этом случае равен 1.

Запуск конфигуратора с параметром /IBRestoreIntegrity рекомендуется, если предыдущее обновление конфигурации базы данных (в пакетном режиме или интерактивно) не выполнено до конца, например, из-за аварийного завершения работы конфигуратора или выключения компьютера.
3.3. Конфигурация и расширения
/DumpCfg <имя cf/cfe файла> [-Extension <Имя расширения>]Выполнить сохранение конфигурации или расширения конфигурации в файл. Сохранение конфигурации расширения будет выполняться при корректном указании параметра -Extension.
/LoadCfg <имя cf/cfe файла> [-Extension <Имя расширения>]Выполнить загрузку конфигурации или расширения конфигурации из файла. Загрузка конфигурации расширения будет выполняться при корректном указании параметра -Extension. Если в момент загрузки расширение отсутствует в информационной базе ‑ оно будет создано с указанным именем. Если расширение, указанное в параметре -Extension, подключено к хранилищу конфигурации ‑ его загрузка невозможна.

Пример: "C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /F<Путь к базе данных> /N<Пользователь> /P<Пароль> /LoadCfg <Путь\Имя файла.cfe> -Extenson <Наименование расширения>
/MergeCfg <имя cf‑ или cfe-файла> -Settings <имя файла настроек> [-EnableSupport | -DisableSupport] [-IncludeObjectsByUnresolvedRefs | -ClearUnresolvedRefs] [-Extension <Имя расширения>] [-force]Выполнить объединение текущей конфигурации или расширения с файлом (с использованием файла настроек) конфигурации или расширения.

Допустимо использовать следующие параметры:

  • <имя cf‑ или cfe-файла> ‑ имя файла с объединяемой конфигурацией (cf-файл) или расширением (cfe-файл).
  • -Settings <имя файла настроек> ‑ позволяет указать имя файла с настройками объединения конфигураций. Формат и описание файла настроек объединения см. здесь.
  • -EnableSupport ‑ поставить конфигурацию на поддержку, если есть возможность объединить с постановкой на поддержку. Правила поддержки в этом случае должны быть указаны в файле настроек.
  • -DisableSupport ‑ не выполнять постановку на поддержку, даже если есть такая возможность.
  • -IncludeObjectsByUnresolvedRefs ‑ если в настройках объединения есть объекты, не включенные в список объединяемых и отсутствующие в основной конфигурации, но на которые есть ссылки из объектов, включенных в список, то такие объекты также помечаются для объединения, и выполняется попытка продолжить объединение. Попытки выполняются, пока не останется объектов со ссылками на не включенные объекты, либо пока не выберется вся конфигурация. Аналогично кнопке Пометить все для объединения в окне с неразрешенными ссылками, только с повторением попыток (подробнее см. здесь).
  • -ClearUnresolvedRefs ‑ ссылки на объекты, которые не включены в список объединяемых объектов, будут очищены. Аналогично кнопке Продолжить в окне с неразрешенными ссылками (подробнее см. здесь).
  • -Extension <Имя расширения> ‑ имя расширения, с которым будет выполняться объединение.
  • -force ‑ проводить объединение в случае наличия:
    • предупреждений об удаляемых объектов, на которые есть ссылки в объектах, не участвующих в объединении (такие объекты будут исключены из объединения);
    • предупреждений о применении настроек.

Если не указан, то объединение будет прервано в вышеуказанных случаях.

Если одновременно указан какой-либо из параметров -EnableSupport или -DisableSupport и параметр -Extension, то объединение будет прервано с ошибкой. Если есть возможность поставить конфигурацию на поддержку, и не указан параметр -EnableSupport или -DisableSupport, то объединение будет прервано с ошибкой. Если возможности поставить конфигурацию на поддержку нет, но указан параметр -EnableSupport или -DisableSupport, то объединение также будет прервано с ошибкой.

Если есть возможность поставить конфигурацию на поддержку, и указан параметр -EnableSupport, но в файле настроек нет элемента SupportRules, то устанавливаются следующие правила поддержки:

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

Если будут обнаружены неразрешенные ссылки в объектах из объединяемой (второй) конфигурации, и не указаны параметры -IncludeObjectsByUnresolvedRefs или -ClearUnresolvedRefs, то объединение будет прервано, а для каждого объекта в файл вывода служебных сообщений будет выведен список свойств объектов, в которых есть неразрешенные ссылки и список не включенных объектов по этим ссылкам.

Предупреждения выводятся в файл для вывода служебных сообщений вне зависимости от параметра -force.
/CompareCfg –FirstConfigurationType <тип конфигурации> [-FirstName <имя конфигурации>] [-FirstFile <путь к файлу>] [-FirstVersion <номер версии>] –SecondConfigurationType <тип конфигурации> [-SecondName <имя конфигурации>] [-SecondFile <путь к файлу>] [-SecondVersion <номер версии>] [-MappingRule <правило>] [-Objects <имя файла>] -ReportType <тип отчета> [-IncludeChangedObjects] [-IncludeDeletedObjects] [-IncludeAddedObjects] -ReportFormat <тип формата> -ReportFile <имя файла>Выполнить сравнение двух конфигураций и сформировать файл с отчетом о сравнении.

Допустимо использовать следующие параметры:

  • –FirstConfigurationType <тип конфигурации> ‑ тип первой конфигурации для сравнения. Параметр может принимать следующие значения:
    • MainConfiguration ‑ основная конфигурация;
    • DBConfiguration ‑ конфигурация базы данных;
    • VendorConfiguration ‑ конфигурация поставщика;
    • ExtensionConfiguration ‑ расширение конфигурации;
    • ExtensionDBConfiguration ‑ расширение конфигурации из база данных;
    • ConfigurationRepository ‑ конфигурация из хранилища конфигурации;
    • ExtensionConfigurationRepository ‑ расширение конфигурации из хранилища конфигурации;
    • File ‑ файл конфигурации/расширения конфигурации.
  • -FirstName <дополнительный идентификатор> ‑ имя первой конфигурации. Значение параметра может принимать следующие значения (в зависимости от значения параметра /FirstConfigurationType):
    • VendorConfiguration ‑ имя конфигурации поставщика;
    • ExtensionConfiguration ‑ имя конфигурации поставщика;
    • ExtensionDBConfiguration ‑ имя конфигурации расширения (из базы данных).

      Для остальных значение параметра /FirstConfigurationType данный параметр не применим.

  • -FirstFile ‑ путь к файлу конфигурации (.cf) или расширения конфигурации (.cfe). Данный параметр имеет смысл только в том случае, если параметр /FirstConfigurationType имеет значение File.
  • -FirstVersion ‑ версия хранилища конфигурации. Данный параметр имеет смысл только в том случае, если параметр /FirstConfigurationType имеет значение ConfigurationRepository или ExtensionConfigurationRepository.
  • –SecondConfigurationType <тип конфигурации> ‑ тип второй конфигурации для сравнения. Значения параметра полностью эквивалентны значениям параметра /FirstConfigurationType.
  • -SecondName <дополнительный идентификатор> ‑ имя второй конфигурации. Полностью аналогично параметру /FirstName.
  • -SecondFile ‑ путь к файлу конфигурации (.cf) или расширения конфигурации (.cfe). Полностью аналогично параметру /FirstFile.
  • -SecondVersion ‑ версия хранилища конфигурации. Полностью аналогично параметру /FirstVersion.
  • -MappingRule <правило> ‑ правило установки соответствий объектов, для тех случаев, когда конфигурации не состоят в отношениях «родитель-потомок»:
    • ByObjectName ‑ по именам объектов. Используется по умолчанию.
    • ByObjectIDs ‑ по внутренним идентификаторам.
  • -Objects <имя файла> ‑ путь к файлу со списком объектов, которые будут участвовать в операции. Если файл указан ‑ в операции участвуют только указанные в файле объекты, в противном случае участвует вся конфигурация.
  • -IncludeChangedObjects ‑ включать в отчет измененные подчиненные объекты.
  • -IncludeDeletedObjects ‑ включать в отчет удаленные подчиненные объекты.
  • -IncludeAddedObjects ‑ включать в отчет добавленные подчиненные объекты.
  • –ReportType <тип отчета> ‑ тип отчета о сравнении:
    • Brief ‑ краткий отчет;
    • Full ‑ полный отчет.
  • -ReportFormat <тип формата> ‑ описывает формат файла отчета:
    • txt ‑ текстовый документ;
    • mxl ‑ табличный документ.
  • -ReportFile <имя файла> ‑ указывает имя файл, в который будет помещен отчет о сравнении.
/UpdateDBCfg [-Dynamic<Режим>] [-BackgroundStart] [-BackgroundCancel] [-BackgroundFinish [-Visible]] [-BackgroundSuspend] [-BackgroundResume] [-WarningsAsErrors] [-Server] [-v1|-v2] [-Extension <Имя расширения>] [-SessionTerminate <режим>]Выполнить обновление конфигурации базы данных. Перед выполнением реструктуризации будет выполнена проверка подписи мобильного клиента (см. здесь). Выводимые диагностические сообщения по умолчанию считаются предупреждениями (не блокируют обновление конфигурации базы данных).

Следует понимать, что механизм фонового обновления не связан с выбором механизма реструктуризации. Если указано выполнение фонового обновления, то выбор варианта механизма реструктуризации (-v1|-v2) будет проигнорировано.

Допустимо использовать следующих параметров:

  • -Dynamic<Режим> ‑ признак использования динамического обновления. Режим может принимать следующие значения:
    • – ‑ явно запрещает динамическое обновление.
    • + ‑ разрешает динамическое обновление. Вначале выполняется попытка выполнить обычное обновление, если попытка не удалась ‑ происходит попытка выполнить динамическое обновление. Динамическое обновление будет разрешено также без указания параметра –Dynamic+ или при использовании параметра -Dynamic без указания режима.
  • -BackgroundStart ‑ запускает фоновое обновление конфигурации базы данных и завершает работу. Если дополнительно указан параметр –Dynamic или –Dynamic+, то вначале будет выполнена попытка динамического обновления и если эта попытка завершилась неудачно, то будет запущено фоновое обновление.
  • -BackgroundCancel ‑ отменяет ранее запущенное фоновое обновление конфигурации базы данных.
  • -BackgroundFinish ‑ завершает фоновое обновление конфигурации базы данных (выполняет фазу принятия изменений): выполняется попытка наложить монопольную блокировку базы данных и выполнить финальную фазу. При указании флага –Visible выдается диалоговое окно с кнопками Отмена, Повторить, Завершить сеансы и повторить в случае невозможности выполнить завершение фонового обновления (перейти к фазе принятия изменений). Если флаг не указан ‑ выполнение завершается с ошибкой.
  • -BackgroundSuspend ‑ приостанавливает фоновое обновление конфигурации базы данных.
  • -BackgroundResume ‑ продолжает фоновое обновление конфигурации базы данных, приостановленное ранее.
  • -WarningsAsErrors ‑ все предупредительные сообщения будут трактоваться как ошибки.
  • -Server ‑ обновление будет выполняться на сервере (имеет смысл только в клиент-серверном варианте работы). Если параметр используется вместе с фоновым обновлением, то:
    • Фаза актуализации всегда выполняется на сервере.
    • Фаза обработки и фаза принятия изменений могут выполняться как на клиенте, так и на сервере.
    • Допускается запуск фонового обновления на стороне клиента, а завершение на стороне сервера (как и наоборот).
    • Не используется оптимизированный механизм реструктуризации (игнорируется команда -v2, если таковая указана).
  • -v1|-v2 ‑ определяет используемый механизм реструктуризации. Если не указана версия механизма реструктуризации (-v1 или -v2), то будет использоваться механизм реструктуризации той версии, которая указана в файле conf.cfg (на стороне клиентского приложения). В противном случае будет использована указанная версия механизма. Если указан оптимизированный механизм реструктуризации, но использование этого механизма конфликтует с другими параметрами ‑ будет использован обычный механизм реструктуризации.
  • -Extension <Имя расширения> ‑ будет выполнено обновление указанного расширения.
  • -SessionTerminate <режим> ‑ завершение активных сеансов в случае необходимости установки эксклюзивной блокировки информационной базы. <режим> может принимать следующие значения:
    • disable ‑ не использовать принудительное завершение сеансов. Значение по умолчанию.
    • force ‑ принудительно завершать сеансы.

Выбор используемого механизма реструктуризации происходит следующим образом:

  • Если в командной строке стоит явное указание на используемый механизм реструктуризации ‑ будет использован указанный механизм.
  • Если в командной строке отсутствует указание на используемый механизм реструктуризации ‑ будет использован механизм реструктуризации, заданный параметром UpdateDBCfg файла conf.cfg (на стороне клиентского приложения).
  • В любом случае команда –Server указывает, что реструктуризация будет выполняться на сервере. Эта команда не оказывает влияния на выбор используемого механизма реструктуризации.

Параметр /UpdateDBCfg допускается указывать после следующих параметров:

  • /LoadCfg;
  • /UpdateCfg;
  • /ConfigurationRepositoryUpdateCfg;
  • /LoadConfigFiles;
  • /LoadConfigFromFiles;
  • /MobileAppUpdatePublication;
  • /MobileAppWriteFile;
  • /MobileClientDigiSign;
  • /MobileClientWriteFile.
/DumpDBCfg <имя cf/cfe файла> [-Extension <Имя расширения>]Выполнить сохранение конфигурации базы данных или конфигурации расширения, сохраненного в базу данных, в файл. Сохранение конфигурации расширения будет выполняться при корректном задании параметра -Extension.
/DumpDBCfgList [-Extension <Имя расширения>] [-AllExtensions]Выводит имя основной конфигурации (если не указан не один параметр) или имя расширения(-ий). Допустимо использование следующих параметров:

  • -Extension ‑ выводит имя указанного расширения.
  • -AllExtensions ‑ выводит имена всех расширений.
/RollbackCfg [-Extension <Имя расширения>]Выполнить возврат к конфигурации базы данных.

В случае указания параметра -Extension будет выполнен возврат к конфигурации, сохраненной в базе данных, для указанного расширения.
/DeleteCfg [-Extension <Имя расширения>] [-AllExtensions]Выполняет удаление расширения с указанным именем. При указании параметра –AllExtensions будет выполнено удаление всех расширений. Использование команды без параметра не допускается.
/DumpConfigFiles <каталог выгрузки> [-Module] [-Template] [-Help] [-AllWritable] [–Picture] [–Right] [-Extension <Имя расширения>]Позволяет осуществлять выгрузку некоторых свойств объектов конфигурации (модулей, макетов, картинки, права доступа и справочной информации) в файлы. Допустимо указывать следующие каталоги и использовать следующие параметры:

  • <каталог выгрузки> ‑ каталог расположения файлов свойств;
  • -Module ‑ признак необходимости выгрузки модулей;
  • -Template ‑ признак необходимости выгрузки макетов;
  • -Help ‑ признак необходимости выгрузки справочной информации;
  • -AllWritable ‑ признак выгрузки свойств только доступных для записи объектов;
  • -Picture ‑ признак выгрузки общих картинок;
  • -Right ‑ признак выгрузки прав.
  • -Extension ‑ выгрузка будет выполнена для указанного расширения.
/LoadConfigFiles <каталог загрузки> [-Module] [-Template] [-Help] [-AllWritable] [–Picture] [–Right] [-Extension <Имя расширения>]Позволяет осуществлять загрузку некоторых свойств объектов конфигурации (модулей, макетов, картинки, права доступа и справочной информации) из файлов. Допустимо указывать следующие каталоги и использовать следующие параметры:

  • <каталог загрузки> ‑ каталог расположения файлов свойств;
  • -Module ‑ признак необходимости загрузки модулей;
  • -Template ‑ признак необходимости загрузки макетов;
  • -Help ‑ признак необходимости загрузки справочной информации;
  • -AllWritable ‑ признак загрузки свойств только доступных для записи объектов;
  • -Picture ‑ признак загрузки общих картинок;
  • -Right ‑ признак загрузки прав.
  • -Extension ‑ загрузка будет выполнена в указанное расширение. Если расширение подключено к хранилищу, то загружаемые объекты должны быть захвачены в хранилище.

Если команда пакетного режима запуска прошла успешно, возвращает код возврата 0, в противном случае ‑ 1 (101, если в данных имеются ошибки).
/DumpConfigToFiles <каталог выгрузки> [-Format <режим>] [-Extension <Имя расширения>] [-AllExtensions] [–update] [–force] [–getChanges <имя файла>] [–configDumpInfoForChanges <имя файла>] [-listFile <имя файла>] [-configDumpInfoOnly] [-Server [-JobsCount <количество>]] [-Archive <имя файла>] [-ignoreUnresolvedReferences]Выполнить выгрузку конфигурации в файлы. Допустимо указывать следующие параметры:

  • -Format ‑ определяет формат выгрузки конфигурации в файлы:
    • Plain ‑ плоский формат;
    • Hierarchical ‑ иерархический формат (подробнее см. здесь). Используется по умолчанию.
  • -Extension ‑ выполняется выгрузка указанного расширения.
  • -AllExtensions ‑ выгружаются все расширения, при этом основная конфигурация не выгружается. Каждое расширение выгружается в каталог со своим именем.
  • -update ‑ указывает, что необходимо выполнить обновление ранее совершенной выгрузки, т. е. будут выгружены только те объекты, версии которых отличаются от версий ранее выгруженных объектов.

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

  • -force ‑ если текущая версия формата выгрузки не совпадает с версией формата в файле версий, будет выполнена полная выгрузка.
  • -configDumpInfoForChanges ‑ если текущий каталог выгрузки перед началом работы не пустой, будет сгенерирована ошибка. Соответствие текущей версии формата выгрузки и версии формата выгрузки в файле версий не проверяется. При выгрузке генерируется новый файл версий. Файл, указанный в параметре -configDumpInfoForChanges не изменяется.
  • -force ‑ выполнить полную выгрузку в том случае, если при попытке обновления выгрузки было обнаружено, что текущая версия формата выгрузки не совпадает с версией формата, записанной в файл версий (ConfigDumpInfo.xml). Используется только совместно с параметром -update. В остальных случаях игнорируется.
  • -getChanges <имя файла> ‑ в указанном файле будет сформирован список изменений текущей конфигурации относительно выгрузки и, соответственно, файла версий, каталог которой указан параметром команды /DumpConfigToFiles. Для данного параметра имя файла является обязательным.

Может использоваться совместно с параметром –configDumpInfoForChanges, в этом случае изменения будут вычислены относительно файла версий (ConfigDumpInfo.xml), указанного в этом параметре. Если при использовании параметра -configDumpInfoForChanges файл версии не найден, будет сгенерирована ошибка.

  • -configDumpInfoForChanges <имя файла> ‑ указывает файл версий (ConfigDumpInfo.xml), который будет использован для сравнения изменений. Для данного параметра указание полного имени файла версий является обязательным.
    Данный параметр используется только совместно с параметрами -update и -getChanges.
  • -listFile <имя файла> ‑ указывает файл со списком объектов, которые будут выгружены независимо от того, были ли они изменены или нет. Для данного параметра имя файла является обязательным.

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

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

В файле, содержащем имена объектов для выгрузки, можно указать идентификатор Configuration, являющийся эквивалентом корня конфигурации. Если в файле присутствует идентификатор Configuration, за которым не следует имя корневого объекта конфигурации, то при выгрузке этот идентификатор будет эквивалентен полному имени корневого объекта конфигурации, т. е. запись вида Configuration.Help эквивалентна записи Configuration.ИмяКонфигурации.Help.

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

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

Данный параметр используется только отдельно от других параметров.

  • -configDumpInfoOnly ‑ указанием данного параметра приводит к тому, что при выгрузке формируется только файл версий (ConfigDumpInfo.xml). Если в командной строке будет указан параметр -format, то файл версии будет сформирован для указанного формата выгрузки. По умолчанию файл версий формируется для иерархического формата выгрузки.

Данный параметр может сочетаться только с параметром -format. Сочетание с другими параметрами не допустимо.

  • -Server ‑ указывает на необходимость выполнить выгрузку конфигурации в файлы на стороне сервера «1С:Предприятия». В этом случае выгрузка будет выполняться в многопоточном режиме (и будет выполняться быстрее). Для данной команды есть необязательный параметр:
    • -JobsCount <количество> ‑ позволяет указать, какое количество одновременно работающих фоновых заданий будет использоваться для выгрузки конфигурации в файлы на стороне сервера.

      Значение по умолчанию ‑ 0. В этом случае количество фоновых заданий определяется платформой автоматически, на основании количества ядер процессора на компьютере с кластером серверов «1С:Предприятия».
  • -Archive <имя файла> ‑ позволяет выполнить выгрузку конфигурации в файл zip-архива. Этот параметр может использоваться для полной выгрузки, частичной выгрузки, выгрузке только файла текущего состояния (указан параметр -configDumpInfoOnly), выгрузки всех расширений конфигурации (указан параметр –AllExtensions).
  • -ignoreUnresolvedReferences ‑ в выгрузке конфигурации не выгружаются ссылки к недостижимым объектам, т. е. к таким объектам, которые были удалены в одной из предыдущих версий конфигурации.

При выгрузке конфигурации c игнорированием ссылок на недостижимые объекты будет наблюдаться следующее поведение:

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

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

Результат сравнения исходной конфигурации и конфигурации, загруженной из XML-файлов, выгрузка которых выполнена с включенным признаком игнорирования ссылок на недостижимые объекты, может содержать изменения объектов конфигурации, в том числе без указания деталей изменений.
/LoadConfigFromFiles <каталог загрузки> [-Extension <Имя расширения>] [-AllExtensions] –files «<файлы>» –listFile <файлСписка> -Format <режим> [-updateConfigDumpInfo] [-NoCheck] [-Archive <имя ZIP-архива>]Выполнить загрузку конфигурации из файлов. Загрузка расширения в основную конфигурацию (и наоборот) не поддерживается. При полной загрузке файлов конфигурации, формат загрузки (линейный или иерархический) определяется автоматически. Для частичной загрузки автоматического определения формата не поддерживается, формат следует явно указать с помощью параметра –Format.

Допустимо указывать следующие параметры:

  • -Extension ‑ выполняется загрузка указанного расширения. Если расширения нет ‑ оно создается. Если расширение подключено к хранилищу, то полная загрузка для такого расширения не поддерживается. Возможна частичная загрузка, если загружаемые объекты захвачены в хранилище конфигурации расширения.
  • -AllExtensions ‑ выполняется загрузка расширений из файлов. Каждый подкаталог в указанном каталоге считается расширением. Параметр несовместим с параметрами –files или -listFile.
  • -files ‑ указывает, какие файлы должны быть загружены при частичной загрузке конфигурации из файлов. Каждый файл может быть указан как с полным путем, так и с путем, указанным относительно каталога загрузки. Список файлов должен быть указан в кавычках, файлы перечисляются через запятую. Параметр не совместим с параметром –AllExtensions.
  • -listFile ‑ описывает файл, который содержит список загружаемых файлов. Файлы в списке перечисляются по одному имени файла на строку, каждое имя может быть как полным (с указанием полного пути к файлу), так и с указанием пути относительно каталога загрузки. Строки должны разделяться переводом строки. Перевод строки поддерживается как в варианте Windows, так и в варианте Linux. Файл ожидается в кодировке UTF-8. Пустые строки не поддерживаются. Строка может быть пропущена, если начинается с REM. Параметр не совместим с параметром –AllExtensions.
  • -Format ‑ определяет формат выгрузки конфигурации в файлы:
    • Plain ‑ плоский формат;
    • Hierarchical ‑ иерархический формат (подробнее см. здесь). Используется по умолчанию.
      Параметр используется только в сочетании с параметрами -files или -listFile.
  • -updateConfigDumpInfo ‑ указывает, что в конце загрузки в каталоге будет создан файл версий (ConfigDumpInfo.xml), соответствующий загруженной конфигурации. Если выполняется частичная загрузка (используется параметры -files или -listFile), то существующий файл версий будет обновлен.
  • -NoCheck ‑ указывает, что при загрузке конфигурации не требуется проводить проверку целостности загружаемой конфигурации. Это сокращает время загрузки, если инициатор команды уверен, что загружается заведомо целостная конфигурация.
  • -Archive ‑ содержит имя ZIP-архива из которого будет выполняться загрузка файлов. Для успешного выполнения команды должен быть указан или каталог загрузки, или данный параметр. Одновременное указание каталога загрузки и данного параметра не допускается.

При указании одновременно параметров –files и –listFile, будет использован тот параметр, который в командной строке указан первым.
/GetConfigGenerationID [-Extension <Имя расширения>]Команда позволяет получить идентификатор текущего «поколения» метданных конфигурации. Этот идентификатор обновляется при любом изменении собственно конфигурации. Идентификаторы, полученные с помощью данной команды, не имеет смысла сравнивать на «больше/меньше». Идентификаторы имеет смысл сравнивать только на «равно/не равно», тем самым проверяя, были изменения в конфигурации с момента последнего получения идентификатора или нет.

Для получения идентификатора следует обязательно указывать команду /Out командной строки запуска конфигуратора. Идентификатор будет иметь следующий вид: 4d8d1d994cd4534c9accd32a5b44b35300000000. Для пустой информационной базы идентификатор будет иметь следующий вид: 0000000000000000000000000000000000000000.

Допустимо указывать следующие параметры:

  • –Extension ‑ выполняется получение идентификатора метаданных указанного расширения. Если параметр не указан ‑ идентификатор получается для основной конфигурации.
3.4. Проверки конфигурации и расширений
/CheckModules [-ThinClient] [-WebClient] [-MobileClient] [-MobileClientStandalone] [-MobileAppClient] [-Server] [-MobileAppServer] [-ExternalConnection] [-ThickClientOrdinaryApplication] [-ExtendedModulesCheck] [-Extension <Имя расширения>] [-AllExtensions]Выполнить проверку программных модулей. Должен быть указан один или несколько параметров, описывающих режимы проверки. Если параметры не указаны, проверка выполнена не будет. Допустимо использование следующих параметров:

  • -ThinClient ‑ проверка в режиме работы тонкого клиента;
  • -WebClient ‑ проверка в режиме работы веб-клиента;
  • -MobileClient ‑ проверка в режиме работы мобильного клиента;
  • -MobileAppClient ‑ проверка в режиме работы клиента мобильного приложения;
  • -MobileClientStandalone ‑ проверка в режиме работы мобильного клиента, работающего в автономном режиме.
  • -Server ‑ проверка в режиме работы сервера «1С:Предприятия»;
  • -MobileAppServer ‑ проверка в режиме работы сервера мобильного приложения;
  • -ExternalConnection ‑ проверка в режиме работы внешнего соединения;
  • -ThickClientOrdinaryApplication ‑ проверка в режиме работы клиентского приложения;
  • -ExtendedModulesCheck ‑ проверка обращений к методам и свойствам объектов «через точку» (для ограниченного набора типов); проверка правильности строковых литералов ‑ параметров некоторых функций, таких как ПолучитьФорму().
  • -Extension ‑ выполнить заданные проверки для указанного расширения.
  • -AllExtensions ‑ выполнить заданные проверки для всех расширений.
/CheckConfig [-ConfigLogIntegrity] [-IncorrectReferences] [-ThinClient] [-WebClient] [-MobileClient] [-MobileAppClient] [-Server] [-MobileAppServer] [-MobileClientStandalone] [-ExternalConnection] [-ExternalConnectionServer] [-ThickClientManagedApplication] [-ThickClientServerManagedApplication] [-ThickClientOrdinaryApplication] [-ThickClientServerOrdinaryApplication] [-DistributiveModules] [-UnreferenceProcedures] [-HandlersExistence] [-EmptyHandlers] [-ExtendedModulesCheck] [-CheckUseModality] [-CheckUseSynchronousCalls] [-UnsupportedFunctional] [-MobileClientDigiSign] [-Extension <Имя расширения>] [-AllExtensions]Выполнить централизованную проверку конфигурации. Допустимо использование следующих параметров:

  • -ConfigLogIntegrity ‑ проверка логической целостности конфигурации. Стандартная проверка, обычно выполняемая перед обновлением базы данных;
  • -IncorrectReferences ‑ поиск некорректных ссылок. Поиск ссылок на удаленные объекты. Выполняется по всей конфигурации, включая права, формы, макеты, интерфейсы и т. д. Также осуществляется поиск логически неправильных ссылок;
  • -ThinClient ‑ синтаксический контроль модулей для режима эмуляции среды управляемого приложения (тонкий клиент), выполняемого в файловом режиме;
  • -WebClient ‑ синтаксический контроль модулей в режиме эмуляции среды веб-клиента;
  • -MobileClient ‑ синтаксический контроль модулей в режиме эмуляции среды мобильного клиента;
  • -MobileClientStandalone ‑ синтаксический контроль модулей в режиме эмуляции среды мобильного клиента, работающего в автономном режиме;
  • -Server ‑ синтаксический контроль модулей в режиме эмуляции среды сервера «1С:Предприятия»;
  • -ExternalConnection ‑ синтаксический контроль модулей в режиме эмуляции среды внешнего соединения, выполняемого в файловом режиме;
  • -ExternalConnectionServer ‑ синтаксический контроль модулей в режиме эмуляции среды внешнего соединения, выполняемого в клиент-серверном режиме;
  • -MobileAppClient ‑ синтаксический контроль модулей в режиме эмуляции среды мобильной платформы, выполняемой в клиентском режиме запуска;
  • -MobileAppServer ‑ синтаксический контроль модулей в режиме эмуляции среды мобильной платформы, выполняемой в серверном режиме запуска;
  • -ThickClientManagedApplication ‑ синтаксический контроль модулей в режиме эмуляции среды управляемого приложения (толстый клиент), выполняемого в файловом режиме;
  • -ThickClientServerManagedApplication ‑ синтаксический контроль модулей в режиме эмуляции среды управляемого приложения (толстый клиент), выполняемого в клиент-серверном режиме;
  • -ThickClientOrdinaryApplication ‑ синтаксический контроль модулей в режиме эмуляции среды обычного приложения (толстый клиент), выполняемого в файловом режиме;
  • -ThickClientServerOrdinaryApplication ‑ синтаксический контроль модулей в режиме эмуляции среды обычного приложения (толстый клиент), выполняемого в клиент-серверном режиме;
  • -DistributiveModules ‑ поставка модулей без исходных текстов. В случае если в настройках поставки конфигурации для некоторых модулей указана поставка без исходных текстов, проверяется возможность генерации образов этих модулей;
  • -UnreferenceProcedures ‑ поиск неиспользуемых процедур и функций. Поиск локальных (не экспортных) процедур и функций, на которые отсутствуют ссылки. В том числе осуществляется поиск неиспользуемых обработчиков событий;
  • -HandlersExistence ‑ проверка существования назначенных обработчиков. Проверка существования обработчиков событий интерфейсов, форм и элементов управления;
  • -EmptyHandlers ‑ поиск пустых обработчиков. Поиск назначенных обработчиков событий, в которых не выполняется никаких действий. Существование таких обработчиков может привести к снижению производительности системы;
  • -ExtendedModulesCheck ‑ проверка обращений к методам и свойствам объектов «через точку» (для ограниченного набора типов); проверка правильности строковых литералов ‑ параметров некоторых функций, таких как ПолучитьФорму();
  • -CheckUseModality ‑ режим поиска использования в модулях методов, связанных с модальностью. Параметр используется только вместе с параметром -ExtendedModulesCheck.
  • -CheckUseSynchronousCalls ‑ режим поиска использования в модулях синхронных методов. Параметр используется только вместе с параметром -ExtendedModulesCheck.
  • -UnsupportedFunctional ‑ выполняется поиск функциональности, которая не может быть выполнена в приложении для мобильного устройства. Проверка в этом режиме показывает:
    • наличие в конфигурации метаданных, классы которых не реализованы на мобильной платформе;
    • наличие в конфигурации планов обмена, у которых установлено свойство Распределенная информационная база;
    • использование типов, которые не реализованы на мобильной платформе:
      • в свойствах Тип реквизитов метаданных, констант, параметров сеанса;
      • в свойстве Тип параметра команды объекта конфигурации Команда;
      • в свойстве Тип реквизитов и колонок реквизита формы;
      • наличие форм с типом формы Обычная;
      • наличие в форме элементов управления, которые не реализованы на мобильной платформе. Проверка не выполняется для форм, у которых свойство Назначения использования не предполагает использование на мобильном устройстве;
      • сложный состав рабочего стола (использование более чем одной формы).
  • -MobileClientDigiSign ‑ выполняет проверку цифровой подписи конфигурации для мобильного клиента;
  • -Extension ‑ выполнить заданные проверки для указанного расширения.
  • -AllExtensions ‑ выполнить заданные проверки для всех расширений.
/CheckCanApplyConfigurationExtensions [-Extension <ИмяРасширения>] [-AllZones] [-Z «Значения разделителей»]Выполняется проверка применимости расширения для использования в конкретной информационной базе.

Допустимо использовать следующие параметры:

  • -Extension ‑ выполнить проверку для указанного расширения с учетом всех ранее загружаемых расширений. Если имя расширения не указано, то проверяются все расширения в порядке загрузки.
  • -AllZones ‑ необходимо проверить расширение во всех областях данных текущей информационной базы.
    • Не поддерживается совместное использование параметров -Extension и –AllZones, а также –Z и –AllZones.
    • Результат проверки применимости расширений для каждой области предваряется выводом -Z с указанием значений разделителей для проверяемой области.
  • -Z ‑ установка значений разделителей для выполнения проверки. Подробное описание см. здесь. Если параметр -Z не указан ‑ проверка выполняется для области данных с неустановленными значениями разделителей.

Если указаны одновременно команда /Z и параметр -Z, то значения разделителей, указанные в команде /Z будут использоваться для запуска конфигуратора и выбора пользователя, а значения разделителей, указанные в параметре -Z (параметр команды /CheckCanApplyConfigurationExtensions) будут использоваться для указания области данных, для которой будет выполняться проверка применимости расширения.
/IBCheckAndRepair [-ReIndex] [-LogIntegrity [MDtype[,MDtype]] | -LogAndRefsIntegrity [MDtype[,MDtype]]] [-RecalcTotals] [-IBCompression] [-Rebuild] [–RebuildStandaloneCfg] [-TestOnly | [[-BadRefCreate | -BadRefClear | -BadRefNone] [-BadDataCreate | -BadDataDelete]]] [-UseStartPoint] [-TimeLimit:hhh:mm] [-ConfigurationExtensionsLogIntegrity] [-RefreshTableLocation] [-BinaryDataStorageIntegrity [MDtype[,MDtype]]]Выполнить операцию тестирования и исправления информационной базы. Допустимо использование следующих параметров:

  • -ReIndex ‑ реиндексация таблиц.
  • -LogIntegrity ‑ проверка логической целостности. Если параметр указан без значений, то выполняется проверка логической целостности всех таблиц информационной базы. Имеется возможность выбрать проверяемые таблиц, указав их (через запятую) в качестве значения параметра. Список проверяемых таблиц приводится далее в тексте.
  • -LogAndRefsIntegrity ‑ проверка логической и ссылочной целостности. Если параметр указан без значений, то выполняется проверка логической и ссылочной целостности всех таблиц информационной базы. Имеется возможность выбрать проверяемые таблиц, указав их (через запятую) в качестве значения параметра. Список проверяемых таблиц приводится далее в тексте.
  • -RecalcTotals ‑ пересчет итогов.
  • -IBCompression ‑ сжатие таблиц. Для файлового варианта также выполняется специальная оптимизация, описание которой см. здесь.
  • -Rebuild ‑ реструктуризация таблиц информационной базы.
  • -RebuildStandaloneCfg ‑ пересоздать конфигурацию, предназначенную для работы в мобильном клиенте с автономным режимом.
  • -TestOnly ‑ выполнять только тестирование информационной базы. В том случае, если выполняется тестирование и исправление информационной базы (отсутствует параметр –TestOnly), можно указывать следующие параметры:

    При наличии ссылок на несуществующие объекты:
    • -BadRefCreate ‑ создавать объекты;
    • -BadRefClear ‑ очищать объекты;
    • -BadRefNone ‑ не изменять при частичной потере объектов.
При частичной потере информации об объектах:
    • -BadDataCreate ‑ создавать объекты;
    • -BadDataDelete ‑ удалять объекты.
  • -UseStartPoint ‑ использовать сохраненную точку возврата для продолжения тестирования с того места, на котором оно было прервано в предыдущем сеансе.
  • -TimeLimit:hhh:mm ‑ ограничение максимального времени сеанса тестирования:
    • hhh ‑ количество часов (0...999);
    • mm ‑ количество минут (0...59).

      При указании параметра следует учитывать, что не все процессы во время тестирования и исправления могут быть прерваны в произвольное время или вообще быть прерваны. Поэтому прерывание выполнения будет происходить после истечения указанного времени, но только в тот момент, когда это возможно. Другими словами, не следует ожидать, что указание лимита времени в 1 час ровно приведет к тому, что ровно через час процесс тестирования и исправления будет прерван.
  • -ConfigurationExtensionsLogIntegrity ‑ позволяет выполнить проверку и исправление (если возможно) логической целостности расширений конфигурации. Если выбран параметр -TestOnly ‑ выполняется только проверка, без исправления.
  • -RefreshTableLocation ‑ обновляет информацию о расположении таблиц в пользовательских табличных пространствах.
  • -BinaryDataStorageIntegrity ‑ позволяет выполнить проверку целостности хранилища двоичных данных. Если параметр указан без значений, то выполняется проверка целостности всех таблиц информационной базы. Имеется возможность выбрать проверяемые таблиц, указав их (через запятую) в качестве значения параметра. Список проверяемых таблиц приводится далее в тексте.

Одновременное использование параметров внутри подгруппы параметров не допускается.

Для параметров -LogIntegrity, -LogAndRefsIntegrity и -BinaryDataStorageIntegrity допускается указание списка обрабатываемых таблиц (в качестве значения параметра, через запятую, если таблиц несколько) из следующего списка:

Значение параметра: 

  • Бизнес-процессы - BusinessProcesses
  • Документы - Documents
  • Другие объекты - Other
  • Журнал документов - DocumentJournals
  • Задачи - Tasks
  • Константы - Constants
  • Планы видов расчета - ChartsOfCalculationTypes
  • Планы видов характеристик - ChartsOfCharacteristicTypes
  • Планы обмена - ExchangePlans
  • Планы счетов - ChartsOfAccounts
  • Регистры бухгалтерии - AccountingRegisters
  • Регистры накопления - AccumulationRegisters
  • Регистры расчета - CalculationRegisters
  • Регистры сведений - InformationRegisters
  • Справочники - Catalogs
3.5. Поддержка конфигурации
/UpdateCfg <имя cf или cfu файла> -Settings <имя файла настроек> [-IncludeObjectsByUnresolvedRefs | -ClearUnresolvedRefs] [-DumpListOfTwiceChangedProperties] [-force]Выполнить обновление конфигурации, находящейся на поддержке.

Выполнить объединение текущей конфигурации с файлом (с использованием файла настроек).

Допустимо использовать следующие параметры:

  • <имя cf‑ или cfu-файла> ‑ имя файла с объединяемой конфигурацией (.cf-файл) или с файлом обновления конфигурации (.cfu-файл).
  • -Settings <имя файла настроек> ‑ позволяет указать имя файла с настройками объединения конфигураций. 
  • -IncludeObjectsByUnresolvedRefs ‑ если в настройках объединения есть объекты, не включенные в список объединяемых и отсутствующие в основной конфигурации, но на которые есть ссылки из объектов, включенных в список, то такие объекты также помечаются для объединения, и выполняется попытка продолжить объединение. Попытки выполняются, пока не останется объектов со ссылками на не включенные объекты, либо пока не выберется вся конфигурация. Аналогично кнопке Пометить все для объединения в окне с неразрешенными ссылками, только с повторением попыток.
  • -ClearUnresolvedRefs ‑ ссылки на объекты, не включенные в список объединяемых объектов, очищаются. Аналогично кнопке Продолжить в окне с неразрешенными ссылками.
  • -DumpListOfTwiceChangedProperties ‑ вывести список всех дважды измененных свойств в файл для вывода служебных сообщений.
  • -force ‑ проводить объединение в случае наличия:
    • предупреждений об удаляемых объектах, на которые есть ссылки в объектах, не участвующих в объединении (такие объекты будут исключены из объединения).
    • предупреждений о наличии дважды измененных свойств, для которых не был выбран режим объединения (такие свойства будут объединены с настройками по умолчанию).
    • объектов, изменение которых запрещено правилами поддержки (такие объекты будут исключены из объединения).
    • предупреждений о применении настроек.

Если не указан, то объединение будет прервано в вышеуказанных случаях.

Предупреждение о наличии дважды измененных свойств будут выведены в файл для вывода служебных сообщений, которые выводятся в файл для вывода служебных сообщений вне зависимости от параметра -force.

Пример: "C:\Program Files (x86)\1cv8\common\1cestart.exe" DESIGNER /F<Путь к базе данных> /N<Имя пользователя> /P<Пароль> /UpdateCfg<Путь и имя файла обновления *.cfu>

/ManageCfgSupport [-disableSupport [-force]]Позволяет снимать конфигурация с поддержки. Допустимо использование следующих параметров:

  • -disableSupport ‑ указывает на необходимость снятия конфигурации с поддержки. При отсутствии параметра генерируется ошибка.
  • -force ‑ выполнить снятие конфигурации с поддержки даже в том случае, если в конфигурации запрещены изменения. При отсутствии параметра будет сгенерирована ошибка, если попытка снятия с поддержки будет выполняться для конфигурации, для которой в интерактивном режиме управления поддержкой запрещены изменения.
3.6. Команды создания файла поставки и обновления
/CreateTemplateListFile <имя файла> [-TemplatesSourcePath]Создать файла шаблонов конфигураций. Допустимо указывать следующие каталоги и использовать следующие параметры:

  • <имя файла> ‑ имя файла списка шаблонов конфигураций. Если не указано, создается в заданном каталоге с именем по умолчанию, если указано только имя создается с указанным именем в заданном каталоге. При указании полного пути используется данный путь;
  • -TemplatesSourcePath ‑ путь для поиска файлов шаблонов конфигураций. Если не задан, берется путь, установленный в системе в диалоге настройке при запуске.
/CreateDistributivePackage <имя каталога> -File <имя файла описания комплекта поставки> -PackageFileName <имя архива> [-Option <вариант поставки>] [-MakeSetup] [-MakeFiles] [-digisign <имя файла с параметрами лицензирования >] [-WarningAsError]Выполнить создание архива с комплектом поставки или файлов комплекта поставки по готовому описанию комплекта поставки. В том случае, если для конфигурации задана подпись мобильного клиента, то перед выполнением команды выполняется проверка того, что установленная подпись соответствует текущим метаданным конфигурации. Если подпись конфигурации не соответствует конфигурации, то формируется диагностическое сообщение, а дальнейшее поведение системы определяется наличием параметра -WarningAsError.

Из параметров -MakeSetup и -MakeFiles может быть использован только один. При отсутствии этих параметров используется -MakeSetup (т. е. создается комплект поставки). Допустимо указывать следующие каталоги и использовать следующие параметры:

  • <каталог создания комплекта поставки> ‑ указание каталога создания комплекта поставки или файлов комплекта поставки.
  • -File <файл описания комплекта поставки> ‑ указание файла описания комплекта поставки.
  • -PackageFileName <имя архива> ‑ имя файла с zip-архивом комплекта поставки. Архив будет создан в <каталог создания комплекта поставки>. Используется только совместно с параметром -MakeSetup. Если переданное имя файла не имеет расширения «.zip», то оно будет добавлено автоматически. Если параметр не указан, то будет использоваться имя по умолчанию: updsetup.zip.
  • -Option <вариант поставки> ‑ создать вариант поставки из описания комплекта поставки. По умолчанию используется вариант поставки Полный.
  • -MakeSetup ‑ создавать комплект поставки.
  • -MakeFiles ‑ создавать файлы комплекта поставки.
  • -digisign <имя файла с параметрами лицензирования> ‑ указание параметров лицензирования рабочего места пользователя.
  • -WarningAsError ‑ при указании данного параметра несоответствие цифровой подписи мобильного клиента текущим метаданным трактуется как ошибка с прерыванием процесса. Если параметр не задан ‑ несоответствие подписи и конфигурации не считается ошибкой и процесс не прерывается.
/CreateDistributionFiles [-cffile <имя cf-файла>] [-cfufile <имя cfu-файла> [-f <имя cf-файла>|-v <версия дистрибутива>]+][–digisign <имя файла с параметрами лицензирования>] [-WarningAsError]Выполнить создание файлов поставки и обновления. В том случае, если для конфигурации задана подпись мобильного клиента, то перед выполнением команды выполняется проверка того, что установленная подпись соответствует текущим метаданным конфигурации. Если подпись конфигурации не соответствует конфигурации, то формируется диагностическое сообщение, а дальнейшее поведение системы определяется наличием параметра -WarningAsError.

Допустимо указывать следующие каталоги и использовать следующие параметры:

  • -cffile <имя cf-файла> ‑ указание создать файл поставки;
  • -cfufile <имя cfu-файла> ‑ указание создать файл обновления;
  • -f <имя cf-файла> ‑ дистрибутив, включаемый в обновление, задан именем;
  • -v <версия дистрибутива> ‑ дистрибутив, включаемый в обновление, задан версией;
  • -digisign <имя файла с параметрами лицензирования> ‑ указание параметров лицензирования рабочего места пользователя.
  • -WarningAsError ‑ при указании данного параметра несоответствие цифровой подписи мобильного клиента текущим метаданным трактуется как ошибка с прерыванием процесса. Если параметр не задан ‑ несоответствие подписи и конфигурации не считается ошибкой и процесс не прерывается.

Группа параметров -f <имя cf-файла>|-v <версия дистрибутива> повторяется столько раз, сколько файлов дистрибутивов включается в обновление.
/CreateDistributive <каталог создания комплекта поставки> -File <имя файла описания комплекта поставки> [-Option <вариант поставки>] [-MakeSetup] [-MakeFiles] [-digisign <имя файла с параметрами лицензирования >] [-WarningAsError]ПРИМЕЧАНИЕ. Данная команда является устаревшей и не рекомендуется для использования.

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

Из параметров -MakeSetup и -MakeFiles может быть использован только один. При отсутствии этих параметров используется -MakeSetup (т. е. создается комплект поставки). Допустимо указывать следующие каталоги и использовать следующие параметры:

  • <каталог создания комплекта поставки> ‑ указание каталога создания комплекта поставки или файлов комплекта поставки;
  • -File <файл описания комплекта поставки> ‑ указание файла описания комплекта поставки;
  • -Option <вариант поставки> ‑ создать вариант поставки из описания комплекта поставки. По умолчанию используется вариант поставки Полный;
  • -MakeSetup ‑ создавать комплект поставки;
  • -MakeFiles ‑ создавать файлы комплекта поставки;
  • -digisign <имя файла с параметрами лицензирования> ‑ указание параметров лицензирования рабочего места пользователя.
  • -WarningAsError ‑ при указании данного параметра несоответствие цифровой подписи мобильного клиента текущим метаданным трактуется как ошибка с прерыванием процесса. Если параметр не задан ‑ несоответствие подписи и конфигурации не считается ошибкой и процесс не прерывается.
/SignCfg -ConfigurationType <тип конфигурации> -SignedFile <путь к cfe-файлу> [-File <путь к cfe-файлу>] [-Name <имя расширения>] [-Version <версия>] -digisign <имя файла с параметрами лицензирования>Подписать расширение конфигурации цифровой подписью. После выполнения процедуры подписи расширение может быть использовано в базовых версиях конфигураций, подписанных тем же ключом, что и расширение.

Допустимо указывать следующие каталоги и использовать следующие параметры:

  • -ConfigurationType <тип конфигурации> ‑ местоположение подписываемого расширения конфигурации. Параметр может принимать следующие значения:
    • ExtensionConfiguration ‑ расширение конфигурации.
    • ExtensionDBConfiguration ‑ расширение конфигурации, расположенное в базе данных.
    • ExtensionConfigurationRepository ‑ расширение конфигурации, расположенное в хранилище расширения конфигурации.
    • File ‑ файл расширения конфигурации.
  • -SignedFile <путь к cfe-файлу> ‑ путь к подписанному файлу расширения (результирующий файл).
  • -File <путь к cfe-файлу> ‑ путь к файлу с подписываемым расширением. Используется при указании типа конфигурации File.
  • -Name <имя расширения> ‑ имя расширения. Используется, если типа конфигурации принимает одно из следующих значений: ExtensionConfiguration, ExtensionDBConfiguration, ExtensionConfigurationRepository.
  • -Version <версия > ‑ версия расширения конфигурации в хранилище. Используется при указании типа конфигурации ExtensionConfigurationRepository.
  • -digisign <имя файла с параметрами лицензирования> ‑ позволяет указать параметры лицензирования рабочего места пользователя.
3.7. Внешние обработки (отчеты)
/DumpExternalDataProcessorOrReportToFiles <корневой файл выгрузки> <внешняя обработка (отчет)> [-Format Plain|Hierarchical]Выполняет выгрузку внешней обработки (отчета) в формате XML. Используется выгрузка формата 2.0 (подробнее см. здесь).

Допустимо использовать следующие параметры:

  • <корневой файл выгрузки> ‑ содержит полный путь к корневому каталогу выгрузки. Обязательный параметр.
  • <внешняя обработка (отчет)> ‑ полный путь к внешней обработке (отчету) в формате .epf (.erf).
  • -Format ‑ указывает формат выгрузки:
    • Plain ‑ линейный формат;
    • Hierarchical ‑ иерархический формат (по умолчанию).
/LoadExternalDataProcessorOrReportFromFiles <корневой файл выгрузки> <внешняя обработка (отчет)>Выполняет загрузку внешней обработки (отчета) из формата XML. Используется выгрузка формата 2.0 (подробнее см. здесь).

Допустимо использовать следующие параметры:

  • <корневой файл выгрузки> ‑ содержит полный путь к корневому каталогу, который содержит внешнюю обработку (отчет) в файлах формата XML. Обязательный параметр.
  • <внешняя обработка (отчет)> ‑ полный путь к внешней обработке (отчету) в формате .epf (.erf), которая получится в результате загрузки. Расширение результирующего файла будет определено автоматически, на основании XML-файлов. Если в командной строке расширение указано неверно ‑ оно будет автоматически заменено на нужное расширение.
3.8. Мобильное приложение
/MobileAppUpdatePublicationОбновить публикацию мобильного приложения, если она была ранее создана, в противном случае будет выдана ошибка. Возможно предварительное обновление конфигурации базы данных.
/MobileAppWriteFile <имя zip-файла>Сохранить конфигурацию в zip-файл. Указанный файл можно использовать для сборки приложения для мобильного устройства. Файл содержит собственно описание конфигурации и сопутствующие материалы. Возможно предварительное обновление конфигурации базы данных.
3.9. Мобильный клиент
/MobileClientWriteFile <имя файла>Сохранить конфигурацию в файл. Указанный файл можно использовать для сборки мобильного клиента. Возможно предварительное обновление конфигурации базы данных.
/MobileClientDigiSignПодписать конфигурацию мобильного клиента. Возможно предварительное обновление конфигурации базы данных.
3.10. Журнал регистрации
/ReduceEventLogSize <Date> [-saveAs <имя файла>] [-KeepSplitting]Выполнить сокращение журнала регистрации. Допустимо использование следующих параметров:

  • Date ‑ новая граница журнала регистраций в формате ГГГГ-ММ-ДД;
  • -saveAs <имя файла> ‑ параметр для сохранения копии выгружаемых записей;
  • -KeepSplitting ‑ требуется сохранить разделение на файлы по периодам.
3.11. Удаление данных
/EraseData [/Z[<разделители>]]Выполнить удаление данных информационной базы. С помощью параметра /Z задается область, в которой будут удалены данные. Удаление данных доступно пользователю с правом Администрирование.
3.12. Предопределенные данные
/SetPredefinedDataUpdate [-Auto] [-UpdateAutomatically] [-DoNotUpdateAutomatically]Параметр предназначен для указания режимов обновления предопределенных данных. Допустимо использование следующих параметров:

  • -Auto ‑ фактическое значение вычисляется автоматически (значение по умолчанию). Для главного узла информационной базы ‑ значение будет равно -UpdateAutomatically, для периферийного узла информационной базы будет равно -DoNotUpdateAutomatically.
  • -UpdateAutomatically ‑ при реструктуризации информационной базы будет выполняться автоматическое создание предопределенных элементов и обновление существующих значений.
  • -DoNotUpdateAutomatically ‑ при реструктуризации информационной базы не будет выполняться автоматическое создание новых предопределенных элементов и обновление их значений.
3.13. Распределенная информационная база
/ResetMasterNodeОтменить назначение главного узла распределенной информационной базы. Действие параметра аналогично вызову метода УстановитьГлавныйУзел() со значением параметра Неопределено.
3.14. Команды работы с хранилищем конфигурации
3.14.1. Параметры доступа к хранилищу
/ConfigurationRepositoryF <каталог хранилища>Параметр предназначен для указания пути к хранилищу конфигурации.
/ConfigurationRepositoryN <имя>Параметр предназначен для указания имени пользователя хранилища конфигурации.
/ConfigurationRepositoryP <пароль>Параметр предназначен для указания пароля пользователя хранилища конфигурации.
3.14.2. Создание хранилища
/ConfigurationRepositoryCreate [-AllowConfigurationChanges -ChangesAllowedRule <Правило поддержки> -ChangesNotRecommendedRule <Правило поддержки>] [-NoBind] [-Extension <Имя расширения>]Создать хранилище конфигурации. Допустимо использовать следующие параметры:

  • -AllowConfigurationChanges ‑ если конфигурация находится на поддержке без возможности изменения, будет включена возможность изменения.
  • -ChangesAllowedRule <Правило поддержки> ‑ устанавливает правило поддержки для объектов, для которых изменения разрешены поставщиком. Может быть установлено одно из следующих правил:
    • ObjectNotEditable ‑ объект поставщика не редактируется,
    • ObjectIsEditableSupportEnabled ‑ объект поставщика редактируется с сохранением поддержки,
    • ObjectNotSupported ‑ объект поставщика снят с поддержки.
  • -ChangesNotRecommendedRule ‑ устанавливает правило поддержки для объектов, для которых изменения не рекомендуются поставщиком. Может быть установлено одно из следующих правил:
    • ObjectNotEditable ‑ Объект поставщика не редактируется,
    • ObjectIsEditableSupportEnabled ‑ Объект поставщика редактируется с сохранением поддержки,
    • ObjectNotSupported ‑ Объект поставщика снят с поддержки.
  • -NoBind ‑ к созданному хранилищу подключение выполнено не будет.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, хранилище которого будет создано данной командой. Если параметр не указан ‑ будет создано хранилище для основной конфигурации.
3.14.3. Работа с пользователями
/ConfigurationRepositoryAddUser -User <Имя> -Pwd <Пароль> -Rights <Права> [-RestoreDeletedUser] [-Extension <Имя расширения>]Создать пользователя хранилища конфигурации. Пользователь, от имени которого выполняется подключение к хранилищу, должен обладать административными правами. Если пользователь с указанным именем существует, то пользователь добавлен не будет. Допустимо использовать следующие параметры:

  • -User ‑ имя создаваемого пользователя.
  • -Pwd ‑ пароль создаваемого пользователя.
  • -Rights ‑ права пользователя. Возможные значения:
    • ReadOnly ‑ право на просмотр,
    • LockObjects ‑ право на захват объектов,
    • ManageConfigurationVersions ‑ право на изменение состава версий,
    • Administration ‑ право на административные функции.
  • -RestoreDeletedUser ‑ если обнаружен удаленный пользователь с таким же именем, он будет восстановлен.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryCopyUsers -Path <путь> -User <Имя> -Pwd <Пароль> [-RestoreDeletedUser] [-Extension <Имя расширения>]Выполнить копирования пользователей из другого хранилища конфигурации. Копирование удаленных пользователей не выполняется. Если пользователь с указанным именем существует, то пользователь не будет добавлен. Допустимо использовать следующие параметры:

  • -Path ‑ путь к хранилищу, из которого выполняется копирование пользователей.
  • -User ‑ имя пользователя хранилища, из которого выполняется копирование пользователей.
  • -Pwd ‑ пароль пользователя хранилища, из которого выполняется копирование пользователей.
  • -RestoreDeletedUser ‑ если обнаружен удаленный пользователь с таким же именем, он будет восстановлен.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
3.14.4. Операции с объектами
/ConfigurationRepositoryLock [–Objects <имя файла>] [-revised] [-Extension <Имя расширения>]Выполняет захват объектов из хранилища конфигурации для редактирования.
Допустимо использовать следующие параметры:

  • -Objects <имя файла> ‑ путь к файлу со списком объектов, которые будут участвовать в операции. Если файл указан ‑ в операции участвуют только указанные в файле объекты, в противном случае участвует вся конфигурация. Описание формата файла см. здесь.
  • -revised ‑ получать захваченные объекты, если потребуется.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.

Код возврата пакетного режима:

  • 0 ‑ нет ошибок.
  • 1 ‑ есть ошибки. Текст ошибки выводится в файл служебных сообщений.
/ConfigurationRepositoryUnLock [–Objects <имя файла>] [-force] [-Extension <Имя расширения>]Выполняет отмену захвата объектов в хранилище конфигурации.
Допустимо использовать следующие параметры:

  • -Objects <имя файла> ‑ путь к файлу со списком объектов, которые будут участвовать в операции. Если файл указан ‑ в операции участвуют только указанные в файле объекты, в противном случае участвует вся конфигурация. Описание формата файла см. здесь.
  • -force ‑ описывает поведение с локально измененными объектами:
    • Параметр указан ‑ локально измененные объекты будут получены из хранилища. Изменения будут потеряны.
    • Параметр не указан ‑ при наличии локально измененных объектов будет выдана ошибка, и операция будет отменена целиком, для всех объектов, участвующих в операции.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.

Код возврата пакетного режима:

  • 0 ‑ нет ошибок.
  • 1 ‑ есть ошибки. Текст ошибки выводится в файл служебных сообщений.
/ConfigurationRepositoryCommit [–Objects <имя файла>] [-comment <текст комментария>] [-keepLocked] [-force] [-Extension <Имя расширения>]Выполняет помещение изменений объектов в хранилище конфигурации.

Допустимо использовать следующие параметры:

  • -Objects <имя файла> ‑ путь к файлу со списком объектов, которые будут участвовать в операции. Если файл указан ‑ в операции участвуют только указанные в файле объекты, в противном случае участвует вся конфигурация. Описание формата файла см. здесь.
  • -comment <текст комментария> ‑ текст комментария к помещаемым объектам. Должен быть в двойных кавычках. Для задания многострочного комментария, каждая строка должна задаваться с помощью своего параметра -comment.
  • -keepLocked ‑ оставлять помещенные объекты захваченными. Если не указан, то после помещения изменений будет отменен захват для объектов, участвующих в операции.
  • -force ‑ описывает поведение при обнаружении ссылок на удаленные объекты:
    • Параметр указан ‑ будет выполнена попытка очистки ссылок.
    • Параметр не указан ‑ будет выдана ошибка.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.

Код возврата пакетного режима:

  • 0 ‑ нет ошибок.
  • 1 ‑ есть ошибки. Текст ошибки выводится в файл служебных сообщений.
3.14.5. Операции со всей конфигурацией
/ConfigurationRepositoryBindCfg [-forceBindAlreadyBindedUser] [-forceReplaceCfg] [-Extension <Имя расширения>]Выполняет подключение ранее неподключенной информационной базы к хранилищу конфигурации. Допустимо использовать следующие параметры:

  • -forceBindAlreadyBindedUser ‑ выполняет подключение даже в том случае, если для данного пользователя уже есть конфигурация, связанная с данным хранилищем.
  • -forceReplaceCfg ‑ если конфигурация непустая, данный параметр подтверждает замену конфигурации на конфигурацию из хранилища.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryUnbindCfg [-force] [-Extension <Имя расширения>]Выполнить отключение конфигурации от хранилища конфигурации (у пользователя должны быть административные права в данной информационной базе). Если пользователь аутентифицируется в хранилище (интерактивно или через параметры командной строки), то отключение конфигурации от хранилища также отражается в самом хранилище конфигурации (информация о подключении удаляется), если же пользователь не аутентифицировался в хранилище, то производится только локальное отключение конфигурации от хранилища.

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

  • -force ‑ параметр предназначен для пропуска диалога аутентификации (если не указаны параметры пользователя хранилища), а также для игнорирования наличия захваченных и измененных объектов.
  • -Extension <Имя расширения> ‑ параметр позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryDumpCfg <имя cf файла> [-v <номер версии хранилища>] [-Extension <Имя расширения>]Сохранить конфигурацию из хранилища в файл. Допустимо использовать следующие параметры:

  • -v <номер версии хранилища> ‑ номер версии, если номер версии не указан, или равен -1, будет сохранена последняя версия.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryUpdateCfg [-v <номер версии хранилища>] [-revised] [-force] [-Objects <имя файла>] [-Extension <Имя расширения>]Обновить конфигурацию из хранилища.
Допустимо использовать следующие параметры:

  • -v<номер версии хранилища> ‑ номер версии в хранилище конфигурации. В том случае, если конфигурация подключена к хранилищу, то номер версии (если он указан) игнорируется и будет получена актуальная версия конфигурации хранилища. Если конфигурация не подключена к хранилищу, то выполняется получение указанной версии, а если версия не указана (или значение равно -1) ‑ будет получена актуальная версия конфигурации;
  • -revised ‑ получать захваченные объекты, если потребуется. Если конфигурация не подключена к хранилищу, то параметр игнорируется;
  • -force ‑ если при пакетном обновлении конфигурации из хранилища должны быть получены новые объекты конфигурации или удалиться существующие, указание этого параметра свидетельствует о подтверждении пользователем описанных выше операций. Если параметр не указан ‑ действия выполнены не будут.
  • -Objects <имя файла> ‑ путь к файлу со списком объектов, которые будут участвовать в операции. Если файл указан ‑ в операции участвуют только указанные в файле объекты, в противном случае участвует вся конфигурация. Описание формата файла см. здесь.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
3.14.6. Сервисные операции
/ConfigurationRepositorySetLabel [-v <номер версии хранилища>] [-name] <имя метки> [-comment <текст комментария>] [-Extension <Имя расширения>]Устанавливает метку на версию хранилища.
Допустимо использовать следующие параметры:

  • -v <номер версии хранилища> ‑ номер версии хранилища, для которого устанавливается метка. Если версия не указана, метка ставится для самой последнее версии хранилища. Если указана несуществующая версия, выдается ошибка.
  • -name <имя метки> ‑ текст метки в двойных кавычках.
  • -comment <текст комментария> ‑ текст комментария к устанавливаемой метки. Должен быть в двойных кавычках. Для задания многострочного комментария, каждая строка должна задаваться с помощью своего параметра -comment.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.

Код возврата пакетного режима:

  • 0 ‑ нет ошибок.
  • 1 ‑ есть ошибки. Текст ошибки выводится в файл служебных сообщений.
/ConfigurationRepositoryReport <имя файла> [-NBegin <номер версии>] [-NEnd <номер версии>] [-DateBegin <дата начала>] [-DateEnd <дата окончания>] [-GroupByObject] [-GroupByComment] [-DoNotIncludeVersionsWithLabels] [-IncludeOnlyVersionsWithLabels] [-IncludeCommentLinesWithDoubleSlash] [-ConfigurationVersion <версия конфигурации>] [-ReportFormat <txt|mxl>] [-Extension <Имя расшире-ния>]Выполнить построение отчета по истории хранилища. Если параметры группировки не указаны и режим совместимости конфигурации равен значению Не использовать, то отчет формируется с группировкой по версиям. В режимах совместимости Версия 8.1 и Версия 8.2.13 отчет формируется с группировкой по объектам. Если конфигурация базы данных отличается от редактируемой по свойству совместимости, при обработке командной строки учитывается значение режима совместимости конфигурации базы данных. Допустимо указывать следующие имена файлов и использовать следующие параметры:

  • <имя файла> ‑ имя файла, в который выводится отчет.
  • -NBegin ‑ номер сохраненной версии, от которой начинается строиться отчет. Если значение параметра равно -1, то отчет строится для последней версии в хранилище.
  • -NEnd ‑ номер сохраненной версии, по которую строится отчет.
  • -DateBegin ‑ дата, начиная с которой формируется отчет по хранилищу. Для формирования даты используется синтаксис строки, передаваемой конструктору типа Дата встроенного языка.
  • -DateEnd ‑ дата, по которую формируется отчет по хранилищу. Для формирования даты используется синтаксис строки, передаваемой конструктору типа Дата встроенного языка.
  • -GroupByObject ‑ признак формирования отчета по версиям с группировкой по объектам.
  • -GroupByComment ‑ признак формирования отчета по версиям с группировкой по комментарию.
  • -DoNotIncludeVersionsWithLabels ‑ позволяет не включать в отчет версии хранилища, с установленными метками.
  • -IncludeOnlyVersionsWithLabels ‑ позволяет включать в отчет только версии хранилища, с установленными метками. Данный параметр игнорируется, если в командной строке указан параметр -DoNotIncludeVersionsWithLabels.
  • -IncludeCommentLinesWithDoubleSlash ‑ включает в отчет строки комментариев (начинающиеся с символов «//»).
  • -ConfigurationVersion <версия конфигурации> ‑ позволяет указать версию конфигурации, для которой формируется отчет по хранилищу.
  • -ReportFormat <txt|mxl> ‑ задает формат файла с отчетом: тестовый файл (txt) или табличный документ «1С:Предприятие» (mxl). По умолчанию используется формат MXL.
  • -Extension <Имя расширения> ‑ позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryOptimizeData [-Extension <Имя расширения>]Выполняет оптимизацию хранения данных в хранилище конфигурации.
3.14.7. Операции с кешем хранилища
/ConfigurationRepositoryClearCache [-Extension <Имя расширения>]Выполнить очистку локальной базы данных хранилища конфигурации.

Параметр -Extension <Имя расширения> позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryClearLocalCache [-Extension <Имя расширения>]Выполнить очистку локального кеша версий конфигурации.

Параметр -Extension <Имя расширения> позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
/ConfigurationRepositoryClearGlobalCache [-Extension <Имя расширения>]Выполнить очистку глобального кеша версий конфигурации.

Параметр -Extension <Имя расширения> позволяет указать имя расширения, с хранилищем которого будет выполняться команда. Если параметр не указан ‑ операция будет выполняться с хранилищем основной конфигурации.
3.15. Команды работы в режиме агента
/AgentModeВключает режим агента конфигуратора. При наличии этой команды игнорируются команды /DisableStartupMessages /DisableStartupDialogs, если таковые указаны.
/AgentPort <Порт>Указывает номер сетевого порта, который использует агент в режиме SSH-сервера. Если команда не указана, то по умолчанию используется сетевой порт с номером 1543.
/AgentListenAddress <Адрес>Параметр команды позволяет указать IP-адрес, который будет прослушиваться агентом. Если команда не указан, то по умолчанию используется IP-адрес 127.0.0.1.
/AgentSSHHostKey <приватный ключ>Параметр команды позволяет указать путь к закрытому ключу хоста. Если параметр не указан, то должна быть указана команда /AgentSSHHostKeyAuto. Если не указан ни одна команда ‑ запуск в режиме агента будет невозможен.
/AgentSSHHostKeyAutoКоманда указывает, что закрытый ключ хоста имеет следующее расположение (в зависимости от используемой операционной системы):

  • Для ОС Windows: %LOCALAPPDATA%\1C\1cv8\host_id.
  • Для ОС Linux: ~/.1cv8/1C/1cv8/host_id.
  • Для ОС macOS: ~/.1cv8/1C/1cv8/host_id.

Если указанный файл не будет обнаружен, то будет создан закрытый ключ для алгоритма RSA с длиной ключа 2 048 бит.
/AgentBaseDir <рабочий каталог>Данная команда позволяет указать рабочий каталог, который используется при работе SFTP-сервера, а также при работе команд загрузки/выгрузки конфигурации.

Если команда не указана, то будет использован следующий каталог:

  • Для ОС Windows: %LOCALAPPDATA%\1C\1cv8\<Уникальный идентификатор информационной базы>\sftp.
  • Для ОС Linux: ~/.1cv8/1C/1cv8/<Уникальный идентификатор информационной базы>/sftp.
  • Для ОС macOS: ~/.1cv8/1C/1cv8/<Уникальный идентификатор информационной базы>/sftp.
3.16. Прочие параметры
/VisibleДелает исполнение пакетной команды видимым пользователю. На время работы конфигуратора открывается окно заставки.

При исполнении в режиме агента ‑ отображает на экране информационное окно.
/RunEnterpriseЗапустить «1С:Предприятие» после исполнения пакетной команды. После команды может быть указана дополнительная командная строка. При запуске «1С:Предприятия», переданные в ней параметры будут использованы вместо параметров текущей сессии. Дополнительная командная строка обязательно должна быть в кавычках, вложенные в нее кавычки должны быть удвоены.
/ConvertFiles <имя файла|путь>Выполнить пакетную конвертацию файлов 1С:Предприятия 8.x. <имя файла|путь> ‑ имя файла или каталога.

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

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

Для работы данного механизма должен быть запущен конфигуратор и открыта конфигурация, в среде которой будет производиться конвертация. Имя информационной базы и параметры авторизации можно указать через стандартные параметры командной строки. В случае отсутствия таких параметров, будут выданы соответствующие запросы, как и в других аналогичных механизмах командной строки, работающих в режиме Конфигуратор.
/DumpResult <имя файла>Записать результат работы конфигуратора в файл. Результат ‑ число (0 ‑ в случае успеха).
4. Пакетный режим запуска клиентского приложения
Пакетный режим запуска клиентского приложения ‑ это специальный режим запуска, во время действия которого платформа «1С:Предприятие» не формирует диалоговых окон. Данный режим действует от момента запуска до окончания выполнения обработчика события ПередНачаломРаботыСистемы модуля приложения. Обработчик события ПриНачалеРаботыСистемы вызывает после завершения режима пакетного запуска клиентского приложения. Работа клиентского приложения автоматически не завершается после завершения пакетного режима запуска клиентского приложения. Пакетный режим запуска клиентского приложения поддерживается тонким и толстым клиентскими приложениями и активируется командой /DisableStartupDialogs командной строки запуска клиентского приложения. Веб-клиент не поддерживает пакетный режим запуска. Ошибки, возникающие в процессе выполнения пакетного режима запуска клиентского приложения, могут быть записаны в файл вывода служебных сообщений. Файлы вывода служебных сообщений задается командой /Out.

При работе в пакетном режиме запуска клиентского приложения действуют все особенности команды /DisableStartupDialogs (см. здесь), кроме того, действует еще ряд особенностей.

В том случае, если во время пакетного режима запуска клиентского приложения осуществляется вызов какого-либо асинхронного метода, то:

  • Такие методы будут исполнены после завершения исполнения обработчика события ПередНачаломРаботыСистемы, но до завершения пакетного режима. Такое поведение будет наблюдаться в том случае, если клиентское приложение запустилось успешно и открывается основное окно приложения.
  • Если пакетный режим завершился отказом от запуска приложения (параметр Отказ обработчика события ПередНачаломРаботыСистемы установлен в значение Истина), то асинхронные вызовы не будут исполнены.

В пакетном режиме запуска клиентского приложения не допускается открытие окон. Если такая попытка будет выполнена, то:

  • открытие формы будет заблокировано;
  • будет сформирована ошибка.

Для определения того, что в клиентском приложении в данный момент запрещено открытие окон, предназначен метод глобального контекста ЗапрещеноОткрытиеФорм().

Запуск внешней обработки, переданной в качестве значения команды /Execute, выполняется после завершения режима пакетного запуска клиентского приложения.

Если во время исполнения методов глобального контекста ЗапуститьПриложения()/НачатьЗапускПриложения() будет обнаружена ошибка времени исполнения, то при работе в пакетном режиме запуска будет сформировано исключение.
5. Регистрация «1С:Предприятия» в качестве OLE-Automation-сервера
/RegServer [-AllUsers | -CurrentUser | -Auto]Выполнить регистрацию объектов «V83.Application» и «V83C.Application». Допустимо использовать один из следующих параметров:

  • -AllUsers ‑ выполняется регистрация для всех пользователей компьютера. Если прав для такой регистрации у пользователя недостаточно, то сообщается об ошибке. Если указан параметр /Out <ИмяФайла>, сообщение выводится в файл, в противном случае ‑ на экран пользователю.
  • -CurrentUser ‑ выполняется регистрация для текущего пользователя.
  • -Auto ‑ выполняется регистрация для всех пользователей компьютера, если есть права и для текущего пользователя, если прав нет, без диалогов.

Если необязательные параметры не указаны, то регистрация выполняется в зависимости от наличия привилегий у пользователя, от чьего имени выполняется регистрация:

  • есть привилегии на регистрацию для всего компьютера ‑ объект регистрируется для компьютера;
  • недостаточно привилегий на регистрацию для всего компьютера ‑ задается вопрос о необходимости выполнении регистрации для текущего пользователя.
/UnregServerОтменить регистрацию объектов V83.Application и V83C.Application.
6. Строка соединения с информационной базой
Строка соединения ‑ строка, задающая параметры информационной базы, каждый из которых представляет собой фрагмент вида <Имя параметра>=<Значение>, где:

  • Имя параметра ‑ имя параметра;
  • Значение ‑ его значение.

Фрагменты отделяются друг от друга символами ;. Если значение содержит пробельные символы, то оно должно быть заключено в двойные кавычки ("). Набор параметров определяется вариантом создаваемой информационной базы ‑ файловый или клиент-серверный. Также существует общий набор параметров, пригодный для любого варианта информационной базы.

Строка соединения указывается в форме списка информационных баз под списком, может быть задана в параметре командной строки выбора режима CREATEINFOBASE, как параметр методов СоздатьНачальныйОбраз().
6.1. Общий набор параметров
UsrУказывает имя пользователя.
PwdУказывает пароль пользователя.
LicDstrУправляет получением клиентских лицензий через сервер 1С:Предприятия. Значение параметра:

  • Y ‑ получать клиентскую лицензию через сервер «1С:Предприятия». Если клиентское приложение не получило программную лицензию или аппаратную лицензию из локального ключа HASP или из сетевого ключа HASP, то производится попытка получения клиентской лицензии через сервер 1С:Предприятия.
  • N ‑ не получать клиентскую лицензию через сервер 1С:Предприятия. Значение по умолчанию.
Z nУстановка значений разделителей прикладного решения.
Подробное описание см. здесь.
prmodУказывает на необходимость выполнить запуск системы в привилегированном режиме (значение параметра равно 1). Запуск разрешен аутентифицированному пользователю, имеющему административные права. Журнал регистрации фиксирует установку или отказ в возможности установки режима привилегированного сеанса.
6.2. Параметры для файлового варианта информационной базы
FileИмя каталога, в котором размещается файл информационной базы
LocaleЯзык (страна), который будет использован при открытии или создании информационной базы. Допустимые значения такие же, как у параметра <Форматная строка> метода Формат(). Параметр Locale задавать не обязательно. Если параметр не задан, то будут использованы региональные установки текущей информационной базы.
DBFormatУказывает формат, в котором будет создаваться база данных в файловом варианте.
Возможные значения: 8.2.14 и 8.3.8.
Значение по умолчанию: 8.2.14.
DBPageSizeУказывает размер страницы создаваемой базы данных в формате 8.3.8 (формат задается параметром DBFormat).
Возможные значения: 4096 или 4k, 8192 или 8k, 16384 или 16k, 32768 или 32k, 65536 или 64k.
Значение по умолчанию: 4096 или 4k.
6.3. Параметры для клиент-серверного варианта информационной базы
SrvrSrvr ‑ имя сервера «1С:Предприятия» в формате: [<протокол>://]<адрес>[:<порт>], где:

  • <протокол> ‑ не обязателен, поддерживается только протокол TCP,
  • <адрес> ‑ имя сервера или IP-адрес сервера в форматах IPv4 или IPv6,
  • <порт> ‑ не обязателен, порт главного менеджера кластера, по умолчанию равен 1541.

Например:

  • server ‑ указано имя сервера, остальные параметры используются по умолчанию;
  • tcp://server:1641 ‑ указан протокол, имя сервера и сетевой порт;
  • 127.0.0.1:1541 ‑ указан IP-адрес сервера (в формате IPv4) и порт;
  • [fe10::c47b:90b7:fa32:a2fa%12] ‑ указан IP-адрес сервера (в формате IPv6), при этом протокол и порт принимают значения по умолчанию.

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

  • Значением параметра Srvr может быть список адресов кластера через запятую. Пробелы в данном списке недопустимы.
  • В диалоге добавления информационной базы в клиентском приложении значением свойства Кластер серверов 1С:Предприятия может быть список адресов кластера через запятую.
RefИмя информационной базы на сервере «1С:Предприятия».
DBMSТип используемого сервера баз данных:

  • MSSQLServer ‑ Microsoft SQL Server;
  • PostgreSQL ‑ PostgreSQL;
  • IBMDB2 ‑ IBM Db2;
  • OracleDatabase ‑ Oracle Database.
DBSrvrИмя сервера баз данных.
DBИмя базы данных в сервере баз данных.
DBUIDИмя пользователя сервера баз данных.
DBPwdПароль пользователя сервера баз данных. Если пароль для пользователя сервера баз данных не задан, то данный параметр можно не указывать.
SQLYOffsСмещение дат, используемое для хранения дат в Microsoft SQL Server. Может принимать значения 0 или 2000. Данный параметр задавать не обязательно. Если не задан, принимается значение 0.
LocaleЯзык (страна), аналогично файловому варианту.
CrSQLDBСоздать базу данных в случае ее отсутствия. Значение параметра:

  • Y ‑ создавать базу данных в случае отсутствия.
  • N ‑ не создавать. Значение по умолчанию.
SchJobDnВ созданной информационной базе запретить выполнение регламентных созданий. Значение параметра:

  • Y ‑ блокировка регламентных заданий включена;
  • N ‑ блокировка регламентных заданий выключена. Значение по умолчанию.
SUsrИмя администратора кластера, в котором должен быть создан начальный образ. Параметр необходимо задавать, если в кластере определены администраторы и для них аутентификация операционной системы не установлена или не подходит;
SPwdПароль администратора кластера.
7. Командная строка веб-клиента
N=<имя>Имя пользователя. Должно быть указано так же, как в списке пользователей информационной базы.
P=<пароль>Пароль пользователя, имя которого указано в параметре N. Если у пользователя нет пароля, этот параметр можно опустить.
WA<режим>Определяет режим использования аутентификации операционной системы при запуске «1С:Предприятие». Если параметр /WA не указывается, то подразумевается, что используется параметр командной строки /WA+.

Пареметр <режим> может принимать следующие значения:

  • "–" ‑ запрет применения аутентификации операционной системы при старте «1С:Предприятия».
  • "+" ‑ установка обязательного применения аутентификации операционной системы при старте «1С:Предприятие».
OIDA<режим>Применение сквозной аутентификации пользователя между разными информационными базами и/или внешними ресурсами для тонкого и веб-клиентов. Если при запуске клиента параметр /OIDA не задан, или задан параметр /OIDA+, то производится попытка аутентификации через OpenID-провайдера, адрес которого задан в файле default.vrd публикации этой информационной базы.

Если OpenID-провайдер требует интерактивной аутентификации (происходит первое обращение или истекло время жизни аутентификационных данных), клиент отображает диалог для ввода имени и пароля пользователя.

Аутентификация происходит по списку пользователей информационной базы OpenID-провайдера.

Аутентифицируемый пользователь информационной базы, использующих OpenID-аутентификацию, должен соответствовать по имени пользователю информационной базы OpenID-провайдера.

Параметр <режим> может принимать следующие значения:

  • "+" ‑ использовать OpenID-аутентификацию (по умолчанию).
  • "–" ‑ не использовать OpenID-аутентификацию.
OidcSelectedProviderПри запуске веб-клиента позволяет указать имя настроенного провайдера OpenID Connect, который будет использован для выполнения аутентификации пользователя.
Описание настройки провайдеров OpenID Connect см. здесь.
AuthoffВыполняет операцию OpenID logout (завершение сеанса работы пользователя). Завершение сеанса работы выполняется вне зависимости от используемого в дальнейшем метода аутентификации.
O=<скорость соединения>Определяет скорость соединения:

  • Normal ‑ обычная,
  • Low ‑ низкая скорость соединения.
C=<строка текста>Передача параметра в прикладное решение.
L=<код языка>Указывается код языка интерфейса платформы. Поддерживаемые языки интерфейса (<код языка>) см. здесь.
VL=<код локализации сеанса>Указывается код локализации сеанса, используемый при форматировании данных типа Число и Дата, а также в методах ЧислоПрописью() и ПредставлениеПериода().
DisableStartupMessagesПодавляет стартовое сообщение Конфигурация базы данных не соответствует сохраненной конфигурации. Продолжить?.
DisableUnrecoverableErrorMessageПозволяет указать специальное поведение при возникновении невосстановимой ошибки (в том числе аварийного завершения):

  • Окно об ошибке показано не будет.
  • Отчет об ошибке будет отправлен, если настроена автоматическая отправка и размер отчета не превышает ограничение на отправку без вопроса о большом размере отчета (5 Мбайт).
  • Вкладка браузера перейдет на пустую страницу (about:blank).

Рекомендуется указывать эту команду, если нужно запустить клиентское приложение в окружении, где не будет пользователя, который отреагирует на сообщение о невосстановимой ошибке.
TechnicalSpecialistModeВключает команду главного меню Функции для технического специалиста.
DisplayPerformanceВключает отображение количества вызовов сервера и объем данных, отправляемых на сервер и принимаемых с сервера.
Debug=[<mode>[,attach]]Указывает протокол отладки (tcp или http) и признак того (attach), что отладчик будет автоматически подключать предметы отладки (клиентский и серверный) запускаемого приложения, которые будут зарегистрированы на сервере отладки. Параметр attach используется только для отладки по протоколу HTTP.

Если команда debug указана без параметра ‑ используется протокол отладки TCP/IP.
DebuggerURL=<URL отладчика>Указание отладчика, к которому приложение сразу после запуска должно подключиться. При отладке по протоколу TCP/IP указывается URL отладчика (протокол, компьютер и номер порта). При отладке по протоколу HTTP указывается URL используемого сервера отладки.
TestClientЗапуск веб-клиента в режиме клиента тестирования. Для идентификации конкретного экземпляра веб-клиента, следует использовать параметр TestClientID.
TestClientID=<Идентификатор>При запуске веб-клиента в режиме клиента тестирования, позволяет менеджеру тестирования различать несколько веб-клиентов по указанному идентификатору. Если значение идентификатора не указано или запущено несколько клиентов с одним и тем же значением, то выбирается произвольный.
UsePrivilegedModeЗапуск веб-клиента в привилегированном режиме. Разрешен аутентифицированному пользователю, имеющему административные права. Журнал регистрации фиксирует установку или отказ в возможности установки режима привилегированного сеанса.
Z=<Общий реквизит 1>,<Общий реквизит 2>,...,<Общий реквизит N>Установка разделителей при запуске клиентского приложения. Подробное описание см. здесь.
itdiИгнорируется. Запуск будет выполнен в режиме интерфейса Такси.
isdiИгнорируется. Запуск будет выполнен в режиме интерфейса Такси.
iTaxiЗапуск в режиме интерфейса Такси.
SYSTEMWEBCLIENTSTATВключение механизма, позволяющего накапливать статистику использования веб-клиента. Механизм предназначен для использования специалистами фирмы «1С».
MainWindowMode=<режим запуска>Позволяет явным образом указать режим запуска основного окна клиентского приложения. Параметр <режим запуска> может принимать одно из следующих значений:

  • Normal ‑ обычный режим запуска.
  • Workplace ‑ режим рабочего места.
  • EmbeddedWorkplace ‑ режим встроенного рабочего места (для встраивания веб-клиента в сторонний сайт).
  • FullscreenWorkplace ‑ режим полноэкранного рабочего места.
  • Kiosk ‑ режим киоск.
ProgressiveWebApplicationName=<название PWA>Позволяет указать наименование прогрессивного веб-приложения, которое можно установить из веб-клиента.

Название прогрессивного веб-приложения также можно задать с помощью файла default.vrd (см. здесь). Подробнее о прогрессивном веб-приложении см. здесь.
DisableHomePageFormsПри открытии веб-клиента запрещает открытие форм начальной страницы прикладного решения.
AccessTokenПозволяет указать JWT-токен для выполнения аутентификации пользователя.
UC=<код доступа>Позволяет выполнить установку соединения с информационной базой, на которую установлена блокировка установки соединений. Если при установке блокировки задан непустой код доступа, то для установки соединения необходимо в параметре UC указать этот код доступа.
#e1cib/system/<stdFuncName>Открытие формы стандартной функции

Навигационная ссылка следующего формата #e1cib/system/<stdFuncName>, указанная в URL запуска веб-клиента, приведет к открытию формы указанной стандартной функции. Данная возможность доступна только при запуске веб-клиента. URL запуска в этом случае может выглядеть следующим образом:

http://localhost/InfoBase/?mainWindowMode=
Workplace&DisableHomePageForms#
e1cib/system/AnalyticsSystemManagement

Поддерживается использование следующих стандартных функций:

  • ActiveUsers - Активные пользователи
  • AdditionalAuthenticationSettings - Дополнительные настройки аутентификации
  • AnalyticsSystemManagement - Управление системой аналитики
  • AuthenticationLocks - Блокировка аутентификации
  • ConfigurationLicense - Лицензирование конфигураций
  • DataBaseCopiesManagement - Управление копиями базы данных
  • DataChangeHistory - История изменения данных
  • DeleteMarkedObjects - Удаление помеченных объектов
  • DocumentsPosting - Проведение документов
  • CollaborationSystemManagement - Управление системой взаимодействия
  • ErrorProcessingSettings - Управление настройками обработки ошибок
  • EventLog - Журнал регистрации
  • EventLogSettings - Настройка журнала регистрации
  • ConfigurationExtensionsManagement - Управление расширениями конфигурации
  • ExternalDataSourcesManagement - Управление внешними источниками данных
  • FindByReference - Поиск ссылок на объекты
  • FullTextSearchManagement - Управление полнотекстовым поиском
  • InfobaseParameters - Параметры информационной базы
  • IntegrationServicesManagment - Управление сервисами интеграции
  • LicenseAcquisition - Получение лицензии
  • MobileAppBuildService - Сервис сборки мобильных приложений
  • MobileAppBuilderServiceLoader - Загрузчик сервиса сборки мобильных приложений
  • InfobaseRegionalSettings - Региональные установки информационной базы
  • TotalsManagement - Управление итогами
  • UserList - Пользователи
  • ServersManagement - Управление серверами

Подробнее о стандартных функциях см. здесь, описание стандартных функций приведено в справке каждой стандартной функции.
8. Командная строка мобильной версии
Мобильная версия «1С:Предприятие» поддерживает указание некоторых команд и параметров, которые можно указать в командной строке запуска клиентских приложений для персонального компьютера.
Далее приведены поддерживаемые команды (список) с указанием того, в каких разделах описываются соответствующие параметры командной строки клиентских приложений для персонального компьютера.

  • /N, /P, /WSN, /WSP, /WSA, /OIDA, /Authoff, /UsePrivilegedMode, /Z, /O: описание см. здесь.
  • /HttpsForceSSLv3, /HttpsForceTLS1_0: описание см. здесь.
  • /L, /VL: описание см. здесь.
  • /ClearCache, /C, /URL: описание см. здесь.
  • /DisableStartupMessages: описание см. здесь.
  • /TestClient, /UILogRecorder: описание см. здесь.


  ...

Как использовать параметры командной строки

В зависимости от параметра и задач параметры командной строки можно использовать несколькими разными способами:  

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

    Дополнительные параметры запуска окне настроек информационной базы 1С:Предприятие

    Окно настроек запуска информационной базы можно открыть нажав на кнопку Изменить в окне запуска 1С:Предприятия со списком информационных баз.

  • Указать в ярлыке запуска "1С:Предприятия" на рабочем столе.
    Таким образом можно задать, например, параметры режима запуска, версии платформы, тип клиента, информационную базу, логин/пароль и большинство других. 

    Дополнительные параметры в ярлыке запуска 1С:Предприятие на рабочем столе

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

  • С помощью команды Выполнить.
    Универсальный вариант, подходит для всех параметров. Окно команды Выполнить можно открыть сочетанием клавиш Win+R.

    Дополнительные параметры запуска 1С:Предприятие с помощью команды Выполнить

  • С помощью командной строки (cmd.exe).
    Универсальный вариант, подходит для всех параметров, но требует определенных навыков от пользователя.

    Дополнительные параметры запуска 1С:Предприятие с помощью командной строки cmd.exe


  • Прописать команду запуска вместе с необходимыми параметрами запуска в bat-файле (или в файле *.cmd).

    Как прописать параметры запуска 1С:Предприятия в батнике


Компания "Онлайн", 2023
www.online-ufa.ru



Ответы на вопросы пользователей (FAQ)

1. Вопрос: У вас в статье везде примеры, как указать файловую базу с помощью параметра "/F", подскажите, как правильно указать путь до клиент-серверной базы с помощью парамтера "/S"?

Ответ: Адрес сервера указываемый в параметре "/S" должен иметь следующий формат "<Имя сервера>\<Ссылочное имя информационной базы на сервере 1С>". Например, если имя сервера "srv1c", имя базы "buh", то командная строка для запуска такой базы в режиме 1С:Предприятие будет выглядеть следующим образом:
"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /S"srv1c\buh"

2. Вопрос: Как на рабочем столе создать ярлык запуска для одной конкретной базы, которая должна быть доступна только мне и не должна отображаться в общем списке баз у других пользователей?

Ответ: Создайте на своем рабочем столе копию существующего ярлыка запуска 1С, потом откройте свойства ярлыка, на закладке "Ярлык" в поле "Объект" после "C:\Program Files\1cv8\common\1cestart.exe" укажите параметр режима запуска и путь к базе. Если база файловая, то в этом поле должно быть: "C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F<Путь к базе данных>.  Опционально можно добавить параметры /N<Имя пользователя> и /P<Пароль>.


3. Вопрос: Можно ли на рабочем столе Windows разместить два ярлыка запуска 1С:Предприятия при нажатии на которые открывались бы два разных списка информационных баз, при этом что бы второй список отображался только под одним пользователем Windows, а другие его не видели?

Ответ: Можно. Второй список баз необходимо будет подготовить вручную в отдельнои файле *.v8i, создать копию ярлыка запуска 1С на рабочем столе, в котором прописать файл со вторым списком с помощью параметра /RunShortcut. 
Пример:

  • "C:\Program Files\1cv8\common\1cestart.exe" /RunShortcut D:\BasesList\Test.v8i

Подробнее, как подготовить файл со списком баз, есть в статье: Управление общими списками информационных баз системы 1С:Предприятие 8


4. Вопрос: Можно ли с помощью параметров командной строки 1С создать bat-файл, который будет сразу запускать нужную базу конфигуратором с указанием имени и пароля пользователя?

Ответ: Можно. Если база файловая, то содержимое bat-файла должно быть примерно следующим: "C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /F<Путь к базе данных> /N<Имя пользователя> /P<Пароль>


5. Вопрос: У вас в статье параметр запуска конфигуратора указан DESIGNER, но в интернете во многих местах встречаю, что режим запуска конфигуратора указывают с помощью параметра CONFIG, который тоже работает.  Хотелось бы разобраться, чем они отличаются.

Ответ: CONFIG - это устаревший параметр, который использовался для запуска конфигуратора в старых версиях платформы 1С:Предприятие 8.0/8.1. Начиная с 8.2 параметр CONFIG заменен на DESIGNER, но в целях обратной совместимости продолжает поддерживаться платформой.




Как оставить отзыв о данной статье

Если данная статья была для Вас полезной, то Вы можете поддержать авторов нашего сайта, оставив свой отзыв. Если у Вас установлен Яндекс.Браузер, то в левом верхнем углу браузера нажмите на кнопку с "замочком" и выберите пункт "Отзывы о сайте".


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

Если же Яндекс.Браузер не установлен, то Вы можете оставить свой отзыв на странице нашей компании в сервисах Яндекс.Бизнес, Google Карты или Flamp.ru.
Подробная инструкция есть здесь.

Ключевые слова

Теги: Параметры командной строки запуска 1С

Возврат к списку

Начать сотрудничать с нами легко

Получить консультацию у менеджера компании “Онлайн” можно по телефону +7 (347) 223-82-28. Звонок бесплатный.

Или воспользуйтесь формой обратной связи.

+7
Яндекс.Метрика