Тип: Структура. Может использоваться в тех случаях, когда необходимо хранить некоторые значения, связанные с объектом, на время выполнения некоторых операций, без изменения объекта. Например, при обработке событий в подписке на события.
Полное описание, параметры и ограничения
ВнешнийИсточникДанныхКубНаборЗаписей.<Имя внешнего источника>.<Имя куба>.ДополнительныеСвойства (ExternalDataSourceCubeRecordSet.<External source name>.<Cube name>.AdditionalProperties)
ВнешнийИсточникДанныхКубНаборЗаписей.<Имя внешнего источника>.<Имя куба> (ExternalDataSourceCubeRecordSet.<External source name>.<Cube name>)
ДополнительныеСвойства (AdditionalProperties)
Доступен, начиная с версии 8.3.3.
Использование:
Только чтение.
Описание:
Тип: Структура.
Может использоваться в тех случаях, когда необходимо хранить некоторые значения, связанные с объектом, на время выполнения некоторых операций, без изменения объекта. Например, при обработке событий в подписке на события.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.3.
Методическая информация
Практические примеры
Прочитать куб с отбором по товару
Отбор ограничивает чтение нужным товаром. ДополнительныеСвойства хранит собственную заметку в памяти, а ЭтотОбъект возвращает этот же набор.
Где и как запускать
Синтаксический пример для толстого клиента: вставьте код в тело обработчика своей учебной формы. Настройте указанный внешний источник заранее. В тонкий клиент эти фрагменты переносить нельзя. Здесь код не запускался.
Подготовка
В учебной конфигурации настройте внешний источник Аналитика, куб Продажи и его таблицу измерения Товары. Имена в коде — имена этих метаданных, а не перевод названий из внешней системы.
В измерении Товары используйте строковый ключ BOOK и поле Код. В кубе задайте измерение и ключевое поле Товар, числовые поля Количество и Сумма. Для просмотра нужны доступные учебные данные и настроенное подключение.
Куб = ВнешниеИсточникиДанных.Аналитика.Кубы.Продажи;
СсылкаТовара = Куб.ТаблицыИзмерений.Товары.ПолучитьСсылку("BOOK");
Набор = Куб.СоздатьНаборЗаписей();
Набор.Отбор.Товар.Установить(СсылкаТовара);
Сообщить("До чтения: " + Строка(Набор.Выбран()));
Набор.Прочитать();
Набор.ДополнительныеСвойства.Вставить("Назначение", "Продажи выбранного товара");
СамНабор = Набор.ЭтотОбъект;
Сообщить("После чтения: " + Строка(Набор.Выбран()));
Сообщить("Строк: " + Строка(СамНабор.Количество()));
Сообщить(Набор.ДополнительныеСвойства.Назначение);Разбор по шагам
Создайте пустой набор и задайте равенство поля Товар нужной ссылке.
Выполните Прочитать и получите количество фактически прочитанных строк.
Добавьте собственную заметку в структуру и прочитайте набор через ЭтотОбъект.
Как проверить результат
После успешного Прочитать значение Выбран показывает прочитанное состояние; количество может быть нулевым.
Заметка показывается из ДополнительныеСвойства и не записывается в источник.
Ожидаемый результат
Показан обычный синтаксис вызовов и способ использовать результат. Здесь пример не исполнялся; результат зависит от подготовленных метаданных и внешних учебных данных.
На что обратить внимание
Отбор, ЭтотОбъект и ДополнительныеСвойства — свойства только для чтения: не присваивайте им другой объект. Содержимое структуры ДополнительныеСвойства изменять можно.
Изменение отбора сбрасывает признак прочитанного набора; затем нужно читать заново.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.