Как изменить фиксированную структуру 1с

1c:коллекции:фиксированная_структура

Структура = Новый ФиксированнаяСтруктура(«КакойТоКлюч1, КакойТоКлюч2»,
                ЗначениеКотороеНадоСохранить1, ЗначениеКотороеНадоСохранить2);

Структура  = Новый Структура;
Структура.Вставить(«КакойТоКлюч1», ЗначениеКотороеНадоСохранить1);
Структура.Вставить(«КакойТоКлюч2», ЗначениеКотороеНадоСохранить2);
 
Структура2 = Новый ФиксированнаяСтруктура(Структура);

Сообщить(Структура2.КакойТоКлюч2);

Структура в 1С 8.3 это динамический набор данных (коллекция значений), каждый элемент которой состоит из пары «Ключ» и «Значение». Ключи структуры уникальны, поэтому ими можно идентифицировать значения. Ключ структуры должен иметь строковый тип данных и отвечать требованиям к именам переменных. К значениям структуры можно обращаться как к свойствам объекта, при этом ключ используется как имя свойства.

Создание структуры

Автомобиль = Новый Структура("Марка,ДатаВыпуска,ПробегКМ","BMW",Дата('20190101'),25000);

Результат:

Добавление элементов, установка значений

Метод Вставить() устанавливает значение элемента структуры по ключу. Если элемент с переданным значением ключа существует, то его значение заменяется, в противном случае добавляется новый элемент.

Автомобиль.Вставить("Цвет","Белый");//Добавили ключ и значение.
Автомобиль.Вставить("Цвет","Чёрный");// Т.к. ключ "Цвет" уже существует, произошла замена значения.

//Другие способы для установки значений
Автомобиль.Цвет = "Белый";//Для ключа "Цвет" установили значение "Белый"
Автомобиль["Цвет"] = "Чёрный";//Для ключа "Цвет" установили значение "Чёрный"

Как узнать количество элементов структуры

КоличествоЭлементов = Автомобиль.Количество();

Обход элементов структуры

Для Каждого Элемент Из Автомобиль Цикл
Ключ = Элемент.Ключ;
Значение = Элемент.Значение;
Сообщить(Ключ + " - " + Значение);
КонецЦикла;

Проверить ключ структуры на существование

// Если ключ существует, выражение вернёт "ИСТИНА" иначе вернёт "ЛОЖЬ"
Автомобиль.Свойство("Марка");

Получить значение элемента структуры по ключу

ЗначениеЭлемента = Неопределено;
Автомобиль.Свойство("Марка ",ЗначениеЭлемента);

Удалить элемент структуры

Автомобиль.Удалить("Цвет ");

Удалить все элементы структуры

Автомобиль.Очистить();

Пример преобразования структуры в таблицу значений

&НаКлиенте
Процедура СтруктураВТЗ(Команда)
РасписаниеДня = Новый Структура();
РасписаниеДня.Вставить("Начало","08:00");
РасписаниеДня.Вставить("Обед","12:00");
РасписаниеДня.Вставить("Конец","17:00");
ТаблицаЗнач = СтруктураВТЗНаСервере(РасписаниеДня);
КонецПроцедуры

&НаСервере
Функция СтруктураВТЗНаСервере(РасписаниеДня)

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Период");
ТЗ.Колонки.Добавить("Время");

Для Каждого КлючИЗначение из РасписаниеДня Цикл
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Период = КлючИЗначение.Ключ;
НоваяСтрока.Время = КлючИЗначение.Значение;
КонецЦикла;

Возврат ТЗ;

КонецФункции

Результат:

Как скопировать структуру

Пример №1

&НаКлиенте
Процедура СкопироватьСтруктуру(Команда)

Структура = Новый Структура();
Структура.Вставить("Фамилия","Петров");
Структура.Вставить("Имя","Пётр");
Структура.Вставить("Отчество","Петрович");

КопияСтруктуры= Новый Структура();
Для Каждого КлючИЗначение Из Структура Цикл
КопияСтруктуры.Вставить(КлючИЗначение.Ключ,КлючИЗначение.Значение);
КонецЦикла;

КонецПроцедуры

 Пример №2

Способ работает в рамках одной информационной базы.

&НаКлиенте
Процедура СкопироватьСтруктуру2(Команда)
Структура = Новый Структура();
Структура.Вставить("Фамилия","Петров");
Структура.Вставить("Имя","Пётр");
Структура.Вставить("Отчество","Петрович");
КопияСтруктуры = СкопироватьСтруктуруНаСервере(Структура);
КонецПроцедуры

&НаСервере
Функция СкопироватьСтруктуруНаСервере(Структура)
КопияСтруктуры = ЗначениеИзСтрокиВнутр(ЗначениеВСтрокуВнутр(Структура));
Возврат КопияСтруктуры;
КонецФункции

 Пример №3

&НаКлиенте
Процедура СкопироватьСтруктуру3(Команда)
Структура = Новый Структура();
Структура.Вставить("Фамилия","Петров");
Структура.Вставить("Имя","Пётр");
Структура.Вставить("Отчество","Петрович");
КопияСтруктуры = Новый ФиксированнаяСтруктура(Структура);
КонецПроцедуры

В примере №3 структура будет скопирована в неизменную (фиксированную) структуру.  Для такого вида структур не доступны методы Вставить(), Удалить(), Очистить().  Если требуется изменить фиксированную структуру, её необходимо скопировать в обычную.

ОбычнаяСтруктура = Новый Структура(ФиксированнаяСтруктура);

&НаКлиенте
Процедура ВыполнитьКод(Команда)
 
    /// Как создать структуру (способ 1) в 1с 8.3, 8.2
 
    ЛичныеДанные = Новый Структура;
    // пара ключ (имя переменной) - значение (произв. типа)
    ЛичныеДанные.Вставить("Фамилия", "Иванов");
    ЛичныеДанные.Вставить("Имя", "Иван");
    ЛичныеДанные.Вставить("ДатаРождения", '19800802');
 
    Сообщить(
        ЛичныеДанные.Имя + " " + ЛичныеДанные.Фамилия +
        " родился " + ЛичныеДанные.ДатаРождения
    );
 
    /// Как создать структуру (способ 2) в 1с 8.3, 8.2
 
    Время = Новый Структура("Часы,Минуты,Секунды", 12, 45, 33);
    Сообщить(
        "Время " + Время.Часы + ":" + Время.Минуты + ":" +
        Время.Секунды
    );
 
    /// Как изменить значение поля созданной структуры (способ 1)
    /// в 1с 8.3, 8.2
 
    ЛичныеДанные.Вставить("Фамилия", "Сидоров");
 
    /// Как изменить значение поля созданной структуры (способ 2)
    /// в 1с 8.3, 8.2
 
    Время.Часы = 13;
 
    /// Как узнать количество элементов структуры в 1с 8.3, 8.2
 
    Сообщить(Время.Количество());
 
    /// Как обойти все элементы структуры в 1с 8.3, 8.2
 
    Для Каждого Элемент Из ЛичныеДанные Цикл
        Сообщить(Элемент.Ключ + " " + Элемент.Значение);
    КонецЦикла;
 
    /// Как удалить элемент структуры в 1с 8.3, 8.2
 
    ЛичныеДанные.Удалить("ДатаРождения");
 
    /// Как очистить все элементы структуры в 1с 8.3, 8.2
 
    ЛичныеДанные.Очистить();
 
КонецПроцедуры
 
/// Скачать и выполнить эти примеры на компьютере

С уважением, Владимир Милькин (преподаватель школы 1С программистов и разработчик обновлятора).

Как помочь сайту: расскажите (кнопки поделиться ниже) о нём своим друзьям и коллегам. Сделайте это один раз и вы внесете существенный вклад в развитие сайта. На сайте нет рекламы, но чем больше людей им пользуются, тем больше сил у меня для его поддержки.

Нажмите одну из кнопок, чтобы поделиться:

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

Создание структуры

Для создания структуры используется конструктор:

СтруктураПараметров = Новый Структура;

Можно сразу в конструкторе указать ключи и значения:

СтруктураПараметров = Новый Структура(«КлючСтруктуры1, КлючСтруктуры2», 25, «значение»);

В этом случае будет создана структура с двумя ключами КлючСтруктуры1 и КлючСтруктуры2. При этом значение ключа КлючСтруктуры1 будет равно 25, а значение ключа КлючСтруктуры2 будет равно строке «значение». В дальнейшем можно изменять значения каждого ключа, можно добавлять новые ключи или удалять существующие. Если для какого-то ключа не указать значение, то оно будет равно Неопределено.

//оба значения будут равны Неопределено
СтруктураПараметров = Новый Структура(«КлючСтруктуры1, КлючСтруктуры2»);

Добавление нового ключа в структуру

Чтобы добавить новый ключ в структуру после ее создания можно использовать метод Вставить. Если в структуре уже был такой ключ, то значение будет заменено.

СтруктураПараметров = Новый Структура;
СтруктураПараметров.Вставить(«НовыйКлюч», 2);

Если попытаться добавить в структуру ключ, который начинается с цифры, то будет вызвано исключение «Задано неправильное имя атрибута структуры»:

СтруктураПараметров = Новый Структура;
СтруктураПараметров.Вставить(«1», 2);
//при компиляции модуля будет ошибка:
//Задано неправильное имя атрибута структуры

Обращение к свойствам структуры

К свойствам (ключам) структуры можно обращаться через точку «.» после имени структуры:

СтруктураПараметров = Новый Структура(«КлючСтруктуры1, КлючСтруктуры2», 25, «значение»);
СтруктураПараметров.КлючСтруктуры1 = «новое значение»;

Можно через оператор индексации []:

СтруктураПараметров = Новый Структура(«КлючСтруктуры1, КлючСтруктуры2», 25, «значение»);
СтруктураПараметров[«КлючСтруктуры1»] = «новое значение»;

Перебор структуры

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

Для Каждого КлючИЗначение Из СтруктураПараметров Цикл
	//метод Сообщить выводит значение на экран
	Сообщить(КлючИЗначение.Ключ);
	Сообщить(КлючИЗначение.Значение);
КонецЦикла;

Как удалить ключ из структуры

Удалить ключ из структуры можно методом Удалить. Данный метод удалит только один ключ. Если нужно удалить все ключи из структуры, то нужно использовать метод Очистить:

СтруктураПараметров.Удалить(«НовыйКлюч»); //удалит только один ключ
СтруктураПараметров.Очистить(); //удалит все ключи из структуры

Как проверить есть ли в структуре ключ

Метод Свойство позволяет проверить наличие в структуре указанного ключа. Если ключ присутствует в структуре, то метод вернет Истина. Если такого ключа нет, то метод вернет Ложь.

ЕстьКлюч = СтруктураПараметров.Свойство("НовыйКлюч");
Если ЕстьКлюч Тогда
	Сообщить("Ключ найден!"); 
КонецЕсли;	

Также с помощью данного метода можно получить значение по ключу:

Перем Значение;
//вторым параметром передаем переменную, в которую будет помещено значение
ЕстьКлюч = СтруктураПараметров.Свойство("НовыйКлюч", Значение);
Если ЕстьКлюч Тогда
	Сообщить(Значение); 
КонецЕсли;	

Если в структуре нет такого ключа, то в переменной Значение будет Неопределено.

Поиск в структуре

Чтобы найти какой-то ключ в структуре можно использовать все тот же самый метод Свойство:

Перем НайденноеЗначение;
Если СтруктураПараметров.Свойство("НовыйКлюч", НайденноеЗначение) Тогда
	Сообщить("Значение найдено: " + НайденноеЗначение); 
Иначе
	Сообщить("Значение не найдено"); 
КонецЕсли;	

Но если поиск в структуре нужно выполнить по значению, то придется перебрать всю структуру:

//поищем в структуре значение "Поиск"
НашлиЗначение = Ложь;
Для Каждого КлИЗнач Из СтруктураПараметров Цикл
	Если КлИЗнач.Значение = "Поиск" Тогда
		//нашли
		НашлиЗначение = Истина;
		Прервать;
	КонецЕсли;	
КонецЦикла;

Если Не НашлиЗначение Тогда
	//не нашли	
КонецЕсли;	

Количество элементов структуры

Узнать количество элементов (ключей, свойств) структуры можно с помощью метода Количество:

Колво = СтруктураПараметров.Количество();

Как скопировать структуру

Стр = Новый Структура("Ключ1", 1);
ВложеннаяСтр = Новый Структура("Ключ2", 2);
Стр.Вставить("ВложеннаяСтр", ВложеннаяСтр);

Копия = Новый Структура;
Для Каждого КлючИЗначение Из Стр Цикл
	Копия.Вставить(КлючИЗначение.Ключ, КлючИЗначение.Значение);	
КонецЦикла;
//в этом случае в структуре Копия в ключе ВложеннаяСтр
//будет та же самая структура, что и в переменной 
//ВложеннаяСтр и в структуре Стр

//для создания полной копии можно сделать так:
ПолнаяКопия = ЗначениеИзСтрокиВнутр(ЗначениеВСтрокуВнутр(Стр));

Фиксированная Структура

Фиксированная структура — это та же самая структура, но после создания нельзя изменить состав ключей и значения. Можно создать на основании обычной структуры (будет создана полная копия), по ключам и значениям или пустую структуру:

//пустая структура
ФиксСтр = Новый ФиксированнаяСтруктура;

//по ключам и значениям
ФиксСтр = Новый ФиксированнаяСтруктура(«Ключ1, Ключ2», 1, 2);

//на основании обычной структуры
ОбычнаяСтруктура = Новый Структура(«Ключ1, Ключ2», 1, 2);
ФиксСтр = Новый ФиксированнаяСтруктура(ОбычнаяСтруктура);

У фиксированной структуры есть только 2 метода:

— Количество()
— Свойство(<Ключ>, <НайденноеЗначение>)

К ключам структуры можно обращаться как к свойству: ФиксСтр.Ключ1, но нельзя менять значение свойства.

На основании фиксированной структуры можно создать обычную структуру:

ФиксСтр = Новый ФиксированнаяСтруктура(«Ключ1, Ключ2», 1, 2);

ОбычнаяСтруктура = Новый Структура(ФиксСтр);
ОбычнаяСтруктура.Ключ1 = 11; //теперь можно менять значения

Смотрите также:
Электронный учебник по по программированию в 1С
Рекомендации по изучению программирования 1С с нуля
Программное решение для сдачи и подготовки к экзаменам
Программирование в 1С 8.3 с нуля — краткий самоучитель
Комплексная подготовка программистов 1С:Предприятие 8.2
Сайты с уроками программирования и со справочниками
Youtube-каналы с уроками программирования
Сайты для обучения программированию
Лекции и уроки

Большинство объектов встроенного языка 1с предназначены для описания алгоритмов функционирования бизнес-логики.

Еще одна группа объектов, не входящая в состав объектов базы данных, — универсальные коллекции значений — не менее важная группа объектов. Хранит временные наборы данных в течение сеанса работы пользователя, служит для вспомогательного сбора, группировки, анализа и обработки информации:

Массив

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

Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются значения элементов массива. Возможно обращение к значению элемента посредством оператора […]. В качестве аргумента передается индекс значения (нумерация с 0).

Более подробно о массивах тут.

Структура

Также как и структура, представляет собой коллекцию пар ключ — значение. Однако, в отличие от структуры, ключ может быть практически любого типа.

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

Соответствие

Также как и структура, представляет собой коллекцию пар ключ — значение. Однако, в отличие от структуры, ключ может быть практически любого типа.

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

Список значений

Список значений — это не сохраняемый в базе данных объект, который позволяет строить для решения интерфейсных задач динамические наборы значений и манипулировать ими (добавлять, редактировать, удалять элементы, сортировать). Может быть наполнен значениями любого типа, т.е. в одном списке типы хранимых значений могут быть разными.

Например, список значений может использоваться для выбора конкретного документа из списка возможных документов, сформированного по сложному алгоритму.

Таблица значений

Таблица значений позволяет строить динамические наборы значений и манипулировать ими. Она может быть наполнена значениями любого типа, и в одной таблице типы хранимых значений могут быть разными.

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

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

Дерево значений

Дерево значений представляет собой динамически формируемый набор значений любого типа, похожий на таблицу значений. В отличие от таблицы значений, строки дерева значений могут образовывать иерархические структуры: каждая строка дерева может иметь набор подчиненных строк, каждая из подчиненных строк, в свою очередь, также может иметь набор подчиненных строк и так далее. При этом поиск значений, сортировка, получение итогов могут осуществляться либо по текущему уровню иерархии, либо включая все подчиненные.

Дерево значений может иметь визуальное представление, если с ним связать элемент управления ТабличноеПоле. Внешний вид такого элемента будет похож на дерево групп справочника.

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

COMSafeArray

Представляет собой объектную оболочку над многомерным массивом SAFEARRAY из COM. Позволяет создавать и использовать SAFEARRAY для обмена данными между COM-объектами.

Фиксированный массив

Неизменяемый массив. Заполняется системой при инициализации объектов данного типа или разработчиком, с помощью конструктора.

Фиксированная коллекция

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

Фиксированное соответствие

Неизменяемая коллекция пар КлючИЗначение. В качестве ключа может выступать любое значение. Рекомендуется, чтобы в качестве ключа выступало значение примитивного типа или другого типа, значение которого может только присваиваться, но не может менять свое содержимое.

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

Если при обращении к элементу коллекции с помощью оператора [], указан несуществующий ключ, будет вызвано исключение. В то же время метод Получить, в параметре которого указан несуществующий ключ, возвращает значение Неопределено.

Фиксированная структура

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

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