Справка, подсказки и свои мануалы: как устроена помощь пользователю в 1С

Инструкции в 1С — это три разных слоя помощи: встроенная справка платформы и конфигурации (открывается по F1), подсказки у полей формы и собственные регламенты компании, которые пишет бухгалтер, внедренец или программист. Первые два слоя уже есть в типовой программе. Третий создаёте вы, и его можно встроить прямо в интерфейс 1С, чтобы он открывался из нужной формы.

Типичная ситуация: в отдел пришёл новый бухгалтер, а авансовые отчёты у вас проводят по своим правилам — с особыми статьями затрат и обязательным файлом чека. Встроенная справка этого не знает. Нужна своя инструкция, и важно, чтобы её не искали по общей папке, а открывали кнопкой из документа.

Виды инструкций в 1С и чем они различаются

Сначала разложим всё, что пользователь может назвать «инструкцией в 1С». У каждого вида свой автор и своё место.

Справка конфигурации описывает «как задумано». Внешний мануал описывает «как принято у нас». Ошибка многих компаний — пытаться заменить одно другим.

Зачем компании собственные инструкции по 1С

Типовая справка хорошая, но универсальная. Свои инструкции закрывают то, что она закрыть не может. Вот семь практических причин:

1. 🧑‍💼 Ввод новичков. Сотрудник осваивает участок за дни, а не за недели, и меньше отвлекает коллег.
2. 📋 Единые правила учёта. Все заполняют статьи затрат, подразделения и аналитику одинаково — отчёты сходятся.
3. 🔁 Передача участка. Отпуск или увольнение не останавливают закрытие месяца .
4. 🧩 Доработки. Справка типовой конфигурации ничего не знает о ваших дополнительных реквизитах и обработках.
5. 🛡️ Контроль рисков. В инструкции фиксируют, что нельзя делать в рабочей базе: перепроводить закрытый период, удалять помеченные объекты без согласования.
6. 🔍 Проверки и аудит. Описанный порядок работы помогает показать, как формируются данные учёта.
7. ⏱️ Меньше обращений в поддержку. Повторяющиеся вопросы закрывает документ, а не программист.

Встроенная справка 1С: что умеет и где её не хватает

Как открыть справку в программе

• Клавиша F1 в открытой форме показывает справку по этой форме или объекту.
• В главном меню (кнопка с тремя полосками в левом верхнем углу) есть раздел «Справка» с содержанием и поиском по справке.
• У многих полей справа есть значок вопроса или подсказка появляется при наведении курсора.

Справка конфигурации хранится в самой конфигурации. После обновления она обновляется вместе с программой, поэтому описывает актуальный релиз.

Подсказки у полей

Подсказка — короткий текст у конкретного реквизита. Разработчик задаёт её в свойствах элемента формы или реквизита. Способ показа тоже настраивается: всплывающий текст, кнопка с вопросом или строка под полем.

Подсказки хороши для коротких фраз вроде «Укажите дату по первичному документу». Длинный порядок действий в них не помещается.

Ограничения встроенной справки

• ❌ Не знает ваших учётных правил и внутренних регламентов.
• ❌ Не описывает доработки, если их автор не написал справку сам.
• ❌ Объясняет назначение формы, но редко показывает сквозной процесс из нескольких документов.
• ❌ Изменить справку типовой конфигурации напрямую — значит вмешаться в саму конфигурацию, а это усложнит обновления.

Отсюда вывод: встроенную справку не переписывают. Рядом с ней строят свой слой инструкций.

Как написать инструкцию для пользователей 1С по шагам

Ниже порядок, по которому получается инструкция, которой реально пользуются. Пример — регламент «Авансовый отчёт подотчётного лица» в 1С:Бухгалтерии 3.0.

Шаг 1. Определите одну операцию и одного читателя

Одна инструкция — одна задача. «Как оформить авансовый отчёт» — хорошо. «Работа с подотчётом» — слишком широко: внутри окажутся выдача, отчёт, возврат и сверка.

Решите, кто читатель: бухгалтер, кладовщик, менеджер. От этого зависят слова и глубина.

Шаг 2. Пройдите операцию в программе и запишите путь

Пройдите процесс в рабочей программе (лучше в копии базы) и фиксируйте каждый переход. Для авансового отчёта в БП 3.0 путь такой: Банк и касса → Авансовые отчёты.

Указывайте конфигурацию и релиз, на котором делали снимки. Через год интерфейс может измениться, и читатель поймёт, почему картинка не совпадает.

Шаг 3. Сделайте снимки экрана

• 📸 Снимайте окно целиком, а не весь рабочий стол.
• 🔴 Выделяйте рамкой поле или кнопку, о которой идёт речь.
• 🙈 Закрывайте персональные данные: ФИО, ИНН, суммы зарплат, номера карт.

Шаг 4. Добавьте ссылки прямо в программу

Это главный приём практика. Почти любой объект, список или отчёт 1С имеет навигационную ссылку вида e1cib/.... Получить её можно командой «Получить ссылку» в меню формы, а открыть — командой «Перейти по ссылке» из главного меню.

Вставьте такую ссылку в инструкцию рядом с шагом. Пользователь копирует её в 1С и сразу попадает в нужный список, без блуждания по разделам.

Шаг 5. Опишите проверку результата

Инструкция не заканчивается кнопкой «Провести». Добавьте пункт «как убедиться, что всё правильно»: какие проводки должны появиться (кнопка Дт/Кт в документе) или какой отчёт открыть для сверки.

Шаг 6. Дайте прочитать новичку

Отдайте черновик человеку, который операцию не делал. Каждое место, где он остановился и спросил, — пробел в тексте. Две-три такие проверки дают больше, чем любая вычитка.

Шаг 7. Назначьте владельца и дату пересмотра

У инструкции должен быть ответственный. Хорошая привычка — проверять её после каждого крупного обновления конфигурации и указывать в шапке дату последней проверки.

Шаблон структуры инструкции

Чтобы все регламенты выглядели одинаково, заведите единый каркас. Пример для одной операции:

Название операции: Авансовый отчёт подотчётного лица
Конфигурация и релиз: 1С:Бухгалтерия 3.0, релиз на дату проверки
Для кого: бухгалтер по расчётам с подотчётными лицами
Когда выполнять: после сдачи сотрудником чеков, не позднее срока по регламенту
Что нужно заранее: приказ о выдаче под отчёт, чеки и билеты
Шаги: нумерованный список, один шаг — одно действие
Проверка результата: проводки документа, остаток по счёту 71
Частые ошибки: что путают на этом участке
Владелец и дата последней проверки: ФИО, дата

Блок «Когда выполнять» и «Что нужно заранее» новички ценят больше всего: именно там ломается процесс, а не на кнопках.

Как встроить инструкцию в интерфейс 1С

Инструкция, лежащая в сетевой папке, открывается редко. Инструкция, которая открывается из формы документа, работает. Есть несколько способов, от простого к требующему программиста.

Избранное и начальная страница

Самый быстрый вариант. Откройте нужный список или отчёт и добавьте его в избранное (звёздочка в заголовке формы). Внешний документ так не добавить, но можно собрать в избранном все объекты, которые упоминает регламент.

Начальную страницу настраивают через главное меню, раздел «Вид». Туда выносят формы, с которых сотрудник начинает рабочий день.

Присоединённые файлы

Во многих типовых конфигурациях у справочников и документов есть команда присоединения файлов (значок скрепки). Можно приложить PDF-инструкцию к элементу справочника, например к статье затрат «Командировочные расходы». Тот, кто выбирает статью, видит и регламент.

Дополнительная обработка-библиотека

Программист делает внешнюю обработку с формой: список инструкций слева, текст или файл справа. Её подключают через Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки и размещают в нужном разделе. Типовая конфигурация при этом не меняется.

Кнопка в форме через расширение

Самый удобный для пользователя способ. В расширении конфигурации добавляют команду в форму документа. По нажатию команда открывает страницу внутренней вики или файл:

&НаКлиенте
Процедура ОткрытьИнструкцию(Команда)
	ПерейтиПоНавигационнойСсылке("https://wiki.company.local/1c/avansovyj-otchet");
КонецПроцедуры

Расширения поддерживаются с платформы 8.3.6. Они переживают обновление типовой конфигурации, поэтому снимать её с поддержки не нужно.

Справка для собственных доработок

Если в базе есть свои справочники, документы и обработки, у каждого такого объекта в Конфигураторе можно заполнить справочную информацию. Она пишется во встроенном редакторе в формате HTML и открывается по F1 так же, как типовая. Для объектов расширения и внешних обработок справку лучше дублировать во внешнем мануале.

Автоматизация инструкций: обработки, сценарии и видео

Ручная инструкция устаревает с каждым обновлением. Часть работы можно автоматизировать.

Сценарии Vanessa Automation

Vanessa Automation — открытый инструмент для сценарного тестирования 1С. Сценарий описывают текстом на языке Gherkin: «открываю форму», «нажимаю кнопку», «заполняю поле». Тот же сценарий умеет проигрываться с подписями и записываться как видеоинструкция.

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

Список доработок как основа для справки

Программист может выгрузить список собственных объектов конфигурации и расширений. Это готовый перечень того, на что нужны инструкции: всё, чего нет в типовой поставке, справка платформы и конфигурации не опишет.

Напоминания о пересмотре

Даже без программиста можно завести задачу в календаре или в системе заявок: «проверить инструкции после обновления релиза». Простой регламент спасает от инструкций, где описаны давно исчезнувшие кнопки.

Ошибки, из-за которых инструкции не работают

• 🗂️ Ссылки на локальный диск. Путь C:\Инструкции\... есть только на одном компьютере. Храните файлы в общей сетевой папке или на внутреннем портале.
• 🧱 Правка типовой конфигурации ради подсказок. Изменение справки или подсказок прямо в типовых объектах снимает их с поддержки и усложняет каждое обновление. Используйте расширение.
• 🕰️ Нет версии и релиза. Читатель не понимает, почему экран не совпадает со снимком, и бросает инструкцию.
• 📚 Одна огромная «книга». Документ на 80 страниц не читают. Лучше 20 инструкций по одной операции.
• 🔗 Навигационные ссылки из тестовой базы. Ссылка на конкретный документ, скопированная из копии, в рабочей базе не откроется. Ссылки на списки и отчёты переносятся надёжнее.
• 👤 Нет владельца. Инструкцию никто не обновляет, и через год она вредит больше, чем помогает.

Частые вопросы