Генерация UML диаграмм на основании текстового описания

10.09.21

–

Обработка, демонстрирующая возможности вывода изображения UML диаграммы, сгенерированной сторонним сервисом на основании текстового описания.

Скачать исходный код

	Наименование	Файл	Версия	Размер
	Обработка по генерации UML диаграмм на основании текстового описания: .epf 8,76Kb 11	.epf		8,76Kb	11	Скачать

В 1С нет встроенных возможностей работы с UML диаграммами. Но можно обогатить функциональность отчетов или форм, если использовать возможности сторонних сервисов, например таких как https://plantuml.com, которые позволяют сгенерировать изображение требуемой UML диаграммы на основании ее текстового описания.

Суть предлагаемого метода, демонстрируемого обработкой

1) Формируем/(составляем вручную) текстовое описание требуемой диаграммы

Пример простейшей диаграммы

2) Сжимаем (deflate) текст описания диаграммы (аналог zip, но не для файла, а для строки)

3) Конвертируем данные полученные на предыдущем этапе при помощи преобразования очень похожего на Base64, но немного отличающегося в силу исторических причин. Подробнее про формат тут

4) Формируем http запрос по адресу сервера, генерирующего изображения. В качестве адреса подставляем требуемый ресурс ( в зависимости от того в каком формате нам нужно изображение, например для PNG - http://www.plantuml.com/plantuml/png/). В конце адреса добавляем закодированный текст, полученный на этапе 3.

5) Получаем ответ от сервера. В случае положительного ответа он содержит виде двоичных данных сгенерированное изображение.

Примеры диаграмм, формируемых обработкой:

Более сложный пример, демонстрирующий схему проведения документов в ЕРП 2.5 ( составлена по мотивам //infostart.ru/public/1185321/):

В настройках обработки можно задать альтернативный сервер генерации изображений ( например можно использовать не только публичные сервера, но и собственные внутри локальной сети), а также ресурс ( определяет тип изображения) и таймаут по умолчанию (обычно генерация даже больших схем укладывается в 1-2 сек)

P.S. Обработка разрабатывалась и тестировалась на платформах 8.3.16.1148 - 8.3.20.1479.

UML plantUML

–

См. также

Богатый редактор картинок, хранимых в базе, с возможностью РИСОВАНИЯ. Редактор внешних файлов картинок. Объект, расширяющий возможности работы с картинками из встроенного языка (Три в одном) + Обработка «Стандартизация картинок»

Работа с интерфейсом Рабочее место Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Платные (руб)

Обработка предназначена для редактирования картинок в режиме «Предприятие», с возможностью РИСОВАТЬ на них. Поддерживается работа как в обычных формах (толстый клиент) так и на управляемых формах (тонкий клиент). Обработка позволяет редактировать как картинки, хранимые в базе, так и графические файлы с диска на файловой системе. Помимо базовых функций (изменение размеров, преобразование формата, обрезание картинки, повороты и т.п.) – редактор имеет богатый набор инструментов для рисования. Доступна функция вставки изображения из буфера обмена. Также обработка может быть использована из встроенного языка как объект для редактирования картинок. Объект может быть использован: на стороне клиента, на стороне сервера, из внешнего соединения. Данная обработка будет особенно полезна тем, кто вносит картинки в базу (изображения номенклатуры, фотографии физических лиц и т.п.). Функционал реализуется с использованием JavaScript и бесплатного ПО ImageMagick (без использования внешних компонент).

6000 руб.

16.01.2015 62173 43 59

Управление дашбордами

Работа с интерфейсом Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Обработка предназначена для создания и управления дашбордами.

2400 руб.

29.06.2020 16975 22 4

Новогоднее оформление для 1С

Работа с интерфейсом Платформа 1С v8.3 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Зарплата и Управление Персоналом 3.x 1С:Управление нашей фирмой 3.0 Бесплатно (free)

Добавьте новогоднего настроения! Расширение создает декорацию в виде гирлянды на некоторых формах объектов.

27.12.2023 11316 768 elcoan 45

106

Генерация диаграммы объектов метаданных для СППР

Инструментарий разработчика Работа с интерфейсом Платформа 1С v8.3 Конфигурации 1cv8 1С:Комплексная автоматизация 2.х Абонемент ($m)

Генерация диаграммы объектов метаданных для типовой конфигурации "Система проектирования прикладных решений" по справочнику ОбъектыМетаданных. Внешняя обработка, без изменения типовой конфигурации и установки дополнительных компонент.

1 стартмани

15.12.2023 2426 20 xman 9

Конструктор HTML, CSS и javascript

Инструментарий разработчика Работа с интерфейсом Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

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

2 стартмани

10.04.2023 9985 153 acces969 31

119

Диаграмма объектов 1С 🏗 на Plant UML

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

Внешняя обработка, которая генерирует диаграмму объектов 1С 🏗 на языке PlantUML. Использует библиотеку для построения диаграммы объектов в нотациях метаданных 1С.

1 стартмани

23.08.2022 9750 108 a_plastinin 38

116

Модель состояния для MVC

Работа с интерфейсом Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

"MVC плохо применима в 1С" - познакомьтесь с моделью состояния и, возможно, ваше мнение поменяется! Представленное решение является эволюционным развитием идеи реализации MVC для 1С. В новой версии добавлены DSL для описания модели состояния, а также параметризация свойств параметров и элементов формы.

1 стартмани

05.07.2022 4008 kalyaka 4

Табло очереди заказов на экран телевизора

WEB-интеграция Работа с интерфейсом Платформа 1С v8.3 1С:Розница 2 Платные (руб)

Связка из веб-приложения и расширения для 1С: Розница 2.3.

3600 руб.

29.04.2022 12362 1 5

Комментарии

Подписаться на ответы Инфостарт бот

Свернуть все

1. malikov_pro 1297 10.09.21 12:35 Сейчас в теме

Тема интересна, прикладных примеров анализа структуры или последовательности вызовов в конфигурации не хватает.

Так же полезно будет осветить вариант локального разворачивания на текущей машине или на VM.

3. xnd 91 10.09.21 13:06 Сейчас в теме

(1) Не совсем понятно что подразумевается под прикладными примерами анализа структуры или последовательности - можете пояснить?
По поводу локального разворачивания - не стали заморачиваться с этим - т.к. мы используем UML диаграммы для совместной работы и нужен тогда общий сервер, доступный всем. Поэтому пошли на использование публичных серверов. Правда в продакшене используем не plantuml.com, а https://kroki.io - у него поддержка типов диаграмм в разы больше

2. cprit 883 10.09.21 13:00 Сейчас в теме

Прикольная тема. Не думали сделать такую обработку, которая будет работать полностью локально? Без внешних сервисов. Вроде есть библиотеки для поля HTML, которые такое умеют

4. xnd 91 10.09.21 13:13 Сейчас в теме

(2) Если нужно локально, то придется скачивать Java и запускать на исполнение jar файл, отвечающий за рендеринг.
В корп. средах обычно ставят где то сервер и все по сетке обращаются к нему.
Но опять же повторюсь - наши схемы не содержат ничего секретного, поэтому пользуемся публичными серверами.

5. cprit 883 10.09.21 13:14 Сейчас в теме

(4) Понял.

6. RustIG 1629 10.09.21 13:44 Сейчас в теме

в этом что-то есть полезное....

7. adn1974 10.09.21 15:09 Сейчас в теме

Интересная тема.
Сейчас многие топят за визуализацию.
Для каких конкретных целей планируете использовать?

12. xnd 91 11.10.21 18:16 Сейчас в теме

(7)(1)
Выпустили инструмент, активно использующий UML диаграммы https://infostart.ru/public/1527549/

8. Идальго 228 10.09.21 21:37 Сейчас в теме

Погодите, а чем просто использование PlantUML не устраивает? Это же довольно старый инструмент. Там отличный плагин есть кстати для VS code.

9. xnd 91 12.09.21 14:55 Сейчас в теме

(8)
так это же и оно и есть, только в среде 1с.
Например с помощью этого есть возможность улучшить информативность отчёта о движениях документов. Есть задумки выложить более функциональный инструмент для аналитиков, в котором будут использоваться вышеописанные возможности по отрисовки в 1с uml диаграмм.

10. malikov_pro 1297 23.09.21 05:59 Сейчас в теме

(3) для диаграмм есть направление в зависимости от типа данных http://blog.atkcg.ru/vybor-vizualizacii-kak-v-diagramme-ne-skryt-vazhnoe/, возможно для каждого вида диаграмм есть подход по построению.

Порядка преобразования кода/структуры данных в диаграмму на русском языке не нашел (возможно плохо искал).
Понятно что статья больше про использование сервиса а не про UML.
Сам диаграмму последовательности рисовал в Visual Paradigm для объяснения рефакторинга кода.

За наводку на kroki.io благодарю, взял из пример JSON, через https://jsoneditoronline.org добавил текст диаграммы и через POST https://kroki.io/plantuml/svg получил требуемый результат, проще чем собирать строку для http://www.plantuml.com.

Использование возможно через плагин, но указание локального сервиса в доке нет https://marketplace.visualstudio.com/items?itemName=asciidoctor.asciidoctor-vscode#how-to-install

В копилку, для plantuml есть
темы https://bschwarz.github.io/puml-themes/gallery.html
расширенный синтаксис с C4 https://github.com/plantuml-stdlib/C4-PlantUML

11. xnd 91 23.09.21 17:58 Сейчас в теме

(10) мы используем автоматическую генерацию диаграмм в одном из наших решений не для кода, а для отражения движений документа ( один из множества примеров - схема проводок БУ)
И да темы делают схемы веселее, их тоже применяем.

13. DELOVOYDOM 12.03.24 01:36 Сейчас в теме

(11) Как дела в 23 году? что то напилить удалось? Не так много кто работает в этой области, многие начинают и потом бросают от чего то. Решения громоздкими становятся и мало востребованными начальством

14. xnd 91 12.03.24 09:21 Сейчас в теме

(13) Если мы говорим про UML схемы, то в основном используем для базы знаний в obsidian( например автогенерация json, описывающих метаданные с поддержкой гиперссылок)

Прикрепленные файлы:

15. xnd 91 12.03.24 09:28 Сейчас в теме

(13) а если про вывод диаграмм в самой 1С, то думаем об отказе от UML и переходе на фреймворк, позволяющий интерактивное изменение полученного результата плюс возможность создавать свои элементы оформления.
Пример возможностей движка:
https://g6.antv.antgroup.com/en/examples
Ниже на скрине пока что примитивнейшая диаграмма в 1С, но зато любой элемент можно подвинуть мышкой

Прикрепленные файлы:

16. Viktor_Ermakov 364 03.05.24 10:11 Сейчас в теме

(15)

Пример возможностей движка:
https://g6.antv.antgroup.com/en/ex

Спасибо большое за наводку на фреймворк.
Очень хорошая идея его использовать!
Единственная просьба посмотреть бы пример, как Вы исходный код импортировали в 1С.
Спасибо!

17. xnd 91 03.05.24 10:40 Сейчас в теме

(16) варианта 2
1 - непосредственное вставка текста js библиотеки в текст html - но тогда неудобно отлаживать html файл - уж больно много он весит

2 - положить js библиотеку во временный каталог и в тексте html сослаться на него

например
фрагмент html
<sc ript src="file:///C:\Users\Александр\AppData\Local\Temp\\g6.min.js"></sc ript>

фрагмент модуля для работы с библиотекой

#Область ПрограммныйИнтерфейс
// Возвращает текст для включения в страницу
// 
// 
// Возвращаемое значение:
//  Строка  - текст с тегами script для включения в html страницу
Функция ТекстПодключенияВHTML() Экспорт
	ШаблонБлока =  "<sc ript src=""file:///%1""></sc ript>";
	Возврат СтрШаблон(ШаблонБлока, ПутьКБиблиотеке());
КонецФункции

// Проверить и установить библиотеку G6.
Процедура ПроверитьиУстановитьБиблиотеку() Экспорт
	ПутьКБиблиотеке = ПутьКБиблиотеке();
	Файл = Новый Файл(ПутьКБиблиотеке); 
    Если Файл.Существует() Тогда
    	Возврат;
    КонецЕсли;
    ТекстовыйФайл = Новый ТекстовыйДокумент;
    ТекстБиблиотеки = граф_МакетыВызовСервера.ТекстМакета("граф_БиблиотекаG6Версия4");
    ТекстовыйФайл.УстановитьТекст(ТекстБиблиотеки);
	ТекстовыйФайл.Записать(ПутьКБиблиотеке, КодировкаТекста.UTF8);
КонецПроцедуры

#КонецОбласти

#Область СлужебныеПроцедурыИФункции
Функция ПутьКБиблиотеке()
	РазделительПути = ПолучитьРазделительПутиКлиента();
	ШаблонПути =  "%1%2g6.min.js";
	Возврат СтрШаблон(ШаблонПути, КаталогВременныхФайлов(), РазделительПути);
КонецФункции

#КонецОбласти

Показать

19. Viktor_Ermakov 364 03.05.24 13:02 Сейчас в теме

(17)Спасибо большое, все понятно, я так и предполагал хранить в макете, получать его и во временный каталог.
Скажите а где именно исходники для макета качали, сорсы с проекта гитхаба?

18. xnd 91 03.05.24 10:43 Сейчас в теме

(16) движок сайта портит ответ - разбивает script на sc и ript

20. Viktor_Ermakov 364 03.05.24 13:03 Сейчас в теме

(18) ну локально даже лучше, не везде есть доступ к инету, или много у кого запрет доступа к различным сайтам. А так все локально.

21. xnd 91 03.05.24 13:17 Сейчас в теме

(19) исходники https://github.com/antvis/G6
для своего проекта беру тут https://gw.alipayobjects.com/os/lib/antv/g6/4.3.11/dist/g6.min.js
( для минимизации объема)
подсмотрел в https://g6.antv.antgroup.com/en/manual/getting-started

23. Viktor_Ermakov 364 03.05.24 13:55 Сейчас в теме

(21) Спасибо большое, доберусь тоже сделаю что нить.

22. xnd 91 03.05.24 13:21 Сейчас в теме

(19) нужную версию можно взять еще тут
https://www.npmjs.com/package/@antv/g6
например
https://www.npmjs.com/package/@antv/g6/v/4.8.24?activeTab=code
в каталоге Dist