1с изменение значения реквизита справочника

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

• Создание элемента справочника
• Поиск элементов справочника
• Изменение элементов справочника
• Удаление элементов справочника
• Обход элементов справочника
• Выбор элементов справочника запросом
• Открытие форм справочника

Создание элемента справочника

Создание новых элементов и групп справочника производится с помощью программного объекта СправочникМенеджер.<Имя справочника>. Данный объект доступен только на сервере.
Создание нового элемента или группы справочника состоит из следующих этапов:

1. Создание элемента или группы;
2. Заполнение владельца (если справочник подчиненный);
3. Заполнение родителя (если справочник иерархический);
4. Заполнение наименования и реквизитов (если не задана автоматическая нумерация, то и кода);
5. Заполнение табличных частей;
6. Запись элемента.

Создание новой группы:
НоваяГруппа = Справочники.Контрагенты.СоздатьГруппу(); // Создание группы
НоваяГруппа.Наименование = "Покупатели"; // Заполнение наименования
НоваяГруппа.Записать(); // Запись группы

Создание нового элемента:
НовыйЭлемент = Справочники.Контрагенты.СоздатьЭлемент(); // Создание элемента
НовыйЭлемент.Родитель = Справочники.Контрагенты.НайтиПоНаименованию("Покупатели"); // Заполнение родителя
НовыйЭлемент.Наименование = "Ромашка ООО"; // Заполнение наименования
НовыйЭлемент.ИНН = "123456789"; // Заполнение реквизита

// Добавление новой строки табличной части
НоваяСтрока = НовыйЭлемент.КонтактнаяИнформация.Добавить();
НоваяСтрока.Тип = "Адрес";
НоваяСтрока.Представление = "Москва";

НовыйЭлемент.Записать(); // Запись элемента


Поиск элементов справочника

Для поиска элементов справочников в языке программирования 1С предусмотрено несколько методов:

• НайтиПоКоду(<Код>, <ПоискПоПолномуКоду>, <Родитель>, <Владелец>)
• НайтиПоНаименованию(<Наименование>, <ТочноеСоответствие>, <Родитель>, <Владелец>)
• НайтиПоРеквизиту(<ИмяРеквизита>, <ЗначениеРеквизита>, <Родитель>, <Владелец>)

Во всех методах если поиск успешный, то будет возвращена ссылка на найденный элемент.
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоКоду("123"); // Поиск контрагента с кодом "123"
НайденныйДоговор = Справочники.ДоговорыКонтрагентов.НайтиПоКоду("1", , , НайденныйКонтрагент); // Поиск подчиненного найденному контрагенту договора с номером "1"
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоНаименованию("Покупатели"); // Поиск элемента с наименованием "Покупатели"
НайденныйКонтрагент1 = Справочники.Контрагенты.НайтиПоНаименованию("Ромашка ООО", , НайденныйКонтрагент); // Поиск элемента с наименованием "Ромашка ООО" в группе "Покупатели"
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоРеквизиту("ИНН", "123456789"); // Поиск контрагента с ИНН "123456789"


Изменение элементов справочника

Для изменения реквизитов справочника необходимо выполнить следующие действия:

1. Получить объект элемента справочника (метод ПолучитьОбъект(), возвращает тип СправочникОбъект.<Имя справочника>);
2. Присвоить новые значения реквизитам объекта;
3. Записать объект элемента справочника.

Программное изменение справочника возможно только на стороне сервера.

Например, на форму обработки выведен реквизит Номенклатура типа СправочникСсылка.Номенклатура. Вот пример кода, изменяющего наименование выбранной пользователем номенклатуры:
НоменклатураОбъект = Номенклатура.ПолучитьОбъект();
НоменклатураОбъект.Наименование = "Новое наименование";
НоменклатураОбъект.Записать();


Удаление элементов справочника

Элементы справочника могут быть помечены на удаление и удалены из базы непосредственно.

Непосредственное удаление – операция необратимая, в то время как пометку на удаление можно отменить. Пометка на удаление хранится в предопределенном реквизите ПометкаУдаления. В пользовательском режиме помеченные на удаление элементы и группы справочника помечаются красным крестиком.

Пометку на удаление можно установить/снять двумя разными способами:
// Способ 1. Использование метода УстановитьПометкуУдаления()
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоКоду("123");
КонтрагентОбъект = НайденныйКонтрагент.ПолучитьОбъект();
КонтрагентОбъект.УстановитьПометкуУдаления(Истина);

// Способ 2. Изменение свойства ПометкаУдаления
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоКоду("123");
КонтрагентОбъект = НайденныйКонтрагент.ПолучитьОбъект();
КонтрагентОбъект.ПометкаУдаления = Истина;
КонтрагентОбъект.Записать();

Пример непосредственного удаления элемента справочника:
НайденныйКонтрагент = Справочники.Контрагенты.НайтиПоКоду("123");
КонтрагентОбъект = НайденныйКонтрагент.ПолучитьОбъект();
КонтрагентОбъект.Удалить();


Обход элементов справочника

Для обхода элементов справочника в языке программирования 1С предусмотрено два метода:

• Выбрать(<Родитель>, <Владелец>, <Отбор>, <Порядок>)
• ВыбратьИерархически(<Родитель>, <Владелец>, <Отбор>, <Порядок>)

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

Рассмотрим примеры обхода элементов справочника:
// Обход всех элементов справочника Контрагенты
Выборка = Справочники.Контрагенты.Выбрать(); // Получение выборки всех элементов справочника
Пока Выборка.Следующий() Цикл
//действия с очередным элементом
Сообщить(Выборка.Наименование);
КонецЦикла;

// Обход контрагентов из группы "Покупатели"
ГруппаПокупатели = Справочники.Контрагенты.НайтиПоНаименованию("Покупатели");
Выборка = Справочники.Контрагенты.Выбрать(ГруппаПокупатели);
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование);
КонецЦикла;

// Обход контрагентов с пустым ИНН
// Реквизит ИНН должен быть проиндексирован!
Отбор = Новый Структура("ИНН", ""); // Структура может содержать только один элемент
Выборка = Справочники.Контрагенты.Выбрать(, , Отбор);
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование);
КонецЦикла;

Выбор элементов справочника запросом

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

Простой пример поиска и вывода товаров со стоимостью больше 1000:
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Товары.Наименование
|ИЗ
| Справочник.Товары КАК Товары
|ГДЕ
| Товары.Стоимость > 1000";
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование);
КонецЦикла;

Открытие форм справочника

Для открытия любых форм справочников рекомендуется использовать метод
ОткрытьФорму(<ИмяФормы>, <Параметры>, <Владелец>, <Уникальность>, <Окно>, <НавигационнаяСсылка>, <ОписаниеОповещенияОЗакрытии>, <РежимОткрытияОкна>)

Для открытия формы элемента или группы справочника также возможно использовать более простой метод
ПоказатьЗначение(<ОписаниеОповещенияОЗавершении>, <Значение>)

Кроме методов ОткрытьФорму() и ПоказатьЗначение() есть и другие (ОткрытьФормуМодально, ОткрытьЗначение, ПолучитьФорму), но их использование не рекомендуется, т.к. часть этих методов использует режим модального открытия, часть противоречит свежим рекомендациям фирмы 1С.

Приведем примеры программного открытия форм справочника:
// Открыть форму списка
ОткрытьФорму("Справочник.Контрагенты.ФормаСписка");

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


Внимание!

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

26.10.07 — 17:46

ДОброго времени суток, товарищи помогите решить вот такую проблему,

ну могу программно записать в справочнике «Контрагенты»  — реквизит -(Справочники.Организации) т.е. справочник.Организации подчинен контрагентам, как можно вписать туда значение?

Заранее спасибо!

1 — 26.10.07 — 17:49

2 — 26.10.07 — 17:49

3 — 26.10.07 — 17:51

можно чуть чуть подробнее, я не сильно понял что куда девать

4 — 26.10.07 — 18:03

надо работать собъектом а не со ссылкой на него. судя по (2) работаешь со ссылкой

5 — 26.10.07 — 18:12

6 — 26.10.07 — 18:16

(5)а какая ошибка?

7 — 26.10.07 — 18:20

Не удается все это дело записать

8 — 26.10.07 — 18:21

9 — 26.10.07 — 18:21

10 — 26.10.07 — 18:25

СегментацияКонтрагентов — это точно реквизит?

11 — 26.10.07 — 18:26

да это реквизит, с типом СправочникСсылка.СегментацияКонтрагентов

12 — 26.10.07 — 18:30

13 — 26.10.07 — 18:33

а еще было бо неплохо пройтись отладчиком.

14 — 26.10.07 — 18:35

да ну видать пока что ума не хватает на решение, отладчиком я проходился… ничего не нашел…ну в любом случае спасибо за рекомендт

15 — 26.10.07 — 18:40

(14) отладчиком, ПередЗаписью и ПриЗаписи, модуля объекта справочника прошелся?

смотри может где при записи в РС вылетает

А открытых элеметов справочника «Контрагентов» нет в это время?

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

СправочникиМенеджер

Объект СправочникиМенеджер предназначен для управления всеми справочниками конфигурации. Через цикл можно получить доступ к менеджеру каждого справочника:

//перебор всех менеджеров справочников:
Для Каждого Мен Из Справочники Цикл
	//Мен - менеджер конкретного справочника
КонецЦикла;

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

//Получение менеджера конкретного справочника:
МенТовары = Справочники.Товары;
МенТовары = Справочники[«Товары»];

Также через СправочникиМенеджер можно проверить является ли ссылка справочником:

//какая-то ссылка, нужно узнать это ссылка на справочник или нет
ПростоСсылка = ПолучитьКакуюТоСсылку();

//получим описание типов со всеми типами справочников конфигурации
ВсеСправочникиКонфигурации = Справочники.ТипВсеСсылки();

//проверяем
Если ВсеСправочникиКонфигурации.СодержитТип(ТипЗнч(ПростоСсылка)) Тогда
	//да, это справочник
Иначе
	//нет, что-то другое
КонецЕсли;

Программное создание элемента справочника

Для программного создания элементов есть метод СоздатьЭлемент. Для программного создания групп — метод СоздатьГруппу:

НовыйТовар = Справочники.Товары.СоздатьЭлемент();
НовыйТовар.Наименование = "Клавиатура";
//...заполнение прочих реквизитов
//запись в базу
НовыйТовар.Записать();

НоваяГруппаТоваров = Справочники.Товары.СоздатьГруппу();
НоваяГруппаТоваров.Наименование = "Комплектующие";
//...заполнение прочих реквизитов
//запись в базу
НоваяГруппаТоваров.Записать();

Программное изменение элементов справочника

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

//функция вернула какую-то ссылку на справочник Товары
СсылкаНаТовар = СсылкаНаТовар();

//получам объект из ссылки
ТоварОбъект = СсылкаНаТовар.ПолучитьОбъект();
//меняем наименование
ТоварОбъект.Наименование = ТоварОбъект.Наименование + " (изменение)";
//записываем
ТоварОбъект.Записать();

Программное копирование элемента справочника

Методом Скопировать можно создать копию элемента справочника. Данный метод можно вызывать как у ссылки, так и у объекта:

//через ссылку
КопияИзСсылки = СсылкаНаТовар.Скопировать();
КопияИзСсылки.Записать();

//через объект
ТоварОбъект = СсылкаНаТовар.ПолучитьОбъект();
КопияИзОбъекта = ТоварОбъект.Скопировать();
КопияИзОбъекта.Записать();

Программное удаление элемента справочника

Для удаления применяются два метода: УстановитьПометкуУдаления и Удалить. Метод УстановитьПометкуУдаления только установит пометку на удаление, сам элемент не будет удален из базы данных. Метод Удалить удалит элемент из базы данных без проверки ссылочной целостности. То есть, если на этот элемент были ссылки в других местах, то теперь вместо ссылки будет надпись «Объект не найден». Не рекомендуется пользоваться методом Удалить. Важно отметить, что вызов метода УстановитьПометкуУдаления вызывает запись объекта. Дополнительно записывать объект не нужно.

ТоварОбъект = СсылкаНаТовар.ПолучитьОбъект();
ТоварОбъект.УстановитьПометкуУдаления(Истина);
//также будут помечены на удаление все подчиненные элементы

//без пометки удаления подчиненных элементов:
ТоварОбъект.УстановитьПометкуУдаления(Истина, Ложь);

//снятие пометки на удаление
ТоварОбъект.УстановитьПометкуУдаления(Ложь);

//удаление без проверки ссылочной целостности
ТоварОбъект.Удалить();
//также удалит все вложенные элементы

Программный поиск по справочнику

Для поиска используются методы НайтиПоКоду, НайтиПоНаименованию и НайтиПоРеквизиту.

НайтиПоКоду

//поиск по коду
ТоварСсылка = Справочники.Товары.НайтиПоКоду("000000008");

//по полному коду. Полный код включает в себя все коды родителей:
//код родителя/код элемента
ТоварСсылка = Справочники.Товары.НайтиПоКоду("000000003/000000008", Истина);

//поиск в пределах одной группы, Группа - ссылка на группу справочника 
ТоварСсылка = Справочники.Товары.НайтиПоКоду("000000008",, Группа); 

//поиск в пределах владельца, Владелец - ссылка на владельца
ТоварСсылка = Справочники.Товары.НайтиПоКоду("000000008",,, Владелец); 

НайтиПоНаименованию

//поиск по наименованию, должна совпадать левая часть
ТоварСсылка = Справочники.Товары.НайтиПоНаименованию("Смартфон");
//будут найдены и "Смартфон" и "Смартфон самсунг", но метод вернет первый 
//попавшийся элемент

//точное совпадение, кроме хвостовых пробелов
//будет найден только Смартфон
ТоварСсылка = Справочники.Товары.НайтиПоНаименованию("Смартфон", Истина); 

//поиск в пределах одной группы, Группа - ссылка на группу справочника
ТоварСсылка = Справочники.Товары.НайтиПоНаименованию("Смартфон",, Группа); 

//поиск в пределах владельца, Владелец - ссылка на владельца
ТоварСсылка = Справочники.Товары.НайтиПоНаименованию("Смартфон",,,Владелец); 

Для обоих методов если элемент не будет найден, то метод вернет пустую ссылку. Если для справочника указана нулевая длина кода или наименования, то метод вернет Неопределено.

НайтиПоРеквизиту

//поиск по реквизиту, 1-ый параметр имя реквизита, 2-ой значение
ТоварСсылка = Справочники.Товары.НайтиПоРеквизиту("Артикул", "Арт001"); 

//поиск в пределах одной группы, Группа - ссылка на группу справочника
ТоварСсылка = Справочники.Товары.НайтиПоРеквизиту("Артикул", "Арт001", Группа); 

//поиск в пределах владельца, Владелец - ссылка на владельца
ТоварСсылка = Справочники.Товары.НайтиПоРеквизиту("Артикул","Арт1",,Владелец); 

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

Выборка справочника

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

//отбор по артикулу. Поле артикул должно быть проиндексировано
//в отборе может быть только одно поле.
ОтборАрт = Новый Структура("Артикул", "");
ВыборкаСпр = Справочники.Товары.Выбрать(,, ОтборАрт, "Наименование Убыв");
Пока ВыборкаСпр.Следующий() Цикл
	Сообщить(ВыборкаСпр.Наименование);
КонецЦикла;
//выборка будет отсортирована по убыванию поля Наименование
//по умолчанию сортируется по основному представлению. Можно указать только
//Код, наименование или проиндексированный реквизит примитивного типа.

//отбор по родителю или владельцу:
ВыборкаСпр = Справочники.Товары.Выбрать(Группа);
ВыборкаСпр = Справочники.Товары.Выбрать(, Владелец);

//иерархическая выборка, сначала группы, потом элементы из этой группы
ВыборкаСпр = Справочники.Товары.ВыбратьИерархически();
//можно получить уровень элемента (для верхнего = 0)
Сообщить(ВыборкаСпр.УровеньВВыборке());

//из выборки можно получить объект
Пока ВыборкаСпр.Следующий() Цикл
	ТоварОбъект = ВыборкаСпр.ПолучитьОбъект();
КонецЦикла;

Получение ссылки по уникальному идентификатору

С помощью метода УникальныйИдентификатор можно получить уникальный идентификатор от ссылки справочника. Чтобы через уникальный идентификатор получить ссылку на справочник используется метод ПолучитьСсылку:

//получение УИД ссылки
УИДСпр = ТоварСсылка.УникальныйИдентификатор();

//получение ссылки по УИД
ТоварСсылка = Справочники.Товары.ПолучитьСсылку(УИДСпр);
ТоварОбъект = Ссылка.ПолучитьОбъект();
//если после получения объекта от ссылки он равен Неопределено, 
//значит этой ссылки не соответствует ни один объект базы данных
Если ТоварОбъект = Неопределено Тогда
	//нет такого объекта
КонецЕсли;

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

//переменная УИДСтрокой - это строка с идентификатором из другой базы
УИДСпр = Новый УникальныйИдентификатор(УИДСтрокой);
ТоварСсылка = Справочники.Товары.ПолучитьСсылку(УИДСпр);
ТоварОбъект = Справочники.Товары.СоздатьЭлемент();
ТоварОбъект.УстановитьСсылкуНового(ТоварСсылка);
//параметром передается именно ссылка, а не идентификатор
//...заполнение реквизитов
ТоварОбъект.Записать();
//уникальный идентификатор нового объекта будет равен уникальному 
//идентификатору из другой базы

Прочие методы

//получение макета
МакетСпр = Справочники.Товары.ПолучитьМакет("ИмяМакета");
//можно через объект
МакетСпр = ТоварОбъект.ПолучитьМакет("ИмяМакета");

//получить полное наименование или код с учетом вложенности через /
ПолноеНаименование = ТоварСсылка.ПолноеНаименование();
ПолныйКод = ТоварСсылка.ПолныйКод();

//принадлежит ли элемент определенной группе
Если ТоварСсылка.ПринадлежитЭлементу(СсылкаНаГруппу) Тогда
    Сообщить("Принадлежит");
КонецЕсли;
 
//уровень вложенности, если не в группе, то вернет 0
УровеньИерархии = ТоварСсылка.Уровень();

//определить пустая ссылка или нет
Если ТоварСсылка.Пустая() Тогда
    //пустая
КонецЕсли;

//получение пустой ссылки
ПустойТовар = Справочники.Товары.ПустаяСсылка();

Смотрите также:
Электронный учебник по программированию в 1С
Рекомендации по изучению программирования 1С с нуля
Игра «Кто хочет стать миллионером?» с вопросами на определенную тематику (язык программирования JavaScript, английские, немецкие, французские, испанские, португальские, ни­дер­ландские, итальянские слова, электробезопасность, промышленная безопасность, бокс и т.п.), написанная на 1С
Программирование в 1С 8.3 с нуля — краткий самоучитель
Комплексная подготовка программистов 1С:Предприятие 8.2
Сайты с уроками программирования и со справочниками
Youtube-каналы с уроками программирования
Сайты для обучения программированию
Лекции и уроки

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

 Элемент = Справочники.Номенклатура.НайтиПоНаименованию("Товар").ПолучитьОбъект();

Элемент.Наименование = "Новое наименование";

Элемент.Записать();   

  номен = Справочники.Номенклатура;

элементСсылка = номен.НайтиПоНаименованию("Наименование-ля-ля");

Если НЕ элементСсылка.Пустая() тогда

	Сообщить("Найден элемент " + элементСсылка);

конецЕсли;

элементОбъект = элементСсылка.ПолучитьОбъект();

элементОбъект.Наименование = "Новое Наименование - Тру -ля- ля";

элементОбъект.Записать();  

   

Как измени реквизит справочника при проведении документа

Автор Gendelf, 18 ноя 2013, 17:27

0 Пользователей и 1 гость просматривают эту тему.