Свойства элемента проекта вида «Справочник»
В проекте справочник имеет следующие свойства:
Владелец
Стандартный реквизит. Справочник, элементы которого будут владельцами элементов данного справочника (подробнее). Имеет следующие свойства:
Имя
Владелец. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Владелец
Тип: Клиенты.Ссылка?
ИспользоватьВПолнотекстовомПоиске: Ложь
ИспользоватьВПолнотекстовомПоиске
Булево. Признак индексирования данных этого реквизита для использования в полнотекстовом поиске. Значение по умолчанию — Истина. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Владелец
Тип: Клиенты.Ссылка?
ИспользоватьВПолнотекстовомПоиске: Ложь
Тип
Тип ссылки на элемент справочника-владельца. Нельзя ис пользовать ссылку на этот же справочник. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Владелец
Тип: Клиенты.Ссылка?
ИспользоватьВПолнотекстовомПоиске: Ложь
Код
Стандартный реквизит. Идентификатор элемента справочника, понятный для человека. Ниже перечислены свойства этого реквизита.
Автонумерация
Способ автоматического заполнения номера (подробнее). Имеет следующие свойства:
Использовать
Булево. Признак использования автонумерации. Значение по умолчанию — Истина, использовать. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Использовать: Ложь
КонтрольФормата
Необходимость контроля формата автонумерации при записи:
- Строгий — код справочника должен строго совпадать с форматом кода. Запись нестандартных кодов запрещена;
- Выключено — контроль не ведется, возможна запись элементов с нестандартным кодом.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
КонтрольФормата: Выключено
Если элементу явно задан префикс или постфикс с помощью свойств Префикс и Постфикс типа имя-справочника.ПараметрыЗаписи, то код считается стандартным и обязан совпадать с форматом. В этом случае значение свойства КонтрольФормата игнорируется.
# Пример YAML-файла, в котором задаются
# префикс и постфикс произвольной длины:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Формат:
РазделительПрефикса: /
РазделительПостфикса: /
ДлинаПрефикса: -1
ДлинаПостфикса: -1
Префикс: ""
Постфикс: ""
// В обработчике ПередЗаписью в модуле объекта справочника МойСправочник
// устанавливаются значения префикса и постфикса автонумерации
@Обработчик
метод ПередЗаписью(ПредыдущееЗначение: МойСправочник.Данные,
ПараметрыЗаписи: МойСправочник.ПараметрыЗаписи)
ПараметрыЗаписи.Префикс = "pref"
ПараметрыЗаписи.Постфикс = "post"
;
Если префикс или постфикс не заданы, то при записи «Шина» разберет код на составные части и примет во внимание значение КонтрольФормата:
- если код стандартный (т. е. проходит контроль формата), то «Шина » выполнит стандартные действия: запишет вместе с элементом поля префикс, постфикс, номер и код;
- если код не проходит контроль формата, то:
- если
КонтрольФорматаравноСтрогий, то будет выдано исключение; - если
КонтрольФорматаравноВыключено, то в поле Код будет записан код, а в поля Префикс, Постфикс и Номер будут записаны значения по умолчанию.
- если
Формат
Описание формата префикса и постфикса. Имеет следующие свойства:
-
ДлинаПостфикса
Число. Возможные значения:-
положительное число — количество символов в постфиксе;
-
0 — значение по умолчанию, постфикс запрещен;
-
∞ или -1 — длина не ограничена.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Постфикс: ПС
Формат:
ДлинаПостфикса: 2
-
-
ДлинаПрефикса
Число. Возможные значения:-
положительное число — количество символов в префиксе;
-
0 — значени е по умолчанию, префикс запрещен;
-
∞ или -1 — длина не ограничена.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Префикс: НК
Формат:
ДлинаПрефикса: 2
-
-
ОграниченияПоСимволам
Булево. Использовать или нет следующие ограничения по символам:-
префикс не может заканчиваться на цифру;
-
постфикс не может содержать цифры.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Префикс: НК
Формат:
ДлинаПрефикса: 2
РазделительПрефикса: "-"
ОграниченияПоСимволам: Истина
-
-
РазделительПостфикса
Строка. Символы, отделяющие код от постфикса. Значение по умолчанию — пустая строка, разделитель отсутствует. Пример YAML-файла:ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Постфикс: ПС
Формат:
ДлинаПостфикса: 2
РазделительПостфикса: "/" -
РазделительПрефикса
Строка. Символы, отделяющие префикс от кода. Значение по умолчанию — пустая строка, разделитель отсутствует. Пример YAML-файла:ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Префикс: НК
Формат:
ДлинаПрефикса: 2
РазделительПрефикса: "-"
ДлинаНумерации
Число. Возможные значения:
- положительное число — длина автоматически формируемого номера;
- 0 — длина номера автоматически вычисляется исходя из заданной длины кода (
Код.Длина); - ∞ или -1 — значение по умолчанию, номер не дополняется нулями.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Число
Длина: 10
Автонумерация:
ДлинаНумерации: 0
Префикс
Строка. Стандартный префикс, который «Шина» будет использовать для всех элементов справочника. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Префикс: НК
Формат:
ДлинаПрефикса: 2
Постфикс
Строка. Стандартный постфикс, который «Шина» будет использовать для всех элементов справочника. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Автонумерация:
Постфикс: ПС
Формат:
ДлинаПостфикса: 2
Длина
Число. Длина кода. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Имя
Строка, имеет значение «Код». Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
ИспользоватьВПолнотекстовомПоиске
Булево. Признак индексирования данных этого реквизита для использования в полнотекстовом поиске. Значение по умолчанию — Истина. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
ИспользоватьВПолнотекстовомПоиске: Ложь
СерииНумерации
Группа элементов справочника, внутри которой будет поддерживаться уникальная нумерация:
- Префикс — элементы, обладающие одинаковым префиксом;
- Постфикс — элементы, обладающие одинаковым постфиксом;
- Владелец — элемент-владелец;
- Сквозная — все элементы справочника.
Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
СерииНумерации:
- Префикс
- Владелец
Автонумерация:
Префикс: НК
Формат:
ДлинаПрефикса: 2
Тип
Число или Строка. Тип кода. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Уникальность
Булево. Уникальность кодов элементов справочника (подробнее). Значение по умолчанию — Истина. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Имя: Код
Тип: Строка
Длина: 10
Уникальность: Истина
Наименование
Стандартный реквизит. Наименование элемента справочника. Имеет следующие свойства:
Имя
Строка. Имя реквизита — «Наименование». Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Ид: 2c7e10c0-7267-41a5-85a2-5e654bf22efb
Имя: МойСправочник
Реквизиты:
-
Имя: Наименование
Длина: 150
ИспользоватьВПолнотекстовомПоиске
Булево. Признак индексирования данных этого реквизита для использования в полнотекстовом поиске. Значение по умолчанию — Истина. Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Ид: 2c7e10c0-7267-41a5-85a2-5e654bf22efb
Имя: МойСправочник
Реквизиты:
-
Имя: Наименование
Длина: 150
НезаполненноеЗначение: Разрешить
ИспользоватьВПолнотекстовомПоиске: Ложь
Длина
Число. Максимальная длина наименования. По умолчанию — 150. Максимальная длина — 400. Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Ид: 2c7e10c0-7267-41a5-85a2-5e654bf22efb
Имя: МойСправочник
Реквизиты:
-
Имя: Наименование
Длина: 150
НезаполненноеЗначение
Политика проверки пустого значения. Возможные значения:
- Разрешить
- ЗапретитьВсегда (по умолчанию)
Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Ид: 2c7e10c0-7267-41a5-85a2-5e654bf22efb
Имя: МойСправочник
Реквизиты:
-
Имя: Наименование
Длина: 150
НезаполненноеЗначение: Разрешить
Реквизит разработчика
Стандартный реквизит. Реквизит, добавленный разработчиком. Имеет следующие свойства:
ДлинаДробнойЧасти
Только у реквизитов, имеющих тип Число. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Вес
Тип: Число
ДлинаЦелойЧасти: 15
ДлинаДробнойЧасти: 3
ДлинаЦелойЧасти
Только у реквизитов, имеющих тип Число. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Вес
Тип: Число
ДлинаЦелойЧасти: 15
ЗначениеПоУмолчанию
Значение реквизита, которое будет использоваться «Шиной» по умолчанию. Не поддерживается для реквизитов-коллекций.Пример YAML-файла:
Ви дЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Возраст
Тип: Число
ЗначениеПоУмолчанию: 18
Имя
Строка. Имя реквизита. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Название
Тип: Строка
Ид
Идентификатор реквизита. «1С:Шина» создает этот идентификатор автоматически. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Название
Тип: Строка
ИспользоватьВПолнотекстовомПоиске
Булево. Признак индексирования данных этого реквизита для использования в полнотекстовом поиске. Значение по умолчанию — Истина. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Название
Тип: Строка
ИспользоватьВПолнотекстовомПоиске: Ложь
КонтрольДлины
ВыдаватьОшибку, Исправлять. Только у реквизитов, имеющих тип Строка. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Название
Тип: Строка
МаксимальнаяДлина: 50
КонтрольДлины: Исправлять
КонтрольПредельныхЗначений
ВыдаватьОшибку, Исправлять. Только у реквизитов, имеющих тип Число. Пример YAML-файла:
ВидЭлемента: Справочник
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Реквизиты:
-
Ид: c13bcc91-3361-4efd-ab9d-03360ece9f29
Имя: Вес
Тип: Число
МинимальноеЗначение: 10
МаксимальноеЗначение: 100
КонтрольОграничений: Исправлять