Структура

Типы · Structure

Представляет собой коллекцию пар КлючИЗначение. При этом ключ может быть только строковым и должен удовлетворять требованиям, предъявляемым к именованию переменных встроенного языка. К значениям структуры можно обращаться как к свойствам объекта. При этом ключ используется как имя свойства. Структура используется обычно для хранения небольшого количества значений, каждое из которых имеет некоторое имя.

Примеры платформы

История = Новый Массив;
Запись = Новый Структура;
Запись.Вставить("Настройки", ПостроительОтчетов.ПолучитьНастройки());
Запись.Вставить("Отчет", ТекущаяСтрока);
История.Добавить(Запись);
Полное описание, параметры и ограничения

Структура (Structure)

Структура (Structure)

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

Элементы коллекции:
КлючИЗначение
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются элементы коллекции.Порядок обхода неопределен.

Свойства:
<Имя ключа> (<Key name>)

Методы:
Вставить (Insert)
Количество (Count)
Очистить (Clear)
Свойство (Property)
Удалить (Delete)

Конструкторы:
На основании фиксированной структуры
По ключам и значениям

Описание:

Представляет собой коллекцию пар КлючИЗначение. При этом ключ может быть только строковым и должен удовлетворять требованиям, предъявляемым к именованию переменных встроенного языка.
К значениям структуры можно обращаться как к свойствам объекта. При этом ключ используется как имя свойства.
Структура используется обычно для хранения небольшого количества значений, каждое из которых имеет некоторое имя.

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

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером. Сериализуется. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data/core}. Имя типа XDTO: Structure.

Пример:

История = Новый Массив;
Запись = Новый Структура;
Запись.Вставить("Настройки", ПостроительОтчетов.ПолучитьНастройки());
Запись.Вставить("Отчет", ТекущаяСтрока);
История.Добавить(Запись);

См. также:
ФиксированнаяСтруктура
КлючИЗначение

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

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

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

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

Заполнить черновик и отдельно изменить его копию

Своя структура задаёт код и имя узла через явное копирование разрешённых полей. Копия остаётся новой; изменение её имени не меняет исходный объект.

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

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

Подготовка

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

  2. Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.

  3. Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.

  4. Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.

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

  6. В отдельной пустой конфигурации Учебная85 создайте Планы обмена → УчебныйОбмен: длина кода 9, тип Строка, наименование длиной 100. Распределённая информационная база выключена; состав плана пустой.

  7. Добавьте реквизит АдресУчебногоУзла: Строка длиной 100, Проверка заполнения = Показывать ошибку. Модуль объекта и подписки должны быть пустыми; не добавляйте отправку сообщений или внешние действия.

  8. Добавьте макет УчебнаяПамятка типа Текстовый документ, одна строка: Этот узел используется только для учебных примеров. История данных для плана не включена. Обновите конфигурацию базы данных.

  9. Каждый фрагмент запускайте отдельно на сервере в ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи. УчебныйОбмен не является существующим рабочим обменом КА2 или УТ.

  10. Узел каждый раз новый и периферийный. Существующие узлы и текущий узел базы не меняются. Запись, блокировка и удаление далее выполняются только над своим новым UUID в собственной отменяемой транзакции.

Если Метаданные.ПланыОбмена.Найти("УчебныйОбмен") = Неопределено Тогда
    ВызватьИсключение "Сначала создайте собственный учебный план обмена";
КонецЕсли;
Узел = ПланыОбмена.УчебныйОбмен.СоздатьУзел();
Если Узел.ЭтотУзел Тогда
    ВызватьИсключение "Нельзя изменять текущий узел информационной базы";
КонецЕсли;
Данные = Новый Структура;
Данные.Вставить("Код", "У00000001");
Данные.Вставить("Наименование", "Учебный узел книги");
Данные.Вставить("АдресУчебногоУзла", "example.invalid");
Узел.Заполнить(Данные);
ЗаполнитьЗначенияСвойств(Узел, Данные, "Код,Наименование,АдресУчебногоУзла");
Сообщить(Узел.Код = "У00000001");
Сообщить(Узел.Наименование = "Учебный узел книги");
Сообщить(Узел.АдресУчебногоУзла = "example.invalid");
Копия = Узел.Скопировать();
Копия.Наименование = "Отдельная копия книги";
Сообщить(Копия.ЭтоНовый());
Сообщить(Копия.Ссылка.Пустая());
Сообщить(Узел.Наименование = "Учебный узел книги");
Сообщить(Копия.Наименование = "Отдельная копия книги");

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

  1. Данные целиком сформированы в примере, не прочитаны из существующего рабочего узла.

  2. Заполнить инициирует ОбработкаЗаполнения. Пустой учебный обработчик не выдаём за готовый алгоритм переноса структуры.

  3. ЗаполнитьЗначенияСвойств явно копирует только три разрешённых собственных поля. Поэтому видно, откуда взялись код, имя и адрес.

  4. Скопировать создаёт новый объект, а не вторую переменную того же изменяемого объекта.

  5. Меняем имя копии и сравниваем оба имени; обе записи остаются только в памяти.

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

  1. Семь сравнений Истина.

  2. Новый код здесь учебный литерал; он не проверен на уникальность для реальной записи, которая не вызывается.

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

Проверены заполнение и независимое изменение своего нового узла.

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

  1. Не записывайте фиксированный учебный код в рабочий план обмена.

  2. Модуль заполнения рабочей конфигурации может выполнять другие операции; этот урок требует пустой учебный модуль.

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

Прочитать необязательную настройку и сохранить значение по умолчанию

Структура хранит настройки по именам. Метод Свойство позволяет отличить отсутствующую настройку от существующей со значением 0.

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

Фрагмент внутри учебной процедуры; внешних объектов нет.

Подготовка

  1. Создайте команду или процедуру для запуска примера.

  2. Оставьте исходное Количество равным 0 в структуре, чтобы увидеть разницу между отсутствием и нулевым значением.

Настройки = Новый Структура;
Настройки.Вставить("Название", "Книга");
Настройки.Вставить("Количество", 0);
Количество = 1;
Если Не Настройки.Свойство("Количество", Количество) Тогда
    Количество = 1;
КонецЕсли;
Сообщить(Количество);
Сообщить(Настройки.Количество());
Настройки.Удалить("Название");
Сообщить(Настройки.Количество());
Настройки.Очистить();
Сообщить(Настройки.Количество());

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

  1. Создаём структуру с двумя именованными свойствами.

  2. Метод Свойство возвращает признак наличия поля и передаёт его значение во второй аргумент.

  3. Количество 0 сохраняется как осмысленная настройка. Значение 1 выбирается только при отсутствии поля.

  4. Количество() возвращает число свойств структуры, а не значение поля Количество.

  5. Удалить убирает одно свойство, Очистить — все свойства.

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

  1. В исходном варианте ожидаются сообщения 0, 2, 1 и 0.

  2. Уберите строку Вставить для Количество: первое сообщение станет 1.

  3. Измените сохранённое количество на 3: первое сообщение должно стать 3 без изменения числа свойств.

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

Настройки читаются с явным правилом выбора значения по умолчанию; ноль не теряется.

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

  1. Имя свойства структуры должно быть допустимым идентификатором встроенного языка. Для произвольных строковых ключей используйте Соответствие.

  2. Точка и круглые скобки различают поле Количество и метод Количество().

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

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

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

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

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