Типы встроенного языка и свойства элемента проекта вида «ОбычнаяКоманда»

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

Тип <ИмяОбычнойКоманды>

После того как вы добавите в проект обычную команду и дадите ей имя, «1С:Шина» создаст один тип встроенного языка. Имя этого типа будет совпадать с именем вашей обычной команды.

Например, если в проекте есть обычная команда КомандаЗавершитьРаботу, то будет создан тип КомандаЗавершитьРаботу. В общем случае имя этого типа выглядит следующим образом: <ИмяОбычнойКоманды>.

Это тип-одиночка. Он доступен на клиенте.

Тип <ИмяОбычнойКоманды> не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:

// Получить обычную команду «КомандаЗавершитьРаботу»
пер КомандаЗавершения = КомандаЗавершитьРаботу

Модуль обычной команды

В проекте модуль, расширяющий тип <ИмяОбычнойКоманды>, называется модулем обычной команды. Он исполняется на клиенте.

В этом модуле вы можете обработать событие нажатия на команду с помощью переопределяемого обработчика:

@Обработчик
метод Обработчик()
    // необходимые действия
;

Для обычной команды, созданной для компонента интерфейса, также можно задать обработчик. Для этого в панели свойств команды перейдите к свойству Обработчик:

Чтобы использовать уже существующий обработчик, выберите его из выпадающего списка. Чтобы открыть выбранный обработчик в модуле, нажмите на значок лупы.

Чтобы создать новый обработчик, введите для него имя и нажмите на значок лупы — обработчик будет автоматически создан и добавлен в модуль компонента.

Если не вводить имя для обработчика, то оно также будет сгенерировано автоматически, на основе следующей схемы:

• Если представление команды не указано:

  • ОбычнаяКомандаОбработчик.

• Если представление команды указано:

  • Представление + «Обработчик».

совет

В модуле обычной команды может находиться реализация контракта сервиса.

Иерархия наследования

Свойства элемента проекта

Изображение

ДвоичныйОбъект.Ссылка?. Ссылка на ресурс картинки, которая будет показана в команде. Пример YAML-файла:

ВидЭлемента: ОбычнаяКоманда
ОбластьВидимости: ВПодсистеме
Ид: 80d2ee77-bd56-4bc5-89cb-f56f22a8596f
Имя: МояОбычнаяКоманда
Представление: Подсказать
Изображение: icon-q.svg

НастройкиТипа

Контракты, которые реализует обычная команда

• Контракты

Массив<Тип>. Имена контрактов сервиса, которые реализует данная команда.

Представление

Строка. Строка, которая будет показана как заголовок команды. Пример YAML-файла:

ВидЭлемента: ОбычнаяКоманда
ОбластьВидимости: ВПодсистеме
Ид: 80d2ee77-bd56-4bc5-89cb-f56f22a8596f
Имя: МояОбычнаяКоманда
Представление: Подсказать
Изображение: icon-q.svg

Важность

ВажностьКоманды. Определяет приоритет при отображении нескольких команд. Например, команда с важностью Низкая будет отображаться в выпадающем меню «Еще». Возможные значения:

• Высокая
• Обычная
• Низкая

Видимость

Булево. Управляет видимостью команды. Если Ложь, команда скрыта в интерфейсе.

Доступность

Булево. Управляет доступностью команды. Если Ложь, команда недоступна для выполнения.

ОпасностьДействия

ОпасностьДействия. Определяет опасность действия, совершаемого пользователем, например, может ли нажатие на кнопку привести к удалению данных. Возможные значения:

• Высокая
• Средняя
• Отсутствует

Имя

Имя элемента проекта или компонента. Пример YAML-файла:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600

Импорт

Список импортированных пространств имен (подробнее). Пример YAML-файла:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Импорт: 
    - Главная
    - Настройки::НовыйПакет

Ид

Идентификатор элемента проекта или компонента. «1С:Шина» создает этот идентификатор автоматически. Пример YAML-файла:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600

ОбластьВидимости

Видимость элемента проекта (подробнее):

• ВПодсистеме — элемент виден внутри одной подсистемы во всех пакетах. Значение по умолчанию.
• ВПроекте — элемент виден во всех подсистемах одного проекта.
• Глобально — элемент виден во всех подсистемах всех проектов.

Пример YAML-файла:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600

ВидЭлемента

Вид элементов проекта (подробнее)либо компонент интерфейса (подробнее). Пример YAML-файла элемента проекта:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600

Пример YAML-файла компонента:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb
Имя: МояГруппа
Наследует:
    Тип: ФиксированнаяГруппа