К первичной настройке переходите после успешной установки пакета Документооборота в подготовленную BPMSoft. Продукт должен присутствовать в конфигурации. Для новой платформы сначала проверьте доступность страницы входа по HTTPS; проверку публикации с документами и интеграциями выполните после назначения лицензий и прав.
1. Подготовьте учётные записи
- Откройте согласованный HTTPS-адрес. Для новой системы используйте начальные реквизиты из защищённого канала поставки и выполните предусмотренную смену начального пароля.
- Подготовьте именованную административную учётную запись и не менее двух тестовых сотрудников для проверки согласования. Административный доступ и пользовательские сценарии проверяются отдельно.
- Проверьте контакты сотрудников, адреса электронной почты, организационные роли и часовые пояса. Если нужен корпоративный каталог, настройте интеграцию с каталогом пользователей и проверьте сопоставление учётных записей до массового подключения.
- Согласуйте рабочее название организации и выбранный часовой пояс. Задайте канонический HTTPS-адрес в системной настройке SiteUrl по инструкции публикации. Изменяйте необходимые настройки адресно.
Подготовьте двух сотрудников для приёмки
Создайте или выберите две разные обычные учётные записи: инициатор и согласующий. Для новых пользователей сначала создайте/сопоставьте контакты сотрудников, затем откройте в дизайнере системы управление пользователями и добавьте пользователя с нужным контактом, способом входа и активностью. Не создавайте новый контакт, если этот сотрудник уже существует.
Для локальных пользователей задайте временные пароли защищённым способом, выполните первый вход и смену пароля по принятой политике. Для LDAP используйте импортированную запись и правильное сопоставление. Назначьте лицензии обоим сотрудникам и включите их в роль с доступом к рабочему месту. Не добавляйте роль «Системные администраторы».
2. Загрузите и назначьте лицензии
Документооборот лицензируется на уровне пользователя. Наличие пакетов в конфигурации и восстановленная БД не заменяют лицензирование. Для менеджера лицензий нужны права операции Управление лицензиями пользователей (CanManageLicUsers).
- Откройте Дизайнер системы → Пользователи и администрирование → Менеджер лицензий.
- Если файл лицензий ещё не получен, выберите Действия → Запросить, проверьте ID компании и версию, сформируйте и сохраните запрос. Передайте его по предусмотренному каналу поставки: формирование запроса.
- Полученный ответный файл лицензий загрузите через Действия → Загрузить. Проверьте продукт, срок действия и доступное количество.
- Назначьте лицензии подготовленным сотрудникам по инструкции распределения. Затем убедитесь в назначении в карточке каждого контрольного пользователя.
Запросите файл лицензий для своего идентификатора приложения и состава пользователей; в управлении лицензиями используйте «Запросить» и «Загрузить». После загрузки проверьте назначение конкретным сотрудникам. Наличие файла лицензий не подтверждает назначение.
Проверьте назначение лицензий
Откройте управление лицензиями в дизайнере системы. При первом получении используйте «Запросить», передайте запрос по согласованному каналу и загрузите полученный файл через «Загрузить». Файл должен относиться к идентификатору этого приложения. Затем проверьте доступность лицензий платформы и необходимых функций Документооборота и их назначение именно двум выбранным сотрудникам.
Если количество лицензий исчерпано, загрузка файла не означает успешного назначения. Если после смены контакта сотрудник теряет возможность работы, проверьте сопоставление пользователя и получателя лицензии. Продуктовые ограничения не исправляются выдачей административной роли.
3. Проверьте компиляцию
- В согласованное окно обслуживания откройте Дизайнер системы → Конфигурация. Сохраните время начала операции.
- Выберите Компилировать → Перекомпилировать все и дождитесь итогового результата.
- Если используются Angular-модули или продвинутый дизайнер интерфейсов, выполните Действия → Скомпилировать приложение клиентского интерфейса. Дождитесь завершения отдельно от серверной операции.
- Сохраните результат и журнал неуспешного этапа. Проверьте SDK, права, свободное место, память, версии Node/npm и получение зависимостей именно в окружении процесса приложения. После исправления повторите неуспешную операцию.
Серверная компиляция собирает конфигурацию приложения; клиентская нужна используемым Angular-модулям. Обе должны завершаться при штатных сетевых правилах и источниках зависимостей. Окружение и проверки описаны в готовности платформы.
4. Проверьте рабочее место и права
- Предоставьте сотруднику рабочее место Документооборот и доступ к разделу Документы по инструкции настройки рабочего места.
- Если используются соответствующие функции, добавьте в нужное рабочее место разделы Интеграция с Диадок, Настройки Informer и Машиночитаемая доверенность. Они не входят в преднастроенное рабочее место «Документооборот».
- Подготовьте типы документов, обязательные справочные значения и роли для первого сценария. Выдайте сотрудникам права на необходимые записи и действия.
- Войдите под контрольным сотрудником и проверьте открытие раздела. Лицензия, видимость рабочего места и права на конкретные данные проверяются отдельно.
Подготовьте права контрольных сотрудников
Создайте отдельную роль для первого сценария или используйте действующую роль с нужными ограничениями. Добавьте двух контрольных сотрудников в неё и в группы доступа рабочего места «Документооборот». Не используйте роль системного администратора для пользовательской приёмки.
В «Дизайнере системы → Пользователи и администрирование → Права доступа на объекты» откройте объект, проверьте права роли на чтение, добавление и изменение. Если включены права по записям или колонкам, проверьте их отдельно: права на операцию сами по себе не открывают нужную запись. Проверяйте итог под контрольным сотрудником.
| Участник или объект | Доступ для первого сценария |
|---|---|
Инициатор — «Документы» (Document) |
Создание, чтение и изменение контрольного документа. Удаление для проверки не требуется. |
«Файлы документа» (DocumentFile) и используемые объекты версий |
Добавление и чтение вложения, изменение при выбранном сценарии редактирования. Если действует доступ по записям, проверьте его отдельно от прав на операции. |
| Согласующий — документ и вложение | Чтение именно переданного ему контрольного документа и файла. |
Активности (Activity) |
Чтение и изменение назначенной согласующему задачи. Для ручного создания задач дополнительно требуется создание. |
| Запуск маршрута | Право на запуск по правилам продукта; для назначаемого разрешения используется системная операция CanStartApproval. Проверьте также доступ к объекту «Согласующее лицо/отдел» по инструкции запуска. |
При ограничении доступа по записям назначьте права на контрольный документ и связанные данные нужным участникам. Не открывайте все документы всем сотрудникам для прохождения проверки. После изменения ролей и прав повторно войдите под обоими сотрудниками, проверьте доступ к контрольному документу и отсутствие доступа к постороннему закрытому документу.
5. Подключите функции выбранного сценария
Начните с рабочего хранилища для первого документа. Используйте вариант, принятый для этой установки; для новой поставки с хранением в БД сохраните этот выбор до проверки базового сценария. Одна настройка внешней папки не определяет состояние всех подключаемых хранилищ: проверьте также активное хранилище и его параметры.
| Задача | Где настроить | Что принять |
|---|---|---|
| Хранение вложений | Карта компонентов; Nextcloud, S3, внешняя папка. | Новое вложение сохраняется в выбранное хранилище, скачивается и открывается. Ограничения поиска и редактирования учтены. |
| Редактирование | Онлайн-редакторы; Informer и Word. | Изменение сохраняется, новая версия доступна при повторном открытии и скачивании из BPMSoft. |
| Почта и согласование письмом | Настройка почты; согласование по email. | Пройдены отправка, приём ответа и предусмотренная обработка решения. Для ссылки проверен правильный HTTPS-адрес. |
| Поиск | Полнотекстовый поиск. | После индексации находится известная фраза из контрольного файла поддерживаемого формата. |
| Нумерация | Настройка нумерации. | В выбранной колонке формируется номер с нужной маской и условиями. |
| Подпись и ЭДО | Электронная подпись; Диадок. | Пройдены отдельные сценарии подписи и согласованного обмена. |
Настройку рассылок и действий, отправляющих документы наружу, проверяйте на согласованных тестовых получателях. Значение IsNeedToEmailNotification не используйте как общий выключатель всех исходящих сообщений: правила продуктовых уведомлений настраиваются по инструкции почтового подключения и связанным статьям.
6. Создайте первый документ
- Войдите под сотрудником с назначенной лицензией. Откройте раздел Документы и нажмите Добавить Документ.
- Заполните и сохраните мини-карточку по статье «Регистрация документа из раздела». Для различимости используйте название «Проверка установки». Заполните обязательные поля конфигурации; в стандартной карточке документа указывается контрагент или контакт.
- В карточке на детали Файлы и ссылки добавьте небольшой контрольный DOCX или PDF по статье «Работа с файлами».
- Закройте карточку и снова откройте её из реестра. Убедитесь, что данные и вложение сохранены. Измените один реквизит и повторите проверку.
- Скачайте вложение и сравните с исходным файлом. Если настроен редактор, внесите различимое изменение, сохраните его и повторно откройте файл из BPMSoft. Проверьте новую версию и независимо скачайте результат.
- Проверьте согласование на втором контрольном сотруднике:
- Сделайте инициатора ответственным по контрольному документу. Проверьте право запуска, доступ к вложению и настройки маршрута.
- Откройте Отправить по маршруту. Для классического режима добавьте контакт второго сотрудника, порядок 1, тип Согласование и срок в рабочих часах; запустите маршрут по пошаговой инструкции.
- Если включён визуальный режим
SmrIsNewRouteEnable, используйте визуальный редактор; не переключайте режим ради теста и не меняйте действующие маршруты. - Войдите вторым сотрудником, откройте назначенную задачу, документ и файл, выполните положительное решение по статье «Движение маршрута».
- Вернитесь к документу под инициатором. Убедитесь, что задача завершена, результат отражён в истории и состояние соответствует выбранному маршруту.
| Контроль | Ожидаемый результат |
|---|---|
| Доступ | Рабочее место, раздел и необходимые действия доступны пользователю со штатными правами. |
| Данные | Сохранённые реквизиты и изменения видны после повторного открытия карточки. |
| Вложения | Новое вложение загружается и скачивается с ожидаемым содержимым; для внешнего хранилища подтверждено место его хранения. |
| Подключённый редактор | Сохранённое изменение и новая версия доступны после закрытия и повторного открытия. |
| Нумерация и маршрут | Номер соответствует принятой настройке; шаг согласования завершён и отражён в истории. |
| Браузер | Нет неуспешных загрузок нужных динамических JavaScript-модулей; используемые WebSocket-соединения устанавливаются. |
| Дополнительные функции | Для почты, поиска, подписи и Диадока пройдены их отдельные проверки. |
Контрольный сценарий регистрации и вложения
- Войдите инициатором, откройте «Документы» и создайте новый контрольный документ с различимым названием. Заполните обязательные поля, сохраните карточку.
- Закройте карточку и найдите её в реестре под тем же сотрудником. Проверьте, что обязательные значения и ответственный сохранились.
- Добавьте небольшой тестовый DOCX в «Файлы и ссылки». Дождитесь окончания загрузки, затем скачайте файл и откройте его локально.
- Если используется нумерация, проверьте номер, маску и отсутствие конфликта со вторым новым документом. Не изменяйте рабочие счётчики для получения красивого тестового номера.
- Проверьте, что согласующий может открыть именно переданный документ и вложение, но не видит отдельный закрытый документ, к которому ему не выдавался доступ.
Файл после скачивания должен содержать ожидаемые данные. Запись в детали без скачиваемого содержимого не подтверждает готовность хранилища.
7. Проверьте повторный запуск и сохраните результат
Для on-site после компиляции выполните согласованный перезапуск приложения и повторите вход, открытие карточки и проверку вложения. На новом выделенном сервере в окно приёмки выполните также перезагрузку ОС: службы должны запуститься штатно, а адреса, сертификаты, права и настройки должны сохраниться. Для обслуживаемой среды согласуйте эти действия с её администратором.
Завершите функциональную проверку HTTPS-публикации с подготовленным пользователем и документом. Для контейнерных интеграций проверка после пересоздания выполняется по инструкции конкретного сервиса. Сохранённые настройки DNS, доверия CA, JWT и хранилищ должны обеспечивать тот же пользовательский результат.
Запишите версии продукта и платформы, выбранные компоненты, номера контрольных записей, результаты компиляции и проверок. Настройте резервирование БД, приложения, конфигурации, внешних файлов и необходимых ключей; проверьте восстановление в отдельной среде. После успешной приёмки возобновите обычную работу.
Таблица результата приёмки
| Проверка | Успех | При отклонении |
|---|---|---|
| Вход обычного сотрудника | Нет отказа лицензии или роли | Пользователь, контакт, активность, лицензии |
| Создание документа | Карточка сохранена и повторно открыта | Обязательные поля, права операций и записи |
| Вложение | Скачивается исходный файл | Хранилище, права службы и файла, лимиты |
| Задача согласующего | Открывается задача, документ и файл | Назначение, роль, права связанных данных |
| Решение | Задача завершена, результат в истории | Текущий этап, настройки маршрута, ошибки процесса |
| Закрытый документ | Недоступен постороннему сотруднику | Прямые права, наследование и остальные роли |
Запишите, какая учётная запись выполняла проверку. Проверка Supervisor не заменяет ни один пользовательский пункт. После успеха подключайте почту, каталог, редакторы и дополнительные хранилища по необходимости, каждое со своей приёмкой.
Если проверка не проходит
| Симптом | Что проверить |
|---|---|
| Ошибка установки пакетов | Назначение архива, зависимости, исходную компиляцию и права приложения на свои каталоги. |
| Ошибка серверной или клиентской компиляции | Версии SDK/Node/npm, эффективные источники зависимостей, права служебной учётной записи, место и пик памяти. Сохранить первый относящийся к ошибке журнал. |
| Нет рабочего места или действия | Лицензию, доступ к рабочему месту, разделу, операции и конкретной записи. |
| Вложение не загружается либо не скачивается | Активное хранилище, его доступность и права, лимиты загрузки в proxy и приложении. |
| Файл скачивается, но не работает просмотр, редактор или поиск | Поддержку операции выбранным хранилищем и отдельную настройку сервиса. |
| Страница пустая или есть ошибки Dynamic JS/WebSocket | Завершение компиляции, доступность ресурсов, HTTPS, proxy и ошибочные запросы в браузере. |
| Ошибка появляется после перезапуска | Постоянную конфигурацию службы, подключение файлов настроек, доступ к каталогам и сохранность настроек внешних сервисов. |
Для поддержки укажите шаг, ожидаемый и фактический результат, время, версии компонентов и идентификатор контрольной записи. Приложите относящиеся к ошибке журналы без секретов и рабочих документов. Согласовывайте повторные операции с БД и миграциями по процедуре полученного комплекта.