Подготовка и обновление веб-ЛК

Инструкция предназначена администратору организации и готовится для веб-ЛК 4.0.34. Пользователю достаточно получить адрес и доступ. Проверенный профиль и ограничения совместимости.

Что подготовить

Нужны опубликованная база УИТ, права администратора 1С и веб-сервера, адреса основного и публичного API одной базы, а также дистрибутив нужной версии. Получите архив через авторизованный кабинет сайта. Если загрузка недоступна, уточните доступ к поддержке. Готовящийся 4.0.34 может ещё отсутствовать среди опубликованных файлов.

Сверьте версию архива и его инструкции. Перед изменением рабочей публикации сохраните файлы кабинета и настройки веб-сервера; сначала проверьте обновление на тестовом стенде.

Опубликуйте кабинет

1. Опубликуйте информационную базу и проверьте основной API.
2. Распакуйте дистрибутив. Скопируйте содержимое app в отдельную папку кабинета.
3. Настройте веб-сервер по инструкции своего дистрибутива. Для IIS нужен отдельный web.config из deploy/iis; для Apache — соответствующая конфигурация из архива.
4. В config.json рядом с index.html укажите адреса своей базы:

{
  "apiUrl": "https://company.ru/base/hs/api/v2/",
  "publicApiUrl": "https://company.ru/base-public/hs/api_public/v2/"
}

Это условные адреса. apiUrl нужен для входа и работы. publicApiUrl — для списка имён и восстановления до входа; он не вычисляется из основного адреса. Оба должны вести в одну информационную базу. В config.json не размещают пароли или токены.

5. Подготовьте отдельную публикацию публичного API по инструкции «Публичный API личного кабинета» из архива. Ей нужен служебный пользователь с ролью «Публичные методы API»; его пароль остаётся в конфигурации сервера. Дополнительные права ему не назначайте.
6. Проверьте HTTPS и доступ с компьютера пользователя. HTTPS-страница должна обращаться к API через HTTPS.
7. Выдайте пользователю адрес страницы кабинета и учётную запись с необходимыми правами.

Обычная схема размещения — кабинет и оба API на одном origin: одинаковые схема, хост и порт. Если они различаются, администратору потребуется настроить CORS и обработку OPTIONS по инструкции публичного API из дистрибутива. Одна лишь доступность адреса API в отдельной вкладке не подтверждает возможность запросов из кабинета.

Подробные схемы размещения и серверные шаги опубликованы для Windows/IIS, Windows/Apache и Ubuntu/Apache. Опубликованные страницы могут отставать от нового архива: сверяйте их с вложенными инструкциями. В частности, наличие отдельной папки kb не является требованием текущей стабильной поставки: база знаний загружается ресурсом сервера.

Проверьте результат

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

Проверка чтения из профиля совместимости не заменяет эти проверки вашей публикации.

Обновите кабинет

1. Сохраните текущую папку кабинета, свой config.json, значок вкладки и настройки веб-сервера.
2. Прочитайте журнал всех пропущенных выпусков, особенно изменения настроек веб-сервера.
3. Замените файлы содержимым нового дистрибутива по его инструкции. Не смешивайте файлы разных выпусков.
4. Примените серверные файлы из нового архива и перенесите свои настройки; верните адреса из сохранённого config.json.
5. Повторите проверки выше и сравните номер ЛК в «Справке» с установленным выпуском.

При проблеме сохраните текст ошибки. Для возврата используйте прежний комплект файлов и настроек. Если одновременно обновлялась база УИТ, её восстановление требует отдельного плана администратора 1С.