---

Руководство программиста FieldConfiguration

---

НАЧАЛО >> Настройки поля >> Руководство программиста FieldConfiguration📄 Скачать в DOCX

---

1. Основной контракт

Публичные операции модуля реализованы в __call. api.php содержит системный класс модуля, record-backed DTO ObjectDataFieldConfigurationDefinition и ObjectDataFieldConfigurationPack, hooks сохранения и PHPDoc @method-описания.

ObjectData-объекты используют стандартный маршрут вызова: отсутствующий метод объекта передается в управляющий модуль FieldConfiguration, а затем в соответствующий __call/*.inc.

2. Основные функции

• NormalizeFieldDefinition(array $definition) приводит JSON/array описание поля к единому контракту.
• NormalizeFieldPack(array $pack) приводит описание набора полей к единому контракту.
• ResolveFieldDefinition(array $definitions, array $context) выбирает лучшее описание поля для fieldKey, owner module, record type, scope и project.
• BuildWhereUsedReport(array $definitions, array $consumers) строит безопасную диагностику явных потребителей.
• GetSystemDefinitions() читает системный JSON без записи в БД.
• HealthCheckDefinition() возвращает описание проверок для будущего HealthCheck provider.

3. Не входит в модуль

FieldConfiguration не должен:

• проверять права пользователя;
• выполнять переходы Workflow;
• строить страницы списков и карточек;
• применять доменную валидацию Tasks;
• выполнять FieldHistory diff;
• импортировать вложения или запускать фоновые задания.

Такие действия должны оставаться в owner-модулях и использовать FieldConfiguration только как источник field metadata.