Элемент проекта вида «Справочник»

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

Например, список сотрудников — это справочник:

Элементами этого справочника являются Булатов И.В. с кодом 001 и возрастом 32, Громова Н.П. с кодом 002 и возрастом 45 и т. д.

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

Вид Справочник содержит специальные свойства, которые называются реквизитами. Реквизит — это описание одной колонки в такой таблице. У вида Справочник есть два стандартных реквизита — Код и Владелец. В проекте вы можете добавить справочнику один или оба этих стандартных реквизита, а также любое количество собственных реквизитов для того, чтобы описать дополнительные колонки, например ФИО, Возраст, Адрес, Должность и др.

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

В самом простом случае в проекте справочник может иметь только один реквизит, например Название типа Строка. Например, справочник Склады:

Вид Справочник предоставляет следующую функциональность и логику работы с данными:

Порождаемые типы встроенного языка

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

Таблица языка запросов

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

Уникальность кодов элементов

Стандартно во время работы приложения «1С:Шина» запрещает записывать элементы справочника с повторяющимися кодами. При необходимости вы можете отключить этот контроль

Автонумерация элементов

Стандартно во время работы приложения «1С:Шина» автоматически создает код для нового элемента справочника. Вы можете настроить этот процесс или совсем отказаться от него

Реквизиты справочника

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

Совет: Реквизиты справочника могут реализовывать контракт типа.

Множественные реквизиты

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

Табличная часть

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

Хранение двоичных данных

Реквизиты справочника, которые вы добавляете в проект, могут быть предназначены для хранения двоичных данных: файлов документов, изображений, видео и т. д. Как правило двоичные данные имеют большой размер, поэтому «1С:Шина» хранит их в специальных хранилищах, отдельно от других данных

Справочники-владельцы

Элементы одного справочника могут быть связаны с элементами другого справочника. Например, клиенты и их телефонные звонки. Для таких справочников «1С:Шина» предоставляет ряд стандартных действий

Представление элемента

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

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

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

Индексы базы данных

Для того чтобы запросы к данным выполнялись быстро, «1С:Шина» стандартно создает для таблицы справочника два индекса: по полю Ссылка и по полю Код. Эти индексы удобны в общем случае, но могут не подходить для конкретных операций поиска и чтения элементов справочника в приложении. Тогда вы можете описать в проекте, какие дополнительные индексы «1С:Шина» должен создать в таблицах справочника

Представление справочника в командном интерфейсе

Во время работы приложения «1С:Шина» автоматически генерирует все команды и формы, которые требуются для работы с элементами справочника. Однако они могут не подходить вам в каких-то сложных или особенных случаях. Тогда вы можете создать собственные формы и указать, в каких ситуациях их должна использовать «1С:Шина» для работы с элементами этого справочника

Права

Элемент проекта вида Справочник обладает следующими правами: Создание, Чтение, Изменение и Удаление (подробнее).

События ВычислитьРазрешенияДоступа и ВычислитьРазрешенияДоступаДляОбъектов следует обрабатывать в модуле справочника.

Дополнительные пространства управляемых блокировок

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

Запись данных в оптимизированном режиме

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

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

Здесь описано назначение всех свойств справочника, которые вы можете менять в проекте