Attach.php

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

<?php
 
namespace Bitrix\Im\V2\Message\Param;
 
use Bitrix\Im\V2\Message\Param;
use Bitrix\Im\V2\Result;
use Bitrix\Main\ArgumentException;
 
class Attach extends Param
{
    private ?\CIMMessageParamAttach $attach = null;
    private bool $isValid = true;
 
    protected ?string $type = Param::TYPE_JSON;

    public function setValue($value): self
    {
        if ($value === null || $value === $this->getDefaultValue())
        {
            return $this->unsetValue();
        }
        if ($value instanceof \CIMMessageParamAttach)
        {
            $this->attach = $value;
        }
        elseif (!empty($value))
        {
            $this->attach = \CIMMessageParamAttach::GetAttachByJson($value);
        }
 
        if (isset($this->attach))
        {
            $this->value = $this->attach->getArray();
            $this->jsonValue = $this->attach->getJson();
        }
 
        return $this;
    }

    public function getValue()
    {
        return $this->value;
    }

    public function saveValueFilter($value)
    {
        $value = '';
        if (!empty($this->value['DESCRIPTION']))
        {
            $value = parent::saveValueFilter($this->value['DESCRIPTION']);
        }
 
        return $value;
    }

    public function saveJsonFilter($value)
    {
        return $this->jsonValue;
    }

    public function loadJsonFilter($value)
    {
        if (!empty($value))
        {
            try
            {
                $val = \Bitrix\Main\Web\Json::decode($value);
                $this->value = \CIMMessageParamAttach::PrepareAttach($val);
            }
            catch (ArgumentException $ext)
            {}
        }
        else
        {
            $value = null;
        }
 
        return $value;
    }

    public function toRestFormat(): ?array
    {
        return $this->getValue();
    }

    public function toPullFormat()
    {
        return \CIMMessageParamAttach::PrepareAttach($this->getValue());
    }

    public function isValid(): Result
    {
        $result = new Result();
 
        if ($this->isValid && (!isset($this->attach) || $this->attach->IsAllowSize()))
        {
            return $result;
        }
 
        return $result->addError(new ParamError(ParamError::ATTACH_ERROR));
    }
}