Другое · 6 мин
Как получить значение из хранилища значений 1С
Разбираем, как просто извлечь значение из хранилища значений 1С по ключу, проверить наличие ключа и избежать типичных ошибок при работе с коллекцией.
Хранилище значений в 1С предназначено для временного хранения пар «ключ — значение» в рамках одной сессии, процедуры или перемещения данных между формами и модулями. Оно удобно, когда нужно передать промежуточный результат, настройку или объект без записи в базу данных и без создания лишних регистров сведений.
Основной способ получить значение — обратиться к хранилищу по ключу. Если ключ есть, метод возвращает сохранённое значение; если ключа нет, результат обычно равен Неопределено. Поэтому получение значения почти всегда должно сочетаться с проверкой наличия ключа.
В статье разобраны порядок действий, проверка результата, ограничения по типам ключей и типичные ошибки. Материал полезен для самостоятельной настройки обработок, отчётов и форм, но не заменяет конфигурирование под конкретную информационную базу.
Что такое хранилище значений и где оно применяется
Хранилище значений представляет собой коллекцию, в которой каждое значение привязано к своему ключу. Ключом может быть строка, число, дата или другое значение, а значением — почти любые данные, которые можно сохранить в переменной, включая справочники, документы, таблицы значений и структуры.
Типичные сценарии: передача выбранного контрагента из формы отчёта в модуль обработки, кэш промежуточных расчётов внутри одной сессии, временное хранение пользовательских настроек при работе с формой. Данные не записываются в базу автоматически и исчезают после завершения соответствующего контекста, если не сохранить их явно.
Значение = Хранилище.Получить(Ключ);
Если Значение = Неопределено Тогда
// ключ отсутствует, нужна альтернативная обработка
КонецЕсли;Как получить значение по ключу
Для извлечения используется метод Получить, которому передаётся ключ. Результат присваивается переменной, после чего программа может проверить, получено ли значение, и продолжить работу. Если хранилище было очищено или ключ никогда не добавлялся, метод не создаёт значение автоматически.
Порядок действий: определите источник ключа, убедитесь, что значение было добавлено в это же хранилище, вызовите Получить и проверьте результат на Неопределено. Разные экземпляры хранилища значений независимы, поэтому значение, полученное в одном модуле, не будет доступно в другом, если не передать само хранилище.
Как проверить результат
Метод Содержит возвращает Истина
Метод Содержит возвращает Ложь или Получить вернул Неопределено
Соответствует ожидаемому справочнику, документу, числу или строке
Неопределено или неожидаемый составной тип
Проверка наличия ключа и обработка отсутствия
Перед получением целесообразно вызвать Содержит(Ключ). Если метод возвращает Истина, ключ есть и можно безопасно извлекать значение. Если Ложь, программа может использовать значение по умолчанию, запросить данные повторно или завершить обработку с понятным сообщением.
Признак успешного получения: переменная содержит ожидаемый тип и не равна Неопределено. Признак проблемы: попытка обратиться к свойству или методу у Неопределено приводит к ошибке выполнения. Поэтому после Получить всегда проверяйте результат, если ключ может отсутствовать.
Особенности ключей и типов данных
Ключи сравниваются по значению и типу, поэтому одинаково выглядящие строки с разным регистром или разными невидимыми символами могут считаться разными ключами. Числа и даты тоже должны совпадать точно, иначе хранилище не найдёт запись.
Значения могут быть простыми или сложными. При получении объекта справочника или документа вы получаете ссылку, а не копию. Изменение полученного объекта может отразиться на исходном данных, поэтому будьте осторожны с записью в полученные справочники и документы без понимания последствий.
Частые ошибки при получении значения
Первая ошибка — обращение к Получить без проверки на Неопределено. Программа может упасть при попытке использовать отсутствующее значение в расчётах, отчётах или печатных формах. Вторая ошибка — использование разных экземпляров хранилища, когда данные добавляются в одно, а читаются из другого.
Третья ошибка — несоответствие типов ключей. Например, ключ сохранён как строка "123", а извлекается по числу 123, что приводит к отсутствию записи. Четвёртая ошибка — хранение конфиденциальных данных в временном хранилище без понимания того, кто имеет доступ к сессии.
Как выбрать действие
Безопасная работа и альтернативы
Если значение нужно сохранить надолго, используйте регистры сведений, настройки пользователей, справочники или документы в зависимости от задачи. Хранилище значений подходит только для временных данных внутри одного процесса. Не полагайтесь на него для обмена данными между независимыми заданиями или пользователями.
Если ключ отсутствует, безопасным действием будет остановка обработки с сообщением пользователю или использование значения по умолчанию. Не пытайтесь угадать ключ перебором и не записывайте в хранилище пароли, платежные реквизиты или иные конфиденциальные сведения.
Что важно запомнить
Значение из хранилища значений 1С получается методом Получить по ключу, но перед использованием нужно проверять наличие ключа и результат на Неопределено. Хранилище подходит только для временных данных, а не для постоянного хранения.
Часто задаваемые вопросы
Что вернёт метод Получить, если ключа нет?
Обычно метод вернёт Неопределено. Программа не создаёт значение автоматически, поэтому после вызова нужно проверить результат, прежде чем использовать его в вычислениях или передавать в другие процедуры.
Можно ли получить значение из другого экземпляра хранилища?
Нет, если это другой объект хранилища, в нём не будет данных, добавленных в первый. Значения доступны только внутри того же экземпляра, который был передан или создан в текущем контексте.
Нужно ли проверять тип ключа перед получением?
Да, потому что ключи чувствительны к типу и точному значению. Строка и число с одинаковым внешним видом могут быть разными ключами, поэтому используйте те же переменные и типы, что при добавлении.
Подходит ли хранилище для постоянного хранения данных?
Нет, это временное хранилище для работы в рамках сессии или процедуры. Для постоянного хранения используйте справочники, документы, регистры сведения или настройки, предназначенные для записи в базу.