В конфигурации «Управление торговлей для Казахстана», редакция 3.4, релиз 3.4.5.21, объект Справочник.ВидыСвязейМеждуФизЛицами предназначен для хранения видов связей между физическими лицами. Фактический состав его реквизитов, форм, предопределённых элементов и программных обработчиков определяется метаданными этого релиза.
1. Идентификация объекта
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник |
| Имя | ВидыСвязейМеждуФизЛицами |
| Полное имя | Справочник.ВидыСвязейМеждуФизЛицами |
| Синоним | «Виды связей между физическими лицами» |
| Конфигурация | «Управление торговлей для Казахстана», редакция 3.4, релиз 3.4.5.21 |
| Основное назначение | Хранение классифицирующих значений, которыми обозначают характер связи между физическими лицами |
| Основное представление | Представление элемента справочника, заданное в метаданных |
Назначение. Элементы справочника используются в тех реквизитах конфигурации, тип которых включает ссылку на Справочник.ВидыСвязейМеждуФизЛицами. Конкретные виды связей следует определять по данным информационной базы, а не по примерному перечню названий.
Где найти. В пользовательском режиме откройте Сервис и настройки → Функции для технического специалиста → Справочники → Виды связей между физическими лицами. Команда «Функции для технического специалиста» отображается пользователю с соответствующими правами.
Для технического открытия списка применяется навигационная ссылка e1cib/list/Справочник.ВидыСвязейМеждуФизЛицами. Она ведёт к списку указанного объекта в той информационной базе, где пользователь авторизован и имеет право на чтение справочника.
2. Реквизиты и табличные части
Точный состав данных устанавливается по ветви Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами в конфигураторе релиза 3.4.5.21. Стандартные свойства справочника и прикладные реквизиты нужно различать: первые предоставляет платформа, вторые создаются разработчиком конфигурации.
Реквизиты шапки
| Данные | Назначение | Как установить фактическое свойство |
|---|---|---|
| Код | Идентификация элемента в пределах справочника | Проверить длину, тип кода и способ нумерации в свойствах объекта метаданных |
| Наименование | Текстовое представление вида связи | Проверить длину и использование наименования как основного представления в свойствах справочника |
| Пометка удаления | Стандартное состояние объекта, подготовленного к удалению | Доступность команды определяется правами пользователя и настройками формы |
| Родитель | Связь элемента с группой или другим элементом в иерархическом справочнике | Используется только при включённой иерархии; значение свойства «Иерархический» видно в метаданных |
| Владелец | Принадлежность элемента другому объекту | Наличие владельцев определяется на вкладке владельцев справочника |
| Прикладные реквизиты | Дополнительные характеристики вида связи | Перечень, типы и обязательность заполнения отображаются в ветви «Реквизиты» |
По одному имени объекта нельзя достоверно определить длину кода, длину наименования, наличие иерархии, владельцев или дополнительных реквизитов. Эти свойства фиксируются в метаданных конфигурации и должны описываться в методичке после просмотра соответствующих узлов объекта.
Табличные части
Наличие табличных частей устанавливается по узлу Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Табличные части. Если узел не содержит дочерних объектов, элемент справочника хранит только стандартные свойства и реквизиты. Если табличные части созданы, в техническое описание включают их имена, реквизиты строк, типы значений и назначение.
Дополнительные реквизиты и дополнительные сведения не следует смешивать с собственными реквизитами или табличными частями объекта. Их использование определяется подключением соответствующего механизма конфигурации и настройками конкретной информационной базы.
3. Формы
Формы объекта просматриваются в ветви Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Формы. Для каждой формы в методическом описании указывают её имя, тип, назначение, основную форму объекта и команды, доступные пользователю.
| Вид формы | Назначение | Что зафиксировать |
|---|---|---|
| Форма списка | Просмотр и выбор элементов справочника | Колонки, отборы, команды создания, изменения, пометки удаления и выбора |
| Форма элемента | Создание и изменение одного элемента | Поля, обязательность заполнения, команды записи и проверки |
| Форма выбора | Выбор значения для реквизита другого объекта | Состав доступных элементов, отборы и обработку выбора |
| Форма группы | Работа с группой иерархического справочника | Описывается только при наличии иерархии и назначенной формы группы |
Отсутствие собственной формы в ветви метаданных означает, что для соответствующего действия платформа может использовать автоматически создаваемую форму. Это следует отличать от собственной формы, сохранённой в конфигурации: у собственной формы есть структура элементов, реквизиты, команды и модуль формы.
4. Ключевые процедуры модулей
Имена процедур и функций приводят только после просмотра модулей объекта, менеджера и собственных форм в конфигураторе релиза 3.4.5.21. Само имя справочника не подтверждает наличие обработчиков ПередЗаписью, ОбработкаПроверкиЗаполнения, ПриСозданииНаСервере или экспортных функций менеджера.
Модуль объекта
Откройте Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Модуль объекта. В описание включаются фактически объявленные обработчики событий объекта, выполняемые проверки, изменяемые реквизиты и вызовы общих модулей. Если модуль пуст, это прямо указывается без добавления типовых обработчиков.
Модуль менеджера
Откройте Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Модуль менеджера. Для экспортных процедур и функций указываются точное имя, параметры, возвращаемое значение, контекст выполнения и места вызова. Примерные имена методов в документацию включать не следует.
Модули форм
Для каждой собственной формы откройте форму, затем команду Форма → Модуль формы. В методичке описываются только существующие клиентские и серверные обработчики, команды формы, обращения к реквизитам и правила доступности элементов интерфейса.
При анализе кода полезно выполнить глобальный поиск по строке ВидыСвязейМеждуФизЛицами. Результаты показывают обращения к справочнику, реквизиты ссылочного типа, запросы, параметры выбора и программное открытие форм.
5. Проведение и движения
Для справочника не применяется механизм проведения, предназначенный для документов. Работа с элементом завершается записью его данных в информационную базу.
Раздел следует использовать для описания того, где ссылка на вид связи участвует в прикладной логике. Такие места определяются поиском ссылок на объект в метаданных и глобальным поиском по имени справочника. Если ссылка хранится в реквизите другого объекта или записи регистра сведений, в методичке указывают точное имя этого объекта и назначение реквизита.
Налоговые ставки, размеры МРП и МЗП, пределы вычетов, ставки взносов, бухгалтерские счета и примеры проводок к описанию этого классификатора не относятся. Добавление таких показателей затрудняет сопровождение методички и не раскрывает устройство справочника.
6. Связанные объекты и ввод на основании
Связанные объекты устанавливаются по результатам поиска ссылок на тип СправочникСсылка.ВидыСвязейМеждуФизЛицами. Для каждого найденного объекта следует зафиксировать полное имя метаданных, имя реквизита, место заполнения и роль значения в прикладном процессе.
- Реквизиты ссылочного типа. Показывают, какие справочники, документы, регистры или обработки хранят выбранный вид связи.
- Параметры выбора. Ограничивают состав элементов, доступных пользователю в поле выбора.
- Запросы и программный код. Показывают, где элементы используются для отбора, сравнения, заполнения или представления данных.
- Формы. Показывают, из каких полей открывается форма выбора справочника.
- Предопределённые элементы. Если они заданы в метаданных, нужно указать точные имена и найденные обращения к ним в коде.
Ввод на основании описывается только при наличии соответствующей команды или зарегистрированной связи в конфигурации. Для проверки откройте свойства объекта и подсистемы, а также выполните поиск команд создания объектов на основании ссылки этого справочника.
При удалении элемента нужно учитывать существующие ссылки на него. Контроль выполняется механизмами платформы и процедурами удаления, настроенными в информационной базе; доступные действия зависят от прав пользователя.
7. Точки расширения
Доработку справочника планируют после фиксации его фактической структуры и всех мест использования в релизе 3.4.5.21. Это снижает риск нарушения выбора значений, обменов и программных обращений.
- Расширение конфигурации. В расширении можно анализировать допустимость добавления реквизитов, форм и обработчиков. Перед реализацией фиксируют назначение каждого изменения и его влияние на обновление конфигурации.
- Дополнительные реквизиты и сведения. Этот вариант применяется, когда объект подключён к соответствующему механизму и требуемое свойство не должно участвовать в сложной программной логике.
- Предопределённые элементы. Их нельзя заменять обычными пользовательскими элементами без анализа программных ссылок. Код может обращаться к предопределённому элементу по системному имени.
- Общие модули. Повторяющиеся операции поиска и подбора значений оформляют единым программным интерфейсом с однозначными параметрами и результатом.
- Права доступа. Чтение, добавление, изменение, пометка удаления и удаление настраиваются в ролях. После изменения ролей проверяют список, форму элемента и выбор значения из связанных объектов.
- Обмен данными. При участии справочника в обменах проверяют правила регистрации, сопоставление элементов, идентификаторы и обработку удаления.
После доработки следует проверить создание элемента, запись изменений, поиск, выбор из связанного реквизита, работу предопределённых элементов, права доступа и обмены, в которые включён справочник.
Вопросы и ответы
Как открыть список видов связей в пользовательском режиме?
Перейдите по пути Сервис и настройки → Функции для технического специалиста → Справочники → Виды связей между физическими лицами. Для технического открытия также используется ссылка e1cib/list/Справочник.ВидыСвязейМеждуФизЛицами.
Как определить точный состав реквизитов справочника?
В конфигураторе откройте Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Реквизиты. Тип кода, длина наименования, иерархия, владельцы и основное представление находятся в свойствах самого справочника.
Как найти объекты, которые используют этот справочник?
В конфигураторе выполните поиск ссылок на объект и глобальный поиск по строкам ВидыСвязейМеждуФизЛицами и СправочникСсылка.ВидыСвязейМеждуФизЛицами. Затем зафиксируйте найденные реквизиты, формы, запросы и программные обращения.
Как понять, есть ли у справочника собственные формы?
Откройте ветвь Конфигурация → Справочники → ВидыСвязейМеждуФизЛицами → Формы. Формы в этой ветви являются собственными; при их отсутствии платформа может создавать формы автоматически.
Что проверить после изменения справочника?
Проверьте запись и изменение элементов, поиск в списке, выбор значения в связанных реквизитах, права пользователей, программные обращения, предопределённые элементы и обмены данными.