1с тип графическая схема
Сначала я собирался накатать большую и умную статью по итогам исследования внутреннего формата различных общих объектов 1С - всяких там географических карт, дендрограмм и прочих мокселей. О том, как оно устроено, что означает тот или иной кусок и какая польза может от того получиться. Ряд манипуляций возможен только с сериализованным текстом, ряд действий просто быстрее и удобнее. Так вот, а потом мне здраво указали, что теория нафиг не нужна и вообще подавай конкретные примеры.
Сразу оговорюсь: приоритет этой идеи принадлежит безвестным гениям доледникового периода, а я, позорно протормозив, просто сделал для себя то, о чём писал Diversus ещё в лохматые годы. Но, поскольку сие может служить иллюстрацией, и к тому же более-менее работоспособно, то выкладываю в виде кода некоторые наработки как пример. Пример сериализации графической схемы в текст, работы с текстом, и последующей обратной серализации. Причём сделано это всё примитивно и топорно, безо всяких DOM.
К недостаткам схемы стоит отнести сложность позиционирования (вам самостоятельно придётся прикидывать, куда "сунуть" каждый новый объект), и капризная чувствительность к правке. Перетаскивать добавленные объекты, связанные добавленными стрелочками, не советую - всё рискует разъехаться. Но для "только просмотр" это сгодится более чем. Также, напомню, графическая схема поддерживает событие расшифровки, что делает её не просто иллюстративным инструментом, но и навигационным.
Где это может пригодиться? Начиная от построения простейших отчётов-связок, вроде "Структуры подчинённости", и заканчивая отражением связей метаданных, как это делали в механизмах, изучающих внутреннюю структуру конфигураций. Для цели отрисовки графов может пригодиться; правда, опять же, позиционирование надо продумывать самим, в отличие от стороннего софта, обычно используемого в таких случаях.
Собственно, код и все пояснения по формату в описаниях функций. Особенно см. подробное описание функции ДобавитьФигуру.
Если теги всё-таки побьются, пишите в личку - пришлю исходник как файл.
Кому пригодится - буду рад. Если возникнут пожелания по доработке, тоже отписывайтесь в теме или в личке. А то ведь метода УдалитьФигуру я делать пока не стал, лень-матушка.
В статье описывается методика программного управления элементами графической схемы при помощи механизма XDTO. Приложена готовая к использованию библиотека функций для создания и удаления графических объектов, а также для связи элементов схемы соединительными линиями.
Невозможность программного управления графической схемой периодически вызывает появление публикаций, которые тем или иным способом устраняют этот недостаток платформы. В качестве примера можно привести
Как правило, в этих публикациях графическая схема либо сохраняется в файл GRS, который может быть программно изменен, либо используется XML-, JSON- сериализация, конвертация в платформенные структуры и массивы. К сожалению, ни в одной публикации не был упомянут самый простой и логичный (на мой взгляд) способ - использование механизма XDTO. Этот способ имеет много общего с использованием XML-сериализации, но гораздо удобнее в изучении и реализации, а также позволяет получить более понятный код.
Описание механизма
Итак, для работы нам потребуется 2 вида сущностей: ОбъектXDTO - объекты, которые будут для нас элементами графической схемы, и СписокXDTO - список объектов ОбъектXDTO. Многие объекты 1С, в том числе графическая схема, могут быть преобразованы в объекты XDTO:
Каждый объект характеризуется типом. Программист может создавать объекты XDTO произвольных типов. Тип определяется совокупностью двух строк: URIПространстваИмен и Имя типа. Например создание объекта - элемента графической схемы выглядит так:
Возникает вопрос: как перед созданием узнать тип нужного программисту объекта, т.е. Имя и URIПространстваИмен? Существует 2 способа: первый - создать объект вручную и посмотреть в отладчике свойства его типа:
Вариант второй - обратиться к в желтым книжкам, или синтаксис-помощнику. Так, для графической схемы:
. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен . Имя типа XDTO: FlowchartContextType.
У объекта XDTO есть свойства, значениями которых могут выступать как простые типы, так и сложные: другие объекты или их списки.
Как видим, у объекта графической схемы есть собственные свойства, кроме того есть реквизит item - Список XDTO. Забегая вперед, отметим, что это - список графических элементов, т.е. именно то, что нам нужно.
Большинство свойств объектов доступны для изменения.
После модификации Объект XDTO можно преобразовать обратно в объект платформы 1С:
Таким образом методика программного изменения графической схемы выглядит так:
- Сериализуем (т.е. преобразовываем в объект XDTO) графическую схему
- Меняем свойства объекта XDTO, список графических элементов,
- Десериализуем объект XDTO обратно в графическую схему.
Неоспоримым плюсом и отличием от способов, предлагаемых в других публикациях, является тот факт, что на этапе изменения схемы мы работаем с понятной объектной моделью - объектами (с доступными свойствами-реквизитами) и списками объектов.
Примеры создания элементов
Для примера попробуем добавить в графическую схему элемент "Действие":
Сериализуем графическую схему и создадим новый элемент схемы:
Реквизит itemType - один из самых важных. Он задает тип графического элемента и его внешний вид.
- 0 - Декорация
- 1 - Линия
- 2 - Старт
- 3 - Завершение
- 4 - Условие
- 5 - Действие
- 6 - Выбор варианта
- 7 - Разделение
- 8 - Слияние
- 9 - Обработка
- 10 - Вложенный процесс
Далее зададим имя создаваемого объекта, его идентификатор (должен быть уникальным среди элементов схемы) и номер порядка обхода.
Следующий шаг - мы должны задать координаты прямоугольника, внутри которого будет расположен наш объект. Именно к серединам его сторон будут потом "привязываться" соединительные линии. Координаты отсчитываются от левого верхнего угла схемы.
Заголовок элемента - это несколько вариантов строк, для разных языков. Нам хватит одного.
Определим цвет элемента. В нашем случае - цвет по умолчанию, определяется типом элемента.
Следующий момент - задание типа линии границы элемента - значение реквизита border. На этом шаге спотыкается большинство разработчиков, так как в документации этот вопрос не рассмотрен, а реверс-инжиниринг дает непонятный результат. Правильно делать так:
У нашего объекта есть свойство point - список объектов XDTO - точек вершин элемента. Для корректного отображения элемента их надо задать. Правые и нижние координаты на единицу меньше чем координаты ограничивающего прямоугольника. (Почему так? Кто знает. )
Что будет если мы зададим свой набор точек? Можно будет нарисовать многоугольник произвольной формы? Да можно, но. до первого "шевеления" элемента мышкой. При первом же удобном случае элемент примет форму, определяемую его типом, в пределах ограничивающего прямоугольника.
И, наконец, добавим наш созданный элемент в список элементов графической схемы и десериализуем ее.
Приведенного выше кода достаточно для отображения элемента "Действие". Но можно настроить и другие свойства: alignHor, alignVer, hyperlink, picturePlacement, pictureStyle, transparent, lineColor, textColor и др. Их назначение понятно из названий.
Аналогичным образом создаются и другие объекты. При этом необходимо учесть несколько особенностей:
- По умолчанию у объектов "Старт" и "Завершение" угол при вершине равен 120º
- По умолчанию у объекта "Условие" углы правой и левой стороны равны 120º
- Объект "Декорация" имеет реквизит shape, который отвечает за форму объекта: Блок, Документ, Эллипс и т.д.
- У объекта "ВыборВарианта" есть реквизит transition, содержащий список вариантов.
- Высота заголовка объекта "Действие" и высота вариантов объекта "ВыборВарианта" - величина постоянная
Создание соединительной линии несколько отличается от создания прочих объектов:
Здесь надо обратить внимание на следующие реквизиты: connectFromItemId, connectToItemId - идентификаторы объектов, к которым "привязаны" начало и конец линии. portIndexFrom, portIndexTo - номера сторон, к которым присоединены линии.
Список номеров сторон:
- 1 - середина левой стороны ограничивающего объект прямоугольника
- 2 - середина верхней стороны
- 3 - середина правой стороны
- 4 - середина нижней стороны
- 6, 8, 10, . - середина левой стороны варианта 1, 2, 3, . для объекта ВыборВарианта
- 7, 9, 11, . - середина правой стороны варианта 1, 2, 3, . для объекта ВыборВарианта
Особенности работы с линиями:
- Если линия начинается из варианта объекта ВыборВарианта, то реквизит connectFromPortIndex равен номеру варианта.
- Реквизит decorativeLine - флаг декоративной линии.
- Соединительная линия, в отличие от декоративной, перестраивается при перемещении объекта, к которому присоединена. Присоединенная декоративная линия также перемещается вслед за перемещаемым объектом, но, как правило, ее форма не так сильно меняется.
- Декоративная линия может иметь наконечники разных типов, а соединительная - только в виде заполненной стрелки.
- Нельзя допускать наличия соседних сегментов линии, лежащих на одной прямой, иначе перемещение линии вызывает странные визуальные эффекты.
Библиотека для работы с графической схемой
Для упрощения работы с графической схемой была разработана библиотека функций, приложенная к статье.
Функции создания и удаления объектов:
Функции работы с вариантами:
Функция соединения объектов:
Задача соединения объектов линией оказалась неожиданно непростой. Количество вариантов взаимного расположения объектов с учетом комбинаций соединяемых сторон довольно велико. Для сокращения количества вариантов пришлось использовать поворот объектов вокруг оси координат так, чтобы линия в первый объект входила всегда с левой стороны. Интересной выглядит следующая задача: написать алгоритм построения соединительной линии так, чтобы а) линия по возможности огибала бы другие элементы схемы и б) количество пересечений с другими линиями было бы минимально. Задача а) уже решена в платформе. Желающие могут из решения этой задачи сделать очень хорошую публикацию.
Пример использования библиотеки:
Предлагаемая библиотека позволит разработчику упростить построение схем произвольных бизнес-процессов, организационных диаграмм, структур подчиненности и т.п.
В заключение хотелось бы отметить, что использование XDTO позволяет программисту получить дополнительные возможности по работе с самыми разными объектами (Дерево значений, табличный документ, и т.д.), тем самым несколько скомпенсировать отсутствие таких возможностей в объектной модели, предоставляемой платформой.
В своей предыдущей статье я разбирал способ создания презентаций в 1С среде на основе сохранения картинок в справочник. В ней использовалось сохранение в подчиненный справочник 1С. В данной же статье разберем, как делать нечто похожее, но немного другими способами.
1. Как создать справочник в 1С
Задача стоит следующая: необходимо создать справочник 1С, в котором можно будет хранить графические схемы, причем при выборе элемента созданного справочника 1С должна отображаться схема, которую содержит элемент.
Для выполнения задачи первым делом создадим справочник 1С. Назовем его «Графические схемы 1С» и создадим сразу две формы – списка и элемента.
Откроем форму элемента и добавим два реквизита – АдресВХранилище – строка, ГрафическаяСхема – тип графическая схема.
Вынесем схему на форму, а адрес в хранилище будет служебным реквизитом, который виден не будет.
Теперь мы можем создавать схемы, но при записи и повторном открытии ничего не сохранится.
2. Как сохранять графическую схему в созданном регистре 1С
· Измерение «Наименование» – строка;
· Ресурс «Графическая схема 1С» - хранилище значения.
Теперь добавим несколько процедур, первая из которых будет сохранять схему в регистр сведений при изменении.
Создадим событие для схемы «ПриИзменении», с помощью которого при каждом изменении будем помещать схему во временное хранилище 1С.
Следующий этап – запись в регистр сведений при записи элемента. Напишем код, для события «ПриЗаписиНаСервере».
Теперь при записи элемента справочника графическая схема сохраняется в созданном в 1С регистре сведений.
Все что осталось сделать, это с помощью ссылки получить графическую схему из регистра, когда открывается форма. Используем для этого событие «ПриСозданииНаСервере».
Нам удалось добиться того, чтобы при внесении изменений результат сохранялся.
Для полного выполнения поставленной задачи осталось всего лишь создать на форме списка такой же, как на форме элемента реквизит типа «графическая схема 1С», добавить событие «ПриАктивизацииСтроки», получить ссылку с помощью «Элементы.Список.ТекущиеДанные.Ссылка» и получить графическую схему с помощью аналогичного кода в 1С:Предприятие, что использовался в процедуре «ПриСозданииНаСервере» на форме элемента, передав туда ссылку.
Специалист компании ООО «Кодерлайн»
Вас могут заинтересовать следующие статьи:
В своей предыдущей статье я разбирал способ создания презентаций в 1С среде на основе сохранения картинок в справочник. В ней использовалось сохранение в подчиненный справочник 1С. В данной же статье разберем, как делать нечто похожее, но немного другими способами.
1. Как создать справочник в 1С
Задача стоит следующая: необходимо создать справочник 1С, в котором можно будет хранить графические схемы, причем при выборе элемента созданного справочника 1С должна отображаться схема, которую содержит элемент.
Для выполнения задачи первым делом создадим справочник 1С. Назовем его «Графические схемы 1С» и создадим сразу две формы – списка и элемента.
Откроем форму элемента и добавим два реквизита – АдресВХранилище – строка, ГрафическаяСхема – тип графическая схема.
Вынесем схему на форму, а адрес в хранилище будет служебным реквизитом, который виден не будет.
Теперь мы можем создавать схемы, но при записи и повторном открытии ничего не сохранится.
2. Как сохранять графическую схему в созданном регистре 1С
· Измерение «Наименование» – строка;
· Ресурс «Графическая схема 1С» - хранилище значения.
Теперь добавим несколько процедур, первая из которых будет сохранять схему в регистр сведений при изменении.
Создадим событие для схемы «ПриИзменении», с помощью которого при каждом изменении будем помещать схему во временное хранилище 1С.
Следующий этап – запись в регистр сведений при записи элемента. Напишем код, для события «ПриЗаписиНаСервере».
Теперь при записи элемента справочника графическая схема сохраняется в созданном в 1С регистре сведений.
Все что осталось сделать, это с помощью ссылки получить графическую схему из регистра, когда открывается форма. Используем для этого событие «ПриСозданииНаСервере».
Нам удалось добиться того, чтобы при внесении изменений результат сохранялся.
Для полного выполнения поставленной задачи осталось всего лишь создать на форме списка такой же, как на форме элемента реквизит типа «графическая схема 1С», добавить событие «ПриАктивизацииСтроки», получить ссылку с помощью «Элементы.Список.ТекущиеДанные.Ссылка» и получить графическую схему с помощью аналогичного кода в 1С:Предприятие, что использовался в процедуре «ПриСозданииНаСервере» на форме элемента, передав туда ссылку.
Специалист компании ООО «Кодерлайн»
Вас могут заинтересовать следующие статьи:
В своей предыдущей статье я разбирал способ создания презентаций в 1С среде на основе сохранения картинок в справочник. В ней использовалось сохранение в подчиненный справочник 1С. В данной же статье разберем, как делать нечто похожее, но немного другими способами.
1. Как создать справочник в 1С
Задача стоит следующая: необходимо создать справочник 1С, в котором можно будет хранить графические схемы, причем при выборе элемента созданного справочника 1С должна отображаться схема, которую содержит элемент.
Для выполнения задачи первым делом создадим справочник 1С. Назовем его «Графические схемы 1С» и создадим сразу две формы – списка и элемента.
Откроем форму элемента и добавим два реквизита – АдресВХранилище – строка, ГрафическаяСхема – тип графическая схема.
Вынесем схему на форму, а адрес в хранилище будет служебным реквизитом, который виден не будет.
Теперь мы можем создавать схемы, но при записи и повторном открытии ничего не сохранится.
2. Как сохранять графическую схему в созданном регистре 1С
· Измерение «Наименование» – строка;
· Ресурс «Графическая схема 1С» - хранилище значения.
Теперь добавим несколько процедур, первая из которых будет сохранять схему в регистр сведений при изменении.
Создадим событие для схемы «ПриИзменении», с помощью которого при каждом изменении будем помещать схему во временное хранилище 1С.
Следующий этап – запись в регистр сведений при записи элемента. Напишем код, для события «ПриЗаписиНаСервере».
Теперь при записи элемента справочника графическая схема сохраняется в созданном в 1С регистре сведений.
Все что осталось сделать, это с помощью ссылки получить графическую схему из регистра, когда открывается форма. Используем для этого событие «ПриСозданииНаСервере».
Нам удалось добиться того, чтобы при внесении изменений результат сохранялся.
Для полного выполнения поставленной задачи осталось всего лишь создать на форме списка такой же, как на форме элемента реквизит типа «графическая схема 1С», добавить событие «ПриАктивизацииСтроки», получить ссылку с помощью «Элементы.Список.ТекущиеДанные.Ссылка» и получить графическую схему с помощью аналогичного кода в 1С:Предприятие, что использовался в процедуре «ПриСозданииНаСервере» на форме элемента, передав туда ссылку.
Специалист компании ООО «Кодерлайн»
Вас могут заинтересовать следующие статьи:
Читайте также: