Перейти к основному содержимому

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

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

важно

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

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

КодФИОВозраст
001Булатов И.В.32
002Громова Н.П.45
003Орлова Е.Н.23
004Савинская З.Ю.41

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

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

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

Также справочник должен содержать реквизиты, реализующие контракт справочника информационных систем:

  • Код — строка (36 символов). Коды элементов должны использоваться отправителями сообщений для указания участников, которым это сообщение предназначено.
  • Наименование — строка (255 символов).
  • Описание — строка.
  • ПользовательПоУмолчанию — объект типа Пользователи.Ссылка?. Свойство содержит ссылку на созданного и подключенного к приложению пользователя.
  • ИдТокена — строка (255 символов). Идентификатор выпущенного для пользователя токена. Доступ по токену должен быть разрешен (подробнее).

Реквизит Родитель используется для иерархических справочников.

Реквизит Файлы используется для добавления в справочник файлов.

совет

Если для загрузки файлов вам требуется использовать реквизит с другим именем, создайте новый реквизит и задайте его тип как Массив<ДвоичныйОбъект.Ссылка>.

Другие реквизиты описывают прикладные свойства элементов справочника.

См. также​