{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"При работе с бизнес-процессами в Битрикс24 (коробочная версия) нередко возникает задача «привязки» одного поля к значению другого, либо динамического отображения полей в зависимости от выбора пользователя. Стандартного функционала для таких связей зачастую не хватает, и тогда на помощь приходит возможность создавать собственные типы полей.","type":"unstyled","key":"5thvp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В этой статье разберёмся:","type":"unstyled","key":"be10o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Где в коробочной версии Битрикс24 хранятся стандартные поля для списков,","type":"ordered-list-item","key":"1bbjk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как зарегистрировать дополнительные поля,","type":"ordered-list-item","key":"3pnap"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"И как самостоятельно добавить свои (кастомные) поля, используя PHP-код в /local/php_interface/.","type":"ordered-list-item","key":"3kae"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Где хранятся стандартные поля?","type":"header-two","key":"4363n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Стандартные поля для модулей списков (Lists) в Битрикс24 (коробка) вы можете найти по следующему пути:","type":"unstyled","key":"bfmf5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"/bitrix/modules/lists/classes/general/listfieldtypes.php","type":"blockquote","key":"bkf2i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Именно там описаны системные классы для работы со стандартными типами полей списков.","type":"unstyled","key":"5cu04"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2. Как зарегистрировать дополнительные поля?","type":"header-two","key":"941fb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":41,"offset":166,"style":"BOLD"}],"text":"Для регистрации дополнительных полей (то есть дополнительных типов свойств) в Битрикс24 используется механизм создания и подключения класса со специальными методами (GetUserTypeDescription, GetPublicEditHTML и т.д.).","type":"unstyled","key":"2vp9u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если говорить про стандартные инфоблоки и их свойства, то мы можем «подключаться» к событию OnIBlockPropertyBuildList через AddEventHandler. При этом наш класс будет объявлять новый пользовательский тип свойства, который будет доступен при создании/редактировании свойств в админке.","type":"unstyled","key":"cjot9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"3. Как создать свои поля?","type":"header-two","key":"1tlag"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы создать собственный тип поля, нужно сделать следующее:","type":"unstyled","key":"bsopr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создать PHP-класс, который описывает все требуемые методы для работы со свойством (отображение, сохранение, вывод на публичной части и т.д.).","type":"ordered-list-item","key":"devld"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключить наш класс к событию OnIBlockPropertyBuildList, чтобы Битрикс «узнал» о новом типе.","type":"ordered-list-item","key":"7jpo2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Разместить код так, чтобы система автоматически его читала — обычно для этого используется файл /local/php_interface/init.php (или иной файл, подключаемый в init.php).","type":"ordered-list-item","key":"d54l6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ниже приведён пример кода, в котором мы регистрируем новое свойство, которое умеет динамически менять свой вид (строка/число/текст/файл/чекбокс/дата/дата+время/список) в зависимости от значения другого свойства (свойство-список с «триггером»).","type":"unstyled","key":"ejc2e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Пример кода /local/php_interface/init.php","type":"header-three","key":"61jn8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"4s4sa"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":" \"S\", // Всё храним как строку \"USER_TYPE\" => \"extended_cond_multi\", \"DESCRIPTION\" => \"Условное (Строка/Число/Текст/Файл/Bool/Date/Datetime/Список) + триггер + AJAX\", // Методы \"GetSettingsHTML\" => [__CLASS__, \"GetSettingsHTML\"], \"PrepareSettings\" => [__CLASS__, \"PrepareSettings\"], \"GetPublicEditHTML\" => [__CLASS__, \"GetPublicEditHTML\"], \"GetPublicViewHTML\" => [__CLASS__, \"GetPublicViewHTML\"], \"ConvertToDB\" => [__CLASS__, \"ConvertToDB\"], \"ConvertFromDB\" => [__CLASS__, \"ConvertFromDB\"], ]; } /** * Отвечает за отрисовку настроек свойства в админке: * - выбор инфоблока-триггера, свойства-списка, значения Enum, * - подтип (строка, число, текст, файл, bool, дата, дата+время, список), * - значение по умолчанию. */ public static function GetSettingsHTML($arProperty, $strHTMLControlName, &$arPropertyFields) { $settings = $arProperty[\"USER_TYPE_SETTINGS\"] ?? []; $iblockId = (int)($settings[\"IBLOCK_ID\"] ?? 0); $propId = (int)($settings[\"LIST_PROPERTY_ID\"] ?? 0); $enumId = (int)($settings[\"LIST_ENUM_ID\"] ?? 0); $fieldSubtype = (string)($settings[\"FIELD_SUBTYPE\"] ?? \"string\"); $defaultVal = (string)($settings[\"DEFAULT_VALUE\"] ?? \"\"); // Указываем, что будем выводить настройки пользовательского типа $arPropertyFields = [\"SHOW\" => [\"USER_TYPE_SETTINGS\"]]; // (A) Выбор инфоблока $iblockOptions = \"\"; $resIblocks = \\CIBlock::GetList([\"NAME\"=>\"ASC\"], [\"CHECK_PERMISSIONS\"=>\"N\"]); while($ib = $resIblocks->Fetch()) { $sel = ($ib[\"ID\"] == $iblockId) ? \"selected\" : \"\"; $safeName = htmlspecialcharsbx(\"[{$ib[\"ID\"]}] {$ib[\"NAME\"]}\"); $iblockOptions .= \"\"; } $html = \" Инфоблок (триггер):
Сохраните, чтобы увидеть след. этап \"; // (B) Свойство-список if($iblockId>0) { $propOptions = \"\"; $pRes = \\CIBlockProperty::GetList([\"NAME\"=>\"ASC\"], [ \"IBLOCK_ID\"=>$iblockId, \"PROPERTY_TYPE\"=>\"L\", ]); while($p=$pRes->Fetch()) { $s2 = ($p[\"ID\"]==$propId) ? \"selected\" : \"\"; $safeP = htmlspecialcharsbx(\"[{$p[\"ID\"]}] {$p[\"NAME\"]}\"); $propOptions .= \"\"; } $html .= \" Свойство-список:
Сохраните, чтобы увидеть список значений \"; } // (C) Enum if($iblockId>0 && $propId>0) { $enumOptions = \"\"; $enRes = \\CIBlockPropertyEnum::GetList([\"SORT\"=>\"ASC\"], [\"PROPERTY_ID\"=>$propId]); while($en=$enRes->Fetch()) { $sel = ($en[\"ID\"]==$enumId) ? \"selected\" : \"\"; $safeE = htmlspecialcharsbx(\"[{$en[\"ID\"]}] {$en[\"VALUE\"]}\"); $enumOptions .= \"\"; } $html .= \" Триггер-значение (Enum):
Если выбрано именно это значение, показываем поле \"; } // (D) Селект подтипов $subtypeOptions = [ 'string' => 'Строка', 'number' => 'Число', 'text' => 'Многострочный текст', 'file' => 'Файл (AJAX->ссылка)', 'bool' => 'Чекбокс (Да/Нет)', 'date' => 'Дата', 'datetime' => 'Дата/Время', 'list' => 'Небольшой список (из defaultVal)' ]; $htmlSubtype = \"\"; foreach($subtypeOptions as $k=>$lab) { $sel = ($k===$fieldSubtype)? \"selected\" : \"\"; $htmlSubtype.=\"\"; } $html .= \" Тип поля: \"; // (E) Default Value (для 'list' — варианты через ;) $html .= \" Значение по умолчанию (или варианты для list):
Для 'list' - варианты через ; (точку с запятой) \"; return $html; } public static function PrepareSettings($arProperty) { $s = $arProperty[\"USER_TYPE_SETTINGS\"] ?? []; $arProperty[\"USER_TYPE_SETTINGS\"] = [ \"IBLOCK_ID\" => (int)($s[\"IBLOCK_ID\"] ?? 0), \"LIST_PROPERTY_ID\" => (int)($s[\"LIST_PROPERTY_ID\"] ?? 0), \"LIST_ENUM_ID\" => (int)($s[\"LIST_ENUM_ID\"] ?? 0), \"FIELD_SUBTYPE\" => (string)($s[\"FIELD_SUBTYPE\"] ?? \"string\"), \"DEFAULT_VALUE\" => (string)($s[\"DEFAULT_VALUE\"] ?? \"\"), ]; return $arProperty; } /** * Отрисовка поля при редактировании элемента */ public static function GetPublicEditHTML($property, $value, $strHTMLControlName) { $s = $property[\"USER_TYPE_SETTINGS\"] ?? []; $propId = (int)($s[\"LIST_PROPERTY_ID\"] ?? 0); $enumId = (int)($s[\"LIST_ENUM_ID\"] ?? 0); $type = (string)($s[\"FIELD_SUBTYPE\"] ?? \"string\"); $defVal = (string)($s[\"DEFAULT_VALUE\"] ?? \"\"); // Текущее значение $curVal = (string)($value[\"VALUE\"] ?? \"\"); if($curVal===\"\" && !in_array($type, ['file','list'], true)) { $curVal = $defVal; } $wrapId = $strHTMLControlName[\"VALUE\"].\"_wrap\"; $htmlName = htmlspecialcharsbx($strHTMLControlName[\"VALUE\"]); // Определяем, как рендерить поле switch($type) { case 'number': $fieldHtml = \"\"; break; case 'text': $fieldHtml = \"\"; break; case 'bool': $checked = ($curVal==='Y') ? \"checked\" : \"\"; $fieldHtml = \" Да/Нет?\"; break; case 'date': $fieldHtml = \"\"; break; case 'datetime': $fieldHtml = \"\"; break; case 'list': // Список вариантов = defaultVal (A;B;C) $variants = explode(';', $defVal); $variants = array_map('trim',$variants); if(empty($variants[0])){ $variants=['Option1','Option2']; } $fieldHtml = \"\"; $fieldHtml.=\"
Варианты из defaultVal\"; break; case 'file': // AJAX -> uploadAjax.php, сохраняем ссылку $fileId = $htmlName.'_file'; $textId = $htmlName.'_link'; $uploadAjaxPath = \"/local/php_interface/uploadAjax.php\"; $fieldHtml = \"
\"; break; case 'string': default: $fieldHtml = \"\"; break; } // Обёртка + скрипт для скрытия/показа поля в зависимости от выбранного значения в другом свойстве $html = \"

{$fieldHtml}

\"; // JS-триггер (наблюдаем за PROPERTY_{propId} и скрываем/показываем текущее поле) $js = \" \"; return $html.$js; } public static function GetPublicViewHTML($property, $value, $strHTMLControlName) { $s = $property[\"USER_TYPE_SETTINGS\"] ?? []; $type = (string)($s[\"FIELD_SUBTYPE\"] ?? \"string\"); $val = (string)($value[\"VALUE\"] ?? \"\"); if(trim($val)===\"\") { return \"(пусто)\"; } switch($type) { case 'bool': return ($val==='Y') ? \"Да\" : \"Нет\"; case 'date': case 'datetime': return htmlspecialcharsbx($val); case 'list': return htmlspecialcharsbx($val); case 'file': $safeUrl = htmlspecialcharsbx($val); return \"Скачать/посмотреть\"; default: return htmlspecialcharsbx($val); } } public static function ConvertToDB($property, $value) { // При необходимости можно форматировать данные перед записью return $value; } public static function ConvertFromDB($property, $value) { // И при извлечении из БД return $value; } }","type":"unstyled","key":"ba01a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"7piik"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"7nb0u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Что здесь происходит:","type":"unstyled","key":"788fi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"PROPERTY_TYPE = \"S\": мы храним данные в виде строки.","type":"unordered-list-item","key":"3gls5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":0,"style":"BOLD"}],"text":"USER_TYPE = \"extended_cond_multi\": машинное название типа.","type":"unordered-list-item","key":"305t6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"BOLD"}],"text":"DESCRIPTION: человеко-читаемое название, отображается в админке.","type":"unordered-list-item","key":"80hi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"BOLD"}],"text":"GetSettingsHTML / PrepareSettings: формируют интерфейс настройки и сохраняют настройки.","type":"unordered-list-item","key":"d4p2r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"GetPublicEditHTML: отвечают за вывод поля в форме редактирования элемента инфоблока (добавляет скрипт, скрывающий/показывающий поле по «триггеру»).","type":"unordered-list-item","key":"cevt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"GetPublicViewHTML: выводит значение на публичной части.","type":"unordered-list-item","key":"4oqs9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":27,"offset":0,"style":"BOLD"}],"text":"ConvertToDB / ConvertFromDB: можно преобразовывать данные перед сохранением и извлечением.","type":"unordered-list-item","key":"7001g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":30,"style":"BOLD"}],"text":"После того как вставите код в /local/php_interface/init.php","type":"unstyled","key":"4ivet"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":26,"offset":0,"style":"BOLD"}],"text":"Можете увидеть новое поле ","type":"unstyled","key":"614d2"},{"data":{"image":{"id":"679a06c33f035153f519a4ba"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"появится новый тип поля в списке","type":"atomic:image","key":"624md"},{"data":{"image":{"id":"679a06da9fd29a7ca193b174"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сможете выбрать, после какого значнеие в списке показывать поле, по умолчанию поле скрыто ","type":"atomic:image","key":"akvbf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"16oqb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Файл uploadAjax.php для загрузки файлов","type":"header-three","key":"6t2hk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для подтипа «файл» мы используем AJAX-загрузку по адресу /local/php_interface/uploadAjax.php. Вот пример кода этого файла:","type":"unstyled","key":"pqnv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"800tf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"'error','message'=>'Only POST']); exit; } if(!isset($_FILES['uploadFile']) || $_FILES['uploadFile']['error'] !== UPLOAD_ERR_OK) { echo json_encode(['status'=>'error','message'=>'No file or upload error']); exit; } $uploadDir = $_SERVER['DOCUMENT_ROOT'].'/upload/my/'; if(!is_dir($uploadDir)){ mkdir($uploadDir, 0755, true); } $origName = $_FILES['uploadFile']['name']; $tmpName = $_FILES['uploadFile']['tmp_name']; $unique = uniqid().'_'.preg_replace('/[^a-zA-Z0-9_\\.-]/','_', $origName); $destPath = $uploadDir.$unique; if(move_uploaded_file($tmpName, $destPath)){ // Генерируем публичную ссылку $scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS']!='off')?'https':'http'; $host = $_SERVER['HTTP_HOST']; $fileUrl = $scheme.'://'.$host.'/upload/my/'.$unique; echo json_encode(['status'=>'ok','url'=>$fileUrl]); } else { echo json_encode(['status'=>'error','message'=>'Failed to move_uploaded_file']); }","type":"unstyled","key":"3mm3t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"9haop"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основные моменты:","type":"unstyled","key":"14edv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Скрипт ожидает POST-запрос с полем uploadFile.","type":"unordered-list-item","key":"8s4la"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сохраняет полученный файл в /upload/my/.","type":"unordered-list-item","key":"1tpmb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Возвращает JSON с публичной ссылкой на загруженный файл, чтобы сразу подставить её в наше свойство.","type":"unordered-list-item","key":"28m3h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итоги","type":"header-two","key":"984op"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Таким образом, вы можете расширить возможности бизнес-процессов, форм и списков в Битрикс24 (коробочная версия), создав собственные динамические поля. Для этого:","type":"unstyled","key":"3f42p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":0,"style":"BOLD"}],"text":"Проверьте, где хранятся стандартные типы (например, в файле /bitrix/modules/lists/classes/general/listfieldtypes.php).","type":"ordered-list-item","key":"cseek"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":0,"style":"BOLD"}],"text":"Создайте класс, описывающий логику нового типа свойства и зарегистрируйте его через AddEventHandler в файле /local/php_interface/init.php.","type":"ordered-list-item","key":"bvp4s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"BOLD"}],"text":"Реализуйте нужные методы (отрисовка формы, обработка настроек, сохранение/вывод значения и т.д.).","type":"ordered-list-item","key":"1gc9s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":0,"style":"BOLD"}],"text":"Добавьте при необходимости дополнительные скрипты (например, для AJAX-загрузки) и подключите их так, чтобы они были доступны (как uploadAjax.php).","type":"ordered-list-item","key":"62isp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь, имея собственный тип поля, вы сможете формировать более гибкие бизнес-процессы с условными (динамическими) полями, которые будут показываться пользователю при выполнении определённых условий. Это открывает широкие возможности для кастомизации форм и автоматизации процессов внутри корпоративного портала Битрикс24.","type":"unstyled","key":"h4li"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если всё сделано правильно, новое свойство будет доступно при добавлении/редактировании свойств инфоблока ","type":"unstyled","key":"1oql8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"uegp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"w8IPvKunYK6eUQnVasxQ"}],"entityMap":{}},"mentions":[]}