entityimport.php

См. документацию.

<?php
namespace Bitrix\Sale\Exchange\Entity;
 
use Bitrix\Main;
use Bitrix\Sale;
use Bitrix\Sale\Shipment;
use Bitrix\Sale\Payment;
use Bitrix\Sale\Exchange;
use Bitrix\Sale\EntityMarker;

abstract class EntityImport extends Exchange\ImportBase
{
    public $collisions = array();
 
    protected $parentEntity = null;
    protected $entity = null;
    protected $external = null;
    protected $marked = false;
 
    public function __construct($parentEntityContext = null)
    {
        $this->fields = new Sale\Internals\Fields();
 
        if(!empty($parentEntityContext))
        {
            $this->setParentEntity($parentEntityContext);
        }
    }

    public function getOwnerTypeId()
    {
        return Exchange\EntityType::UNDEFINED;
    }

    public function setParentEntity(Sale\Order $parentEntity)
    {
        $this->parentEntity = $parentEntity;
    }

    public function getParentEntity()
    {
        return $this->parentEntity;
    }

    public function isLoadedParentEntity()
    {
        $order = $this->getParentEntity();
        return $order instanceof Sale\Order;
    }

    protected function loadParentEntity(array $fields)
    {
        $entity = null;
 
        if(!empty($fields['ID']))
        {
 
            $registry = Sale\Registry::getInstance(Sale\Registry::REGISTRY_TYPE_ORDER);
            $orderClass = $registry->getOrderClassName();

            $entity = $orderClass::load($fields['ID']);
        }
        return $entity;
    }

    abstract public function setEntity(Sale\Internals\Entity $entity);

    public function getEntity()
    {
        return $this->entity;
    }

    protected function isExternal()
    {
        return $this->external;
    }

    public function setExternal($external = true)
    {
        $this->external = $external;
    }

    public function setCollisions($tipeId, Sale\Internals\Entity $entity, $message=null)
    {
        if(Exchange\EntityCollisionType::getErrorGroup($tipeId) == Exchange\EntityCollisionType::GROUP_E_ERROR)
        {
            $this->collisionErrors = true;
        }
        elseif(Exchange\EntityCollisionType::getErrorGroup($tipeId) == Exchange\EntityCollisionType::GROUP_E_WARNING)
        {
            $this->collisionWarnings = true;
        }
 
        $collision = $this->getCurrentCollision($this->getOwnerTypeId());
        $collision->addItem($this->getOwnerTypeId(), $tipeId, $entity, $message);
 
        $this->collisions[] = $collision;
    }

    public function getCollisions()
    {
        return $this->collisions;
    }

    public function hasCollisions()
    {
        return (count($this->collisions));
    }

    public function markedEntityCollisions($collisions)
    {
        $entity = $this->getEntity();

        $parentEntity = $this->getParentEntity();

        foreach($collisions as $collision)
        {
            $result = new Sale\Result();
            $result->addWarning(new Sale\ResultError(Exchange\EntityCollisionType::getDescription($collision->getTypeId()).($collision->getMessage() != null ? " ".$collision->getMessage():'' ), $collision->getTypeName()));
 
            $entity->setField('MARKED', 'Y');
            $this->marked = true;
 
            $collisionEntity = $collision->getEntity();
            if(!empty($collisionEntity))
            {
                $this->addMarker($parentEntity, $collisionEntity, $result);
            }
            else
            {
                $this->addMarker($parentEntity, $entity, $result);
            }
        }
    }

    protected function addMarker($order, $entity, $result)
    {
        EntityMarker::addMarker($order, $entity, $result);
    }

    public function isMarked()
    {
        return $this->marked;
    }

    public function getId()
    {
        return $this->getEntityId();
    }

    public function isImportable()
    {
        return $this->settings->isImportableFor($this->getOwnerTypeId());
    }

    public function import(array $params)
    {
        $result = parent::import($params);
        if($result->isSuccess())
        {
            if(($entity = $this->getEntity()))
                $this->marked($entity, $params['TRAITS']);
        }
        return $result;
    }

    abstract public function save();

    function marked(Sale\Internals\Entity $entity, array $fields)
    {
        if($this->isExternal())
            $entity->setField($this->getExternalFieldName(), 'Y');
        else
            $entity->setField('UPDATED_1C', 'Y');
 
        if(!$this->hasCollisions())
        {
            $entity->setField('VERSION_1C', $fields['VERSION_1C']);
        }
 
        $entity->setField('ID_1C', $fields['ID_1C']);
 
        if(!($entity instanceof Sale\Order))
        {
            $parentEntity = $this->getParentEntity();
 
            $parentEntity->setField('UPDATED_1C','Y');
        }
    }

    public function getEntityId()
    {
        $entity = $this->getEntity();
        if(!empty($entity))
        {
            return $entity->getId();
        }
 
        return null;
    }

    protected function checkEntity($id)
    {
        return is_int($id) && $id > 0;
    }

    abstract protected function getExternalFieldName();

    public static function resolveEntityTypeId(Sale\Internals\Entity $entity)
    {
        return Exchange\EntityType::UNDEFINED;
    }

    public static function getFieldExternalId()
    {
        return 'ID_1C';
    }
}