Параметры командной строки 1С

Значение интерфейса командной строки

Разработчики программных продуктов 1С: Предприятие постоянно усовершенствуют интерфейс, создают специальные настройки. «Время - деньги» — фраза хоть и избитая, но для бизнеса не пустой звук. Чем быстрее пользователь запустит 1С, тем больше успеет выполнить производственных заданий.

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

Способы использования параметров командной строки в 1С 8.3

Обычно речь идет о двух вариантах применения параметров:

1. через свойства ярлыка запуска конфигурации 1С;
2. ручной метод прописывания полного пути при отсутствии ярлыков.

Наглядно на изображениях 1 и 2 показаны оба способа.

В первом случае открыта вкладка «Ярлык» в окне «Свойства: 1С: Предприятие». В поле «Объект» прописывают параметры командной строки.

На втором рисунке показано, как прописать полный путь — команду с параметрами командной строки. Делается это в новом текстовом файле, английскими буквами и символами. Когда содержимое сохранится, изменится расширение с TXT на BAT.

Разработчик с помощью раздела «Автозагрузка» может создать автоматизированные рабочие места для пользователей, которые работают постоянно в системе 1С. В данный раздел надо отправить копию «Ярлыка», в котором предварительно настроить параметры. К папке «Автозагрузка» добираются через Пуск – Все программы. После размещения копии «Ярлыка» в «Автозагрузке» при включении ПК сразу запускается система 1С.

Применяя параметры запуска командной строки в системе 1С: Предприятие 8.3, настраивается выгрузка конфигурации, информационной базы, запуск сеанса обмена, выполнение регламентных заданий, внешние обработки. И всё это в автоматическом режиме.

Режим запуска

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

1. ENTERPRISE – для открытия программы в режиме 1С: Предприятие, в формате 1cv8 ENTERPRISE [<параметры запуска>].
2. DESIGNER – для запуска системы в режиме Конфигуратор, в формате 1cv8 DESIGNER [<команды>].
3. CREATEINFOBASE – для запуска системы в режиме создания информационной базы, в формате 1cv8 CREATEINFOBASE <строка соединения>.

Запуск нужной информационной базы происходит после указания адреса расположения базы и других необходимых параметров. А именно:

1. Указание каталога, где хранится файл 1Cv8.1CD, имя файла указывать не нужно. Прописывается так: /F <Каталог информационной базы> (например /F С:\Base1C\Accounting).
2. Указание адреса клиент-серверной информационной базы, хранящейся на сервере 1С: Предприятия. Выглядит примерно следующим образом: /S srv1c\Buh. Здесь srv — имя сервера 1С: Предприятие, Buh — имя информационной базы.
3. URL-адрес информационной базы, опубликованной на веб-сервере, задает параметр /WS <URL информационной базы>.
4. В предлагаемом системой перечне информационных баз находится имя ИБ, требующую запуска. Если одноименных баз в списке несколько, система выдаст ошибку. Параметр записывается в двойных кавычках. Например, так: /IBName "Бухгалтерия предприятия".
5. В качестве параметра командной строки соединения с информационной базой в целом используется /IBConnectionString. В том виде, в котором ее возвращает функция СтрокаСоединенияИнформационнойБазы(). Если /IBConnectionString находится в командной строке раньше, то части строки соединения могут изменяться на ранее существовавшие параметры. Вся строка соединения оформляется кавычками. В случае имеющихся внутренних кавычек они удваиваются.
6. В тонком клиенте можно использовать для настройки элемента списка ИБ параметр /O<скорость соединения>. Обычно по умолчанию его значение /O Normal. Другой пример записи /O Low (низкая скорость).

Параметры для аутентификации

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

Где есть логин, имеется и пароль. Пользователь увидит о нем сообщение после запуска системы, при условии, что такой параметр задан: /P"Parol 991". Его не задают, когда списка пользователей в базе нет, либо логин не указывался.

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

Для аутентификации операционной системы при старте 1С: Предприятие существует команда /WA<режим>. Обязательность применения аутентификации обозначается знаком «плюс». Отрицательный значок «минус» говорит о запрете на аутентификацию ОС при запуске 1С: Предприятие. Выглядит запись так: /WA- или иначе: /WA+.

Как добавить информационную базу в список или создать новую

Платформа 1С предоставляет широкую возможность не просто пользоваться теми базами, которые включены в перечень. Разработчик может создавать новые базы. Следует к пути запуска платформы добавить режим CREATEINFOBASE (он выбирается). Дальше прописывается обязательная СтрокаСоединенияСБазой в форме списка информационных баз под списком. Она задает параметры информационной базы, каждый из которых представляет собой фрагмент вида <Имя параметра>=<Значение>. Символ ; применяется для разделения фрагментов. Значение, содержащее пробельные символы, заключается в двойные кавычки (").

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

Назовем индивидуальные параметры в СтрокеСоединения.

Для файловых ИБ применяют:

• File - имя каталога, в котором размещается файл информационной базы.
• Locale – не обязательный параметр, задающий язык (страну).
• DBFormat - формат для создания базы данных в файловом варианте, по умолчанию его значение 8.2.14. Может также использоваться 8.3.8.
• DBPageSize – указание размера страницы в формате 8.3.8. По умолчанию значение следующее: 4096 или 4k.

Для клиент-серверного варианта информационной базы:

1. Srvr - имя сервера 1С: Предприятие в формате: [<протокол>://]<адрес>[:<порт>]. При использовании нескольких серверов список адресов кластера перечисляется через запятую, без пробелов.
2. Ref - имя информационной базы на сервере.
3. DBSrvr - имя сервера баз данных.
4. DBMS - тип используемого сервера баз данных. По умолчанию указывается MSSQLServer (Microsoft SQL Server). Также могут быть указаны: PostgreSQL; IBMDB2; OracleDatabase.
5. DBUID - имя пользователя сервера баз данных.
6. DBPwd – пароль пользователя.
7. SQLYOffs – параметр для смещения дат, используемого для хранения дат в Microsoft SQL Server. Может принимать значения 0 или 2000. При его не задании (что не является обязательным) учитывается значение 0.
8. CrSQLDB – параметр для создания новой базы данных. По умолчанию применяется значение N, то есть, «не создавать». Если надо создать, указывается Y.

Для запрещения выполнения регламентных заданий активируют параметр SchJobDn. Буквой Y обозначают включение блокировки. Литера N используется для уведомления о выключенной блокировке.

Когда в кластере определены администраторы и для них аутентификация операционной системы не установлена или не подходит, необходимо задать параметр SUsr. Это имя (логин) администратора кластера, в котором должен быть создан начальный образ базы. Пароль к кластерному администратору SPwd.

Дополнительные не означает «неважные»

Разработчики системы создали немало других, на первый взгляд, не обязательных к употреблению «кнопочек». От этой необязательности их значение не уменьшается. Дополнительные параметры в затруднительные минуты облегчают работу на платформе, делая более удобным интерфейс, выискивая нужную информацию из глубин машинной памяти.

1. Вспомогательный параметр для передачи в прикладное решение /C <строка текста>.
2. Для выполнения очистки кеша клиент-серверных вызовов, в котором хранятся метаданные форм, модули, а также сохраненный индекс поиска по текстам модулей, служит команда /ClearCache.
3. Команда /UC <код доступа> позволит выполнить установку соединения с информационной базой, на которую установлена блокировка установки соединений.
4. Благодаря параметру /RunShortcut <имя файла> можно запустить систему 1С: Предприятие со списком информационных баз, который помещен в указанный файл (*.v8i) либо файл ярлыка информационных баз (*.v8l).
5. /Out <имя файла> [-NoTruncate] – в кодировке UTF-8 формируется файл для вывода служебных сообщений. При заданном параметре -NoTruncate (через пробел) файл не очищается (не используется в тонком клиенте). /DisableStartupMessages – с его помощью можно отключить стартовые сообщения по поводу несоответствия конфигурации базы данных сохраненной конфигурации. Или о недостатке возможностей вашего компьютера для редактирования справки по конфигурации, html-документов.
6. /DisableStartupDialogs служит для отключения диалогов аутентификации и вызова стартового диалога. Поддерживается конфигуратором, тонким и толстым клиентскими приложениями.
7. /DisableUnrecoverableErrorMessage рекомендуется, когда требуется запуск приложения при отсутствии пользователя, который смог бы отреагировать адекватно, если произойдет невосстановимая ошибка. Команда регламентирует шаги в случае аварийного завершения и других кризисных ситуациях, приводящих к невосстановимой ошибке. При аварийном завершении дамп сформируется в соответствии с настройками в файле logcfg.xml (в ОС Windows) или настройками операционной системы (в ОС Linux и macOS).

Можно еще отметить ряд параметров, которые пригодятся пользователям. Среди них:

• /itdi - по этой команде включается режим закладок;
• /isdi - существует для открытия отдельного окна.

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

Подобрать необходимую версию платформы для запускаемой базы поможет параметр /AppAutoCheckVersion.

На основе данных информационной базы платформа подберет режим запуска, если задействовать параметр /AppAutoCheckMode.

Быстрая настройка соединения с сервером и ИБ

Клиент-серверная 1С наиболее распространена в бизнесе и государственном секторе. Взаимодействие пользователей с клиентским приложением, кластером серверов 1С и сервером базы данных не всегда протекает «без сучка и задоринки».

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

1. Степень защиты соединения с сервером:
   • /SLev0 – незащищенное соединение;
   • /SLev1 – соединение защищено только в процессе прохождения аутентификации;
   • /SLev2 – полная защита всего сеанса.
2. За запрет на применение прокси, разрешение только ws-соединения отвечает команда /NoProxy.
3. Задание режима сжатия трафика взаимодействия клиентской и серверной частей может происходить тремя способами:
   • None (Выключено);
   • Deflate (http стандарт сжатия);
   • SDC (собственный алгоритм (используется стандартно)).
   Параметр выглядит как /TComp_РежимСжатия.
4. Для определения скорости взаимодействия с тонким клиентом используют параметр /O_СкоростьСоединения. Соответственно в одном из двух возможных значений: Normal, Low.
5. Включение имитации медленного соединения обеспечивает команда /SimulateServerCallDelay_ДопПараметры_. В эту формулу подставляется одна определенная строка или тандем из следующих значений:
   • Call XXXX – задержка ответа с сервера (4,45 с, по умолчанию);
   • Send YYYY – задержка отправки данных на сервер в пересчете на 1 кб, либо по умолчанию это значение 0,45 с;
   • Receive ZZZZ – задержка приема данных на клиент в пересчете на 1 кб, по умолчанию – 0,15 с.

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

Параметры для настройки информационной базы

Если база заблокирована от соединений, пользователь может не расстраиваться и начинать сеанс в 1С. Но не каждый сотрудник, а только тот, у кого разработчик в командной строке 1С: Предприятие 8.3 установил параметр /UC [_КодБазы_]. При установленном коде разрешения (раздел Свойства) именно его прописывают как параметр _КодБазы_.

Для стабильного функционирования системы требуется время от времени запускать тестирование, исправления информационной базы. За эту задачу несет ответственность параметр /IBCheckAndRepair _СтрокаОпций_. Из большого числа опций можно выбрать важные для вас и прописать их в строке, через пробел:

1. ReIndex (переиндексация таблиц);
2. RecalcTotals (пересчет итоговых значений);
3. IBCompression – сжатие таблиц;
4. BadRefClear (очищение ссылок);
5. и другие.

Для тонкого клиента разработана своя «фишка»: /DisplayAllFunctions. Эта команда отвечает за отображение «Все функции». Когда она задействована, пользователь не сможет установить флажок в меню Сервис – Параметры.

Пакетная работа конфигуратора

Пакетный режим запуска — это специальный режим со своими параметрами.

1. /UpdateCfg _имя cf или cfu файла_ служит для запуска обновления конфигурации на поддержке. Используется файл одного из указанных форматов:
   • cf – файл (имя файла с объединяемой конфигурацией);
   • cfu – файл (файл обновления конфигурации).
2. /ManageCfgSupport [-disableSupport [-force]] благодаря данному параметру можно снять конфигурацию с поддержки. Параметр disableSupport указывает на необходимость снять конфигурацию с поддержки. Если этот параметр отсутствует, будет сгенерирована ошибка.
3. /DumpIB _ИмяФайла_ позволяет запустить сеанс выгрузки информационной базы в указанный файл.
4. /RestoreIB _ИмяФайла_ имеет противоположное значение /DumpIB, то есть запускает загрузку базы из файла.
5. /UpdateDBCfg [-WarningsAsErrors] [-Server] – параметр отвечает за обновление конфигурации БД. Параметры в скобках отвечают за восприятие предупреждений как ошибки и выполнение обновления на сервере, соответственно, но могут быть опущены. Параметр с противоположным действием предыдущей команде /RollbackCfg служит для запуска механизма возврата к конфигурации БД и отмене всех изменений.
6. При указании параметра /RunEnterprise, после того как пакетные задания выполнены, запускается в работу система 1С: Предприятие. Это ключ, указав который, можно отмечать параметры для нового сеанса соединения с платформой 1С. При этом не забывать о кавычках для дополнительной командной строки и отдельно об экранировании вложенных кавычек.
7. Пакетная конвертация файлов происходит после запуска конфигуратора со структурой метаданных информационной базы. Параметр /ConvertFiles _ИмяФайлаИлиКаталога_ запускает преобразование информации из файлов заданного каталога. Другие, не заданные для обработки файлы, останутся вне доступа.
8. Параметр /Visible делает исполнение пакетной команды видимым пользователю. Пока работает конфигуратор, открыто окно заставки. При исполнении в режиме агента на экране отображается информационное окно.
9. При установленном параметре /DumpResult <имя файла> можно записать результат работы конфигуратора в файл в виде определенного числа. В случае успешного выполнения команды появится 0 (ноль).

С помощью каких параметров проверяют конфигурацию 1С

Стабильной работе системы 1С: Предприятие способствует соблюдение разумного принципа «доверяй, но проверяй». Проблемы в функционировании любой конфигурации могут возникнуть в любое время. Всегда лучше предупредить, чем потом диагностировать, «лечить» и восстанавливать важные данные. Грамотно выставленные администратором параметры командной строки платформы 1С: Предприятие 8.3 сэкономит много рабочего времени на проверку ПО.

1. Синтаксис проверяют после отдачи команды /CheckModules _Ключи_. При этом указание одного из списка ключей — обязательное условие начала проверки. Ключи для включения конкретного режима проверки:
   • ThinClient – тонкий клиент;
   • WebClient – веб-клиент;
   • Server – сервер 1С;
   • ExternalConnection – внешнее соединение;
   • ThickClientOrdinaryApplication – клиентское приложение.
2. Полная централизованная проверка всей конфигурации запускается по команде /CheckConfig _ДополнительныеПараметры_. К дополнительным параметрам относятся:
   • ConfigLogIntegrity – обыкновенная проверка логической целостности 1С;
   • IncorrectReferences – поиск по всей структуре некорректных и нелогичных ссылок, удаленных объектов;
   • Server - Сервер;
   • Webclient - Веб-клиент;
   • ThinClient - Файловый управляемый режим;
   • ExternalConnection - Внешнее соединение с файловой базой;
   • ExternalConnectionServer - Внешнее соединение с клиент-серверной базой;
   • ThickClientManagedApplication - Файловый толстый управляемый клиент;
   • ThickClientServerManagedApplication - Клиент-серверный толстый управляемый клиент;
   • ThickClientOrdinaryApplication - Файловый толстый клиент;
   • ThickClientServerOrdinaryApplication - Клиент-серверный толстый обычный клиент.
   Установив один из этих дополнительных параметров, запускаете проверку синтаксиса модулей в различных режимах эмуляции.

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

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

1. UnreferenceProcedures – проверка на наличие неиспользуемых не экспортных функций и процедур и обработчиков событий.
2. EmptyHandlers – поиск пустых обработчиков и не содержащих никаких действий.

Запускает выгрузку всех свойств объектов метаданных в указанный каталог команда /DumpConfigFiles _КаталогВыгрузки_. Противоположную функциональную нагрузку несет параметр /LoadConfigFiles _КаталогЗагрузки_. Он отвечает за запуск загрузки из определенного каталога всех свойств объектов метаданных.

Создание файлов обновлений

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

1. /CreateTemplateListFile <имя файла> [-TemplatesSourcePath] используется для создания файла шаблонов конфигураций. Здесь две части:
   • TemplatesSourcePath – задает путь для поиска шаблонов конфигураций. Можно не задавать, а взять путь, установленный в системе в диалоге настроек при запуске.
   • <имя файла> из списка шаблонов приобретенной конфигурации 1С. Если его не указать, применяется имя по умолчанию, как и текущий каталог. При указании полного пути используется данный путь.
2. /CreateDistributivePackage <имя каталога> -File <имя файла описания комплекта поставки> -PackageFileName <имя архива> [-Option <вариант поставки>] [-MakeSetup] [-MakeFiles] [-digisign <имя файла с параметрами лицензирования>] [-WarningAsError]
   По этим параметрам выполняется создание архива с комплектом поставки или файлов комплекта поставки по готовому описанию комплекта поставки. Когда есть выбор между MakeSetup и MakeFiles, используется один из двух. При отсутствии этих параметров используется MakeSetup (создание комплекта поставки, а не файла).
3. /CreateDistributionFiles [-cffile <имя cf-файла>] [-cfufile <имя cfu-файла> [-f <имя cf-файла>|-v <версия дистрибутива>]+] [–digisign <имя файла с параметрами лицензирования>] [-WarningAsError]
   Команда для выполнения создания файлов поставки и обновления. В том случае, если для конфигурации задана подпись мобильного клиента, то перед выполнением команды выполняется проверка того, что установленная подпись соответствует текущим метаданным конфигурации. Если подпись конфигурации не соответствует конфигурации, то формируется диагностическое сообщение, а дальнейшее поведение системы определяется наличием параметра -WarningAsError.

Работа с хранилищем конфигурации

Механизм хранилища широко распахивает окно возможностей для доработчиков конфигураций платформы 1С. Управление механизмом происходит с помощью определенных параметров командной строки. Прежде всего, надо задать каталог хранилища. Путь указывается параметром /ConfigurationRepositoryF <каталог хранилища>.

Для указания имени пользователя хранилища конфигурации используют команду /ConfigurationRepositoryN <имя>. Соответственно, для пароля существует параметр /ConfigurationRepositoryP <пароль>.

Параметр /ConfigurationRepositoryLock [–Objects <имя файла>] [-revised] [-Extension <Имя расширения>] выполняет захват объектов из хранилища конфигурации для редактирования.

Команда по отмене захвата объектов из хранилища выглядит так /ConfigurationRepositoryUnLock [–Objects <имя файла>] [-force] [-Extension <Имя расширения>].

Заключение

Как говорится, «мы легких путей не искали». Но облегчить дальнейшую работу на платформе 1С: Предприятие 8.3 не откажется никто. Особенно, если для этого достаточно запомнить основной набор параметров командной строки 1С 8.3, которые ускоряют запуск системы. Платформа не мучает своих клиентов, заставляя их заучивать наизусть формулы. Правильность их написания всегда можно проверить в интернете.