РегистрСведенийМенеджер.<Имя регистра сведений>.ПустойКлюч

Методы · EmptyKey

Получает пустое значение ключа записи регистра сведений.

Синтаксис

ПустойКлюч()
Полное описание, параметры и ограничения

РегистрСведенийМенеджер.<Имя регистра сведений>.ПустойКлюч (InformationRegisterManager.<Information register name>.EmptyKey)

РегистрСведенийМенеджер.<Имя регистра сведений> (InformationRegisterManager.<Information register name>)

ПустойКлюч (EmptyKey)

Доступен, начиная с версии 8.2.

Синтаксис:
ПустойКлюч()
Возвращаемое значение:
Тип: РегистрСведенийКлючЗаписи.<Имя регистра сведений>.

Описание:

Получает пустое значение ключа записи регистра сведений.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Создать ключ периодической цены, не записывая саму цену

Ключ записи формируется из периода и всех измерений. Непустой ключ ещё не означает наличие строки в регистре.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Создайте НОВУЮ пустую файловую базу. В Конфигураторе корню задайте имя Учебная85; не добавляйте учебные регистры в рабочую УТ/КА2/УНФ/БП.

  2. Регистры сведений → Добавить: УчебныеЦены. Режим записи Независимый, периодичность Непериодический. Измерение КодТовара: Строка, длина 50, индексировать. Ресурс Цена: Число, 12 цифр, 2 дробных, неотрицательное.

  3. Проверку заполнения измерения установите Показывать ошибку. Модуль набора записей оставьте ПУСТЫМ; обработчики записи, обмена, фоновые задания и внешние сервисы для урока не создавайте.

  4. Обновите конфигурацию базы данных. Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки для вызова ВыполнитьПример() Экспорт.

  5. Фрагмент вставьте в тело ВыполнитьПример. Каждую задачу запускайте отдельно. Вымышленные коды не являются справочными ссылками на рабочие товары.

  6. Создайте второй независимый регистр УчебнаяИсторияЦен: периодичность В пределах секунды, измерение КодТовара (Строка 50, индексировать), ресурс Цена (Число 12,2, неотрицательное). Модуль также пустой.

  7. Обновите конфигурацию базы данных. Код первого регистра не заменяйте именем рабочего регистра цен.

Описание = Метаданные.РегистрыСведений.Найти("УчебнаяИсторияЦен");
Если Описание = Неопределено Тогда
    ВызватьИсключение "Сначала подготовьте собственный учебный регистр";
КонецЕсли;
Если Описание.РежимЗаписи <> Метаданные.СвойстваОбъектов.РежимЗаписиРегистра.Независимый
    Или Описание.ПериодичностьРегистраСведений <> Метаданные.СвойстваОбъектов.ПериодичностьРегистраСведений.Секунда Тогда
    ВызватьИсключение "Настройки учебного регистра не соответствуют подготовке";
КонецЕсли;
Если Описание.Измерения.Количество() <> 1
    Или Описание.Измерения.Найти("КодТовара") = Неопределено
    Или Описание.Ресурсы.Найти("Цена") = Неопределено Тогда
    ВызватьИсключение "Нужны одно измерение КодТовара и ресурс Цена";
КонецЕсли;
Менеджер = РегистрыСведений.УчебнаяИсторияЦен;
Пустой = Менеджер.ПустойКлюч();
ЗначенияКлюча = Новый Структура("Период,КодТовара", Дата(2026, 9, 15, 10), "TRAIN-KEY-ONLY");
Ключ = Менеджер.СоздатьКлючЗаписи(ЗначенияКлюча);
Сообщить(Пустой.Пустой());
Сообщить(Не Ключ.Пустой());
Сообщить(Ключ.Период = Дата(2026, 9, 15, 10));
Сообщить(Ключ.КодТовара = "TRAIN-KEY-ONLY");
Сообщить(Ключ.Метаданные().Имя = "УчебнаяИсторияЦен");
Запись = Менеджер.СоздатьМенеджерЗаписи();
Запись.Период = Ключ.Период;
Запись.КодТовара = Ключ.КодТовара;
Запись.Цена = 123.45;
Сообщить(Запись.Модифицированность());
Сообщить(Не Запись.Выбран());
Сообщить("Ключ и менеджер заполнены только в памяти, Прочитать/Записать не вызывались.");

Разбор по шагам

  1. Периодический независимый регистр отличается ключом: к измерению добавляется Период.

  2. ПустойКлюч создаёт пустое значение ключа. СоздатьКлючЗаписи строит заполненный ключ из структуры.

  3. Ключ.КодТовара — динамическое измерение именно учебного регистра.

  4. Создаём менеджер записи и переносим ключевые поля. Значение цены не является частью ключа.

  5. Модифицированность означает изменение экземпляра в памяти, Выбран — чтение записи. Чтение/запись здесь отсутствуют.

Как проверить результат

  1. Все семь проверок Истина.

  2. Новые цены не появились в базе; ключ можно сформировать без сохранённой записи.

Ожидаемый результат

Различены идентичность записи, цена ресурса и существование данных в информационной базе.

На что обратить внимание

  1. Для независимого регистра нет Регистратора: его не подставляют в ключ этого урока.

  2. Для большей периодичности, например День, нужно учитывать нормализацию Периода; здесь В пределах секунды.

  3. Не используйте ключ как доказательство существования строки.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.