Тип: Строка. Определяет назначение использования формы. См. также КлючНазначенияИспользования. Если режим совместимости Версия8_3_4 или ниже не установлен, то при попытке открытия формы клиентского приложения с параметром КлючНазначенияИспользования, длина значения которого превышает 128 символов, будет вызвано исключение.
Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.КлючНазначенияИспользования (ClientApplicationForm.PurposeUseKey)
ФормаКлиентскогоПриложения (ClientApplicationForm)
КлючНазначенияИспользования (PurposeUseKey)
Доступен, начиная с версии 8.2.
Использование:
Ключевой.
Описание:
Тип: Строка.
Определяет назначение использования формы.
См. также КлючНазначенияИспользования.
Если режим совместимости Версия8_3_4 или ниже не установлен, то при попытке открытия формы клиентского приложения с параметром КлючНазначенияИспользования, длина значения которого превышает 128 символов, будет вызвано исключение.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Отделить настройки учебного выбора
Короткий ключ отделяет сохраняемые настройки данного назначения. При отсутствии сохранённых настроек используются начальные; ключ не создаёт другую карточку.
Где и как запускать
Клиентская команда внешней учебной формы; серверный производитель находится отдельно в том же модуле.
Подготовка
Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте Справочник УчебныеКарточки; не добавляйте эти учебные объекты в рабочую базу.
Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.
Справочник неиерархический, без владельца. Имя УчебныеКарточки не означает наличие такого справочника в типовой конфигурации.
Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.
Создайте у собственного справочника управляемую объектную форму УчебноеОткрытие с основным реквизитом Объект. Выведите Наименование и Комментарий, оставьте стандартную команду выбора.
Основной клиентский блок и дополнительную серверную функцию разместите отдельно в модуле внешней учебной формы; добавьте кнопку команды ОткрытьПодчиненнуюКарточку.
ЭтаФорма в третьем аргументе ОткрытьФорму — реальный владелец, а не фиктивный объект. Повторный опыт проводите после закрытия дочерней формы.
&НаКлиенте
Процедура ОткрытьПодчиненнуюКарточку(Команда)
Ссылка = СоздатьСсылкуДляОткрытия();
ПараметрыОткрытия = Новый Структура("Ключ,РежимВыбора", Ссылка, Истина);
ПараметрыОткрытия.Вставить("КлючНазначенияИспользования", "УчебнаяКарточкаДляВыбора");
ОткрытьФорму("Справочник.УчебныеКарточки.Форма.УчебноеОткрытие", ПараметрыОткрытия, ЭтаФорма);
КонецПроцедурыМодуль внешней учебной формы: серверный производитель ссылки
&НаСервереБезКонтекста
Функция СоздатьСсылкуДляОткрытия()
Объект = Справочники.УчебныеКарточки.СоздатьЭлемент();
Объект.Наименование = "Учебная карточка";
Объект.Лимит = 100;
Объект.Комментарий = "Учебный пример";
Объект.Записать();
Возврат Объект.Ссылка;
КонецФункцииРазбор по шагам
Создаём свою ссылку, передаём ключ и режим выбора.
Стандартный параметр задаём до открытия, а владельца передаём третьим аргументом.
Короткий ключ отделяет сохраняемые настройки данного назначения. При отсутствии сохранённых настроек используются начальные; ключ не создаёт другую карточку.
Как проверить результат
Короткий ключ отделяет сохраняемые настройки данного назначения. При отсутствии сохранённых настроек используются начальные; ключ не создаёт другую карточку.
Созданная собственная карточка остаётся в учебной базе; ни один существующий рабочий объект не используется.
Ожидаемый результат
Стандартный параметр проверяется в настоящей собственной подчинённой форме.
На что обратить внимание
ТолькоПросмотр не заменяет роли и ограничения доступа.
Изменение параметра при повторном открытии может не примениться к уже открытому экземпляру.
КлючНазначенияИспользования не должен превышать 128 символов; это не UUID записи.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.