Инструктор. Прототип инструмента создания быстрых пользовательских инструкций

Публикация № 999267

Управление - Пользователю системы

конфигурация инструкции windows скриншоты рисование автоматизация прототип javascript js psr

67
Прототип дружелюбного и эффективного инструмента для написания пользовательских экспресс-инструкций. Задействована штатная утилита Windows, о существовании которой многие не знают и которая умеет делать огромную работу по логированию действий и снятию скриншотов на всех ПК с Windows (начиная с версии Win7). "Инструктор" не требует никакой установки и дополнительных библиотек! Это означает, что инструмент будет работать и на домашнем ПК и на "чужом ноутбуке" и на терминальном win-сервере у заказчика, где ваши права сильно ограничены. Вы просто подключаете легкую файловую базу 1С и получаете инструмент по снятию скриншотов с интересной функциональностью...

Внимание! Прототип "Инструктор" не является готовым инструментом, а лишь демонстрацией возможностей. Для его полноценного использования, требует развития и доработки некоторых обязательных функций.

Тестировался на управляемых формах, на релизах платформы 8.3.11 и выше.

 
 Почему "прототип", а не готовый продукт?

Цель (которая ставилась для конечного инструмента):

  • Сделать дружелюбный инструмент для написания экспресс-инструкций. 
  • Инструмент должен позволять любому, не подкованному в разных утилитах пользователю, не заморачиваясь на сжатие картинок и установку вспомогательных инструментов - делать быстрые инструкции с большим количеством скриншотов. 
  • Время существенно должно экономиться в сравнении с алгоритмами типа “Print Screen -> Paint, Word”, которые, к сожалению, используются начинающими (и не только) специалистами при документировании, обучении пользователей или проработке методологии учета.

Что уже работает в прототипе:

  1. При нажатии кнопки "Rec" в конфигурации 1С, стартует фоновый процесс штатной утилиты PSR (Problem Steps Recorder) встроенной в Windows. Процесс осуществляет детальное логирование действий пользователя.
  2. Логируются все значимые действия в операционной системе (не только в окне 1С), все клики, перетаскивания, ввод текста, запуск программ...
  3. Каждое значимое действие сопровождается текстовым комментарием и скриншотом.
  4. По окончании записи (нажатии кнопки "Stop") - формируется временный MHT-файл (формат MIME HTML). Это делает сама утилита PSR и формат обусловлен её возможностями.
  5. Полученный временный файл разбирается на части, вытаскивается текст по записанным шагам и скриншоты каждого шага.
  6. Запчасти (текстовое описание действия + скриншот) складируются в простейший справочник конфигурации "Инструктор". Вся последовательность шагов записанных за 1 сеанс образует "инструкцию". Инструкции представлены простой группой (папкой) в справочнике. Страницы - соответственно элементами справочника.
  7. Из получившейся инструкции легко удаляются "лишние" шаги (непосредственным удалением). Необходимым для инструкции шагам присваивается имя, корректируется автоматический комментарий к шагу.
  8. На основе обработки с Инфостарта "Рисуем в 1С" от автора Василий Попов, в прототипе накиданы базовые возможности подписать или подрисовать что-либо на скриншотах (средствами js) опять же "внутри 1С".
  9. Рисунки и подписи сохраняются в инструкции.
 
Преимущества подхода
 
Недостатки подхода и текущей версии
 
Что не работает, но хотелось бы видеть в конечном инструменте
67

Скачать файлы

Наименование Файл Версия Размер
Инструктор. Выгрузка базы (DT).
.dt 363,94Kb
15.02.19
22
.dt И.1.0 363,94Kb 22 Скачать
Инструктор. Концепция, критичные и перспективные функции.pdf
.pdf 482,71Kb
15.02.19
11
.pdf К.1.0 482,71Kb 11 Скачать

См. также

Специальные предложения

Лучшие комментарии
8. ROM_NN 68 21.02.19 03:00 Сейчас в теме
Решил тоже запилить видео...
Чтобы было понятнее что делает "Инструктор" и как получается инструкция...
Буду признателен, если те кто скачал уже - поделятся всё-таки размышлениями о применимости и актуальности такого инструмента.
Мыслей много разных по сценариям использования и развитию "Инструктора", но интересен взгляд со стороны.
https://youtu.be/M6XDlYHge2Q
Остальные комментарии
Избранное Подписка Сортировка: Древо
1. Pr-Mex 117 15.02.19 14:29 Сейчас в теме
(0)
Есть и другие утилиты для создания автоинструкций.
Например, в Vanessa-Automation можно автоматически собирать вот такие ролики
https://www.youtube.com/watch?v=JNnmtv_yWI8&feature=youtu.be
Есть канал в телеграмме, где это обсуждают
https://t.me/testspro1c
Designer1C; awk; sorb; Shmell; JohnyDeath; imgrandi89; +6 Ответить
3. ROM_NN 68 15.02.19 14:44 Сейчас в теме
(1)
Vanessa-Automation
безусловно гениальная и актуальная разработка.
Я до того как услышал о ней - подумывал доставать "нормальные" текстовые шаги для "инструктора" через "режим записи журнала действий пользователя"... Но там сложность парсинга тянула на отдельный проект и не стал связываться :)
Имхо, у "Инструктора", если довести до практического использования - немного другое назначение и несколько другой уровень "сложности". Настройка автоматизированного тестирования - не вот уж прям быстрое вхождение в инструмент :)
Если иные пользователи не умеют скриншоты сжимать - какая уж тут настройка клиента и менеджера тестирования.
Повторюсь, Vanessa - безусловно классный инструмент. В рекламе и так не нуждается :)
2. Pr-Mex 117 15.02.19 14:33 Сейчас в теме
(0)
1С плохо "отдаёт" идентификаторы элементов управления (в терминах windows). Надеюсь, что эту особенность платформы поменяют. Помнится какое-то движение в "зазеркалье" под заголовком "улучшение невизуальной доступности" платформы и решений было... Но видимо это никак с аналогичными windows-возможностями не соотносится. Надо развивать и "Инструктор" и платформу 1С в этом вопросе


Начиная с 8.3.12 и дальше в УФ вообще нет индентификаторов элементов форм в терминах windows.
4. ROM_NN 68 15.02.19 14:45 Сейчас в теме
(2) Да, я заметил, что текстовые "расшифровки" после какого-то релиза платформы стали просто никакие :(
Жаль, если это запланированное "развитие" платформы 1С
5. strek_ivan 19.02.19 09:14 Сейчас в теме
Было бы неплохо добавить ещё режим плавной анимации скринов. Так оно "компактнее" для восприятия.
6. ROM_NN 68 19.02.19 10:10 Сейчас в теме
(5) В смысле, вместо последовательности страниц (слайдов) сделать gif-анимацию? Или просто плавные переходы при перещелкивании картинок от одной страницы к другой?
Безусловно, в текущем виде, прототип не очень удобен для просмотра инструкций.
Как минимум вывод во внешние форматы нужен для готовых инструкций.

Но спасибо за мнение!
Вы скачачивали? Всё получилось запустить?

Просто забавно - столько раз скачали и никакой обратной связи... Начинаю ощущать дискомфорт )) Вдруг ничего не работает и все молчат... :)
7. strek_ivan 19.02.19 10:27 Сейчас в теме
(6) плавные переходы, без необходимости щелкать на каждом слайде; ещё не скачивал, поскольку для этого требуются $m, а их временно не хватает :)
8. ROM_NN 68 21.02.19 03:00 Сейчас в теме
Решил тоже запилить видео...
Чтобы было понятнее что делает "Инструктор" и как получается инструкция...
Буду признателен, если те кто скачал уже - поделятся всё-таки размышлениями о применимости и актуальности такого инструмента.
Мыслей много разных по сценариям использования и развитию "Инструктора", но интересен взгляд со стороны.
https://youtu.be/M6XDlYHge2Q
Оставьте свое сообщение