Типы встроенного языка и свойства элемента проекта вида «ОбычнаяКоманда»
Обычная команда выполняет алгоритм на встроенном языке. Отображается в виде картинки и заголовка команды.
После того, как вы добавили в проект обычную команду и дали ей имя, «1С:Шина» создаст один тип встроенного языка. Имя этого типа совпадает с именем вашей обычной команды.
Например, если в проекте есть обычная команда КомандаЗавершитьРаботу, то будет создан тип КомандаЗавершитьРаботу. В общем случае имя этого типа выглядит следующим образом: <ИмяОбычнойКоманды>.
Тип <ИмяОбычнойКоманды>
Это тип-одиночка. Он доступен на клиенте.
Тип <ИмяОбычнойКоманды> не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:
// Получить обычную команду «КомандаЗавершитьРаботу»
пер КомандаЗавершения = КомандаЗавершитьРаботу
Модуль обычной команды
В проекте модуль, расширяющий тип <ИмяОбычнойКоманды>, называется модулем обычной команды. Он исполняется на клиенте.
В этом модуле вы можете обработать событие нажатия на команду.
Иерархия наследования
- Команда (абстрактный)
Свойства элемента проекта
- Изображение
- Ссылка на ресурс картинки, которая будет показана в команде. Пример
YAML-файла:
ВидЭлемента: ОбычнаяКоманда ОбластьВидимости: Подсистема Ид: 80d2ee77-bd56-4bc5-89cb-f56f22a8596f Имя: МояОбычнаяКоманда Представление: Подсказать Изображение: icon-q.svg Обработчик: ОбработчикКоманды
- НастройкиТипа
- Контракты, которые реализует обычная команда
- Контракты
- Массив<Тип>. Имена контрактов сервиса, которые реализует данная команда.
- Обработчик
- Имя метода в модуле обычной команды, который будет вызван для выполнения команды. Пример
YAML-файла:
ВидЭлемента: ОбычнаяКоманда ОбластьВидимости: Подсистема Ид: 80d2ee77-bd56-4bc5-89cb-f56f22a8596f Имя: МояОбычнаяКоманда Представление: Подсказать Изображение: icon-q.svg Обработчик: ОбработчикКоманды
- Представление
- Строка, которая будет показана как заголовок команды. Пример
YAML-файла:
ВидЭлемента: ОбычнаяКоманда ОбластьВидимости: Подсистема Ид: 80d2ee77-bd56-4bc5-89cb-f56f22a8596f Имя: МояОбычнаяКоманда Представление: Подсказать Изображение: icon-q.svg Обработчик: ОбработчикКоманды
- Важность
- Определяет важность команды. Важность может использоваться при отображении команды, например, все команды с важностью Низкая из свойства формы ДополнительныеКоманды будут отображены в выпадающем меню «Еще»
- Видимость
- Управляет видимостью команды
- Доступность
- Если Ложь, команда не доступна для выполнения
- Коннотация
- Управляет коннотацией команды. Коннотация отображается только тогда, когда компонент, используемый для отображения команды умеет показывать коннотацию. Например, компонент Кнопка
- Внешний
- Является ли элемент проекта или компонент внешним. Пример
YAML-файла:
ВидЭлемента: Пользователи Внешний: Истина Имя: Пользователи СобственныйПакет: Стд::Пользователи
- Имя
- Имя элемента проекта или компонента. Пример YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- Импорт
- Список импортированных пространств имен (подробнее). Пример
YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600 Импорт: - Главная - Настройки::НовыйПакет
- Ид
- Идентификатор элемента проекта или компонента. «1С:Шина» создает этот идентификатор автоматически. Пример
YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- ОбластьВидимости
- Видимость элемента проекта (подробнее):
- Подсистема — элемент виден внутри одной подсистемы во всех пакетах. Значение по умолчанию.
- Проект — элемент виден во всех подсистемах одного проекта.
- Глобально — элемент виден в других проектах.
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- СобственныйПакет
- Имя пакета собственного объекта. Пример
YAML-файла:
ВидЭлемента: Пользователи Внешний: Истина Имя: Пользователи СобственныйПакет: Стд::Пользователи
- ВидЭлемента
- Вид элементов проекта (подробнее) либо компонент интерфейса
(подробнее). Пример YAML-файла элемента
проекта:
Пример YAML-файла компонента:ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа