Как мы отражаем документацию по системе 1С OneNote

14.01.13

Управление ИТ - Стандарты и документация

Опишу наш опыт написания инструкций пользователям по работе в 1С. И какими средствами мы это делали. И на чем собственно мы остановились.

Перед стартом 1С в нашей компании мы создали большой документ о том, как работать в 1С УТ с типовыми документами всем категориям пользователей. По сути это было очень похоже на описание 1С в обычной книжке из коробки 1С УТ. Мы их рассылали по пользователям и отдавали распечатанные версии. В итоге их никто не читал и не интересовался ими. При возникновении вопросов просто звонил и спрашивал что делать.

Наша система часто изменяется и дорабатывается, а также меняются правила работы с ней без изменения кода. Пользователей достаточно много. Одни забывают, другие уходят и приходят, меняются разработчики и ключевые сотрудники. В итоге часто пользователи задают вопросы "как это сделать?" или еще интереснее "А почему так было сделано?". Естественно для ответа на этот вопрос можно полезть в код(если там есть ссылка на задачу или описание) но это оптимально и отнимает время у консультанта/программиста 1С.

Встроенная справка не подходит по следующим причинам:

  • Неудобно редактировать;
  • Для изменения справки нужно изменять конфигурацию;
  • Неудобно вносить справку, не относящуюся напрямую к объектам системы.

Wiki

Был очередной шаг сделать описание системы. Подняли свой сайт на типовом движке. Начали наполнять информацией. Wiki позволяет создать действительно удобную справку со ссылками на другие элементы, удобным поиском, отображает список изменений через RSS, что крайне удобно и позволяет быть в курсе всех изменений другим разработчикам и консультантам. Но система имеет один большой для нас недостаток - это трудозатратность поддержки. Тратится достаточно много усилий на поддержание справки и на ее внесение. Например описание с картинками и разными стилями и таблицами внести в Word поставляет 5 минут, а в Wiki - 20 минут(а может и больше). Необходимо отдельно загружать графические файлы и прописывать на них ссылку.

 

Microsoft OneNote

Интересный продукт. Вначале использовался нашим программистом для своих заметок. Он помещал туда ссылки на базы, инструкции. И мы постепенно начали вносить в нее записи типа расположения серверов, нюансов установки сканеров к 1С, наши внутренние инструкции. А также нюансы объектов в информационной системе 1С.

Мы перешли от сухого языка программистов описания реквизитов и пунктов меню к понятному на бытовом уровне тексту. Объект содержит описание для простого пользователя. Обязательно используем красивые схемы и рисунки там где ими возможно заменить текст. Постепенно стал наблюдать как справка по работе с программой тесто переплетается с регламентами работы внутри подразделений самих пользователей. И очень хорошо что это все было в одном месте.

Пример охраннику на КПП поставлен 1С . И есть ссылка на рабочем столе на страницу с интрукцией, как запустить 1С, как работать с его интерфейсом, куда ему ввести номер машины или ФИО водителя с инструкцией, что ему нужно сделать или сказать если номер машины в системе не найден. Можно брать человека с улицы и сажать за компьютер.

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

Преимущества, которые мы получили при использовании последнего ПО:

  • Редактируется легко, почти как MS Word.
  • Не привязано к конфигурации 1С.
  • Гибкий поиск по словам.
  • Древовидная структура записей с группами разделов. Редактированные недавно разделы выделяются в структуре жирным.
  • Хранится история изменений, можно посмотреть список изменений за интервал времени, а также авторов этих изменений.
  • Можно задать пароль на определенные разделы.
  • Можно разрешить ключевым сотрудника редактировать описание(не только программистам).
  • Можно редактировать через WEB интерфейс, что является плюсом.

Кстати, пользователей мы так и не переубедили работать со справкой самостоятельно, они звонят на тех.поддержку. Но теперь все чаще, вместо консультации мы им отправляем ссылку на статью в OneNote.

Техническая теализация связи со справкой:

Mirosoft OneNote развернут на портале SharePoint, где опубликована ссылка на наш файл OneNote.

В системе создается специальный справочник - Справка по объектам. Например: наименование = "Справочник.Сертификаты" и ссылка на справку.

Создается общая команда "СправкаПоОбъекту", она вызывается из любой формы списка или элемента. При переходе на по этой ссылке в 1С открывается само содержание справки.

 

 

Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».

  • 0% комиссии — оплата напрямую исполнителю;
  • Исполнители любого масштаба — от отдельных специалистов до команд под проект;
  • Прямой обмен контактами между заказчиком и исполнителем;
  • Безопасная сделка — при необходимости;
  • Рейтинги, кейсы и прозрачная система откликов.

См. также

Стандарты и документация 1С:Предприятие 8 1С:ERP Управление предприятием 2 Машиностроение и приборостроение Бесплатно (free)

В связи с тем, что большинство предприятий, на которых мы проводим внедрения, работают с конструкторской документацией, составили краткую справку по подготовке к внедрению «1С:ERP Управление предприятием 2».

20.05.2026    463    0    AiBCifra-1S-ERP-UH    1    

1

Стандарты и документация Бесплатно (free)

Рассказываем, как использовать текст договора в качестве инструмента управления проектом: фиксировать ожидания, этапы работ, сценарии выполнения и возможные изменения. На примере проектов переноса данных 1С показываем, чем они отличаются от проектов внедрения, зачем нужна короткая анкета на старте и как декомпозиция помогает заранее «разложить проект на кирпичики». Объясняем, почему IT-проекты можно оценивать по аналогии со строительством – через понятные виды работ, объемы и нормировки, – а коммерческое предложение стоит делать достаточно подробным, чтобы к нему можно было вернуться при изменении сценария. Отдельно разбираем, как повторяющиеся этапы и фиксация работ по периодам помогают гибко управлять объемом проекта, снижать риски для подрядчика и упрощать согласования на стороне заказчика.

14.05.2026    613    9    primat    0    

2

Стандарты и документация Бесплатно (free)

Безопасная конфигурация в 1С начинается с соблюдения стандартов v8std, которые определяют требования к защите серверного API, работе с внешним кодом, запуску приложений и хранению чувствительных данных. Объясняем ключевые принципы безопасной разработки: от корректного использования признака «Вызов сервера» и безопасного хранения паролей до правил запуска внешних программ, ограничения исполнения произвольного кода и работы с внешними компонентами. Подробный разбор каждого требования показывает, как минимизировать риски и создать конфигурацию, устойчивую к типовым угрозам безопасности.

07.05.2026    2337    0    zeegin    3    

22

Стандарты и документация Коммуникации Россия Бесплатно (free)

Как оценить зрелость команды 1С не по общему чек-листу, а по практикам, которые реально важны для платформы? Собрал модель из 8 направлений — от управления кодом и CI/CD до AI-практик — с конкретными критериями на каждом из пяти уровней. Внутри — открытый инструмент для самооценки.

08.04.2026    1032    0    maraty    10    

3

Управление знаниями в ИТ Стандарты и документация Бесплатно (free)

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

31.03.2026    690    0    monwig    0    

0

Стандарты и документация Бизнес-аналитик Бесплатно (free)

На примере записки по модели RLS в 1С ERP разбираю, что в таком документе уже хорошо, чего не хватает для управленческого решения и как сообщество оценивает качество такой аналитики?

23.03.2026    966    0    EMelihoff    1    

2

Стандарты и документация Бесплатно (free)

В сфере IT-разработки, особенно в экосистеме 1С, где сроки поджимают, а требования меняются каждый день, качественное техническое задание (ТЗ) становится обязательным этапом, который помогает избежать путаницы и неопределенности в проекте. Но что же превращает ТЗ в действительно эффективный инструмент, а не просто формальный документ, который остается без внимания?

12.02.2026    1344    0    AlexeyPROSTO_1C    5    

0

Взгляд со стороны Заказчика Работа с заинтересованными сторонами Стандарты и документация Бесплатно (free)

Статья про то, как выстроить с Заказчиком прозрачные и доверительные отношения на всем пути — от коммерческого предложения до запуска. Покажем, как вовлекать его уже на этапе подготовки КП: делать документ вместе, чтобы было ясно, за что клиент платит и что в итоге получит. Разберем, как сбалансировать загрузку проектных команд и бюджет, выбирая подходы, которые не создают простоев и сохраняют темп. Также расскажем о том, как управлять ожиданиями с помощью стандартизированной документации и понятных результатов по каждому этапу. И, наконец, о том, как зажечь и удержать интерес пользователей.

21.10.2025    1455    0    user1984674    0    

-1
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. romansun 194 11.01.13 21:38 Сейчас в теме
хм.... занятно, спасибо

а в шарепоите что ведете?
6. 91197ch 30 14.01.13 12:03 Сейчас в теме
(1) romansun, на шарапоинте корпоративный портал поднят.
2. pumbaE 13.01.13 10:41 Сейчас в теме
Как быстро документация устаревает, кто следит за актуальностью?
4. 91197ch 30 14.01.13 11:59 Сейчас в теме
(2) pumbaE, как только сотрудник выполняет задачу он получает еще одну задачу - отразить это в документации.
7. pumbaE 15.01.13 17:35 Сейчас в теме
(4) а как программист узнает, что изменение в общем модуле ОбработкаТабличныхЧастей, должно изменить инструкцию например "Как отчитаться поставщику?"
10. 91197ch 30 16.01.13 15:27 Сейчас в теме
(7) pumbaE, я являюсь и архитектором и главным аналитиком, поэтому после выполнения задачи я прошу программистов поправить инструкции.
11. pumbaE 16.01.13 15:52 Сейчас в теме
(10) понятно. У меня, дабы не забыть каждая инструкция привязана к определенной или нескольким подсистемам, когда изменяется объект конфигурации, то для всех вики подсистем (вики страничка с названием подсистемы), в которые входит этот объект добавляется ссылка на задачу. И открыв подсистему, я могу оперативненько сказать, какую инструкцию необходимо изменять из-за решенной этой задачи. Пока это работает в полуручном режиме, но когда добью соответствующий плагин для снегопата и redmine , думаю получиться чуть автоматизировать этот труд и уменьшить список "забытых" инструкций.
3. Yashazz 4922 14.01.13 10:25 Сейчас в теме
Автор, что такое "толмут" в вашем тексте?

Эхма, выложить, что ли, свой вариант решения проблемы...
5. 91197ch 30 14.01.13 12:01 Сейчас в теме
(3) Yashazz, Толмут - конечно исправлю в тексте на большое количество листов
8. KulSer 16.01.13 09:46 Сейчас в теме
(3) Проблема, поднятая автором, для нас действительно актуальна. Так что, если у Вас есть свой вариант, - выкладывайте.
9. Steelvan 317 16.01.13 12:16 Сейчас в теме
Интересная программа, уже нашел видео по ней.
Сам использую MyNotesKeeper - позволяет также работать в древовидном режиме. Плюс генерирует exe книжки.

Только нет истории изменений, это напрягает при написании версий ТЗ.
Попробую эту разобрать.
И по цене вроде не дорого.
12. sikuda 685 18.01.13 09:16 Сейчас в теме
Не совсем понял по требования по ПО:
- Microsoft Office (OneNote) для каждого сотрудника
- SharePoint на одном сервере
Так?
15. 91197ch 30 24.01.13 17:14 Сейчас в теме
(12) sikuda, Да, программу ставим только тем кто редактирует эти статьи. Остальные через Веб доступ с ней работают. Хотя Веб доступ также позволяет редактировать. Но он менее удобен для этого.
13. Steelvan 317 19.01.13 15:21 Сейчас в теме
В общем посмотрел я видео по этой программе.
По сравнению с MyNotesKeeper не нашел преимуществ.
Также можно работать в древовидном режиме, выгружать всю книгу, или ее часть в различные форматы.
От создания книги в формате exe и справки windows, до выгрузки каждой страницы в HTML для создания внутреннего сайта со справкой.

Поддерживается выгрузка в RTF.

Вот нет сравнения, но для сравнения можно выгрузить два документа в RTF и сравнить тем же OpenOffice.

Как плюс, можно изменять иконки в узлах дерева.
Например, для того, что бы использовать при тестировании, типа прошел тест, описанный на этой странице или нет.
14. pumbaE 19.01.13 19:01 Сейчас в теме
(13) Steelvan, посмотри в сторону svn и tortoise , там с ним идут скрипты по вызову сравнения rtf/doc/odt файлов как в openoffice , так и с помощью word . Вот и будет вам история.
16. romansun 194 01.02.13 18:27 Сейчас в теме
Коллеги, а поделитесь, кто в чем еще ведет справочную систему?
17. Yashazz 4922 07.10.13 17:09 Сейчас в теме
Для отправки сообщения требуется регистрация/авторизация