инвентаризация:dev:model:fields

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия 		Предыдущая версия
инвентаризация:dev:model:fields [2024/05/25 08:41]
admin 		инвентаризация:dev:model:fields [2025/05/20 08:03] (текущий)
admin
Строка 1: Строка 1:
-{{tag>dev Инвентаризация}} +{{tag>dev Инвентаризация model fields}} 
-====== Инвентаризация: model:fields ======+====== Инвентаризация: DEV: Model Fields ======
  
 Описание атрибутов модели делаем в одной функции: Описание атрибутов модели делаем в одной функции:
 <code php> <code php>
-    public $parentAttr='parentService'; //имя атрибута в котором у нас объект-предок (родительское помещение/сервис/отдел и т.д.)+    /** @var string как называется один экземпляр модели (для страницы Create -> Новый объект) */ 
 +    public static $title='Объект'; 
 +  
 +    /** @var string как называется список моделей (для страницы Index) */ 
 +    public static $titles='Объекты'; 
 +  
 +    /** @var string надпись на кнопке создания нового объекта в списке */ 
 +    public static $addButtonText='Добавить'; 
 +  
 +    /** @var null|string подсказка для кнопки создания нового объекта */ 
 +    public static $addButtonHint=null; 
 +  
 +    /** @var string Префикс для страницы Create (Новый $title) */ 
 +    public static $newItemPrefix='Новый'; 
 + 
 +    public $parentAttr='parentService'; //имя атрибута в котором у нас объект-предок (родительское помещение/сервис/отдел и т.д.) - нужен для рекурсивных функций обхода дерева
     public function attributeData() {     public function attributeData() {
         return [         return [
Строка 17: Строка 32:
                 //позже транслируется в attributeIndexHints, используется для пояснения атрибута в списках                 //позже транслируется в attributeIndexHints, используется для пояснения атрибута в списках
                 'indexHint'=>'Модели можно перечислить варианты через верт. черту &quot;|&quot;',                   'indexHint'=>'Модели можно перечислить варианты через верт. черту &quot;|&quot;',  
-                //поле наследуемое (если не задано в этом объекте, то значение берется из родителя) +                //тип Input этого аттрибута в форме редактирования 
-                'is_inheritable'=>true,  +                //  - boolean - да / нет (чекбокс) 
 +                //  - toggle - это как boolean, но только для 0 и 1 есть свои названия, напр сервис/услуга 
 +                //  - radios - это как toggle, только значений может быть больше 2 
 +                //  - list - это как radios, только значений прям много и оформляется в виде dropdown 
 +                //  - ntext - textarea (простой текст без форматирования с конвертацией nl -> <br> при рендере) 
 +                //  - text - текст с форматированием (какой формат прописывается в параметрах) 
 +                //  - date - дата 
 +                //  - datetime - дата/время 
 +                //  - ips - список IP 
 +                //  - macs - список MAC 
 +                //  - urls - список URL  
 +                //  - link - одиночная ссылка 
 +                //  - string - обычный текст (по умолчанию) 
 +                'fieldType' => 'text',
                 //чем заполнить селектор в форме, если значение не введено                 //чем заполнить селектор в форме, если значение не введено
                 'placeholder' => 'Модель ПК не выбрана',                   'placeholder' => 'Модель ПК не выбрана',  
 +                //поле наследуемое (если не задано в этом объекте, то значение берется из родителя)
 +                'is_inheritable'=>true,
 +                //поле является ссылкой на объекты с обратной ссылкой на этот. 
 +                //при наличии объектов в этом поле, считаем что себя удалять нельзя, 
 +                //иначе в объектах ссылающихся на нас будут битые ссылки
 +                //(если не объявлять явно, определяется из $linkSchema)
 +                'is_reverseLink'=false,
 +                //при вызове функции absorb это поле нужно поглощать из переданного объекта
 +                // - false - нет (по умолчанию для полей - "не обратных ссылок"
 +                // - 'ifEmpty' - если локальное значение отсутствует, то принимать с абсорбируемого объекта
 +                // - true - да (по умолчанию для полей, являющихся обратными ссылками)
 +                'absorb'=>true,
 +                //что нужно заджойнить при отображении этого атрибута в списке (для жадной загрузки + поиск)
 +                'join'=>['techModel','techType']
             ],             ],
             'model'=>['alias'=>'model_id'], //значения параметров атрибута брать из model_id             'model'=>['alias'=>'model_id'], //значения параметров атрибута брать из model_id
Строка 26: Строка 68:
     }     }
  
- /** +    /** 
-  * @return array[] Ссылками на объекты каких классов являются атрибуты +     * @return array[] Ссылками на объекты каких классов являются атрибуты 
-  * $linksSchema=[ +     * $linksSchema=[ 
-  * 'services_ids'=>[ +     * 'services_ids'=>[ 
-  * Service::class, //на какой класс ссылаемся +     * Service::class, //на какой класс ссылаемся 
-  * 'acls_ids', //если там есть обратная ссылка, то в каком аттрибуте +     * 'acls_ids', //если там есть обратная ссылка, то в каком аттрибуте 
-  *  ], +     *                  'updater' => ['class' => ManyToManySmartUpdater::class,], //Если запись в many-2-many таблицу делается кастомным способом 
- * 'user_id'=>[ +     *                                          //Передается в behaviors() 
- * Users::class, +     *                                          //https://github.com/voskobovich/yii2-linker-behavior?tab=readme-ov-file#custom-junction-table-values 
-  * 'loader'=>'user' //как загрузчик этого объекта называется в мастер-классе +     * 'loader'=>'servicesList',//как загрузчик этого объекта называется, если он не формируется автоматически из названия ссылки 
-  * ], +     * 'deleteable'=>true,     //можно ли удалять объект с такими ссылками (если ссылки удаляются в beforeDelete) 
-  * ]; +     * ], 
-  */ +     * ]; 
- public $linksSchema=[ +     */ 
- 'depends_ids' => [Services::class,'dependants_ids'], +    public $linksSchema=[ 
- 'comps_ids' => [Comps::class,'services_ids'], +        'depends_ids' =>                [Services::class,'dependants_ids'], 
- 'techs_ids' => [Techs::class,'services_ids'], +        'comps_ids' =>                  [Comps::class,'services_ids'], 
- 'maintenance_reqs_ids'=> [MaintenanceReqs::class,'services_ids'], +        'techs_ids' =>                  [Techs::class,'services_ids'], 
- 'maintenance_jobs_ids'=> [MaintenanceJobs::class,'services_ids'], +        'maintenance_reqs_ids'=>        [MaintenanceReqs::class,'services_ids'], 
- 'support_ids' => [Users::class,'support_services_ids','loader'=>'support'], +        'maintenance_jobs_ids'=>        [MaintenanceJobs::class,'services_ids'], 
- 'infrastructure_support_ids' => [Users::class,'infrastructure_support_services_ids','loader'=>'infrastructureSupport'], +        'support_ids' =>                [Users::class,'support_services_ids','loader'=>'support'], 
- 'contracts_ids' =>  [Contracts::class,'services_ids'], +        'infrastructure_support_ids' => [Users::class,'infrastructure_support_services_ids','loader'=>'infrastructureSupport'], 
- 'acls_ids' =>  [Acls::class,'services_id'],+        'contracts_ids' =>              [Contracts::class,'services_ids'], 
 +        'acls_ids' =>                   [Acls::class,'services_id'],
   
- 'responsible_id' => [Users::class,'services_ids'], +        'responsible_id' =>             [Users::class,'services_ids'], 
- 'infrastructure_user_id' => [Users::class,'infrastructure_services_ids','loader'=>'infrastructureResponsible'], +        'infrastructure_user_id' =>     [Users::class,'infrastructure_services_ids','loader'=>'infrastructureResponsible'], 
- 'providing_schedule_id' => [Schedules::class,'providing_services_ids'], +        'providing_schedule_id' =>      [Schedules::class,'providing_services_ids'], 
- 'support_schedule_id' => [Schedules::class,'support_services_ids'], +        'support_schedule_id' =>        [Schedules::class,'support_services_ids'], 
- 'segment_id' => [Segments::class,'services_ids'], +        'segment_id' =>                 [Segments::class,'services_ids'], 
- 'parent_id' => [Services::class,'children_ids','loader'=>'parentService'], +        'parent_id' =>                  [Services::class,'children_ids','loader'=>'parentService'], 
- 'partners_id' => [Partners::class,'services_ids'], +        'partners_id' =>                [Partners::class,'services_ids'], 
- 'places_id' => [Places::class,'services_ids'], +        'places_id' =>                  [Places::class,'services_ids'], 
- 'currency_id' => Currency::class,+        'currency_id' =>                Currency::class,
     ];     ];
  
  • инвентаризация/dev/model/fields.1716626509.txt.gz
  • Последнее изменение: 2024/05/25 08:41
  • — admin