Установка приложения в 1С

Кратко

Эта статья — для того, кто ставит приложение TehProf.kz прямо в базу 1С: администратора базы клиента или вашего специалиста. Установщик — один файл .epf: он сам подбирает вариант расширения под эту базу, записывает его, проверяет результат и связь с TehProf.kz. После перезапуска 1С в базе появляется раздел «Поддержка TehProf.kz» — в нём вводится код привязки, и дальше база подключается сама. Что Support показывает по подключённой базе и кто в Support это видит — в статье 1С:Предприятие.

Что понадобится

• Установщик — файл TehProfKz-Setup-<версия>.epf. Его скачивает администратор в Support: Настройки → Интеграции → «1С:Предприятие», кнопка «Скачать установщик» — она всегда ведёт на последнюю опубликованную версию. Файл один на все базы, отдельного установщика под каждого клиента нет.
• Код привязки вашей компании — там же, кнопка «Копировать код». Это тот же код, которым к вам привязываются клиенты из Битрикс24. Срока действия у кода нет: он работает, пока его не отключат, и один и тот же код вводится в каждой базе.
• Подходящая база. Готовый вариант есть для «Бухгалтерии для Казахстана» 3.0 — он проверен на базах клиентов; для современных конфигураций на БСП (библиотеке стандартных подсистем) установщик несёт свой вариант. Режим совместимости конфигурации — от 8.3.16 до 8.3.27. Вариант установщик подбирает сам, ничего не записывая в базу. Если не подошёл ни один, установка не начнётся, а итог попросит прислать нам текст из «Техническое» — по нему соберём вариант под эту конфигурацию.
• Права администратора в базе 1С — без них расширение не записать.
• Базу без других пользователей на время записи. Расширение меняет структуру базы, и 1С пишет его только монопольно. Кто ещё работает в базе, установщик покажет сам.
• Выход в интернет к support.tehprof.kz по порту 443 с того компьютера, где выполняется код базы: у файловой базы — компьютер пользователя, у серверной — сервер 1С. Если в клиент-серверной базе включены профили безопасности, администратор кластера разрешает в профиле адрес support.tehprof.kz:443.

Шаг 1. Откройте установщик в нужной базе

Запустите 1С:Предприятие (не Конфигуратор) под администратором и откройте базу, в которую ставите приложение. Главное меню → «Файл» → «Открыть…» → выберите скачанный файл TehProfKz-Setup-….epf. В веб-клиенте браузер предложит выбрать файл на вашем компьютере — это нормально.

Если пункта «Открыть» нет или 1С пишет, что внешние обработки открывать нельзя, — у вашего пользователя нет такого права. Его выдаёт администратор базы (в типовых конфигурациях — «Администрирование» → «Настройки пользователей и прав»).

Вопрос «защиты от опасных действий»

1С спрашивает, открывать ли внешний файл, — так платформа поступает с любым внешним файлом, это не признак проблемы с установщиком. Ответьте «Да». Тот же вопрос может прийти при записи расширения: ответьте «Да» — если после этого 1С просит повторить действие, установщик повторит установку сам.

Шаг 2. Проверьте сведения об этой базе

Откроется окно «TehProf.kz — установка». В блоке «Эта база» — конфигурация, платформа, режим совместимости и адреса, с которыми будет работать приложение, простыми словами; технические подробности свёрнуты под «Техническое». Там же видно, стоит ли приложение в базе и какой версии.

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

Шаг 3. Нажмите главную кнопку

Кнопка называется по тому, что будет сделано:

• «Установить» — приложения в базе нет;
• «Обновить» — в базе стоит более старая версия;
• «Переустановить» — стоит эта же версия.

Более старую версию поверх более новой установщик не поставит и базу не изменит. Перед обновлением он сохраняет копию стоящего расширения файлом Документы\TehProfKz-backup\… (у файловой базы — на компьютере пользователя, у серверной — на сервере 1С). Если запись или проверка сорвались, прежняя версия возвращается сама; копия нужна, только если итог прямо назовёт её путь. Как обновлять и переустанавливать приложение позже — в статье Обновление, удаление и переустановка приложения в 1С.

Шаг 4. Прочитайте итог

Итог собран блоками и одинаков на всех путях:

• заголовок одной фразой: зелёный — получилось, янтарный — получилось, но есть на что обратить внимание, красный — не получилось;
• что с базой — например, «База не изменена» или «Возвращена прежняя версия …»;
• кто в базе — таблицей, если установке мешают другие сеансы;
• что сделать — нумерованными шагами; для базы на хостинге — готовый текст просьбы с номерами сеансов;
• «Техническое (для поддержки)» — свёрнутые подробности: выбранный вариант, копия, перенос настроек, связь, ответ платформы. Если что-то не получилось, пришлите нам этот блок целиком — это быстрее, чем пересказывать словами.

После успешной установки окно показывает «В базе теперь TehProf.kz …», а главной остаётся кнопка «Закрыть»: дальше нужен только перезапуск 1С.

Связь с TehProf.kz установщик проверяет теми же адресами и тем же прокси, с которыми пойдёт приложение. Если в настройках базы остался чужой адрес (например, след тестового стенда), итог будет янтарным и назовёт, какой адрес и куда он ведёт, и шаги, как его поправить в «Дополнительно».

Шаг 5. Перезапустите 1С и привяжите базу

1. Перезапустите 1С и откройте слева раздел «Поддержка TehProf.kz». Роли назначать не нужно: раздел доступен всем пользователям базы.
2. Откроется окно «Подключение к поддержке». Введите код привязки и нажмите «Подключиться».
3. База сразу привязана: окно открывает кабинет с заявками и перепиской, а у базы в Support появляется своя карточка клиента с названием организации и БИН из 1С.
4. Обмен данными для отчёта Support подключает сам, в фоне — без кнопок и дополнительных кодов.

Если кода нет, в том же окне есть «Зарегистрироваться»: откроется регистрация компании в TehProf.kz, а код привязки после неё будет в меню профиля кабинета. Если приложение поставлено в базу вашей же компании, окно так и скажет — «Это база вашей компании» — и предложит обычный вход оператора вместо кабинета клиента.

Как проверить, что всё работает

В Support: Настройки → Интеграции → «1С:Предприятие». Через несколько минут после привязки база появится своей карточкой с точкой «На связи», а отчёт по деньгам — в карточке клиента, раздел «1С», после первой выгрузки данных. Состояния базы и что они значат — в статье 1С:Предприятие.

В самой 1С администратору базы видна ссылка «Дополнительно» внизу окна: там прокси, адреса, обмен данными («Пинг», «Отправить метаданные») и журнал. Остальные пользователи этой ссылки не видят.

Файловая база: когда идёт обмен

У файловой базы регламентные задания выполняет сама 1С, пока в базе открыт хотя бы один сеанс: закрыта 1С — обмена нет до следующего запуска. Ещё в «Дополнительно» есть флажок «Опрашивать, пока форма открыта» — тогда обмен идёт, пока открыта эта форма. У серверной базы обмен идёт по расписанию сам, независимо от того, открыт ли у кого-то сеанс.

Частые проблемы

• «Установка не начата — нет варианта под эту конфигурацию» или «…1С не приняла ни один вариант приложения» — у конфигурации свойства, под которые варианта ещё нет. База не изменена. Скопируйте текст из «Техническое» и пришлите нам — соберём вариант под эту конфигурацию.
• В базе работают другие пользователи — установка не начнётся, пока они не выйдут; итог назовёт их таблицей. Окна веб-клиента на хостинге, закрытые без «Файл → Выход», могут оставлять сеансы, которые сами не закрываются часами: их завершает администратор базы («Активные пользователи») или хостинг — для хостинга итог даёт готовый текст просьбы.
• «Фоновые задания 1С не остановились» — установщик останавливает регламентные задания сам, но иногда 1С запускает их снова. Итог даст шаги по виду базы: для файловой в клиенте — запуск 1С с ключом /AllowExecuteScheduledJobs -Off, для файловой через веб-клиент — выключить задания на веб-сервере (обычно это делает хостинг), для серверной — «Блокировка регламентных заданий» в свойствах базы.
• Нет связи с support.tehprof.kz — приложение установлено, но с этого компьютера или сервера нет доступа к support.tehprof.kz:443. Это не ошибка установки: попросите системного администратора открыть доступ напрямую или через прокси (прокси задаётся в «Дополнительно»).
• Раздел «Поддержка TehProf.kz» не виден — перезапустите 1С: раздел появляется после перезапуска. Если в базе ещё стоит старое расширение «ТехПрофКоннектор», установщик снимает его сам при установке — проверьте список расширений.
• «База уже подключена» — эта база уже привязана с другой установки приложения (например, 1С переустановили начисто). Попросите администратора Support отвязать эту базу (меню «⋯» её карточки → «Отвязать базу…»), затем снова введите код привязки.

Связанные статьи

• 1С:Предприятие — обзор интеграции, состояния базы, отчёт по деньгам, права доступа.
• Обновление, удаление и переустановка приложения в 1С
• Привязка клиента (код подключения)