Командная строка 1С:Розницы: режим ENTERPRISE, ключи, ярлыки и bat-файлы
Содержание
Чтобы запустить 1С:Розницу с параметрами режима enterprise, вызовите исполняемый файл платформы с первым словом ENTERPRISE и ключами базы и пользователя: 1cv8.exe ENTERPRISE /F"D:\Bases\Roznica" /N"Кассир" /P"пароль". Для серверной базы вместо /F пишут /S"имя_сервера\имя_базы". Ту же строку можно вписать в ярлык на рабочем столе, в bat-файл или в задание планировщика Windows.
Командная строка в 1С не зависит от конфигурации: ключи принадлежат платформе 1С:Предприятие 8.3, а Розница лишь добавляет несколько своих параметров через ключ /C (они пришли из Библиотеки стандартных подсистем). Ярлык нужен, когда кассир должен открывать базу одним щелчком без окна выбора баз. Bat-файл — когда запуск надо встроить в сценарий: ночная обработка, блокировка перед обновлением, автозапуск кассы при включении компьютера.
Из чего состоит строка запуска 1С:Розницы
Строка запуска собирается из трёх частей: какой файл запускаем, в каком режиме и с какими ключами.
Исполняемые файлы платформы
| Файл | Где лежит | Когда использовать |
|---|---|---|
1cestart.exe | C:\Program Files\1cv8\common\ | Стартер: сам выбирает версию платформы, подходящую базе |
1cv8.exe | C:\Program Files\1cv8\8.3.xx.xxxx\bin\ | Толстый клиент и Конфигуратор конкретной версии |
1cv8c.exe | там же, в папке bin | Тонкий клиент — обычный режим работы кассира и менеджера |
Розница — конфигурация на управляемых формах, поэтому её штатно открывают тонким клиентом. Для 1cv8c.exe режим ENTERPRISE подразумевается, слово можно не писать. Для 1cv8.exe и 1cestart.exe первое слово задаёт режим: ENTERPRISE — пользовательский режим, DESIGNER — Конфигуратор.
Указывайте полный путь к 1cv8.exe из папки конкретной версии, если на компьютере стоит несколько платформ. Иначе после очередной установки сценарий может уйти в другую версию, и сервер откажет в соединении.
Основные ключи режима ENTERPRISE
| Ключ | Что делает | Пример |
|---|---|---|
/F | Путь к каталогу файловой базы | /F"D:\Bases\Roznica" |
/S | Сервер и имя базы в кластере | /S"srv1c\roznica" |
/WS | Адрес опубликованной на веб-сервере базы | /WS"http://web/roznica" |
/IBName | Имя базы из списка окна запуска | /IBName"Розница магазин 1" |
/N | Имя пользователя 1С | /N"Кассир1" |
/P | Пароль пользователя 1С | /P"12345" |
/WA+ / /WA- | Включить или выключить вход по учётной записи Windows | /WA- |
/UC | Код доступа, когда начало сеансов заблокировано | /UC"0001" |
/C | Строка параметра, которую читает конфигурация | /C"ЗапуститьОбновлениеИнформационнойБазы" |
/Execute | Открыть внешнюю обработку сразу после входа | /Execute"D:\epf\night.epf" |
/DisableStartupMessages | Не показывать предупреждения при старте | — |
/DisableStartupDialogs | Не показывать диалоги, в том числе окно ввода пароля | — |
/ClearCache | Очистить кэш клиента перед входом | — |
/UsePrivilegedMode | Привилегированный сеанс (только для администратора) | — |
Значения с пробелами и кириллицей всегда берите в двойные кавычки. Пробела между ключом и значением нет: /N"Кассир1", а не /N "Кассир1".
Файловая и клиент-серверная Розница: что меняется в команде
Различие сводится к одному ключу. Всё остальное — пользователь, пароль, параметры /C — пишется одинаково.
Файловая база — Розница одного магазина, база лежит в папке на кассе или на общем ресурсе:
"C:\Program Files\1cv8\8.3.24.1342\bin\1cv8c.exe" /F"\\shop-pc\Bases\Roznica" /N"Кассир1" /P"12345"
Клиент-серверная база — центральная база сети магазинов на сервере 1С:
"C:\Program Files\1cv8\8.3.24.1342\bin\1cv8c.exe" /S"srv1c\roznica" /N"Кассир1" /P"12345"
Если менеджер кластера слушает нестандартный порт, его пишут через двоеточие: /S"srv1c:2541\roznica". Для сервера 1С есть ещё одно требование: версия клиента должна совпадать с версией сервера до последней цифры сборки.
| Признак | Файловая | Клиент-серверная |
|---|---|---|
| Ключ базы | /F"путь к папке" | /S"сервер\база" |
| Что указывать | Каталог, где лежит 1Cv8.1CD | Имя базы в кластере, не путь на диске |
| Версия клиента | Любая подходящая версия 8.3 | Строго равна версии сервера |
| Типовая проблема | Нет прав на папку с базой | Порт закрыт брандмауэром, версия не совпала |
Путь в /F — это папка, а не сам файл. Строка /F"D:\Bases\Roznica\1Cv8.1CD" не откроет базу.
Для Розницы, опубликованной на веб-сервере, вместо /F и /S используют /WS с адресом публикации. Логин и пароль передаются так же через /N и /P.
Bat-файл и ярлык: запуск Розницы одним щелчком
Ярлык для кассы
- Щёлкните правой кнопкой по рабочему столу →
Создать → Ярлык. - В поле расположения вставьте строку запуска целиком, с путём к
1cv8c.exeв кавычках. - Назовите ярлык понятно для кассира, например «Касса — магазин на Ленина».
- Проверьте запуск: окно выбора баз появиться не должно, программа сразу открывается под нужным пользователем.
Есть вариант без отдельного ярлыка. В окне запуска 1С выделите базу → Изменить → пройдите мастер до последней страницы. Там есть поле «Дополнительные параметры запуска», куда пишут ключи вроде /DisableStartupMessages или /C. Тогда параметры применяются при каждом входе в эту базу из списка.
Bat-файл
Bat-файл удобнее ярлыка, когда команд несколько или нужен журнал. Минимальный сценарий:
@echo off
chcp 65001 >nul
set V8="C:\Program Files\1cv8\8.3.24.1342\bin\1cv8c.exe"
set IB=/S"srv1c\roznica"
start "" %V8% %IB% /N"Кассир1" /P"12345" /DisableStartupMessages
Команда chcp 65001 переключает консоль в UTF-8: без неё кириллица в имени пользователя превратится в «кракозябры», и 1С ответит, что пользователь не найден. Сам файл тогда сохраняйте в кодировке UTF-8 без BOM. Второй рабочий способ — сохранить bat в кодировке OEM 866 и обойтись без chcp.
start "" запускает 1С и сразу возвращает управление сценарию. Если нужно дождаться закрытия программы — например, чтобы потом скопировать базу, — используйте start "" /wait.
Автозапуск кассы при входе в Windows
Положите ярлык или bat-файл в папку автозагрузки пользователя. Открыть её проще всего так: Win+R → shell:startup. После входа кассира в Windows Розница откроется сама под его учётной записью 1С.
Ключ ENTERPRISE в регламентных сценариях и при обновлении
Самое полезное применение командной строки — обслуживание базы без участия человека. Здесь работают параметры ключа /C, которые понимает Розница.
Завершение и разрешение работы пользователей
Перед обновлением Розницы нужно выгнать всех пользователей и запретить новые входы. Делается это сеансом в режиме ENTERPRISE с параметром блокировки:
"%V8%" ENTERPRISE /S"srv1c\roznica" /N"Администратор" /P"пароль" /C"ЗавершитьРаботуПользователей" /UC"0001"
Программа устанавливает блокировку начала сеансов с кодом 0001, предупреждает пользователей и завершает их сеансы. Дальше администратор входит в базу с тем же кодом /UC"0001" — без кода блокировка не пустит. После работ блокировку снимают командой с параметром /C"РазрешитьРаботуПользователей" и тем же /UC.
Блокировка обрывает работу кассиров. Несохранённые чеки и документы будут потеряны. Запускайте такие сценарии после закрытия смен, а в рабочее время — только предупредив магазины.
Обработчики обновления после смены релиза
После обновления конфигурации в Конфигураторе Розница должна выполнить обработчики обновления данных. Обычно они стартуют при первом входе пользователя, и кассир утром ждёт несколько минут. Чтобы этого не было, выполните их ночью:
"%V8%" ENTERPRISE /S"srv1c\roznica" /N"Администратор" /P"пароль" /C"ЗапуститьОбновлениеИнформационнойБазы" /DisableStartupMessages
Сеанс отработает обработчики и завершится. Полный ночной цикл выглядит так:
- Сеанс ENTERPRISE с
/C"ЗавершитьРаботуПользователей"и кодом/UC. - Выгрузка копии базы в Конфигураторе: режим
DESIGNERс ключом/DumpIB"D:\Backup\roznica.dt"и тем же/UC. - Обновление конфигурации
в режиме
DESIGNER(ключи/UpdateCfgи/UpdateDBCfg). - Сеанс ENTERPRISE с
/C"ЗапуститьОбновлениеИнформационнойБазы". - Сеанс ENTERPRISE с
/C"РазрешитьРаботуПользователей".
Для шагов в режиме DESIGNER добавляйте /Out"D:\Logs\update.log" — туда платформа пишет результат, и утром видно, на каком шаге сценарий споткнулся.
Ночные обработки через /Execute
Ключ /Execute открывает внешнюю обработку
сразу после входа. Так запускают свои регламентные операции: выгрузку остатков в интернет-магазин, перепроведение документов
за день, загрузку цен. Обработка должна сама закрыть сеанс по окончании — иначе 1С останется висеть до утра. Это делают в коде обработки, вызовом ЗавершитьРаботуСистемы(Ложь).
Расписание задаёт планировщик заданий Windows:
schtasks /Create /TN "Roznica_night" /TR "D:\Scripts\night.bat" /SC DAILY /ST 03:00 /RU svc1c /RP *
Учтите настройку безопасности платформы: при открытии внешней обработки в Рознице может появиться предупреждение об опасных действиях. Для служебного пользователя этот запрос отключают в его карточке, в разделе Администрирование → Пользователи и права (флажок защиты от опасных действий).
Что делать, если Розница не стартует с параметрами
Если ничего из списка не подошло, запустите ту же строку вручную из командной строки Windows (cmd). Сообщение 1С покажет на экране, на каком этапе остановился запуск. Отдельно попробуйте ключ /ClearCache: устаревший кэш клиента иногда мешает открыть базу после обновления релиза.
Пароли в командной строке и права пользователя
Пароль в ярлыке или bat-файле хранится открытым текстом. Его видит любой, кто откроет свойства ярлыка. Кроме того, строка запуска с паролем видна в диспетчере задач Windows, если включить колонку «Командная строка».
Как снизить риск:
- 🔐 Вход через Windows. Привяжите пользователя 1С к учётной записи Windows (флажок аутентификации операционной системы в карточке пользователя) и запускайте без
/Nи/P. Ключ/WA+включает этот способ явно. - 👤 Отдельный служебный пользователь. Для ночных сценариев заведите в Рознице пользователя с минимальным набором прав, нужных обработке. Учётную запись «Администратор» в bat-файлы не пишите.
- 📁 Права на папку со скриптами. Сценарии храните в папке, доступ к которой есть только у администратора и служебной учётной записи Windows.
- 🔑 Код
/UC. Не используйте простые коды вроде1: кто знает код, тот войдёт в заблокированную базу. - 🧑💼 Кассир — только кассир. Для автозапуска кассы используйте пользователя с ролями кассира, без доступа к настройкам и администрированию.
Ключ /UsePrivilegedMode для повседневного запуска не нужен. Он даёт сеансу полный доступ к данным в обход ограничений прав и срабатывает только для пользователя с административными правами. Держите его для отладки и разовых служебных операций.