gifts2017

Скрипт создания справки по функциям и процедурам

Опубликовал Василий Казьмин (awk) в раздел Программирование - Инструментарий

При групповой (да и не только разработке) возникает проблема, как не написать уже написанную функцию.

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

Параметры скрипта:

    -App - exe файл приложения 1С. Если задан, то сначала модули будут выгружены.
    -User  - Имя пользователя
    -Password - пароль
    -File - каталог расположения базы (если задан, то -server и -base игнорируются)
    -Server - сервер 1С
    -Base - база 1С на сервере
    -DirIn - каталог, где расположены (куда будут выгружены) модули (если не задан, то текущий каталог)
    -DirOut - каталог, где будут созданы файлы справки, если не задан, то равен $DirIn
    -Filter - фильтр обрабатываемых файлов (по умолчанию "*.txt")

В результате работы скрипта будут созданы файлы: xml, index.htm и default.xsl.

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

Наименование Файл Версия Размер Кол. Скачив.
names1C.ps1
.ps1 5,93Kb
23.08.11
95
.ps1 5,93Kb 95 Скачать

См. также

Подписаться Добавить вознаграждение

Комментарии

1. Артур Аюханов (artbear) 23.08.11 16:23
(0) Чувствую что-то полезное, но пока не пойму применения :)
Ты бы описал, что можно/нужно делать с полученными файлами, выложил бы скриншот фрагментов одного двух-файлов.
Пока непонятно :(
2. Артур Аюханов (artbear) 23.08.11 16:26
(0) Про Снегопат, надеюсь, слышал?
http://snegopat.ru/main/home
Почитай страницы возможности и дальнейшие планы, обрати внимание на выполненную работу.
Интересно было бы подключить подобный хелп прямо в Конфигураторе.
ЗЫ Саша Орефков активно делает скриптовую часть, я также потихоньку подключился.
3. Ийон Тихий (cool.vlad4) 23.08.11 16:27
По всей видимости запускает 1С, выгружает модули в текст, преобразует в соответствующие форматы...сейчас скачаем заценим (вообще подобная мысль у меня была давно)...жду когда смельчак сделает индексирование и поиск по внутренностям обработок...их просто тьма, я уже даже пишу в блокноте....
4. Артур Аюханов (artbear) 23.08.11 16:33
(3) это-то понятно, я не об этом, что делать с результатом :) - вот в чем вопрос?
5. Ийон Тихий (cool.vlad4) 23.08.11 16:44
(4) Я думаю автор поправит, но мне кажется как удобно, так и использовать - а так, по всей видимости создается web файл справки, - можно затем уже куда-нибудь выгрузить, проиндексировать для поиска, создать pdf для чтения (или chm), в общем остановит только фантазия.
6. Василий Казьмин (awk) 23.08.11 17:26
(2) Все хорошо, но не то что я хотел.
(3)(4) Да-да-да. Результат xml- если в браузере открыть - то выглядит как:
Функция: ПолучитьДанныеФайлаИНавигационнуюСсылкуВерсииВоВременномХран­илище
Параметры:

    ФайлСсылка
    ВерсияСсылка
    ИдентификаторФормы

Описание:

Получает ДанныеФайла и НавигационнуюСсылкуВерсии, предварительно поместив файл версии во временное хранилище 
...Показать Скрыть


Если скрипт поставить в cron (планировщик задач), то можно выкладывать на веб сервер. И изучать конфу не только по конфигуратору. Но можно этого и не делать, а просто смотреть какие есть функции/процедуры - не перескакивая в конфигураторе по блокам.


Так как файлы в xml, то можно повысить культуру разработки например проверив на наличие процедур без описаний или орфографические ошибки.

Это не замена и не подмена конфигуратора.

(5) Ну у меня из фантазии - это удобный инструмент комментирования процедур и функций. По принципу вылил, отредактировал/написал описание в браузере и залил обратно + автогенерация тестов к процедурам и функциям.
cool.vlad4; +1 Ответить
7. Дмитрий Елисеев (w-divin) 26.08.11 18:24
(2) все бы ничего, но кто-то забыл упомянуть о платности по ссылке (((
8. Александр Зайцев (AlecoZAV) 23.09.11 14:46
не хватает описания сильно, разобраться тяжело
Для написания сообщения необходимо авторизоваться
Прикрепить файл
Дополнительные параметры ответа