Тип: Строка. Имя элемента графической схемы.
Полное описание, параметры и ограничения
ЭлементГрафическойСхемыДействие.Имя (GraphicalSchemaItemActivity.Name)
ЭлементГрафическойСхемыДействие (GraphicalSchemaItemActivity)
Имя (Name)
Доступен, начиная с версии 8.0.
Использование:
Только чтение.
Описание:
Тип: Строка.
Имя элемента графической схемы.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Подписать действие, не создавая задачу
У собственной точки ПодготовитьКнигу задаём понятное название и пояснение. Признак групповой адресации относится к изображению точки, а не к запуску новых задач.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
В этой отдельной пустой конфигурации Учебная85 добавьте Задачи → УчебнаяЗадача: длина номера 9, тип Строка, автонумерация; наименование длиной 100. Добавьте реквизит Комментарий (Строка, 100), без проверки заполнения.
Добавьте Бизнес-процессы → УчебныйПроцесс: длина номера 9, тип Строка, автонумерация, реквизит Комментарий (Строка, 100), без проверки заполнения. В свойстве Задача выберите УчебнаяЗадача.
Карта маршрута: одна точка старта Старт → одна одиночная точка действия ПодготовитьКнигу → одна точка завершения Финиш. Соедините их стрелками; в представлении точки действия укажите Подготовить учебную книгу.
Адресацию задач, групповые/условные/вложенные точки и обработчики маршрута для этой задачи не добавляйте. Модули задачи и процесса, подписки и внешние действия должны быть пустыми. Обновите конфигурацию базы данных.
Все имена здесь относятся к новым учебным объектам, не к рабочей КА2/УНФ/УТ/БП. Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи.
В этих упражнениях процесс не записывается и не запускается. Исследуется копия карты маршрута в памяти; печать на физический принтер не вызывается.
Если Метаданные.БизнесПроцессы.Найти("УчебныйПроцесс") = Неопределено
Или Метаданные.Задачи.Найти("УчебнаяЗадача") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебные процесс, задачу и карту маршрута";
КонецЕсли;
Процесс = БизнесПроцессы.УчебныйПроцесс.СоздатьБизнесПроцесс();
Схема = Процесс.ПолучитьКартуМаршрута();
Если ТипЗнч(Схема) <> Тип("ГрафическаяСхема") Тогда
ВызватьИсключение "Учебный процесс не вернул графическую схему";
КонецЕсли;
Действие = Схема.ЭлементыГрафическойСхемы.Найти(БизнесПроцессы.УчебныйПроцесс.ТочкиМаршрута.ПодготовитьКнигу);
Если Действие = Неопределено Тогда
ВызватьИсключение "В собственной карте отсутствует точка ПодготовитьКнигу";
КонецЕсли;
Если ТипЗнч(Действие) <> Тип("ЭлементГрафическойСхемыДействие") Тогда
ВызватьИсключение "У точки ПодготовитьКнигу другой тип элемента";
КонецЕсли;
Действие.Наименование = "Подготовить книгу: 3 экземпляра";
Действие.Подсказка = "Учебное действие в памяти, без запуска процесса";
Действие.Пояснение = "Учебный маршрут без адресата";
Действие.Групповая = Ложь;
Действие.Гиперссылка = Ложь;
Сообщить(Действие.Наименование = "Подготовить книгу: 3 экземпляра");
Сообщить(Действие.Подсказка = "Учебное действие в памяти, без запуска процесса");
Сообщить(Действие.Пояснение = "Учебный маршрут без адресата");
Сообщить(Не Действие.Групповая);
Сообщить(Не Действие.Гиперссылка);
Сообщить(Действие.Значение = БизнесПроцессы.УчебныйПроцесс.ТочкиМаршрута.ПодготовитьКнигу);
Сообщить("Внутреннее имя: " + Действие.Имя);Разбор по шагам
Находим точку по ссылке маршрута и проверяем её тип, а не берём случайный элемент коллекции.
Наименование — текст на схеме, Подсказка — текст при наведении. Пояснение отдельно описывает адресацию действия.
Групповая=Ложь соответствует одиночной учебной точке. Изменения схемы не редактируют карту метаданных и не запускают исполнение.
Гиперссылка=Ложь отключает гиперссылочное отображение. Истина сама по себе не создаёт обработчик события Выбор.
Значение и Имя только читаются: первая величина — ссылка точки маршрута, вторая — внутреннее имя элемента.
Как проверить результат
Шесть сравнений Истина и диагностическое внутреннее имя.
Нет новых задач или записанного бизнес-процесса: никакие методы запуска и записи не вызваны.
Ожидаемый результат
У собственного действия подготовлены разные смысловые подписи без подмены логики маршрута.
На что обратить внимание
Три экземпляра — часть учебной подписи, не реквизит задачи и не движение товаров.
Назначение адресатов настраивается в метаданных и алгоритме процесса, не этим оформлением.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать границы трёх точек без попытки перемещения
Изучаем положение Старт, действия и Финиш в логических единицах. Координаты и размеры по API только для чтения; для изменения расположения нужен редактор маршрута.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
В этой отдельной пустой конфигурации Учебная85 добавьте Задачи → УчебнаяЗадача: длина номера 9, тип Строка, автонумерация; наименование длиной 100. Добавьте реквизит Комментарий (Строка, 100), без проверки заполнения.
Добавьте Бизнес-процессы → УчебныйПроцесс: длина номера 9, тип Строка, автонумерация, реквизит Комментарий (Строка, 100), без проверки заполнения. В свойстве Задача выберите УчебнаяЗадача.
Карта маршрута: одна точка старта Старт → одна одиночная точка действия ПодготовитьКнигу → одна точка завершения Финиш. Соедините их стрелками; в представлении точки действия укажите Подготовить учебную книгу.
Адресацию задач, групповые/условные/вложенные точки и обработчики маршрута для этой задачи не добавляйте. Модули задачи и процесса, подписки и внешние действия должны быть пустыми. Обновите конфигурацию базы данных.
Все имена здесь относятся к новым учебным объектам, не к рабочей КА2/УНФ/УТ/БП. Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи.
В этих упражнениях процесс не записывается и не запускается. Исследуется копия карты маршрута в памяти; печать на физический принтер не вызывается.
Если Метаданные.БизнесПроцессы.Найти("УчебныйПроцесс") = Неопределено
Или Метаданные.Задачи.Найти("УчебнаяЗадача") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебные процесс, задачу и карту маршрута";
КонецЕсли;
Процесс = БизнесПроцессы.УчебныйПроцесс.СоздатьБизнесПроцесс();
Схема = Процесс.ПолучитьКартуМаршрута();
Если ТипЗнч(Схема) <> Тип("ГрафическаяСхема") Тогда
ВызватьИсключение "Учебный процесс не вернул графическую схему";
КонецЕсли;
Старт = Схема.ЭлементыГрафическойСхемы.Найти(БизнесПроцессы.УчебныйПроцесс.ТочкиМаршрута.Старт);
Если Старт = Неопределено Тогда
ВызватьИсключение "В собственной карте отсутствует точка Старт";
КонецЕсли;
Если ТипЗнч(Старт) <> Тип("ЭлементГрафическойСхемыСтарт") Тогда
ВызватьИсключение "У точки Старт другой тип элемента";
КонецЕсли;
Действие = Схема.ЭлементыГрафическойСхемы.Найти(БизнесПроцессы.УчебныйПроцесс.ТочкиМаршрута.ПодготовитьКнигу);
Если Действие = Неопределено Тогда
ВызватьИсключение "В собственной карте отсутствует точка ПодготовитьКнигу";
КонецЕсли;
Если ТипЗнч(Действие) <> Тип("ЭлементГрафическойСхемыДействие") Тогда
ВызватьИсключение "У точки ПодготовитьКнигу другой тип элемента";
КонецЕсли;
Финиш = Схема.ЭлементыГрафическойСхемы.Найти(БизнесПроцессы.УчебныйПроцесс.ТочкиМаршрута.Финиш);
Если Финиш = Неопределено Тогда
ВызватьИсключение "В собственной карте отсутствует точка Финиш";
КонецЕсли;
Если ТипЗнч(Финиш) <> Тип("ЭлементГрафическойСхемыЗавершение") Тогда
ВызватьИсключение "У точки Финиш другой тип элемента";
КонецЕсли;
Точки = Новый Массив;
Точки.Добавить(Старт);
Точки.Добавить(Действие);
Точки.Добавить(Финиш);
Для Каждого Элемент Из Точки Цикл
Сообщить("Элемент: " + Элемент.Имя);
Сообщить("Лево/Верх: " + Строка(Элемент.Лево) + " / " + Строка(Элемент.Верх));
Сообщить("Ширина/Высота: " + Строка(Элемент.Ширина) + " / " + Строка(Элемент.Высота));
Сообщить(Элемент.Ширина > 0 И Элемент.Высота > 0);
КонецЦикла;Разбор по шагам
Все три переменные получены поиском и проверены на конкретный тип, прежде чем добавлены в массив.
Лево и Верх — отступы от начала схемы, не координаты окна Windows.
Ширина и Высота также в логических единицах; код не приравнивает их к миллиметрам печати или пикселям PNG.
Свойства readonly только читаются. Для изменения геометрии вернитесь в Конфигуратор → Бизнес-процессы → УчебныйПроцесс → Карта маршрута.
Как проверить результат
По одной положительной проверке размеров на каждую точку.
Конкретные координаты диагностические: они зависят от того, как вы расположили точки в редакторе.
Ожидаемый результат
Прочитана геометрия настоящего собственного маршрута, без присваивания readonly-свойств.
На что обратить внимание
Положительные размеры не доказывают отсутствие перекрытия подписей: это отдельная визуальная проверка.
Размещение точек не изменяется при одном только чтении координат.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.