Свойства элемента проекта вида «Справочник»
В проекте справочник имеет следующие свойства:
Владелец
Стандартный реквизит. Справочник, элементы которого будут владельцами элементов данного справочника (подробнее). Имеет следующие свойства:
Имя
Владелец. Пример 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
Уникальность: Истина
Наименование
Стандартный реквизит. Наименование элемента справочника. Имеет следующие свойства: