Хранить документы — это только половина задачи. Вторая половина — не терять историю изменений, быстро находить нужный материал и не превращать обновление регламента в ручную рассылку по всем отделам.
В этой статье по шагам разбираем документы в удобном формате, изображения, видео и файлы без лишних действий и копирование и перенос целых разделов, а по ходу собираем выводы, которые можно сразу примерить на свои процессы.
Мы разработали собственный модуль «База знаний» (внутреннее название — «Документация», MDLib) для коробочной версии Битрикс24 и заложили в него не только структуру, но и рабочие механики: версии, поиск, уведомления, API и готовность к работе с ИИ. В этой статье разберём именно их.
Документы в удобном формате
При создании документа можно выбрать один из трёх форматов:
- Markdown — простой синтаксис, редактируется в визуальном редакторе с панелью инструментов. Подходит для большинства инструкций и регламентов, легко переносится между системами и особенно удобен для работы с нейросетями;
- HTML — полнофункциональный редактор для страниц со сложным оформлением, собственной вёрсткой и встроенными элементами;
- BBCode — разметка, привычная тем, кто уже работает со стандартным редактором задач и комментариев Битрикс24.
Помимо текстовых документов, в базе знаний можно хранить интеллект-карты и редактируемые схемы процессов — рядом с инструкцией можно разместить визуальное описание логики работы отдела.
Формат выбирается при создании документа, но материал можно конвертировать, например, из Markdown в HTML. При конвертации создаётся новая версия документа в выбранном формате, а предыдущая редакция сохраняется в истории. В карточке документа всегда видны автор, дата создания и последнего изменения, расположение в структуре, формат и количество просмотров.
Изображения, видео и файлы без лишних действий
Изображение вставляется в документ обычным сочетанием Ctrl+C и Ctrl+V либо через кнопку «Картинка» в редакторе, с возможностью настроить ширину. К документу можно прикреплять изображения, PDF-файлы, презентации, таблицы, видео, архивы и другие рабочие материалы.
Все вложения сохраняются на Битрикс.Диске соответствующей рабочей группы, а не на личном диске автора — благодаря этому файлы остаются доступны участникам группы даже после кадровых изменений. При просмотре документа файлы отображаются в разделе «Вложения»: их можно открыть или скачать, изображения показываются прямо внутри текста, а видео может воспроизводиться во время чтения инструкции.
Копирование и перенос целых разделов
В проектной работе часто используются типовые наборы документов: правила ведения проекта, требования к постановке задач, инструкции по тестированию, шаблоны отчётов. Вместо того чтобы каждый раз собирать структуру заново, можно скопировать отдельный документ или целый раздел в новую рабочую группу, а если документация больше не относится к текущему проекту — перенести её вместе со всей вложенной структурой.
Так база знаний становится конструктором типовых рабочих пространств: при запуске нового проекта можно сразу скопировать готовый комплект правил коммуникации, шаблонов технических заданий и требований к сдаче работ.
Обсуждения непосредственно в документе
Для совместной подготовки регламентов и проектной документации предусмотрены контекстные обсуждения: пользователь выделяет фрагмент текста, создаёт обсуждение и при необходимости упоминает коллегу. Команда отвечает на комментарии, переходит к конкретному обсуждению по ссылке и закрывает его после согласования.
Обсуждение остаётся привязано к конкретному фрагменту документа, поэтому участникам не нужно искать контекст в чатах и переписке — это особенно удобно при подготовке регламентов, технических заданий и Welcome Book.
Полная история изменений
Каждое редактирование создаёт новую версию документа, предыдущие редакции не удаляются и остаются в истории. В панели версий можно:
- увидеть список всех версий и дату каждого изменения;
- определить автора редакции;
- сравнить две версии в формате side-by-side, чтобы быстро понять, какие фрагменты добавлены, изменены или удалены;
- восстановить предыдущую редакцию — при этом она становится новой активной версией, а полная история сохраняется;
- создать новый документ на основе любой сохранённой версии.
Удалённые материалы попадают в корзину: администратор может посмотреть, кто и когда удалил документ, и восстановить его. Для защиты от потери данных предусмотрено автосохранение.
Быстрый поиск по всей базе знаний
Поиск работает как внутри конкретного пространства, так и по всем доступным сотруднику базам. Результаты делятся на две группы (совпадения в названиях документов и совпадения внутри текста), что помогает найти материал, даже если сотрудник не помнит точного названия инструкции.
Дополнительно доступны подборки недавно изменённых и популярных документов — они позволяют быстро вернуться к актуальным материалам и понять, какие инструкции сотрудники используют чаще всего.
Уведомления, которые сотрудники действительно увидят
При создании, изменении или удалении документа можно отправить уведомление в чат рабочей группы, в её ленту или в формате важного сообщения с подтверждением ознакомления. Администратор может настроить шаблоны сообщений и обязательную отправку уведомлений при определённых действиях.
Поскольку рабочая группа уже объединяет нужных сотрудников, вручную выбирать получателей не требуется — при изменении регламента информация сразу попадает в пространство соответствующего отдела или проекта.
Перенос существующей документации
Внедрение новой базы знаний не означает, что все документы придётся создавать заново. Для переноса материалов предусмотрены миграторы из штатного модуля обучения Битрикс24 и базы знаний «Улей», а также развивается импорт из Markdown, HTML, DOCX и других источников.
При импорте большого структурированного документа система может разобрать его заголовки и предложить будущую структуру: какие части превратить в разделы, а какие — в отдельные документы. Это особенно полезно, когда уже накоплены десятки или сотни регламентов и инструкций.
REST API, вложения и вебхуки
Модуль предоставляет REST API для программного доступа к базе знаний. Через API внешние системы могут создавать, изменять, удалять и восстанавливать документы, работать с версиями, получать и загружать вложения, управлять публичными ссылками и использовать другие функции модуля — это позволяет встраивать базу знаний в более сложную корпоративную архитектуру.
Отдельного внимания заслуживает работа с вложениями: метод documentsGetAttachments возвращает список прикреплённых файлов с идентификатором, названием, размером, расширением и ссылками на просмотр и скачивание. Метод documentsUploadAttachment позволяет загрузить новое вложение через multipart/form-data — после загрузки создаётся новая версия документа, поэтому даже изменения из внешней системы остаются в общей истории.
Модуль также отправляет вебхуки при создании, обновлении, удалении и восстановлении документов, что позволяет внешним системам сразу узнавать об изменениях и запускать нужную автоматизацию: публиковать материал на сайте, передавать изменённый регламент ИИ-ассистенту, запускать согласование новой редакции, ставить задачу ответственному сотруднику или синхронизировать документацию между несколькими системами.
Один из перспективных сценариев автоматизации — формирование документации на основе выполненных задач: получить описание задачи и итоговый результат, передать информацию ИИ-модели, подготовить черновик инструкции, создать документ в нужной рабочей группе и отправить его ответственному сотруднику на проверку. Так решение нестандартной задачи не остаётся только в переписке исполнителей, а превращается в повторно используемое корпоративное знание.
База знаний, готовая к работе с искусственным интеллектом
Поддержка Markdown, единая структура, API и вебхуки позволяют использовать документы как проверенный источник информации для ИИ. Корпоративный ассистент сможет отвечать на вопросы сотрудников на основе утверждённых материалов — как оформить отпуск, где найти шаблон договора, как выставить счёт, по каким правилам поставить задачу — вместо того чтобы искать ответ по десяткам разделов вручную.
При этом первоисточником остаётся сама база знаний: если регламент изменился, его достаточно обновить один раз, после этого новая информация становится доступна и пользователям, и связанным ИИ-сервисам.
Куда движется продукт
В план развития модуля входят: интеллектуальный поиск по смыслу и синонимам, единый интерфейс для работы со всеми открытыми обсуждениями, расширенный импорт из Markdown и DOCX, выгрузка документов и разделов в PDF, создание тестов по документам, генерация проверочных вопросов с помощью ИИ, фиксация прохождения обучения, связь регламентов с картами компетенций и периодическая переаттестация сотрудников.
Следующий логичный этап — объединение документации, тестирования и внутреннего контроля качества: для каждого документа или раздела можно будет создать проверочные вопросы, а система будет учитывать, какие материалы сотрудник уже изучил и какие тесты прошёл. Так база знаний сможет стать основой полноценного корпоративного университета внутри Битрикс24.
Итог
Хранилище документов приносит пользу только тогда, когда сотрудники им действительно пользуются — а для этого важны не только права доступа, но и рабочие механики: понятная история изменений, быстрый поиск, уведомления без лишнего шума и возможность автоматизировать рутину через API.
Если вам нужно не просто перенести документы в Битрикс24, а построить вокруг них рабочий процесс с поиском, версиями, автоматизацией и подготовкой к работе с ИИ — напишите нам. Поможем спроектировать решение под задачи вашей компании.
Будем на связи!
🎬 Смотреть: YouTube, VK Видео, RuTube
📡 Не пропустить:
Канал «Интегратор с сапогами» – Пишем о реальной жизни IT-интегратора: факапы, клиенты, CRM, продажи, автоматизация, ИИ, странные задачи и решения, проверенные нервами, деньгами и практикой. Telegram, MAX
Канал «★ 5 УГЛОВ о Битрикс24» – Пишем исключительно о Битрикс24 – про внедрение, развитие и поддержку Битрикс24: практические решения, сложные кейсы, модули и системный подход. Telegram
