Converter

Методы

В современной веб-разработке фронтенд занимает значительную частью кода. И этот код тоже должен быть хорошо структурирован, разделен на слои, разбит на классы и т.д.

Соответственно, на стороне фронтенда должен быть удобный класс, предоставляющий доступ к данным об элементах CRM или других сущностей.

Заготовкой такого класса является javascript-экстеншн crm.model.

Чтобы данные для этого класса были правильно подготовлены необходим сервис Service\Converter.

Это абстрактный класс, для каждого типа модели необходимо иметь свою реализацию.

Этот же сервис используется для формирования данных в REST-методах.

abstract public function toJson($model): array;

public function convertKeysToCamelCase(array $data): array

Наследники

Самый простой вид конвертера. Метод toJson принимает на вход EntityObject и преобразует в json актуальные значения объекта.

Преобразует в json данные об элементе CRM.

Этот конвертер вызывается автоматически в методе Item::jsonSerialize().

Преобразует в json данные о настройках смарт-процесса. На вход принимает orm-объект \Bitrix\Crm\Model\Dynamic\Type.

Работает в паре с js-экстеншном crm.type-model.

Преобразует в json данные о стадии. На вход принимает orm-объект \Bitrix\Crm\EO_Status.

Примеры

use Bitrix\Crm\Service;

$factory = Service\Container::getInstance()->getFactory(\CCrmOwnerType::Quote);
$stages = $factory->getStages();
$converter = Service\Container::getInstance()->getStageConverter();

$json = [];
foreach ($stages as $stage)
{
	$json[] = $converter->toJson($stage);
}