Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Как сделать свою карточку редактирования лида». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.
Как сделать свою карточку редактирования лида
> Scope: crm
>
> Кто может выполнять метод: пользователи с административным доступом к разделу CRM
Пример автоматической генерирации карточки редактирования лида со всеми полями, созданными в Битрикс24, на странице приложения.
Некоторые типы полей не реализованы в данном примере, на месте полей с неподдерживаемым типом будет выводиться сообщение field not support.
Информация
Для использования примеров на PHP настройте работу класса CRest и подключите файл crest.php в файлах, где используется этот класс. Подробнее
Для использования примеров на PHP настройте работу класса CRest и подключите файл crest.php в файлах, где используется этот класс. Подробнее
Код генерируемой формы:
<?
$ID = intVal($_REQUEST['ID']);
class CPrintForm
{
/**
* @var $arParams array params input keys: 'NAME', 'ID', 'TYPE', 'REQUIRED', 'CHECKED', 'DISABLE', 'MULTIPLE', 'VALUE'
* @return string html select
*/
public static function input($arParams)
{
$count = 0;
$i = 0;
$sResult = '';
if($arParams[ 'MULTIPLE' ] && $arParams[ 'TYPE' ] != 'file')
{
$count = 2;
}
$value = $arParams[ 'VALUE' ];
while($i <= $count)
{
if($count > 0)
{
$value = $arParams[ 'VALUE' ][ $i ];
}
$sResult .= '<input class="form-control' . (($arParams[ 'TYPE' ] == 'file') ? '-file' : '') . '"';
if(!empty($arParams[ 'ID' ]))
{
$sResult .= ' id="' . $arParams[ 'ID' ] . '"';
}
if(!empty($arParams[ 'NAME' ]))
{
$sResult .= ' name="' . $arParams[ 'NAME' ] . '' . (($arParams[ 'MULTIPLE' ]) ? '[]' : '') . '"';
}
if(!empty($arParams[ 'TYPE' ]))
{
$sResult .= ' type="' . $arParams[ 'TYPE' ] . '"';
}
if(!empty($arParams[ 'REQUIRED' ]))
{
$sResult .= ' required';
}
if(!empty($arParams[ 'DISABLE' ]))
{
$sResult .= ' disabled';
}
if(!empty($arParams[ 'CHECKED' ]))
{
$sResult .= ' checked';
}
if(!empty($arParams[ 'MULTIPLE' ])) //sometimes work, not for standard type="text"
{
$sResult .= ' multiple';
}
if(!empty($arParams[ 'VALUE' ]))
{
$sResult .= ' value="' . $value . '"';
}
$sResult .= '>';
$i++;
}
return $sResult;
}
/**
* @var $arParams array settings of select params keys: 'NAME', 'ID', 'REQUIRED', 'DISABLE','MULTIPLE', 'VALUE'
* @var $arList array of select options where key is value option and value is title
* @return string html select
*/
public static function select($arParams, $arList)
{
$sResult = '';
if(!empty($arList) && is_array($arList))
{
$sResult .= '<select class="form-control"'
. (($arParams[ 'NAME' ]) ? ' name="' . $arParams[ 'NAME' ] . '' . (($arParams[ 'MULTIPLE' ]) ? '[]' : '') . '"' : '')
. (($arParams[ 'ID' ]) ? ' id="' . $arParams[ 'ID' ] . '"' : '')
. (($arParams[ 'REQUIRED' ]) ? ' required' : '')
. (($arParams[ 'DISABLE' ]) ? ' disabled' : '')
. (($arParams[ 'MULTIPLE' ]) ? ' multiple' : '')
. '>';
$value = [];
if(is_array($arParams[ 'VALUE' ]))
{
$value = $arParams[ 'VALUE' ];
}
else
{
$value[] = ($arParams[ 'VALUE' ]) ? $arParams[ 'VALUE' ] : '';
}
foreach($arList as $key => $title)
{
$sResult .= '<option value="' . $key . '" ' .
((in_array($key, $value)) ? ' selected' : '')
. '>' . $title . '</option>';
}
$sResult .= '</select>';
}
return $sResult;
}
}
$arData = [
//Get all fields and standard enum fields
'FIELDS' => [
'method' => 'crm.lead.fields',
'params' => []
],
'FIELD_VALUES_SOURCE_ID' => [
'method' => 'crm.status.list',//only 50 first values
'params' => ['filter' => ['ENTITY_ID' => '$result[FIELDS][SOURCE_ID][statusType]']]
],
'FIELD_VALUES_STATUS_ID' => [
'method' => 'crm.status.list',//only 50 first values
'params' => ['filter' => ['ENTITY_ID' => '$result[FIELDS][STATUS_ID][statusType]']]
],
'FIELD_VALUES_CURRENCY' => [
'method' => 'crm.currency.list',//only 50 first values
'params' => ['filter' => ['ENTITY_ID' => '$result[FIELDS][STATUS_ID][statusType]']]
],
'OWNER_TYPE' => [
'method' => 'crm.enum.ownertype',
'params' => []
],
];
if($ID > 0)//get item and standard enum field values if is update form
{
$arData['ITEM'] = [
'method' => 'crm.lead.get',
'params' => ['id' => $ID]
];
$arData['VALUE_COMPANY_ID'] = [
'method' => 'crm.company.get',
'params' => ['id' => '$result[ITEM][COMPANY_ID]']
];
$arData['VALUE_CONTACT_ID'] = [
'method' => 'crm.contact.get',
'params' => ['id' => '$result[ITEM][CONTACT_ID]']
];
}
$arResult = CRest::callBatch($arData, 0);
$arResult = $arResult['result']['result'];
$sResult = '';
$sResultCustom = '';
if(is_array($arResult['FIELDS'])):
foreach($arResult[ 'FIELDS' ] as $key => $arField)
{
$value = '';
$return = '';
if(!empty($arResult[ 'ITEM' ][ $key ]))
{
$value = $arResult[ 'ITEM' ][ $key ];
}
$arList = (isset($arResult[ 'FIELD_VALUES_' . $key ])) ? $arResult[ 'FIELD_VALUES_' . $key ] : [];
switch($arField[ 'type' ])
{
case 'crm_status':
if(empty($arList))
{
$arFieldsStatus = \CRest ::get('crm.status.list', ['filter' => ['ENTITY_ID' => $arField[ 'statusType' ]]]);
if(!empty($arFieldsStatus[ 'result' ]))
$arList = $arFieldsStatus[ 'result' ];
}
$arList = array_column($arList, 'NAME', 'STATUS_ID');
$return = CPrintForm ::select(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value
],
$arList);
break;
case 'crm_currency':
$arList = array_column($arResult[ 'FIELD_VALUES_CURRENCY' ], 'FULL_NAME', 'CURRENCY');
$return = CPrintForm ::select(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value
],
$arList);
break;
case 'enumeration':
if(!empty($arField[ 'items' ]))
$arList = array_column($arField[ 'items' ], 'VALUE', 'ID');
$return = CPrintForm ::select(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value
],
$arList);
break;
case 'crm_multifield'://its simple example: need multifield, check data type and more...
if(!empty($value) && is_array($value))
$value = reset($value)[ 'VALUE' ];
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => false,
'VALUE' => $value,
'TYPE' => 'text',
]);
break;
case 'crm_company':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'text',
]);
if(!empty($arResult[ 'VALUE_COMPANY_ID' ]) && $value == $arResult[ 'VALUE_COMPANY_ID' ][ 'ID' ])
{
$return .= '(' . $arResult[ 'VALUE_COMPANY_ID' ][ 'TITLE' ] . ')';
}
break;
case 'crm_contact':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'text',
]);
if(!empty($arResult[ 'VALUE_CONTACT_ID' ]) && $value == $arResult[ 'VALUE_CONTACT_ID' ][ 'ID' ])
{
$return .= '(' . implode(' ', [$arResult[ 'VALUE_CONTACT_ID' ][ 'NAME' ], $arResult[ 'VALUE_CONTACT_ID' ][ 'LAST_NAME' ]]) . ')';
}
break;
case 'file':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'file',
]);
if($arField[ 'isMultiple' ])
{
if(is_array($value))
{
foreach($value as $k => $val)
{
if(!empty($val[ 'downloadUrl' ]))
{
$return .= '<br/><a href="' . $val[ 'downloadUrl' ] . '">old file ' . $k . '</a>';
}
}
}
}
else
{
if(!empty($value[ 'downloadUrl' ]))
{
$return .= '<br/><a href="' . $value[ 'downloadUrl' ] . '">old file</a>';
}
}
break;
case 'date':
if(!empty($value))
{
$value = date('Y-m-d', strtotime($value));
}
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'date',
]);
break;
case 'datetime':
if(!empty($value))
{
$value = date('Y-m-d\TH:i:s', strtotime($value));
}
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'datetime-local',
]);
break;
case 'char':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => 'Y',
'CHECKED' => ($value == 'Y') ? true : false,
'TYPE' => 'checkbox',
]);
break;
case 'boolean':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => '1',
'CHECKED' => ($value == 'Y') ? true : false,
'TYPE' => 'checkbox',
]);
break;
case 'double':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'number'
]);
break;
case 'url':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'text',
]);
break;
case 'integer':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'number',
]);
break;
case 'user':
$arUser = [];
if(!empty($value))
{
$arUser = CRest ::get('user.get', ['filter' => ['ID' => $value]]);
}
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'number'
]);
if(!empty($arUser[ 'result' ]))
{
$return .= '(';
$i = 0;
foreach($arUser[ 'result' ] as $val)
{
$i++;
if($i > 1)
{
$return .= ', ';
}
$return .= implode(' ', [$val[ 'NAME' ], $val[ 'LAST_NAME' ]]);
}
$return .= ')';
}
break;
case 'money':
list($money, $currency) = explode('|', $value);
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $money,
'TYPE' => 'number',
]);
$arList = array_column($arResult[ 'FIELD_VALUES_CURRENCY' ], 'FULL_NAME', 'CURRENCY');
$return .= CPrintForm ::select(
[
'NAME' => $key . '_CURRENCY',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $currency
],
$arList);
break;
case 'address':
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'text',
]);
break;
case 'resourcebooking':
//some code booking
$return = 'field not support';
break;
default:
$return = CPrintForm ::input(
[
'NAME' => 'form[' . $key . ']',
'REQUIRED' => $arField[ 'isRequired' ],
'DISABLE' => $arField[ 'isReadOnly' ],
'MULTIPLE' => $arField[ 'isMultiple' ],
'VALUE' => $value,
'TYPE' => 'text',
]);
break;
}
if(strpos($key, 'UF_') === 0)
{
$sResultCustom .= '<div class="col-4 mt-3">' . (($arField[ 'formLabel' ]) ? $arField[ 'formLabel' ] : $arField[ 'title' ]) . ': ' . '</div>';
$sResultCustom .= '<div class="col-6 mt-3">' . $return . '</div>';
}
else
{
$sResult .= '<div class="col-4 mt-3">' . (($arField[ 'formLabel' ]) ? $arField[ 'formLabel' ] : $arField[ 'title' ]) . ': ' . '</div>';
$sResult .= '<div class="col-6 mt-3">' . $return . '</div>';
}
}
?>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" crossorigin="anonymous">
<script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" crossorigin="anonymous"></script>
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js" crossorigin="anonymous"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<script>
$(document).ready(function()
{
$('#auto_form').on( 'submit', function(el) {//event submit form
el.preventDefault();//the default action of the event will not be triggered
var formData = new FormData(this);
var xhr = new XMLHttpRequest();
xhr.open("POST", 'auto_form.php');
xhr.onreadystatechange = function () {
if (this.readyState === 4) {
if (this.status >= 200 && this.status < 400) {
// Success!
var resp = this.responseText;
try {
var json = JSON.parse(resp);
if (typeof json.message !== 'undefined') {
alert(json.message);
}
} catch (e) {
return false;
}
} else {
alert('error');
}
}
};
xhr.send(formData);
});
});
</script>
<div class="container">
<form id="auto_form" action="" enctype="multipart/form-data" method="post">
<? if(!empty($arResult[ 'ITEM' ][ 'ID' ]))://for update entity
?>
<input type="hidden" name="form[ID]" value="<?= $arResult[ 'ITEM' ][ 'ID' ] ?>">
<?endif; ?>
<h2>Standard fields</h2>
<div class="row">
<?= $sResult ?>
</div>
<h2>Custom fields</h2>
<div class="row">
<?= $sResultCustom ?>
</div>
<div class="row">
<div class="col-sm-10 mt-5">
<input type="submit" class="btn btn-primary" value="Submit">
</div>
</div>
</form>
</div>
<?endif; ?>Код файла auto_form.php, который сохраняет форму:
<?
$arForm = [];
foreach($_POST['form'] as $key => $item)
{
if(is_array($item))
{
$arForm[$key] = [];
foreach($item as $k => $val)
{
$arForm[$key][$k] = htmlspecialchars($val);
}
}
else
{
$arForm[$key] = htmlspecialchars($item);
}
}
//make array multiple files for add to custom field
if(!empty($_FILES['form']['tmp_name']) && is_array($_FILES['form']['tmp_name']))
{
foreach($_FILES['form']['tmp_name'] as $key => $files)
{
if(is_array($files))
{
foreach($files as $k => $file)
{
$arForm[$key][$k] = [
"fileData" => [
$_FILES['form']['name'][$key][$k],
base64_encode(file_get_contents($file))
]
];
}
}
else
{
$arForm[$key] = [
"fileData" => [
$_FILES['form']['name'][$key],
base64_encode(file_get_contents($files))
]
];
}
}
}
$arResult = CRest::get('crm.lead.fields', []);
if(!empty($arResult['result']))
{
foreach($arResult['result'] as $key => $prop)
{
if(!isset($arForm[$key]))
{
if(!$prop['isReadOnly'] && $prop['type'] != 'file')
{
if($prop['type'] == 'enumeration' && $prop['isMultiple'])
{
//if type multiple enumeration to clean selected value need send: [false]
$arForm[$key] = [false];
}
elseif($prop['isMultiple'])
{
$arForm[$key] = [];
}
else
{
$arForm[$key] = '';
}
}
continue;
}
//here may be any check field example by type
if($prop['type'] == 'crm_multifield')
{
if(isset($arForm[$key]))
{
$arForm[$key] = [['VALUE' => $arForm[$key]]];
}
}
elseif($prop['type'] == 'money')
{
$arForm[$key] = implode('|', [$arForm[$key], $arForm[$key . '_CURRENCY']]);
unset($arForm[$key . '_CURRENCY']);
}
}
}
$arForm['ID'] = intVal($arForm['ID']);
if($arForm['ID'] > 0)
{
$method = 'crm.lead.update';
$arParams = [
'id' => $arForm['ID'],
'fields' => $arForm
];
$arMess = [
'success' => 'Lead update',
'error' => 'Lead not updated',
];
}
else
{
$method = 'crm.lead.add';
$arParams = [
'fields' => $arForm
];
$arMess = [
'success' => 'Lead add',
'error' => 'Lead not added',
];
}
$result = CRest::get($method, $arParams);
if(!empty($result['result']))
{
echo json_encode(['message' => $arMess['success'] . (($method == 'crm.lead.add') ? ' ID:' . $result['result'] : '')]);
}
elseif(!empty($result['error_description']))
{
echo json_encode(['message' => $arMess['error'] . ': ' . $result['error_description']]);
}
else
{
echo json_encode(['message' => $arMess['error']]);
}
?>💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к битрикс, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Как сделать свою карточку редактирования лида».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
Написать во ВКонтакте
или на почту: gorandvas@yandex.ru
