Вызывается однократно при первом формировании списка команд, выводимых в форме конкретного объекта конфигурации. Список добавленных команд следует вернуть в параметре Команды. Результат кэшируется с помощью модуля с повторными использованием возвращаемых значений (в разрезе имен форм).

Синтаксис

Процедура ПриОпределенииКомандПодключенныхКОбъекту(НастройкиФормы, Источники, ПодключенныеОтчетыИОбработки, Команды) Экспорт

Параметры

• НастройкиФормы — Структура - сведения о форме, в которой выводятся команды. Для чтения:
  • ИмяФормы - Строка - полное имя формы, в которой выводятся подключаемые команды. Например, "Документ.Анкета.ФормаСписка".
• Источники — ДеревоЗначений - сведения о поставщиках команд этой формы. На втором уровне дерева могут располагаться источники, регистрируемые автоматически при регистрации владельца. Например, документы-регистраторы журналов:
  • Метаданные - ОбъектМетаданных - метаданные объекта.
  • ПолноеИмя - Строка - полное имя объекта. Например: "Документ.ИмяДокумента".
  • Вид - Строка - вид объекта в верхнем регистре. Например: "СПРАВОЧНИК".
  • Менеджер - Произвольный - модуль менеджера объекта, или Неопределено, если у объекта нет модуля менеджера или если его не удалось получить.
  • Ссылка - СправочникСсылка.ИдентификаторыОбъектовМетаданных - ссылка объекта метаданных.
  • ЭтоЖурналДокументов - Булево - Истина, если объект является журналом документов.
  • ТипСсылкиДанных - Тип
  • ОписаниеТипов - тип ссылки элемента.
• ПодключенныеОтчетыИОбработки — ТаблицаЗначений - отчеты и обработки, предоставляющие свои команды для объектов Источники:
  • ПолноеИмя - Строка - полное имя объекта метаданных.
  • Менеджер - Произвольный - модуль менеджера объекта метаданных. Состав колонок см. в ПодключаемыеКомандыПереопределяемый.ПриОпределенииСоставаНастроекПодключаемыхОбъектов.
• Команды — ТаблицаЗначений - записать в этот параметр сформированные команды для вывода в подменю:
  • Вид - Строка - вид команды. Подробнее см. ПодключаемыеКомандыПереопределяемый.ПриОпределенииВидовПодключаемыхКоманд.
  • Идентификатор - Строка - идентификатор команды.
  1. Настройки внешнего вида.
  • Представление - Строка - представление команды в форме.
  • Важность - Строка - суффикс подгруппы в меню, в которой следует вывести эту команду. Допустимо использовать: "Важное", "Обычное" и "СмТакже".
  • Порядок - Число - порядок размещения команды в группе. Используется для настройки под конкретное рабочее место. Допустимо задавать в диапазоне от 1 до 100. По умолчанию порядок 50.
  • Картинка - Картинка - картинка команды. Необязательный.
  • СочетаниеКлавиш - СочетаниеКлавиш - сочетание клавиш для быстрого вызова команды. Необязательный.
  • ТолькоВоВсехДействиях - Булево - отображать команду только в меню Еще.
  • ЗначениеПометки - Строка - путь к реквизиту, где содержится значение пометки команды. Если источником команд является Таблица формы, то возможно использовать параметр %Источник%. Например: "ЗначениеПометок.%Источник%", где ЗначениеПометок - реквизит формы произвольного типа, в котором содержится структура. "Объект.ПометкаУдаления", где Объект - реквизит формы с типом СправочникОбъект.
  2. Настройки видимости и доступности.
  • ТипПараметра - ОписаниеТипов - типы объектов, для которых предназначена эта команда.
  • ВидимостьВФормах - Строка - имена форм через запятую, в которых должна отображаться команда. Используется, когда состав команд отличается для различных форм.
  • Назначение - Строка - определяет вид форм, для которых предназначена команда. Принимаемые значения:
  • "ДляСписка" — показывать команду только в форме списка,
  • "ДляОбъекта" — показывать команду только в форме объекта. Если параметр не указан, то команда предназначена для любых видов форм.
    • ФункциональныеОпции - Строка - имена функциональных опций через запятую, определяющих видимость команды.
    • УсловияВидимости - Массив - определяет видимость команды в зависимости от контекста. Для регистрации условий следует использовать процедуру ПодключаемыеКоманды.ДобавитьУсловиеВидимостиКоманды(). Условия объединяются по "И".
    • ИзменяетВыбранныеОбъекты - Булево - определяет доступность команды в ситуации, когда у пользователя нет прав на изменение объекта. Если Истина, то в описанной выше ситуации кнопка будет недоступна. Необязательный. Значение по умолчанию - Ложь.
    3. Настройки процесса выполнения.
    • МножественныйВыбор - Булево - если Истина, то команда поддерживает множественный выбор. В этом случае в параметре выполнения будет передан список ссылок. Необязательный. Значение по умолчанию - Истина.
    • РежимЗаписи - Строка - действия, связанные с записью объекта, которые выполняются перед обработчиком команды:
  • "НеЗаписывать" — объект не записывается, а в параметрах обработчика вместо ссылок передается вся форма. В этом режиме рекомендуется работать напрямую с формой, которая передается в структуре 2-го параметра обработчика команды.
  • "ЗаписыватьТолькоНовые" — записывать новые объекты.
  • "Записывать" — записывать новые и модифицированные объекты.
  • "Проводить" — проводить документы. Перед записью и проведением у пользователя запрашивается подтверждение. Необязательный. Значение по умолчанию - "Записывать".
    • ТребуетсяРаботаСФайлами - Булево - если Истина, то в веб-клиенте предлагается установить расширение для работы с 1С:Предприятием. Необязательный. Значение по умолчанию - Ложь.
    4. Настройки обработчика.
    • Менеджер - Строка - объект, отвечающий за выполнение команды.
    • ИмяФормы - Строка - имя формы, которую требуется получить для выполнения команды. Если Обработчик не указан, то у формы вызывается метод "Открыть".
    • ИмяПараметраФормы - Строка - имя параметра формы, в который следует передать ссылку или массив ссылок.
    • ПараметрыФормы - Неопределено
    • Структура - параметры формы, указанной в ИмяФормы. Необязательный.
    • Обработчик - Строка - описание процедуры, обрабатывающей основное действие команды, в виде: "<ИмяОбщегоМодуля>.<ИмяПроцедуры>", если процедура размещена в общем модуле; либо "<ИмяПроцедуры>" - в следующих случаях: если ИмяФормы заполнено, то в модуле указанной формы ожидается клиентская процедура; если ИмяФормы не заполнено, то в модуле менеджера этого объекта ожидается серверная процедура. В обработчик передаются два параметра:

    ПараметрКоманды - Массив из ЛюбаяСсылка - список объектов, для которых выполняется команда;

    ПараметрыВыполненияКоманды - см. ПодключаемыеКомандыКлиент.ПараметрыВыполненияКоманды

    • ДополнительныеПараметры - Структура - параметры обработчика, указанного в Обработчик. Необязательный. Расположение Общий модуль ПодключаемыеКомандыПереопределяемый

Доступность

Сервер, Толстый клиент, Внешнее соединение