- Где скачать Снегопат?
- Устанавливаем Снегопат
- Решения проблем, возникающих при установке и запуске Снегопата
- Запускаем Конфигуратор со Снегопатом
- Вместо заключения: Где найти информацию о других возможностях Снегопата?
Где скачать Снегопат?
Триал-версия Снегопата предоставляет доступ ко всем его функциям без каких-либо ограничений на 3 месяца. Ссылка на триальную версию Снегопата размещена в списке файлов в публикации Снегопат - расширение Конфигуратора 8.2/8.3 от orefkov.
Нажимаем "Скачать бесплатно" и затем для получения ссылки на скачивание указываем свой email:
Обязательно указывайте реальную почту, к которой у вас есть доступ: на этот адрес будет выслано письмо со ссылкой для скачивания.
Письмо приходит практически мгновенно. Если по какой-то причине письмо во Входящих не обнаружите, проверьте на всякий случай папку со спамом.
Чтобы наконец-то скачать заветный файл, нужно перейти по ссылке из полученного письма.
Устанавливаем Снегопат
Распаковываем архив со Снегопатом
После того, как вы скачаете архив, распакуйте его в какой-нибудь каталог вашей файловой системы, откуда вам удобно будет его запускать. Я создал каталог SnegopatTrial в папке Документы моей домашней директории и распаковал содержимое скачанного архива Снегопата туда:
Запускаем Снегопат первый раз и проверяем настройки базы
Теперь в папке, куда мы распаковали наш Снегопат (у меня это C:\Users\kuntashov\Документы\SnegopatTrial), переходим в каталог core. В нем расположен "запускатель" Снегопата - исполняемый файл starter.exe.
Запускаем стартер двойным кликом. Откроется стандартное окно запуска 1С:
Снегопат работает в режиме Конфигуратора, поэтому для продолжения установки нам нужно открыть из этого списка в конфигураторе любую базу — или существующую, или добавить новую, например, пустую, как у меня.
Снегопат на текущий момент поддерживает только 32-битные версии платформы, поэтому убедитесь, что в свойствах базы у вас выбрана именно эта разрядность:
Установили разрядность 32 бита? Тогда открываем базу в Конфигураторе.
Получаем ключ и активируем Снегопат
Перед тем, как конфигуратор откроется, вы увидите окно активации Снегопата:
По кнопке "Перейти на infostart.ru для получения ключа" или напрямую по ссылке //infostart.ru/profile/snegopat/ открываем в браузере страницу получения ключей активации.
На этой странице нажимаем кнопку "Сгенерировать ключ":
Полученный ключ вставляем в окно активации Снегопата:
В результате успешной активации вы увидите окно с информацией о начале получения файлов Снегопата. В окне нажимаем ОК:
Настраиваем подключение (прокси-сервер)
Сразу после ввода ключа активации скрипт установки Снегопата проверит доступность сайта snegopat.ru и откроет окно настройки прокси-сервера:
Для получения файлов скриптов, установщику требуется доступ к сайту snegopat.ru. Если snegopat.ru доступен, как на моем скриншоте, то никаких настроек прокси делать не нужно.
Если же вы используете прокси, то скорее всего вы знаете, какие настройки нужно указать, поэтому на их описании останавливаться специально не будем.
Независимо от того, есть ли у вас прокси или нет, в этом окне мы нажимаем "Сохранить". Перед тем, как начать установку скриптов, Снегопат предупредит нас, что после окончания установки обязательно нужно перезапустить конфигуратор:
Нажимаем ОК, после чего откроется консольное окно скрипта-установщика.
Получаем логин и пароль
В открывшемся консольном окне установщика Снегопата вы увидите свой логин и пароль на сайте snegopat.ru:
На всякий случай запишите их в ваш любимый менеджер паролей или на стикер с паролями, наклеенном на вашем мониторе (шутка).
Для тех, кто все-таки (надеюсь) заморачивается с вопросами информационной безопасности, то имейте в виду, что логин и пароль вам придут на почту, указанную в профиле Инфостарта, и при желании этот пароль вы можете изменить.
После изменения пароля на сайте snegopat.ru запустите скрипт
get_latest.cmdиз папкиcore\tools, введите новый пароль и на вопрос о необходимости сохранить эти данные ответьтеY.
Далее нужно ввести Y и нажать Enter, чтобы установщик запомнил этот пароль и вам не требовалось его вводить при каждом обновлении Снегопата и его скриптов.
В результате начнется загрузка и затем установка скриптов из комплекта поставки Снегопата. По окончании вы увидите в консоли предложение нажать любую клавишу, что сигнализирует об успешном завершении установки:
Решения проблем, возникающих при установке и запуске Снегопата
В некоторых случаях при установке Снегопата возникают проблемы. Чаще всего они единичны и зависят от конкретного окружения, но некоторые ошибки все-таки повторяются. В этом разделе опишу известные проблемы и их решения.
Ошибка "Identifier 'LOGFONT' is not a data type in global namespace"
При попытке установить триальную версию, запроса о настройках прокси не выдается, а просто запускается конфигуратор. При повторном запуске starter.exe выдается простыня ошибок вида:
--- Ошибка ---
AngelScript: file System function, line: 1, col: 22
Identifier 'LOGFONT' is not a data type in global namespace
Для устранения этой проблемы нужно удалить папку repo, которая появилась в корне папки, куда вы распаковали архив со Снегопатом, откройте в этой папке командную строку и выполните в ней команду
core\tools\get_trial.cmd Логин Пароль
где Логин - ваш логин из письма, которое вы получили после ввода ключа активации, а Пароль, соответственно, ваш пароль.
Запускаем Конфигуратор со Снегопатом
Чтобы Снегопат заработал в конфигураторе, запуск 1С нужно выполнять при помощи приложения starter.exe из поставки Снегопата, с которым мы уже знакомы. starter.exe расположен в подкаталоге core каталога установки Снегопата:
При запуске Снегопата откроется, как мы уже видели, стандартный список информационных баз.
Уже на старте конфигурации можно увидеть, успешно ли запустился Снегопат или нет: в случае успешного "запуска" движка Снегопата внизу сплеш-скрина 1С можно увидеть информацию о Снегопате и владельце данного экземпляра Снегопата:
С чего начать знакомство со Снегопатом?
После запуска конфигуратора при помощи стартера, в конфигураторе откроется главное окно Снегопата.
Это своего рода центр управления всеми скриптами/аддинами, хоткеями. Здесь же можно прочитать подробную справку по использованию скриптов и API.
Если вы закрыли это окно, то чтобы снова открыть, нажмите комбинацию клавиш
Ctrl+Shift+M.
Ниже я постараюсь в формате обзора рассказать, с чего начать использовать Снегопат. Это не будет исчерпывающим руководством, а только подсказкой по ключевым функциям, которые можно начать использовать "здесь и сейчас", интуитивно, без предварительной подготовки и не вникая в особенности их работы.
Справочная система Снегопата
Если вы еще не знакомы со Снегопатом, то первым делом рекомендую прочитать раздел "Начало работы со Снегопатом" встроенной справки, чтобы познакомиться с терминологией и основными функциями, которые реализованы в Снегопате.
Отдетльно отмечу, что в этой же справке можно найти описание API движка Снегопата (SnegAPI), которое можно использовать при разработке своих скриптов:
Вызов макросов
Весь функционал Снегопата реализован при помощи "аддинов" (addins) — скриптов и плагинов, которые реализуют какие-то полезные функции. Некоторые такие функции работают незаметно и не требуют явного вызова.
Например, скрипт "Автоподключение к хранилищу" перехватывает штатное окно авторизации в хранилище и автоматически за вас вводит логин и пароль, которые вы укажете при первом подключении.
Другие функции требуют интерактивного вызова. Такие функции в терминах Снегопата называются "макросы".
Список всех доступных макросов открывается при помощи комбинации клавиш Ctrl+M:
Новичкам обычно удобнее искать нужный макрос просматривая дерево скриптов и ориентируясь на их название.
Опытные же пользователи могут использовать быстрый поиск макроса по имени, вводя название в поле ввода в верхней части списка макросов. Поддерживается нечеткий поиск, и это позволяет искать даже не помня точно название макроса. Например, я пишу "сд вл" и получаю:
Хоткеи
Макросам, которые вы используете часто, лучше всего назначить горячие клавиши. Это делается в главном окне Снегопата (Ctrl + Shift + M) на странице "Хоткеи":
Здесь вы можете изучить уже назначенные комбинации клавиш, переназначить их или добавить свои для вызова любого макроса.
Обратите внимание, что здесь же можно изменить стандартные хоткеи конфигуратора или даже назначить хоткей на штатную команду конфигуратора, для которой разработчики 1С забыли это сделать.
Например, стандартная команда конфигуратора "Отладка - Отключить/включить все точки останова" не имеет назначенного ей хоткея. Я при помощи Снегопата назначил этой команде комбинацию Ctrl+Shift+D и теперь могу временно отключать/включать точки останова не залезая в меню.
После редактирования списка хоткеев нужно нажать кнопку "Применить", иначе ваши изменения не сохранятся.
Клавиатура в редакторе модулей
Основная боль разработчиков 1С, кто программирует на русскоязычной версии встроенного языка, заключается в том, что над ними смеются даже разработчики на PHP в необходимости переключаться на английскую раскладку для ввода многих специальных символов, таких как <, >, & и т.п., если не использовать какие-либо ухищрения в виде специальных шаблонов или раскладки Павла Чистова.
Снегопат из коробки поддеживает удобный способ ввода нужных символов без переключения раскладки с использованием клавиши Alt:
полный перечень комбинаций можно подсмотреть в списке хоткеев, о котором я рассказал в предыдущем абзаце.
В дополнение к этому Снегопат умеет автоматически разворачивать сокращенные конструкции инкремента/декремента, например, конструкция "A++" автоматически при наборе развернется в А = А + 1, а при вводе А += вы автоматически получите А = А +.
Улучшенная навигация в конфигураторе
Быстрая навигация по метаданным — одна из самых часто используемых мной функций Снегопата. Этот функционал реализован скриптом "Навигатор по метаданным". Окно для перехода к объекту метаданных по умолчанию открывается комбинацией клавиш Ctrl+~.
В открывшемся окне вводим части имени метаданных. Здесь, как и почти везде в полях ввода строки поиска, также работает нечеткий поиск. В результате получаем список подходящих объектов:
Кроме навигации по дереву метаданных данный скрипт позволяет открывать окно редактирования объекта метаданных, модули объектов без перехода в дерево конфигурации, захватывать отфильтрованные в этом списке объекты. Попробуйте — очень удобно!
На всякий случай напомню: если вы перешли к объекту метаданных и хотите вернуться в исходную точку, нажмите
Ctrl + -.
Расширенный поиск
В конфигураторе 1С относительно неплохой пользовательский интерфейс для глобального поиска, который выводит результаты в окно. Это позволяет перемещаться между резултатами поиска в произвольном порядке.
А вот поиск в пределах одного модуля позволяет только последовательную навигацию вперед (F3) или назад (Shift + F3) от результата к результату, и это очень неудобно, особено в больших модулях.
Скрипт "Расширенный поиск" призван устранить этот недостаток: он результаты поиска даже в пределах одного модуля выводит в окно, при этому умеет группировать их по процедурам и функциям и делает переход к нужному результату более удобным:
Кроме того, "Расширенный поиск" умеет: - искать в пределах текущего модуля, только среди открытых модулей или глобально по всей конфигурации - выполнять поиск регулярными выражениями - выполнять глобальный поиск в фоне (!)
Анализ модуля при помощи BSL Language Server
С помощью скрипта "Анализ модуля" вы можете выполнить проверку кода модуля при помощи BSL Language Server и результаты этой проверки будут выведены в окно в конфигураторе.
При первом запуске макроса "Расширенный анализ текущего модуля" он попрсит вас указать полный путь к исполняемому файлу bsl-language-server.exe. Если у вас BSL Language Server еще не был установлен, то скачайте архив последней версии со страницы релизов проекта.
Скачанный архив BSL Language Server нужно распаковать в каталог, полный путь к которому не содержит кириллицы, иначе "Анализ модуля" не заработает. В частности, не размещайте BSL в подкаталоге вашей домашней директории, если имя вашего пользователя на кириллице. Например. Неправильный путь:
C:\Users\ИвановИИ\BSLLanguageServer. Правильный путь:C:\BSLLanguageServer.
Пока скрипт "Анализ модуля" умеет проверять только текущий модуль, но он еще совсем новый и будет развиваться.
Вместо заключения: Где найти информацию о других возможностях Снегопата?
Выше я перечислил минимальный набор функций Снегопата, которые можно начать использовать сразу после установки, но в реальности возможностей гораздо больше и в одной статье о них не рассказать.
Кроме официальной справки по Снегопату, рекомендую ознакомиться со следующими информационными ресурсами:
- Список видеороликов, демонстрирующих функционал Снегопата и его скриптов
- Статья Скрипты для проекта Снегопат: автоматизация работы в Конфигураторе
- Разработка скрипта для проекта Снегопат
- Официальный канал проекта Снегопат в Телеграме
Задать вопрос, предложить идею по функционалу, запросить помощь можно: - на форуме поддержки проекта Снегопат - в официальном чате проекта Снегопат в Телеграме
Happy coding!
