userfield.php

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

<?php
 
namespace Bitrix\Main;
 
use Bitrix\Main\DB\SqlExpression;
use Bitrix\Main\Localization\Loc;

class UserFieldTable extends ORM\Data\DataManager
{
    // to use in uts serialized fields
    const MULTIPLE_DATE_FORMAT = 'Y-m-d';
    const MULTIPLE_DATETIME_FORMAT = 'Y-m-d H:i:s';
 
    public static function getMap()
    {
        return array(
            'ID' => array(
                'data_type' => 'integer',
                'primary' => true,
                'autocomplete' => true,
            ),
            'ENTITY_ID' => array(
                'data_type' => 'string',
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_ENTITY_ID_TITLE'),
            ),
            'FIELD_NAME' => array(
                'data_type' => 'string',
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_FIELD_NAME_TITLE'),
            ),
            'USER_TYPE_ID' => array(
                'data_type' => 'string',
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_USER_TYPE_ID_TITLE'),
            ),
            'XML_ID' => array(
                'data_type' => 'string',
            ),
            'SORT' => array(
                'data_type' => 'integer',
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_SORT_TITLE'),
            ),
            'MULTIPLE' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_MULTIPLE_TITLE'),
            ),
            'MANDATORY' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_MANDATORY_TITLE'),
            ),
            'SHOW_FILTER' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_SHOW_FILTER_TITLE'),
            ),
            'SHOW_IN_LIST' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_SHOW_IN_LIST_TITLE'),
            ),
            'EDIT_IN_LIST' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_EDIT_IN_LIST_TITLE'),
            ),
            'IS_SEARCHABLE' => array(
                'data_type' => 'boolean',
                'values' => array('N', 'Y'),
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_IS_SEARCHABLE_TITLE'),
            ),
            'SETTINGS' => array(
                'data_type' => 'text',
                'serialized' => true,
                'title' => Loc::getMessage('MAIN_USER_FIELD_TABLE_SETTINGS_TITLE'),
            ),
        );
    }
 
    public static function getLabelsReference(string $referenceName = null, string $languageId = null): ORM\Fields\Relations\Reference
    {
        if(!$referenceName)
        {
            $referenceName = 'LABELS';
        }
 
        $filter = [
            '=this.ID' => 'ref.USER_FIELD_ID',
        ];
 
        if($languageId)
        {
            $filter['=ref.LANGUAGE_ID'] = new SqlExpression('?s', $languageId);
        }
 
        return new ORM\Fields\Relations\Reference(
            $referenceName,
            UserFieldLangTable::class,
            $filter
        );
    }
 
    public static function getLabelFields(): array
    {
        return [
            'LANGUAGE_ID',
            'EDIT_FORM_LABEL',
            'LIST_COLUMN_LABEL',
            'LIST_FILTER_LABEL',
            'ERROR_MESSAGE',
            'HELP_MESSAGE',
        ];
    }
 
    public static function getLabelsSelect(string $referenceName = null): array
    {
        if(!$referenceName)
        {
            $referenceName = 'LABELS';
        }
 
        $result = [];
        foreach(static::getLabelFields() as $labelField)
        {
            $result[$labelField] = $referenceName . '.' . $labelField;
        }
 
        return $result;
    }
 
    public static function getFieldData(int $id): ?array
    {
        $labelFields = static::getLabelFields();
        $field = [];
        $list = static::getList([
            'select' => array_merge(['*'], UserFieldTable::getLabelsSelect()),
            'filter' => [
                '=ID' => $id,
            ],
            'runtime' => [
                static::getLabelsReference(),
            ]
        ]);
        foreach($list as $data)
        {
            if(empty($field))
            {
                $field = $data;
                unset(
                    $field['LANGUAGE_ID'],
                    $field['EDIT_FORM_LABEL'],
                    $field['LIST_COLUMN_LABEL'],
                    $field['LIST_FILTER_LABEL'],
                    $field['ERROR_MESSAGE'],
                    $field['HELP_MESSAGE'],
                    $field['UALIAS_0']
                );
            }
 
            foreach($labelFields as $labelField)
            {
                $field[$labelField][$data['LANGUAGE_ID']] = $data[$labelField];
            }
        }
 
        if(empty($field))
        {
            return null;
        }
 
        if($field['USER_TYPE_ID'] === 'enumeration')
        {
            $field['ENUM'] = [];
            $enumEntity = new \CUserFieldEnum();
            $enumList = $enumEntity->GetList(
                [
                    'SORT' => 'ASC'
                ], [
                    'USER_FIELD_ID' => $field['ID'],
                ]
            );
            while($enum = $enumList->Fetch())
            {
                $field['ENUM'][] = $enum;
            }
        }
 
        return $field;
    }

    public static function add(array $data)
    {
        throw new NotImplementedException('Use \CUserTypeEntity API instead.');
    }

    public static function update($primary, array $data)
    {
        throw new NotImplementedException('Use \CUserTypeEntity API instead.');
    }

    public static function delete($primary)
    {
        throw new NotImplementedException('Use \CUserTypeEntity API instead.');
    }

    public static function attachFields(ORM\Entity $entity, $ufId)
    {
        global $USER_FIELD_MANAGER;
 
        $utsFields = array();
        $utsFieldNames = array();
 
        $utmFields = array();
        $utmFieldNames = array();
 
        $fields = $USER_FIELD_MANAGER->getUserFields($ufId);
 
        foreach ($fields as $field)
        {
            if ($field['MULTIPLE'] === 'Y')
            {
                $utmFields[] = $field;
                $utmFieldNames[$field['FIELD_NAME']] = true;
            }
            else
            {
                $utsFields[] = $field;
                $utsFieldNames[$field['FIELD_NAME']] = true;
            }
        }
 
        if (!empty($utsFields) || !empty($utmFields))
        {
            // create uts entity & put fields into it
            $utsEntity = static::createUtsEntity($entity, $utsFields, $utmFields, $ufId);
 
            // create reference to uts entity
            $utsReference = new ORM\Fields\Relations\Reference('UTS_OBJECT', $utsEntity->getDataClass(), array(
                '=this.ID' => 'ref.VALUE_ID'
            ));
 
            $entity->addField($utsReference);
 
            // add UF_* aliases
            foreach ($fields as $userfield)
            {
                $utsFieldName = $userfield['FIELD_NAME'];

                $utsField = $utsEntity->getField($utsFieldName);
 
                $aliasField = new ORM\Fields\UserTypeField(
                    $utsFieldName,
                    '%s',
                    'UTS_OBJECT.'.$utsFieldName,
                    array('data_type' => get_class($utsField))
                );
 
                $aliasField->configureValueField($utsField);
 
                if ($userfield['MULTIPLE'] == 'Y')
                {
                    $aliasField->configureMultiple();
                }
 
                $entity->addField($aliasField);
            }
 
 
            if (!empty($utsFields))
            {
                foreach ($utsFields as $utsField)
                {
                    $utsEntityField = $utsEntity->getField($utsField['FIELD_NAME']);
 
                    foreach ($USER_FIELD_MANAGER->getEntityReferences($utsField, $utsEntityField) as $reference)
                    {
                        // rewrite reference from this.field to this.uts_object.field
                        $referenceDesc = static::rewriteUtsReference($reference->getReference());
 
                        $aliasReference = new ORM\Fields\Relations\Reference(
                            $reference->getName(),
                            $reference->getRefEntityName(),
                            $referenceDesc
                        );
 
                        $entity->addField($aliasReference);
                    }
                }
            }
 
            if (!empty($utmFields))
            {
                // create utm entity & put base fields into it
                $utmEntity = static::createUtmEntity($entity, $utmFields, $ufId);
 
                // add UF_* aliases
                foreach ($utmFieldNames as $utmFieldName => $true)
                {
                    $utmField = $utmEntity->getField($utmFieldName);
 
                    $aliasField = new ORM\Fields\ExpressionField(
                        $utmFieldName.'_SINGLE',
                        '%s',
                        $utmEntity->getFullName().':PARENT_'.$utmFieldName.'.'.$utmField->getColumnName(),
                        array('data_type' => get_class($utmField))
                    );
 
                    $entity->addField($aliasField);
                }
            }
        }
    }

    protected static function createUtsEntity(ORM\Entity $srcEntity, array $utsFields, array $utmFields, $ufId = null)
    {
        global $USER_FIELD_MANAGER;
 
        // get namespace & class
        $utsClassFull = static::getUtsEntityClassNameBySrcEntity($srcEntity);
        $utsClassPath = explode('\\', ltrim($utsClassFull, '\\'));
 
        $utsNamespace = join('\\', array_slice($utsClassPath, 0, -1));
        $utsClass = end($utsClassPath);
 
        // get table name
        $utsTable = static::getUtsEntityTableNameBySrcEntity($srcEntity, $ufId);
 
        // base fields
        $fieldsMap = array(
            'VALUE_ID' => array(
                'data_type' => 'integer',
                'primary' => true
            ),
            'PARENT' => array(
                'data_type' => $srcEntity->getDataClass(),
                'reference' => array(
                    '=this.VALUE_ID' => 'ref.ID'
                )
            )
        );
 
        // initialize entity
        if (class_exists($utsNamespace."\\".$utsClass))
        {
            ORM\Entity::destroy($utsNamespace."\\".$utsClass);
            $entity = ORM\Entity::getInstance($utsNamespace."\\".$utsClass);
 
            foreach ($fieldsMap as $fieldName => $field)
            {
                $entity->addField($field, $fieldName);
            }
        }
        else
        {
            $entity = ORM\Entity::compileEntity($utsClass, $fieldsMap, array(
                'namespace' => $utsNamespace, 'table_name' => $utsTable
            ));
        }
 
        foreach ($utsFields as $utsField)
        {
            $field = $USER_FIELD_MANAGER->getEntityField($utsField);
            $entity->addField($field);
 
            foreach ($USER_FIELD_MANAGER->getEntityReferences($utsField, $field) as $reference)
            {
                $entity->addField($reference);
            }
        }
 
        foreach ($utmFields as $utmFieldMeta)
        {
            // better to get field from UtmEntity
            $utmField = $USER_FIELD_MANAGER->getEntityField($utmFieldMeta);
 
            // add serialized utm cache-fields
            $cacheField = (new ORM\Fields\UserTypeUtsMultipleField($utmField->getName()))
                ->configureUtmField($utmField);
 
            static::setMultipleFieldSerialization($cacheField, $utmField);
            $entity->addField($cacheField);
        }
 
        return $entity;
    }

    public static function setMultipleFieldSerialization(ORM\Fields\Field $entityField, $fieldAsType)
    {
        global $USER_FIELD_MANAGER;
 
        if (!($fieldAsType instanceof ORM\Fields\Field))
        {
            $fieldAsType = $USER_FIELD_MANAGER->getEntityField($fieldAsType);
        }
 
        if ($fieldAsType instanceof ORM\Fields\DatetimeField)
        {
            if ($entityField instanceof ORM\Fields\ArrayField)
            {
                $entityField->configureSerializeCallback([__CLASS__, 'serializeMultipleDatetime']);
                $entityField->configureUnserializeCallback([__CLASS__, 'unserializeMultipleDatetime']);
            }
            else
            {
                $entityField->addSaveDataModifier([__CLASS__, 'serializeMultipleDatetime']);
                $entityField->addFetchDataModifier([__CLASS__, 'unserializeMultipleDatetime']);
            }
        }
        elseif ($fieldAsType instanceof ORM\Fields\DateField)
        {
            if ($entityField instanceof ORM\Fields\ArrayField)
            {
                $entityField->configureSerializeCallback([__CLASS__, 'serializeMultipleDate']);
                $entityField->configureUnserializeCallback([__CLASS__, 'unserializeMultipleDate']);
            }
            else
            {
                $entityField->addSaveDataModifier([__CLASS__, 'serializeMultipleDate']);
                $entityField->addFetchDataModifier([__CLASS__, 'unserializeMultipleDate']);
            }
        }
        else
        {
            if ($entityField instanceof ORM\Fields\ArrayField)
            {
                $entityField->configureSerializationPhp();
            }
            else
            {
                $entityField->setSerialized();
            }
        }
    }
 
    public static function rewriteUtsReference($referenceDesc)
    {
        $new = array();
 
        foreach ($referenceDesc as $k => $v)
        {
            if (is_array($v))
            {
                $new[$k] = static::rewriteUtsReference($v);
            }
            else
            {
                $k = str_replace('this.', 'this.UTS_OBJECT.', $k);
                $new[$k] = $v;
            }
        }
 
        return $new;
    }
 
    protected static function getUtsEntityClassNameBySrcEntity(ORM\Entity $srcEntity)
    {
        return $srcEntity->getFullName().'UtsTable';
    }
 
    protected static function getUtsEntityTableNameBySrcEntity(ORM\Entity $srcEntity, $ufId = null)
    {
        return 'b_uts_'.mb_strtolower($ufId ?: $srcEntity->getUfId());
    }

    protected static function createUtmEntity(ORM\Entity $srcEntity, array $utmFields, $ufId = null)
    {
        global $USER_FIELD_MANAGER;

        $utmClassFull = static::getUtmEntityClassNameBySrcEntity($srcEntity);
        $utmClassPath = explode('\\', ltrim($utmClassFull, '\\'));
 
        $utmNamespace = join('\\', array_slice($utmClassPath, 0, -1));
        $utmClass = end($utmClassPath);
 
        // get table name
        $utmTable = static::getUtmEntityTableNameBySrcEntity($srcEntity, $ufId);
 
        // collect fields
        $fieldsMap = array(
            'ID' => array(
                'data_type' => 'integer',
                'primary' => true,
                'autocomplete' => true
            ),
            'VALUE_ID' => array(
                'data_type' => 'integer',
                'primary' => true
            ),
            'PARENT' => array(
                'data_type' => $srcEntity->getDataClass(),
                'reference' => array(
                    '=this.VALUE_ID' => 'ref.ID'
                )
            ),
            'FIELD_ID' => array(
                'data_type' => 'integer'
            ),
 
            // base values fields
            'VALUE' => array(
                'data_type' => 'text'
            ),
            'VALUE_INT' => array(
                'data_type' => 'integer'
            ),
            'VALUE_DOUBLE' => array(
                'data_type' => 'float'
            ),
            'VALUE_DATE' => array(
                'data_type' => 'datetime'
            )
        );
 
        // initialize entity
        if (class_exists($utmNamespace."\\".$utmClass))
        {
            ORM\Entity::destroy($utmNamespace."\\".$utmClass);
            $entity = ORM\Entity::getInstance($utmNamespace."\\".$utmClass);
 
            foreach ($fieldsMap as $fieldName => $field)
            {
                $entity->addField($field, $fieldName);
            }
        }
        else
        {
            $entity = ORM\Entity::compileEntity($utmClass, $fieldsMap, array(
                'namespace' => $utmNamespace, 'table_name' => $utmTable
            ));
        }
 
        // add utm fields being mapped on real column name
        foreach ($utmFields as $utmField)
        {
            $field = $USER_FIELD_MANAGER->getEntityField($utmField);
 
            if ($field instanceof ORM\Fields\IntegerField)
            {
                $columnName = 'VALUE_INT';
            }
            elseif ($field instanceof ORM\Fields\FloatField)
            {
                $columnName = 'VALUE_DOUBLE';
            }
            elseif ($field instanceof ORM\Fields\DateField)
            {
                $columnName = 'VALUE_DATE';
            }
            else
            {
                $columnName = 'VALUE';
            }
 
            $field->setColumnName($columnName);
 
            $entity->addField($field);
 
            foreach ($USER_FIELD_MANAGER->getEntityReferences($utmField, $field) as $reference)
            {
                $entity->addField($reference);
            }
 
            // add back-reference
            $refField = new ORM\Fields\Relations\Reference(
                'PARENT_'.$utmField['FIELD_NAME'],
                $srcEntity->getDataClass(),
                array('=this.VALUE_ID' => 'ref.ID', '=this.FIELD_ID' => array('?i', $utmField['ID']))
            );
 
            $entity->addField($refField);
        }
 
        return $entity;
    }
 
    protected static function getUtmEntityClassNameBySrcEntity(ORM\Entity $srcEntity)
    {
        return $srcEntity->getFullName().'UtmTable';
    }
 
    protected static function getUtmEntityTableNameBySrcEntity(ORM\Entity $srcEntity, $ufId = null)
    {
        return 'b_utm_'.mb_strtolower($ufId ?: $srcEntity->getUfId());
    }

    public static function serializeMultipleDatetime($value)
    {
        if (is_array($value) || $value instanceof \Traversable)
        {
            $tmpValue = array();
 
            foreach ($value as $k => $singleValue)
            {
                $tmpValue[$k] = $singleValue->format(static::MULTIPLE_DATETIME_FORMAT);
            }
 
            return serialize($tmpValue);
        }
 
        return $value;
    }

    public static function unserializeMultipleDatetime($value)
    {
        if($value <> '')
        {
            $value = unserialize($value, ["allowed_classes" => false]);
 
            foreach($value as &$singleValue)
            {
                try
                {
                    //try new independent datetime format
                    $singleValue = new Type\DateTime($singleValue, static::MULTIPLE_DATETIME_FORMAT);
                }
                catch(ObjectException $e)
                {
                    //try site format
                    $singleValue = new Type\DateTime($singleValue);
                }
            }
        }
 
        return $value;
    }

    public static function serializeMultipleDate($value)
    {
        if (is_array($value) || $value instanceof \Traversable)
        {
            $tmpValue = array();
 
            foreach ($value as $k => $singleValue)
            {
                $tmpValue[$k] = $singleValue->format(static::MULTIPLE_DATE_FORMAT);
            }
 
            return serialize($tmpValue);
        }
 
        return $value;
    }

    public static function unserializeMultipleDate($value)
    {
        if($value <> '')
        {
            $value = unserialize($value, ["allowed_classes" => false]);
 
            foreach($value as &$singleValue)
            {
                try
                {
                    //try new independent datetime format
                    $singleValue = new Type\Date($singleValue, static::MULTIPLE_DATE_FORMAT);
                }
                catch(ObjectException $e)
                {
                    //try site format
                    $singleValue = new Type\Date($singleValue);
                }
            }
        }
 
        return $value;
    }
}