entityproperty.php

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

<?php
 
namespace Bitrix\Sale;
 
use Bitrix\Location\Entity\Address;
use Bitrix\Sale\Internals\Input;
use Bitrix\Main;
use Bitrix\Main\Localization\Loc;
use Bitrix\Sale\Internals\OrderPropsGroupTable;
use Bitrix\Sale\Internals\OrderPropsTable;
 
Loc::loadMessages(__FILE__);

abstract class EntityProperty
{
    protected $fields = [];

    abstract protected static function getEntityType(): string;

    public static function getRegistryType()
    {
        return Registry::REGISTRY_TYPE_ORDER;
    }

    public function getField($name)
    {
        return $this->fields[$name] ?? null;
    }

    public static function getList(array $parameters = [])
    {
        $filter = [
            '=ENTITY_REGISTRY_TYPE' => static::getRegistryType(),
            '=ENTITY_TYPE' => static::getEntityType()
        ];
 
        if (isset($parameters['filter']))
        {
            $filter[] = $parameters['filter'];
        }
 
        $parameters['filter'] = $filter;
        return OrderPropsTable::getList($parameters);
    }

    public static function getObjectById($propertyId)
    {
        $dbRes = static::getList([
            'filter' => [
                '=ID' => $propertyId
            ]
        ]);
 
        $data = $dbRes->fetch();
        if ($data)
        {
            return new static($data);
        }
 
        return null;
    }

    public function getGroupInfo(bool $refreshData = false)
    {
        static $groupList = [];
 
        if ($refreshData || !isset($groupList[$this->getPersonTypeId()]))
        {
            $dbRes = OrderPropsGroupTable::getList([
                'filter' => [
                    '=PERSON_TYPE_ID' => $this->getPersonTypeId()
                ]
            ]);
            while ($group = $dbRes->fetch())
            {
                $groupList[$this->getPersonTypeId()][$group['ID']] = $group;
            }
        }
 
        $groupId = $this->getGroupId();
 
        if (!isset($groupList[$this->getPersonTypeId()][$groupId]))
        {
            return [
                'ID' => 0,
                'NAME' => Loc::getMessage('SOP_UNKNOWN_GROUP'),
            ];
        }
 
        return $groupList[$this->getPersonTypeId()][$groupId];
    }

    public function __construct(array $property, array $relation = null)
    {
        if (isset($property['SETTINGS']) && is_array($property['SETTINGS']))
        {
            $property += $property['SETTINGS'];
            unset ($property['SETTINGS']);
        }
 
        $this->fields = $property;
 
        if ($relation === null)
        {
            $relation = $this->loadRelations();
        }
 
        $this->fields['RELATION'] = $relation;
 
        if ($this->fields['TYPE'] === 'ENUM')
        {
            if (!isset($property['OPTIONS']))
            {
                $this->fields['OPTIONS'] = $this->loadOptions();
            }
        }
 
        if (isset($this->fields['DEFAULT_VALUE']))
        {
            $this->fields['DEFAULT_VALUE'] = $this->normalizeValue($this->fields['DEFAULT_VALUE']);
        }
    }

    public function normalizeValue($value)
    {
        if ($this->fields['TYPE'] === 'FILE')
        {
            return Input\File::loadInfo($value);
        }
        elseif ($this->fields['TYPE'] === 'ADDRESS' && Main\Loader::includeModule('location'))
        {
            if (is_array($value))
            {
                return $value;
            }
            elseif (is_numeric($value))
            {
                $address = Address::load((int)$value);
 
                $value = ($address instanceof Address) ? $address->toArray() : null;
            }
            elseif (is_string($value) && !empty($value))
            {
 
                try
                {
                    $result = Main\Web\Json::decode($value);
                }
                catch (\Exception $exception)
                {
                    $result = (new Address(LANGUAGE_ID))
                        ->setFieldValue(Address\FieldType::ADDRESS_LINE_2, $value)
                        ->toArray();
                }
 
                return $result;
            }
        }
        elseif ($this->fields['TYPE'] === "STRING")
        {
            if (isset($this->fields['IS_EMAIL']) && $this->fields['IS_EMAIL'] === "Y" && !empty($value))
            {
                $value = trim((string)$value);
            }
 
            if (Input\StringInput::isMultiple($value))
            {
                foreach ($value as $key => $data)
                {
                    if (Input\StringInput::isDeletedSingle($data))
                    {
                        unset($value[$key]);
                    }
                }
            }
 
            return $value;
        }
 
        return $value;
    }

    protected function loadOptions()
    {
        $options = array();
 
        $dbRes = Internals\OrderPropsVariantTable::getList([
            'select' => ['VALUE', 'NAME'],
            'filter' => ['ORDER_PROPS_ID' => $this->getId()],
            'order' => ['SORT' => 'ASC']
        ]);
 
        while ($data = $dbRes->fetch())
        {
            $options[$data['VALUE']] = $data['NAME'];
        }
 
        return $options;
    }

    protected function loadRelations()
    {
        return Internals\OrderPropsRelationTable::getRelationsByPropertyId($this->getId());
    }

    public static function getMeaningfulValues($personTypeId, $request)
    {
        $result = [];
 
        $personTypeId = intval($personTypeId);
        if ($personTypeId <= 0 || !is_array($request))
        {
            return [];
        }
 
        $dbRes = static::getList([
            'select' => [
                'ID',
                'IS_LOCATION',
                'IS_EMAIL',
                'IS_PROFILE_NAME',
                'IS_PAYER',
                'IS_LOCATION4TAX',
                'IS_ZIP',
                'IS_PHONE',
                'IS_ADDRESS',
                'IS_ADDRESS_FROM',
                'IS_ADDRESS_TO',
            ],
            'filter' => [
                '=ACTIVE' => 'Y',
                '=UTIL' => 'N',
                '=PERSON_TYPE_ID' => $personTypeId
            ]
        ]);
 
        while ($row = $dbRes->fetch())
        {
            if (array_key_exists($row["ID"], $request))
            {
                foreach ($row as $key => $value)
                {
                    if (($value === "Y") && (mb_substr($key, 0, 3) === "IS_"))
                    {
                        $result[mb_substr($key, 3)] = $request[$row["ID"]];
                    }
                }
            }
        }
 
        return $result;
    }

    public function checkValue($value)
    {
        $result = new Result();
 
        static $errors = [];
 
        if (
            $this->getField('TYPE') === "STRING"
            && (int)$this->getField('MAXLENGTH') <= 0
        )
        {
            $this->fields['MAXLENGTH'] = 500;
        }
 
        $error = Input\Manager::getError($this->fields, $value);
 
        if (!is_array($error))
        {
            $error = array($error);
        }
 
        foreach ($error as $item)
        {
            if (!is_array($item))
            {
                $item = [$item];
            }
 
            foreach ($item as $message)
            {
                if (isset($errorsList[$this->getId()]) && in_array($message, $errors[$this->getId()]))
                {
                    continue;
                }
 
                $result->addError(
                    new Main\Error(
                        Loc::getMessage(
                            "SALE_PROPERTY_ERROR",
                            ["#PROPERTY_NAME#" => $this->getField('NAME'), "#ERROR_MESSAGE#" => $message]
                        )
                    )
                );
            }
        }
 
        if (!is_array($value) && isset($value))
        {
            $value = trim((string)$value);
 
            if ($value !== '' && $this->getField('IS_EMAIL') === 'Y')
            {
                if (!check_email($value, true))
                {
                    $result->addError(
                        new Main\Error(
                            Loc::getMessage("SALE_GOPE_WRONG_EMAIL")
                        )
                    );
                }
            }
        }
 
        return $result;
    }

    public function checkRequiredValue($value)
    {
        static $errors = [];
 
        $result = new Result();
 
        $errorList = Input\Manager::getRequiredError($this->fields, $value);
 
        foreach ($errorList as $error)
        {
            if (is_array($error))
            {
                foreach ($error as $message)
                {
                    $result->addError(new ResultError($message));
                    $errors[$this->getId()][] = $message;
                }
            }
            else
            {
                $result->addError(new ResultError($error));
                $errors[$this->getId()][] = $error;
            }
        }
 
        return $result;
    }

    public function getPreparedValueForSave(EntityPropertyValue $propertyValue)
    {
        $value = $propertyValue->getField('VALUE');
 
        if ($this->getType() == 'FILE')
        {
            $value = Input\File::asMultiple($value);
 
            foreach ($value as $i => $file)
            {
                if (Input\File::isDeletedSingle($file))
                {
                    unset($value[$i]);
                }
                else
                {
                    if (Input\File::isUploadedSingle($file))
                    {
                        $fileId = \CFile::SaveFile(array('MODULE_ID' => 'sale') + $file, 'sale/order/properties');
                        if (is_numeric($fileId))
                        {
                            $file = $fileId;
                        }
                    }
 
                    $value[$i] = Input\File::loadInfoSingle($file);
                }
            }
 
            $property = $this->getFields();
            $propertyValue->setField('VALUE', $value);
            $value = Input\File::getValue($property, $value);
 
            $originalFields = $propertyValue->getFields()->getOriginalValues();
            foreach (
                array_diff(
                    Input\File::asMultiple(Input\File::getValue($property, $originalFields['VALUE'])),
                    Input\File::asMultiple($value),
                    Input\File::asMultiple(Input\File::getValue($property, $property['DEFAULT_VALUE']))
                )
                as $fileId
            )
            {
                \CFile::Delete($fileId);
            }
        }
        elseif ($this->getType() === 'ADDRESS'  && Main\Loader::includeModule('location'))
        {
            if (!is_array($value))
            {
                return null;
            }
 
            $address = Address::fromArray($value);
            $result = $address->save();
            if (!$result->isSuccess())
            {
                return null;
            }
 
            return (int)$result->getId();
        }
 
        return $value;
    }

    public function getViewHtml($value)
    {
        return Input\Manager::getViewHtml($this->fields, $value);
    }

    public function getEditHtml(array $values)
    {
        $key = isset($this->property["ID"]) ? $this->getId() : "n".$values['ORDER_PROPS_ID'];
        return Input\Manager::getEditHtml("PROPERTIES[".$key."]", $this->fields, $values['VALUE']);
    }

    public function getFields()
    {
        return $this->fields;
    }

    public function getId()
    {
        return $this->getField('ID');
    }

    public function getPersonTypeId()
    {
        return $this->getField('PERSON_TYPE_ID');
    }

    public function getGroupId()
    {
        return $this->getField('PROPS_GROUP_ID');
    }

    public function getName()
    {
        return $this->getField('NAME');
    }

    public function getRelations()
    {
        return $this->getField('RELATION');
    }

    public function getDescription()
    {
        return $this->getField('DESCRIPTION');
    }

    public function getType()
    {
        return $this->getField('TYPE');
    }

    public function isRequired()
    {
        return $this->getField('REQUIRED') === 'Y';
    }

    public function isUtil()
    {
        return $this->getField('UTIL') === 'Y';
    }

    public function getOptions()
    {
        return $this->getField('OPTIONS');
    }

    public function onValueDelete($value)
    {
        if ($this->getType() === 'FILE')
        {
            foreach (Input\File::asMultiple($value) as $fileId)
            {
                \CFile::Delete($fileId);
            }
        }
    }
}