Стандартный реквизит стандартная табличная часть

Содержание

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

• Пользовательские реквизиты — при проектировании пользователь определяет какие данные, какого типа будут храниться в справочнике. Например у справочника Банковские счета будут определены реквизиты: номер счета, банк и тд, для справочника контрагенты ИНН, КПП и тд.

• Предопределенные реквизиты — любой справочник обладает набором предопределенных реквизитов.

• Табличные части — справочник может любое количество табличных частей.

У каждого справочника есть номер и наименование. В принципе их можно отключить, указав длину 0. Так же код может быть числовым или текстовым, если код текстовый для удобства сортировки система дополняет код лидирующими нулями на всю длину кода, например если у справочника указана длина кода 9 и справочнику был присвоен код 3 то система дополнит нулями до такого вида: «000000003». Также в случае если имеется распределенная база в код обычно добавляется префикс той базы в которой был создан элемент, например: «ЦН0000003». Нужно учитывать эту особенность если вы соберетесь указывать числовой код, этот объект не сможет корректно работать в распределенной базе. У справочника есть и другие предопределенные реквизиты:

• ЭтоГруппа – Имеет смысл только для иерархических справочников. Указывает на то что элемент является группой.

• Родитель — Имеет смысл только для иерархических справочников. Указывает на группу или элемент который является родителем для этого справочника.

• Владелец – Имеет смысл только для подчиненных справочников. Указывает на владельца данного справочника.

• ПометкаУдаления – атрибут с типом булево, указывает помечен ли элемент на удаление или нет.

• Ссылка – это самый главный атрибут, справочник потому и называется ссылочным типом, потому, что у него есть уникальная ссылка, которая хранится в этом атрибуте.

• Предопределенный – атрибут с типом булево указывает на то, что элемент создан в конфигураторе.

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

НашаФирма = Справочники.Контрагенты.НашаДочерняяФирма

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

Важно. Контроль за удалением предопределенных элементов лежит на плечах разработчиков, а не платформы.

Для предопределенных элементов справочников, стандартный реквизит Предопределенный имеет значение Истина. Это свойство которое доступно только на чтение, но это не означает, что нельзя «обычный» элемент справочника сделать предопределенным и наоборот. В последних релизах 8.3FIXME(Надо узнать в каких именно), появилась возможность переопределять предопределенные элементы изменяя свойство ИмяПредопределенныхДанных. Например, вот так можно сделать элемент не предопределенным:

ПредОпрЭлемент = Справочники.МойСправочник.НайтиПоКоду("КодЭлемента").ПолучитьОбъект();
ПредОпрЭлемент.ИмяПредопределенныхДанных = “”;
ПредОпрЭлемент.Записать();

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

Нашафирма = Справочники.Организации.НайтиПоНаименованию("ООО Рога и копыта")

Нашафирма = Справочники.Организации.НайтиКоду("000112")

Нашафирма = Справочники.Настройки.НашаФирма.Значение

Все классы справочника можно увидеть в ветке Прикладные объекты –> Справочники.

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

Справочник менеджер – можно получить с помощью переменных глобального контекста:

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

Этот класс служит для:

• Поиска по наименованию, коду или другому реквизиту.

  Ножницы = Справочники.Номенклатура.НайтиПоНаименованию("Ножницы канцелярские");

• Программного создания групп или элементов:

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

• Делать выборки:

  Выборка = Справочники.Номенклатура.Выбрать()

  Получать пустые ссылки:

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

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

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

Для поиска по наименованию используется функция НайтиПоНаименованию(). Для использования этого метода необходимо указать наименование по которому будет происходить поиск. Если поиск должен проходить по точному соответствию с указанной строкой то вторым параметром, нужно указать Истина, иначе поиск будет проходить по первым буквам указанного шаблона поиска, то есть если в качестве строки для поиска указать «Слон» то под шаблон попадут и «Слон» и «Слон игрушечный» и «Слонопотам». Поиск можно ограничить определенной группой, если справочник иерархический или владельцем, если справочник подчиненный. Если значение не найдено, метод вернет пустую ссылку того типа справочника для которого производился поиск.

Для поиска по коду используется функция НайтиПоКоду(). Для использования этого метода необходимо в параметре «Код» указать код, по которому будет производиться поиск. Если в качестве кода указывается полный путь с учетом иерархии (уровни справочника разделяются символом «/»), то второй параметр поиск по полному коду, необходимо установить в Истина. Например:
Номенклатура «Слонопотам» с кодом «001142» находится в папке «Мягкие Игрушки» с кодом «000826» которая находится в папке «Игрушки» с кодом 000375. Тогда можно найти ее с помощью вот такой строки

Слонопотам = Справочники.Номенклатура.НайтиПоКоду("000375/000826/001142", Истина);

Или можно искать сразу:

Слонопотам = Справочники.Номенклатура.НайтиПоКоду("001142");

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

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

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

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

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

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

Группа справочника создается аналогично с помощью метода СоздатьГруппу()
В том случае, если у справочника установлено свойство Автонумерация код указывать не нужно, он устанавливается автоматически.

Иногда возникает необходимость проверить заполнено ли значение с типом «Справочник.Ссылка». Такая необходимость может возникнуть, когда реквизит какого либо объекта имеет тип «Справочник.Ссылка» или когда вы например ищете элемент справочника по коду или наименованию, или в ряде других случаев, когда метод возвращает пустую ссылку на справочник. Есть несколько способов это сделать:

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

2. Сравнить c пустой ссылкой менеджера этого справочника. Например:

   Если ПроверяемоеЗначение = Справочники.Номенклатура.ПустаяСсылка() Тогда

   Только для сервера

3. Использовать метод ‘Пустая()’ доступный на клиенте для объектов класса «Справочник ссылка».

Когда мы говорим о проверке подчиненности, необходимо понимать, что все методы справедливы не только для групп, но и для элементов, если у справочника установлен вид иерархии «Иерархия элементов».
Здесь возможно несколько вариантов: если у нас есть группа и нам необходимо знать если ли именно в ней и нигде иначе определенный элемент справочника, то можно сравнить предопределенный реквизит Родитель нужного нам элемента справочника с ссылкой на группу, например:

Если КакойтоЭлемент.Родитель = НужнаяГруппа Тогда

Если справочник многоуровневый и нужно знать есть ли элемент в этой группе или где то в подчинненых группах то можно воспользоваться методом «ПринадлежитЭлементу()» этот метод вернет Истина если элемент содержится в текущей или любой подчиненной группе. Например в этом случае

НужнаяГруппа = НайтиПоНаименованию("ГруппаРаз");
Если НашЭлемент.ПринадлежитЭлементу(НужнаяГруппа) Тогда

условие будет истинным.

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

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

Проверить то что справочник является ссылкой можно очень просто, с помощью одной строки:

Справочники.ТипВсеСсылки().СодержитТип(ТипЗнч(СсылкаНаЭлементСправочника));

Где СсылкаНаЭлементСправочника проверяемая ссылка, эта строка вернет Истина если проверяемая ссылка является ссылкой на какой либо элемент справочника.

МетаданныеДокумента = Документ.Метаданные();
//или МетаданныеДокумента = Метаданные.Документы.ТвойДокумент

ТвойРеквизит = МетаданныеДокумента.Реквизиты.Найти(«ИмяТвоегоРеквизита»);

вопрос с собеседования чтоли?

(5)
ТЧ=Док.Метаданные().ТабличныеЧасти[«ИмяТЧ»];

Для Каждого Стр Из ТЧ Цикл
  Сообщить(«»+Стр[«КолонкаРаз»]+»,»+Стр[«КолонкаДва»]);
Конеццикла;

Для каждого ТЧ Из Док.Метданные().ТабличныеЧасти() Цикл    
       Сообщить(«————«+ТЧ.Имя);
       Для Каждого Стр Из Док[ТЧ.Имя] Цикл

                       Строчка=»»;
           Для Каждого Рек Из ТЧ.Реквизиты Цикл
               Строчка=Строчка+ТЧ.Индекс(Стр)+».  «+Рек.Имя+»=»+Стр[Рек.Имя]+»,»;
           КонецЕсли;
           Сообщить(Строчка);
       Конеццикла;    
   Конеццикла

выдает ошибку

ТЧ=СсылкаНаДокумент.Метаданные().ТабличныеЧасти;
Для каждого ТЧ Из СсылкаНаДокумент.Метданные().ТабличныеЧасти Цикл    
       Сообщить(«————«+ТЧ.Имя);
       Для Каждого Стр Из СсылкаНаДокумент[ТЧ.Имя] Цикл

                       Строчка=»»;
           Для Каждого Рек Из ТЧ.Реквизиты Цикл
               Строчка=Строчка+ТЧ.Индекс(Стр)+».»+Рек.Имя+»=»+Стр[Рек.Имя]+»,»;
           КонецЦикла;
           Сообщить(Строчка);
       Конеццикла;    
   Конеццикла;

{Форма.ПерегрузкаДокумента.Форма(73)}: Метод объекта не обнаружен (Метданные)
Для каждого ТЧ Из СсылкаНаДокумент.Метданные().ТабличныеЧасти Цикл

(15)Да забей ты на него:)

Но если хочешь , то убери «ТЧ.Индекс(Стр)+»

и поставь вместо Строчка=»»; -> Строчка=СсылкаНаДокумент[ТЧ.Имя].Индекс(Стр);

Я его зря в цикл по реквизитам поставил

блин, опять очепятался:))  что за день сегодня

Строчка=»»+СсылкаНаДокумент[ТЧ.Имя].Индекс(Стр);

kuzma7126

19 — 13.10.10 — 14:03

Занятие 3

Справочники

52 1С:Предприятие 8.3. Практическое пособие разработчика

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

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

Кроме этого, вы узнаете еще об одном объекте конфигурации – Форма. Узнаете, какие виды форм существуют у  объекта конфигурации Справочник и  в каких ситуациях они используются.

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

Что такое справочник

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

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

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

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

Занятие 3 53

Поскольку эти объекты конфигурации логически связаны с  объектом Справочник, они называются подчиненными этому объекту.

Рис. 3.3. Справочник «Товары» в  режиме «Конфигуратор», в  режиме «1С:Предприятие» и  в базе данных

Рис. 3.4. Справочник «Сотрудники» в  режиме «Конфигуратор», в  режиме «1С:Предприятие» и  в базе данных

56 1С:Предприятие 8.3. Практическое пособие разработчика

Причем система скрывает от разработчика всю «техническую» часть, связанную с  хранением данных: в  базе данных для справочника создаются несколько таблиц, эти таблицы связываются по уникальному полю (Ссылка), поля таблиц имеют определенные типы и  т. д. Все это система делает сама. Нам лишь нужно добавить в  объект конфигурации Справочник подчиненный ему объект ТабличнаяЧасть.

Для удобства использования элементы справочника могут быть сгруппированы пользователем по какому-либо принципу.

Например, в  справочнике Бытовая техника могут быть созданы следующиегруппы:Холодильники,Телевизоры,Стиральные машины и  т. д.

Возможность создания таких групп в  справочнике задается свойством Иерархический объекта конфигурации Справочник. В  этом случае элемент справочника, представляющий собой группу, будет являться родителем для всех элементов и  групп, входящих в  эту группу. Такой вид иерархии называется иерархией групп и  элементов (рис. 3.5).

Рис. 3.5. Иерархический справочник с  иерархией групп и  элементов

Возможен и  другой вид иерархии – иерархия элементов. В  этом случае в  качестве родителя выступает не группа элементов справочника, а непосредственно один из его элементов. Например, такой вид иерархии можно использовать при создании справочника Подразделения, когда одно подразделение является родителем для нескольких других, входящих в  его состав (рис. 3.6).

Занятие 3 57

Рис. 3.7. Справочник «Товары» – владелец справочника «Единицы измерения»

58 1С:Предприятие 8.3. Практическое пособие разработчика

Порой возникают ситуации, когда необходимо, чтобы в  справоч-

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

(рис. 3.8).

Рис. 3.8. Справочник «Склады» с  предопределенным элементом «Основной»

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

Формы справочника

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

(рис. 3.9).

Занятие 3 59

Рис. 3.10. Названия форм справочника на  закладке «Формы»