1С-Битрикс Разработчикам

ORM

28.10.201315:5428.10.2013 15:54:57

В старом ядре

На каждую сущность программируется свой GetList, Update, Add, Delete. В основном копи-пастом. Недостатки: разный набор параметров; разный синтаксис полей фильтров; события могут быть или не быть; иногда разный код под разные БД (Add).

Какая цель поставлена в новом ядре

Сделать операции выборки и сохранения в БД однотипными, с одинаковыми параметрами и фильтрами. По возможности таблицы сущностей должны обслуживаться с минимумом нового кода. Стандартные события добавления/изменения/удаления должны быть доступны автоматически.[spoiler]

Реализация

Введены три понятия:
- сущности (Bitrix\Main\Entity\Base)
- поля сущностей (Bitrix\Main\Entity\Field и его наследники)
- датаменеджер (Bitrix\Main\Entity\DataManager)

Сущность описывает таблицу в БД, в т.ч. содержит поля сущностей. Датаменеджер производит операции выборки и изменения сущности. На практике работа в основном ведется на уровне датаменеджера.

Пример

Начнем с простого примера использования датаменеджера для своей сущности:

use Bitrix\Main\Entity;

class CultureTable extends Entity\DataManager
{
   const LEFT_TO_RIGHT = 'Y';
   const RIGHT_TO_LEFT = 'N';

   public static function getFilePath()
   {
      return __FILE__;
   }

   public static function getTableName()
   {
      return 'b_culture';
   }

   public static function getMap()
   {
      return array(
         'ID' => array(
            'data_type' => 'integer',
            'primary' => true,
            'autocomplete' => true,
         ),
         'CODE' => array(
            'data_type' => 'string',
         ),
         'NAME' => array(
            'data_type' => 'string',
            'required' => true,
            'title' => Loc::getMessage("culture_entity_name"),
         ),
         'FORMAT_DATE' => array(
            'data_type' => 'string',
            'required' => true,
            'title' => Loc::getMessage("culture_entity_date_format"),
         ),
         'FORMAT_DATETIME' => array(
            'data_type' => 'string',
            'required' => true,
            'title' => Loc::getMessage("culture_entity_datetime_format"),
         ),
         'FORMAT_NAME' => array(
            'data_type' => 'string',
            'required' => true,
            'title' => Loc::getMessage("culture_entity_name_format"),
         ),
         'WEEK_START' => array(
            'data_type' => 'integer',
         ),
         'CHARSET' => array(
            'data_type' => 'string',
            'required' => true,
            'title' => Loc::getMessage("culture_entity_charset"),
         ),
         'DIRECTION' => array(
            'data_type' => 'boolean',
            'values' => array(self::RIGHT_TO_LEFT, self::LEFT_TO_RIGHT),
         ),
      );
   }
}

1. Название сущности CultureTable состоит из собственно названия сущности и обязательного суффикса Table. Почему суффикс? Название класса Culture резервируется на будущее для «настоящей» ORM.
2. Класс должен быть наследован от Bitrix\Main\Entity\DataManager.
3. Должны быть перекрыты два абстрактных метода:
- getFilePath() возвращает путь к файлу сущности (в TODO есть избавиться от этого)
- getMap() возвращает массив, описывающий поля сущности. О полях ниже.
4. Метод getTableName() может быть определен и должен вернуть название таблицы. Если метод не переопределен, то базовая сущность попытается получить имя таблицы автоматически, например из Bitrix\Sale\OrderTable получилось бы b_sale_order.

Поля сущностей

Рассмотрим подробнее, как описываются поля сущности. Метод getMap() должен вернуть массив полей сущности вида:

array(
   "FIELD_CODE" => array(
      'data_type' => 'тип поля',
      другие атрибуты
   ),
   …
)

Атрибут data_ type описывает тип поля. Сейчас доступны типы:

boolean (наследует ScalarField)
date (наследует ScalarField)
datetime (наследует DateField)
enum (наследует ScalarField)
float (наследует ScalarField)
integer (наследует ScalarField)
string (наследует ScalarField)
text (наследует StringField)

«Другие атрибуты» могут зависеть от типа поля.

Первичный ключ указывается с помощью атрибута 'primary'=> true. Если первичный ключ - целочисленный с авто увеличением, то нужно указать атрибут 'autocomplete' => true.

Атрибут 'required' => true указывает на обязательность поля.

Атрибут 'format' => 'паттерн' валидирует значение по шаблону регулярного выражения, например '/^[A-Z][A-Za- z0-9]+$/'.

Атрибут expression позволяет получить вычисляемое значение, например:

 'VAT_RATE_PRC' => array(
   'data_type' => 'float',
   'expression' => array(
      '100 * %s', 'VAT_RATE'
   )
),

Сущности могут быть связаны через поле типа reference. При этом в качестве типа указывается название сущности, на которую идет ссылка, например:

'ORDER' => array(
   'data_type' => 'Order',
   'reference' => array(
      '=this.ORDER_ID' => 'ref.ID'
   )
),

Атрибут values задает словарь для поля типа bool , например:

'DIRECTION' => array(
   'data_type' => 'boolean',
   'values' => array(self::RIGHT_TO_LEFT, self::LEFT_TO_RIGHT),
),

Атрибут title задает текстовое название поля.

Датаменеджер

Как видим, класс сущности практически не содержит кода. Базовый класс датаменеджера дает нам следующие методы:

- CultureTable::update($ID, $arFields)
- CultureTable::add($arFields)
- CultureTable::Delete ($ID)
- и наш любимый CultureTable::getList($arParams)
- есть также базовый checkFields(Result $result, array $data, $id = null)

Обратите внимание, все методы статические. Сущность может переопределить эти базовые методы, если это необходимо.

Выборка данных

Для выборки данных используется статический метод getList(). На вход принимается массив параметров:

'select' – массив выбираемых в SELECT полей;
'filter' – массив условий фильтра для WHERE;
'group' – массив полей для группировки;
'order' – массив сортировки;
'limit' – ограничение количества записей;
'offset' – смещение начала выборки;
'count_total' – нужно ли считать количество записей выборки.

Пример использования:

$cultureList = CultureTable::getList(array(
     'select' =>array('ID', 'NAME'),
     'order' => array('NAME' =>'ASC'),
     'filter'=>array('=CHARSET'=>'Windows-1251'),
));

Метод возвращает объект нового ядра Bitrix\Main\DB\Result, с помощью которого можно выбирать записи:

$cultureRes = CultureTable::getList(array('order'=>array('name'=>'asc')));
while($cult = $cultureRes->fetch())
{
   var_dump($cult);
}

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

Для выборки одной записи по первичному ключу может применяться метод getById():

$cultureDb = CultureTable::getById($cultureId);

Модификация данных

Статические методы add(), update(), delete() служат для модификации данных сущности и вызывают соответствующие события. Методы add() и update() производят встроенную проверку полей сущностей, вызывая метод checkFields().

Методы модификации данных возвращают объекты типов Bitrix\Main\Entity\AddResult, Bitrix\Main\Entity\UpdateResult и Bitrix\Main\Entity\DeleteResult. Эти классы наследованы от Bitrix\Main\Entity\Result. Назначение этих объектов – сообщить об успешности операции и дать доступ к ошибкам.

checkFields()

Метод checkFields() датаменеджера в настоящее время проверяет поля на обязательные значения (атрибут поля сущности required) и соответствие маске (атрибут format). Для дополнительных проверок класс сущности может переопределить этот метод:

public static function checkFields(Result $result, array $data, $id = null)

Параметр $result – объект результата. В случае ошибки метод должен добавить ошибку в этот объект. Ошибка может быть либо общая для всей сущности, либо относиться к конкретному полю. В первом случае добавляется объект типа Bitrix\Main\Entity\EntityError, вот втором - Bitrix\Main\Entity\FieldError:

$result->addError(new Entity\EntityError("Нельзя изменить запись номер 1."));
$result->addError(new Entity\FieldError(static::getEntity()->getField('NAME'), 'Поле «имя» очень странное.'));

Если ни одна ошибка не была добавлена, то проверка считается успешной.

Параметр $data содержит массив вида 'код поля'=>'значение поля'.

Параметр $id содержит значение первичного ключа записи, если производится update, либо не указан, если производится add.

Метод не возвращает результат. Фактический результат содержится в объекте $result.

add()

public static function add(array $data)

Параметр $data содержит массив вида 'код поля'=>'значение поля'.

Метод возвращает объект типа AddResult. Кроме проверки на успешность, объект результата содержит также идентификатор добавленной записи (только для целочисленных первичных ключей с автоинкрементом). Пример:

     $arFields = array(
              "NAME" => $request['NAME'],
              "FORMAT_DATE" => $request['FORMAT_DATE'],
              "FORMAT_DATETIME" => $request['FORMAT_DATETIME'],
              "WEEK_START" => intval($request["WEEK_START"]),
              "FORMAT_NAME" => CSite::GetNameFormatByValue($request["FORMAT_NAME"]),
              "CHARSET" => $request['CHARSET'],
              "DIRECTION" => $request['DIRECTION'],
              "CODE" => $request['CODE'],
     );
 
     if($ID > 0)
     {
              $result = CultureTable::update($ID, $arFields);
     }
     else
     {
              $result = CultureTable::add($arFields);
              $ID = $result->getId();
     }
 
     if($result->isSuccess())
     {
              if($request["save"] <> '')
                     LocalRedirect(BX_ROOT."/admin/culture_admin.php?lang=".LANGUAGE_ID);
              else
                     LocalRedirect(BX_ROOT."/admin/culture_edit.php?lang=".LANGUAGE_ID."&ID=".$ID."&".$tabControl->ActiveTabParam());
     }
     else
     {
              $errors = $result->getErrorMessages();
     }

update()

public static function update($primary, array $data)

Параметр $primary содержит значение первичного ключа. Для составных ключей можно передать массив значений.

Параметр $data содержит массив вида 'код поля'=>'значение поля'.

Метод возвращает объект типа UpdateResult. Пример см. выше.

delete()

public static function delete($primary)

Параметр $primary содержит значение первичного ключа. Для составных ключей можно передать массив значений.

Метод возвращает объект типа DeleteResult. Пример:

$result = CultureTable::delete($ID);
if(!$result->isSuccess())
{
          $adminList->AddGroupError("(ID=".$ID.") ".implode("<br>", $result->getErrorMessages()), $ID);
}

Результат

Как видно из примеров, объект результата содержит в себе признак успешности (isSuccess() возвращает булевое значение) и список ошибок (getErrorMessages() возвращает массив строк с ошибками):

if(!$result->isSuccess())
          $errors = $result->getErrorMessages();

Метод getErrors() возвращает массив объектов типов Entity\EntityError или Entity\FieldError.

Класс AddResult содержит метод getId(), который возвращает идентификатор добавленной записи.

События

Датаменеджер при модификации данных отправляет события. Названия событий строятся автоматически и имеют вид <КодСущности> On( Before|<пусто>| After)( Add| Update| Delete), например CultureOnBeforeDelete. Отменить операцию могут только обработчики событий OnBefore.

При добавлении записи порядок событий следующий (указаны параметры для обработчика):

OnBeforeAdd (array("fields"=>$data))
checkFields()
OnAdd(array("fields"=>$data))
add
OnAfterAdd(array("id"=>$id, "fields"=>$data))

Если обработчик OnBeforeAdd вернет ошибку, то добавление не будет произведено. О реализации обработчиков см. ниже.

При обновлении записи порядок событий следующий:

OnBeforeUpdate(array("id"=>$primary, "fields"=>$data))
checkFields()
OnUpdate(array("id"=>$primary, "fields"=>$data))
update
OnAfterUpdate(array("id"=>$primary, "fields"=>$data))

Если обработчик OnBeforeUpdate вернет ошибку, то обновление не будет произведено.

При удалении записи порядок событий следующий:

OnBeforeDelete(array("id"=>$primary))
OnDelete(array("id"=>$primary))
delete
OnAfterDelete(array("id"=>$primary))

Если обработчик OnBeforeDelete вернет ошибку, то удаление не будет произведено.

Обработчики событий

Разберем код обработчика на основе примера:

use Bitrix\Main;
use Bitrix\Main\Entity;
 
$eventManager = Main\EventManager::getInstance();
$eventManager->addEventHandler("main", "CultureOnBeforeUpdate", "CultureBeforeUpdate");
 
function CultureBeforeUpdate(Entity\Event $event)
{
   $errors = array();

   $primary = $event->getParameter("id");
   if($primary["ID"] == 1)
   {
      $errors[] = new Entity\EntityError("Нельзя изменить запись номер 1.");
   }
   
   $fields = $event->getParameter("fields");
   if($fields["CHARSET"] == "UTF-8")
   {
      $entity = $event->getEntity();
      $errors[] = new Entity\FieldError($entity->getField("CHARSET"), "На этом проекте недопустима кодировка UTF-8.");
   }

   $changedFields = array();

   //slightly change encoding
   if($fields["CHARSET"] == "Windows-1252")
   {
      $changedFields["CHARSET"] = "Windows-1251";
   }

   //impossible to change day of week
   $unsetFields = array("WEEK_START");

   $result = new Entity\EventResult();
   if(!empty($errors))
   {
      $result->setErrors($errors);
   }
   else
   {
      $result->modifyFields($changedFields);
      $result->unsetFields($unsetFields);
   }

   return $result;
}

Функция обработчика получает на вход экземпляр объекта события Entity\DataManagerEvent $event. Класс DataManagerEvent является наследником \Bitrix\Main\Event.

Событие содержит в себе входящие параметры, переданные при отправке события. Получить значение параметра мы можем так:

$primary = $event->getParameter("id");

Либо сразу получить все параметры в виде ассоциативного массива:

$params = $event->getParameters();

Обработчик может вернуть результат в виде объекта типа Entity\EventResult (наследник Main\EventResult). Результат проверяется только для событий OnBefore, для остальных событий он игнорируется.

Результат по умолчанию создается как успешный. Если нужно вернуть ошибки (и прервать тем самым обновление данных), то используется метод, в который передается массив ошибок:

$result->setErrors($errors);

Массив может содержать объекты типа Entity\EntityError (для всей сущности) или Entity\FieldError (для поля сущности).

UPD. Теперь обработчик OnBefore может вернуть массив измененных полей (14.0.4). Этот массив мержится с исходными данными.

UPD2. Объект результата события Entity\EventResult позволяет указать поля, которые будут изменены или удалены из исходных данных:

$result->modifyFields($changedFields);
$result->unsetFields($unsetFields);

UPD3. Начиная с ядра 14.0.6 объекты результата UpdateResult и AddResult содержат сохраненные данные, доступные через $result->getData().

Dumbravanu Vadim

28.10.201315:5428.10.2013 15:54:57

Просмотров:188726 Комментариев:101 28

Пользователь 51682

28.10.2013 17:31:10

EventManager будет корректно работать с анонимными функциями?

$eventManager->addEventHandler("main", "CultureOnBeforeUpdate", function(Entity\DataManagerEvent $event0{})) ;

Будет ли мэйджик функции, чтобы делать вызов

$event->id; или $event->id() ;

а не

$event->getParameter("id") ;

Да, это немного медленнее, но значительно удобнее имхо.

Ссылка 4

Пользователь 10

28.10.2013 18:02:42

Волшебными функциями не увлекаемся. Они медленнее, и вовсе не "немного".

Родитель Ссылка 1

Пользователь 51682

28.10.2013 18:44:08

Это заметно только на 100.000+ итераций, т.к. это eventManager, то вероятнее всего он будете работать только с 1м экземпляром за весь цикл.
Исключение составляет разве что, _НЕ_ пошаговый импорт каталога миллионника, но при таком расскладе вызов call_user_func_array в EventManager::sendToEventHandler будет на порядок медленнее.

Как дополнительная фича, короткие вызовы были бы удобны, а тем кто хочет "бороться" за производительность может и getParameter использовать

Родитель Ссылка 2

Пользователь 17890

30.10.2013 03:18:58

присоединяюсь к вопросу о анонимных функциях в качестве обработчиков событий.
Это будет возможно?

Родитель Ссылка 0

Пользователь 292995

13.02.2015 10:37:03

Вадим, "Они медленнее" не обоснованный аргумент на общем фоне "прожорливости" битрикса вообще. Простите, просто критика ничего личного. Но аргументируя данный факт, вы реально бьете по рукам многим разработчикам, лишая их изяществ при использовании "умных" IDE.

ps/ не поленился, протестировал, да разница есть во времени ... но онная весьма не существенная, на одну интерацию, при моем достаточно не шустром железе, дельта составила 0.00000031714690 секунды ...

Родитель Ссылка 1

Пользователь 10

30.10.2013 12:24:22

С анонимными работает:

$inst = \Bitrix\Main\EventManager::getInstance();
$inst->addEventHandler("main", "AAA", function (\Bitrix\Main\Event $e) {print_r($e);});

Родитель Ссылка 7

Пользователь 51682

30.10.2013 13:36:06

За анонимные функции большое спасибо.

Родитель Ссылка 0

Пользователь 11847

28.10.2013 17:55:22

Круто, обнулим весь текущий опыт и напишем заново. Молодца, так держать:|

Ссылка 2

Пользователь 10337

28.10.2013 18:41:46

ну что значит обнулим?
Прогресс ведь не стоит на месте, за ним приходится бежать.

Родитель Ссылка 6

Пользователь 24164

28.10.2013 18:34:58

Если первичный ключ - целочисленный с авто увеличением, то нужно указать атрибут 'autocomplete' => true

Неожиданно. autoincrement было бы как-то традиционнее.

Ссылка 6

Пользователь 10

28.10.2013 19:27:16

Изначально в первичные ключи вкладывалась расширенная семантика, это может быть не числовое поле. Но реализация пока только для числового.

Родитель Ссылка 0

Пользователь 24164

28.10.2013 18:55:05

В Bitrix\Main\Entity\DataManager::add():

$event = new DataManagerEvent($entity, "OnBeforeAdd", array("fields"=>$data));

Не совсем понял, каким образом можно в обработчике изменить данные? Тут $data передаётся без ссылки, а модифицированные через Bitrix\Main\ENtity\DataManagerEvent::setParameter() данные ниже в методе нигде не испльзуются.

Ссылка 3

Пользователь 10

28.10.2013 19:28:33

Спасибо, что-то мы упустили, подумаем. Если по ссылке передать, то вроде должно работать.

Родитель Ссылка 0

Пользователь 10

29.10.2013 15:00:05

Теперь обработчик OnBefore может вернуть массив измененных полей (14.0.4). Этот массив мержится с исходными данными.

 return new Main\EventResult(Main\EventResult::SUCCESS, $changedFields);

Родитель Ссылка 1

Пользователь 24164

29.10.2013 18:54:13

Отлично, но как поле не изменить, а исключить из обновления? Например, я хочу заблокировать пользовательское изменение какого-то свойства элемента HL-инфоблока.

Родитель Ссылка 2

Пользователь 10

30.10.2013 18:59:48

Спасибо за существенное замечание. Мы расширили объект результата, я изменил пример в посте:

$result->modifyFields($changedFields);
$result->unsetFields($unsetFields);

Родитель Ссылка 4

Пользователь 24164

30.10.2013 20:11:27

Вот теперь, наверное, совсем отлично, благодарю:-)

Родитель Ссылка 0

Пользователь 17890

30.10.2013 03:18:05

брызги шампанского...
осталось допилить при использовании в реальных боевых условиях...

Ссылка 0

Пользователь 11948

30.10.2013 08:01:40

Это просто праздник какой-то!

Ссылка 0

Пользователь 11948

30.10.2013 14:06:54

Пардон за невнимательность, если пропустил - а "insert on duplicate key update" - будет? Чтобы в одном запросе добавлять/обновлять записи.

Ссылка 1

Пользователь 10

30.10.2013 14:22:32

Сейчас нет, но интерес, безусловно, представляет.

Родитель Ссылка 6

Пользователь 11948

30.10.2013 16:11:26

А еще тут хороший задел для вывода любой табличной информации в админке (список / форма). Ну то есть некий класс визуализации, который берет мапу некоей таблицы и строит по ней и список и форму. Просто копипаст этот в админке жутко достал, для себя набросал классы списка и формы http://my.jetscreenshot.com/18603/20131030-taex-39kb , скоро надо будет подружить с ORM. Но если бы это вышло вкоробке - было бы очень круто!

Естественно, эти классы не решат все задачи, но 80-90% хотя бы - уже круто.

Ссылка 5

Пользователь 10

30.10.2013 17:34:39

Может для этого модуля highloadblock будет достаточно?

Будете делать сущности вообще без кода.

Родитель Ссылка 4

Пользователь 11948

30.10.2013 18:00:53

А он во все редакции пойдет?

А так да, по интерфейсу он вроде довольно абстрактен.

Родитель Ссылка 0

Пользователь 17890

01.11.2013 00:00:37

да-да. Используем уже решения, храним разные вещи в отдельных таблицах.
Вот highloadblock хотим, во-первых, благодаря наличию админки, во-вторых - это же решение из-коробки

Еще вот у меня важный вопрос: будет привязка iblock к highloadblock и наоборот? К примеру, справочники можно вынести в highloadblock, и прочие "сервисные" данные по каталогу товаров. А сам каталог товаров оставить в iblock, т.к. других вариантов думаю не будет для торгового каталога )

Родитель Ссылка 2

Пользователь 10

01.11.2013 11:53:22

Только вчера обсуждали справочники для каталога на highloadblock, лично мне эта идея нравится.

Родитель Ссылка 2

Пользователь 17890

01.11.2013 13:38:42

нам тоже очень нравится) а к чему пришли? будет возможно такое разделение сделать из-коробки или нет?
хотя по-сути всегда можно свой тип свойства инфоблока сделать, и уже завязаться в нем на highloadblock

Родитель Ссылка 1

Пользователь 10

01.11.2013 13:43:31

Свойство инфоблоков из коробки. Ну и для ядра видимо тоже свойство нужно делать.

Родитель Ссылка 5

Пользователь 17890

02.11.2013 00:14:12

Для ядра, это пользовательские в смысле?

Родитель Ссылка 0

Пользователь 17890

07.11.2013 22:12:00

Скажите, ну когда уже это свершиться и выйдут highloadblock?
В презентации было 7е и 14е, думал 7го уже увижу....
Действительно ряд вещей пока откладываем в надежде на highloadblock, есть ли смысл еще 7 дней подождать?

Родитель Ссылка 0

Пользователь 5427

31.10.2013 10:45:04

Вадим, как сейчас обстоят дела с выборкой пользовательских свойств?
сделал по аналогии с User, получаю ошибку Fatal error: Call to undefined method Bitrix\Main\Entity\UField::getColumnName() in /home/.../bitrix/modules/main/lib/entity/querychainelement.php on line 197

upd: сейчас проверил и стандартную UserTable ошибка аналогична, метода getColumnName в ядре вообще нет.

Ссылка 0

Медведев Дмитрий

31.10.2013 13:35:20

Евгений, по аналогии с User - как именно? И как проверили с UserTable?
у меня следующий вызов срабатывает без ошибок

$res = \Bitrix\Main\UserTable::getList(array(
   'select' => array('UF_DEPARTMENT')
));

Родитель Ссылка 0

Пользователь 5427

31.10.2013 13:40:13

$res = \Bitrix\Main\UserTable::getList(array(
        'select' => array('UF_WORK_BINDING')
));

$ar = $res->fetch();
print_r($ar);

При выполнении команды произошла ошибка
Fatal error: Call to undefined method Bitrix\Main\Entity\UField::getColumnName() in/home/.../bitrix/modules/main/lib/entity/querychainelement.php on line 197

что я делаю не так?

Родитель Ссылка 0

Пользователь 5427

31.10.2013 13:42:19

хммм, а с UF_DEPARTMENT работает...
а с другими типами нет

Родитель Ссылка 0

Пользователь 223783

31.10.2013 22:52:12

А нормально что самые базовые вещи вроде отбора по инфоблоку не работают?

$sectionsResult = \Bitrix\Iblock\SectionTable::getList(array(
'select' => array('ID','NAME'),
'filter' => array('IBLOCK_ID'=>3)
));
while($s = $sectionsResult->fetch()) { ... }

Вываливается исключение вида:
Fatal error: Uncaught exception 'Exception' with message 'Unknown field definition `IBLOCK_ID` (IBLOCK_ID) for Section Entity.' in /home/bitrix/www/bitrix/modules/main/lib/entity/querychain.php:282 Stack trace: #0 /home/bitrix/www/bitrix/modules/main/lib/entity/query.php(1271):

Кстати выборка чего-либо кроме ID и названия секции тоже не работает - в getMap только они определены

Ссылка 2

Пользователь 10

01.11.2013 11:51:20

Сущности описываются по мере необходимости. Задача описать все сущности сразу не стоит.

Родитель Ссылка 0

Пользователь 41428

01.11.2013 13:30:38

По инфоблоку и каталогу я бы такую задачу поставил, если бы был в вашем кор. портале :-)

Родитель Ссылка 6

Пользователь 223783

01.11.2013 00:24:23

А значения по умолчанию для полей Entity нельзя задать?

Ссылка 1

Пользователь 6494

06.11.2013 18:03:08

Где можно увидеть "Hello World " пример

Самый простой с командной строки, но чтоб работал.

Ссылка 0

Пользователь 9700

11.11.2013 00:32:11

Можно ли как то попроще получить формат даты\время сайта в РНР формате? Прошу прощения за тавтологию.

use Bitrix\Main\Type as FieldType;
$dateTimeFormat = FieldType\DateTime::convertDateTimeFormatToPhp(Main\Application::getInstance()->getContext()->getCulture()->getDateTimeFormat());

Чтобы потом можно было бы сформировать массив данных для добавления вида

$arFields = array(
    "SYSTEM_ENTITY" => 'ERROR',
    "CLIENT_ID" => 1,
    "USER_ID" => rand(0,9),
    "DATE_MODIFIED" => new FieldType\DateTime(date($dateTimeFormat)),
);

Ссылка 1

Кирсанов Алексей

15.11.2013 11:54:14

а почему бы не написать

$arFields = array(
    "SYSTEM_ENTITY" => 'ERROR',
    "CLIENT_ID" => 1,
    "USER_ID" => rand(0,9),
    "DATE_MODIFIED" => new FieldType\DateTime(),
);

Родитель Ссылка 0

Кирсанов Алексей

15.11.2013 12:00:11

А если нужна специфическая дата, то

"DATE_MODIFIED" => new FieldType\DateTime('2009-02-15 15:16:17', 'Y-m-d H:i:s'),

Родитель Ссылка 1

Пользователь 9700

15.11.2013 15:45:10

Так конечно тоже можно делать, предварительно приведя дату к какому-то общему формату (если мы не знаем в каком формате она пришла). Спасибо.

Хотя отсюда попутно вопрос:
Планируется ли упрощение работы с полем типа datatime?
Чтобы, например, можно было передавать дату не объектом, а строкой в поддерживаемых базовым РНР классом DateTime форматах.

Родитель Ссылка 0

Пользователь 27542

19.02.2015 03:03:48

А из unix timestamp как получить? Причем в текущем формате, и если мы не найте конкретном находимся, а, скажем, в кроне?

Родитель Ссылка 0

Пользователь 109703

13.11.2013 17:38:25

Где должен лежать код пользовательских сущностей описанных через ORM?

Ссылка 0

Кирсанов Алексей

15.11.2013 11:48:26

Там, где вам это необходимо. Это зависит от решаемой задачи. Как правило правильнее оформлять код в виде модулей. Усиленная поддержка этого в виде папки local в нашем продукте есть.

Родитель Ссылка 3

Пользователь 109703

17.11.2013 19:43:34

Алексей, то есть, не будет стандартизированного места размещения всех моделей, которые используются в проекте?
Я спрашиваю, потому что у меня появилось желание посмотреть пример модели и я несмог конечно же етого сделать, так как непонятно, где их хранить.
Не планируется ли пойти по проверенному пути и хранить модели в папке предусмотренной для етого, собственно как обычно делают mvc фреймворки?

Насчет модулей я неочнеь понял. Если я хочу описать сущность и сделать для нее несколько удобных методов выборки и базы + REST, мне ненужно делать для нее модуль, я просто хочу вместо инфоблока хранить сущность с помощью модели и работать с ней с помощью модели. В таком случае небудет стандарта дял разработчиков, описывающего правила хранения таких сущностей?

Родитель Ссылка 2

Кирсанов Алексей

25.11.2013 14:08:31

Архитектура нашего продукта модульная. Поэтому я и дал рекомендацию подумать сразу о создании модуля. Это и в архитектуру впишется, и повторное использование функционала будет происходить естественным образом, и вся оснастка уже есть в ядре. Например, автоматическое подключение классов при необходимости и т.п. Но в конечном счете выбирать вам.
Если хотите, вы можете разместить свой код в любом месте вашего проекта. Единственно вам придется самостоятельно озаботится его подключением на тех страницах, где он нужен.

Родитель Ссылка 0

Пользователь 10

16.11.2013 12:27:51

Начиная с ядра 14.0.6 объекты результата UpdateResult и AddResult содержат сохраненные данные, доступные через $result->getData(). Дело в том, что данные могут быть изменены обработчиками событий, и вызывающий скрипт мог получить актуальные значения только выборкой из БД. Теперь это не обязательно, можно забрать данные из объекта результата. Есть, конечно, допущение, что данные сохранились так, как было передано. В любом случае остается возможность выбрать из БД.

Ссылка 2

Пользователь 54897

17.11.2013 00:38:41

Вадим, неплохо бы добавить этот момент в пост (пусть будет UPD3, например), а то не все дойдут до Вашего коммента

Родитель Ссылка 1

Пользователь 67000

20.11.2013 00:02:40

Сижу, ковыряю новое ядро
Здесь и в новой документации функция checkFields описана как

public static function checkFields(Result $result, array $data, $id = null)

a в исходном файле datamanager.php она описана как

public static function checkFields(Result $result, $primary, array $data)

поправьте

Ссылка 0

Пользователь 71426

29.11.2013 14:11:11

Добавил в свой класс (пусть class MyTable extends Entity\DataManager)

public static function getConnectionName()
{
return 'my';
}

но все равно берется по умолчанию имя соединения default

Ссылка 0

Пользователь 71426

29.11.2013 14:14:57

класс: \Bitrix\Main\Entity\Query
ф-ия: query
строка: $connection = \Bitrix\Main\Application::getConnection();

здесь не указано имя соединения и в других нескольких функциях класса тоже,
странно что \Bitrix\Main\Application::getConnection() не определили отдельной функцией,
тогда получение соединения можно было бы переопределить в дочернем классе

Родитель Ссылка 1

Пользователь 21444

06.12.2013 18:31:03

А автогнерация датаменеджера своей сущности есть или я не нашел?
По созданному hiload иблоку и соответсвенно таблице

Ссылка 1

Пользователь 25821

08.12.2013 11:33:37

Как использовать 'count_total', если мне нужно узнать общее количество записей удовлетворяющее условиям выборки, как мне это вычислить? Запускать просто GetList без Limit на большой выборке намертво вешает базу..

Ссылка 2

Пользователь 27949

03.03.2014 12:47:29

Попробуйте использовать метод getCount.

Родитель Ссылка 0

Пользователь 8839

26.12.2013 14:42:37

Заложен ли при проектировании сущностей БД механизм регистрации пользовательских типов "полей сущности"? Без него новое ядро будет ООП-версией старого подхода, когда разработчику предлагают готовые решения, а если они не устраивают - пиши все с нуля...
Что-то подобное хотелось бы видеть и в функционале параметров компонентов.

Ссылка 0

Пользователь 155968

25.01.2014 16:56:08

При попытке авторизации Yandex выдает такую вот ошибку
Fatal error: Class 'Bitrix\Main\Entity\UpdateResult' not found in /home/bitrix/www/bitrix/modules/main/lib/entity/datamanager.php on line 416

Стоит последний стабильный битрикс

Как лечить ?

Ссылка 0

Пользователь 235064

30.01.2014 01:07:33

Подскажите почему при подключения массива для фильтра, пустые значения вставляются в запрос

$arFilter = array(
"TITLE" => $find_title,
"DESC" => $find_desc,
"CODE" => $find_code,
"PROGRAM_ID" => $find_program_id
);

WHERE (`TITLE` IS NULL OR `TITLE` = '') AND (`DESC` IS NOT NULL AND LENGTH(`DESC`) > 0) AND (`CODE` IS NULL OR `CODE` = '') AND (`PROGRAM_ID` IS NULL OR `PROGRAM_ID` = 0)

Ссылка 0

Пользователь 161636

10.02.2014 09:29:31

Что будет с постраничной навигацией? Результат выборки будет поддерживать работу старых методов ::NavStart(); ::NavPrint();?? Или возможно есть уже другая их реализация?

Ссылка 1

Пользователь 113171

31.12.2014 13:18:56

Неужели с этим так ничего и не известно?

Родитель Ссылка 0

Пользователь 113318

14.02.2014 21:43:57

Как с помощью новых методов получить все данные по элементу инфоблока (по ID), включая его свойства и фотографию?
Перепробовал уже всё что возможно:| Или это не предусмотрено в новом API и нужно всё таки в "новом коде" использовать старые функции?

Ссылка 0

Пользователь 195908

20.02.2014 22:46:08

Подскажите, как можно делать LEFT JOIN 3х последовательно связанных таблиц?

Например,

SELECT ...
FROM `c_client` LEFT JOIN `c_client_contracts` ON `c_client`.`ID` = `c_client_contracts`.`CLIENT_ID`
LEFT JOIN `c_support_license` ON `c_client_contracts`.`id` = `c_support_license`.`contract_id`

Ссылка 0

Пользователь 200621

07.04.2014 17:36:09

прописать привязки в двух таблицах, тоесть в таблице №1 делаем выборку значений из таблицы № 2, а в таблице №3 делаем выборку этих самых значений из таблицы №1. получается довольно лаконичные джойны

Родитель Ссылка 0

Пользователь 15046

16.03.2014 15:20:37

Здравствуйте всем.

можно ли при создании сущности задать значение по умолчанию?

Ссылка 0

Пользователь 53760

08.06.2014 21:28:34

Что жутко не хватает дак это документации с примерами (( .
Создал свою таблицу, через GetList не могу фильтровать нормально по дате, как это делать , живые бы примеры.

Ссылка 0

Пользователь 13254

24.06.2014 18:47:55

Фильтровать также как и обычные иблоки (логика таже)

$resultRes = $entity_data_class::getList(array(
        'select' =>array('ID'),
        'order'=>array('ID'=>'asc'),
        'filter'=>array('>=UF_DATE'=>"05.06.2014",'<=UF_DATE'=>"11.06.2014"), //фильтр по дате
        //'filter'=>array('UF_ADR_LEG'=>"%Москва%"),//фильтр стринга по слову
    ));

Родитель Ссылка 1

Пользователь 13254

24.06.2014 17:50:40

Присоединяюсь к ранее написанному про «Как использовать 'count_total'» и «getCount»
getCount возвращает возвращает количество всех записей, а нужно вернуть количество записей согласно фильтру.

Ссылка 1

Пользователь 11948

20.07.2014 09:01:19

Какая-то непоследовательность в обработке событий.

$eventManager = Main\EventManager::getInstance();
$eventManager->addEventHandler('asd.metrika', 'CountersOnAfterUpdate', function (Entity\Event $event) {
   $id = $event->getParameter('id');
});
$eventManager->addEventHandler('asd.metrika', 'CountersOnAfterAdd', function (Entity\Event $event) {
   $id = $event->getParameter('id');
});

В первой функции $id есть как массив array(ID => 123), во второй как число.

Ссылка 0

Медведев Дмитрий

21.07.2014 17:41:17

$event->getParameter('primary') вернет в обоих случаях массив

Родитель Ссылка 3

Пользователь 11948

20.07.2014 10:22:22

И касаемо обработчика для delete. Почему нет единой стандартизации опять?

Делаю:

   public static function onAfterDelete(Entity\Event $event)
   {
      $id = $event->getParameter('id');
   }

выдает ошибку:

Argument 1 passed to Asd\Metrika\CountersTable::onAfterDelete() must be an instance of Bitrix\Main\Entity\Event, array given

мол ожидаю Event, а ты мне массив суешь. Переделал вот так:

   public static function onAfterDelete(array $event)
   {
      $id = $event['ID'];
      ec($event,1);
   }

все ок.

Ссылка 0

Медведев Дмитрий

21.07.2014 17:45:09

Антон, покажите пожалуйста трейс для первого случая, когда ругается на Entity\Event $event.

Родитель Ссылка 0

Пользователь 11948

22.07.2014 05:52:20

Дмитрий, почему-то уже эту модель не ловлю. Как поймаю снова - напишу

Родитель Ссылка 0

Пользователь 87386

17.08.2014 12:00:28

Вроди получилось найти причину...
теперь есть 2 вида обработчиков, версия 1 и версия 2

 
//стандартный RegisterModuleDependences всегда создает под старой версией 1 
//$eventManager->registerEventHandler - версия 2 
// $eventManager->registerEventHandlerCompatible - версия 1

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->registerEventHandler("mlife.asz", "BasketOnBeforeAdd", "mlife.asz", '\Mlife\Asz\DiscountHandlers', "BasketOnBeforeAdd");
$eventManager->registerEventHandler("mlife.asz", "BasketOnBeforeUpdate", "mlife.asz", '\Mlife\Asz\DiscountHandlers', "BasketOnBeforeUpdate");

Родитель Ссылка 5

Пользователь 4544

21.08.2016 12:44:28

Если вопрос еще актуален, то могу показать трейс.
Хотя там в коде компоненты, при выполнении обработчиков события, первый аргумент и заявляется как массив.

 foreach (GetModuleEvents("sale", 'OnSaleComponentOrderProperties', true) as $arEvent)
         ExecuteModuleEventEx($arEvent, array(&$this->arUserResult, $this->request, &$this->arParams, &$this->arResult));

То есть в заново переписанном модуле магазина все равно имеем куски старого ядра?

Родитель Ссылка 0

Пользователь 144100

06.11.2014 16:21:13

А параметр count_total вообще используется?
Все, что я нашел касательно этого параметра - закомментированный кусок кода с комментарием "Vadim: this is for paging but currently is not used"

Ссылка 2

Пользователь 94859

06.12.2014 20:15:19

Число записей по фильтру:

use Bitrix\Main\Entity\ExpressionField;

$totalCount = SotbitTable::getList(array(
        'limit' =>null,
        'offset' => null,
        'select' => array(new ExpressionField('CNT', 'COUNT(1)')),
        "filter" => array("IBLOCK_ID"=>2)

    ))->Fetch();

Ссылка 6

Пользователь 113171

31.12.2014 11:50:52

Здравствуйте!

Не удается воспользоваться описанной системой событий. Попробую описать, что имею, и что хочу получить, и что получаю в итоге.

У меня есть некая таблица SubscribeMessage (сообщение о рассылке), для нее создан и подключен файлик ORM. Когда туда добавляется элемент (сообщение), мне необходимо отправлять уведомления, т.е. некоторый класс CNotice должен отследить добавление сообщение и сделать свои дела.

Добавляю следующие строки в init.php:

$eventManager = Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler("main", "SubscribeMessageOnAfterAdd", array("CNotices", "SubscribeMessageOnAfterAddHandler"));

Добавив его я полагаю, что вызовется метод SubscribeMessageOnAfterAddHandler класса CNotices. Но он не вызывается.

Если что-то не работает, айда в исходники. В исходниках я не нашел кода, который вызывал бы события, как вы описывали с названием "<КодСущности> On( Before|<пусто>| After)( Add| Update| Delete)".
Я нашел только вызов методов а-ля SubscribeMessage :: OnAfterAdd. Т.е. мало того, что название сокращенное, так еще и это метод класса сообщений, а не уведомлений.

Может я не то ожидаю и/или не так что-то делаю?

Ссылка 0

Пользователь 224396

01.12.2015 11:59:30

Уберите main из навешиваемого события. Мне помогло.

Родитель Ссылка 2

Пользователь 305420

13.01.2015 10:46:07

Вот что я не пойму, коллеги из битрикса всегда наровятся сделать все по-своему.
Есть множество качественных ORM, неужели вы думаете, что сделаете лучше? Судя по тому что есть у вас сейчас и как вы отстали по технике это не так. Люди душу вкладывают в open source проекты, а вы ?

Автолоадер - самый очевидный пример того, как надо сопротивляться прогрессу. PSR-0, PSR-4 стандарты, которые разрабатывались годами, которые удовлетворяют практически всем требованиям сообщества PHP, нет надо сделать свой. Строго требовать называть файлы так: /lib/inheritedproperty/elementtemplates.php , это издевательство.

Вам нужно развиваться вместе с сообществом. Перенимать лучшее. Цены бы вам не было.

Ссылка 2

Пользователь 292995

13.02.2015 11:48:16

Михаил, думал я один которого выворачивает наизнанку, после работы с доктриной и активрекордсами ....
Как понимаю, это один из методов что бы не оставить своих партнеров без заработка ...

Родитель Ссылка 1

Пользователь 94272

07.04.2015 17:30:03

Почему может не работать группировка полей в highload?
В 'group' передаю такой массив:
Array("UF_NAME")

Все равно возвращает десяток записей с одинаковыми именами, то есть не группирует в принципе

Ссылка 0

Пользователь 42376

12.04.2015 13:56:56

столкнулся с аналогичной проблемой, пришлось писать запрос...

Родитель Ссылка 0

Пользователь 94272

14.04.2015 20:29:46

Там дело оказывается в поле select, туда нужно передавать только те поля, по которым группируете

Родитель Ссылка 0

Пользователь 98057

09.06.2015 11:59:21

А как вывести CNT? И отсорировать по этому полю?

Родитель Ссылка 0

Пользователь 94272

15.04.2015 13:19:05

Вопрос по такой строке:
Bitrix\Highloadblock\HighloadBlockTable::compileEntity

По какому принципу в первом случае block с маленькой буквы, а во втором с большой?

Ссылка 1

Пользователь 95864

23.04.2015 16:15:12

Вадим, здравствуйте. Пожалуйста, подскажите как получить общее кол-во записей удовлетворяющее условиям выборки, countTotal не работает до сих пор.

Ссылка 0

Пользователь 10

23.04.2015 18:08:31

Если нужно сделать запрос, то:

$query->addSelect(new ExpressionField('CNT', 'COUNT(1)'));
$res = $query->exec()->fetch();
echo $res["CNT"];

Если выборка уже есть, то:

$res = $query->exec();
echo $res->getSelectedRowsCount();

Родитель Ссылка 0

Пользователь 94272

22.04.2016 21:15:54

Как такие вещи искать в документации? Куда смотреть?
Гугл по запросу "getSelectedRowsCount bitrix" в принципе документацию битрикса по ORM не показывает. Она есть?

Родитель Ссылка 1

Пользователь 26553

27.04.2015 23:21:10

Подскажите пожалуйста как сделать "Truncate table" ? Не нашел ни в одном мануале ответ.

Ссылка 0

Пользователь 230117

18.01.2016 04:38:08

Main\Application::getConnection()->truncateTable($entity->getDBTableName());

Родитель Ссылка 0

Пользователь 13254

29.10.2015 15:06:42

Люди, ну честное слово, когда же будет документация?
Простые вопросы: как писать «expression» и «runtime»? Как писать подзапрос?
Очень понравился мне, вызовов метода класса Query. Пример:

$query = new Entity\Query(MyTable::getEntity());  
$query ->setFilter(array(
 ...
)) 
//подзапрос (отлично работает)  выбираем в таблице описание с нужным языком
->registerRuntimeField("REVIEWS", array(
    "data_type" => "ReviewsTable",
    'reference' => array(
    '=this.ID' => 'ref.ID',
    '=ref.LANG' => new \Bitrix\Main\DB\SqlEx * pression('?i', $lang)
    ),
 'join_type' => "LEFT"
 )
) 
//но пытаясь объединить результаты по полю SORT (т.к. элемент может принадлежать к нескольким типам) получаем ошибку: [932] ORA-00932: inconsistent datatypes: expected - got CLOB  
->registerRuntimeField("TYPES_SORT", array(  
 "data_type" => "integer",
    'expression' => array('MIN(%s)', 'TABLE_TYPES.UF_SORT')
)) 
//хотя в getList это работает    
$list_ob = MyTable::getList(array( 
    'runtime' => array(  
'TYPES_SORT' => array( 
 'expression' => array('MIN(%s)', 'TABLE_TYPES.UF_SORT') )  
........

А как в гет листе тогда подзапросы делать не понятно. Дайте мануал как CIBlockElement::GetList
Последний компонент писал, делая запросы к базе, так скоро никакого битрикса на сайте не останется.

Ссылка 4

Пользователь 230117

18.01.2016 03:59:20

Подскажите, пожалуйста, как при помощи Entity\Query добавить условие сортировки в случайном порядке?
$query->setOrder('RAND()'); возвращает Unknown field definition `RAND()`

Ссылка 0

Пользователь 654351

22.12.2017 13:50:06

Типа этого
$query->registerRuntimeField(
'RAND', array('data_type' => 'float', 'expression' => array('RAND()'))
);
$query->addOrder("RAND", "ASC");

https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=5746

Родитель Ссылка 0

Пользователь 230117

22.12.2017 23:38:37

Я, конечно, рад ответу через два года, тогда единственная информация о новом ядре была в двух статьях в блоге.

Родитель Ссылка 1

Пользователь 129131

26.01.2016 14:01:55

Очень неудобно без фильтра в

 $entityData::delete($id)

Если, например, запись привязана к пользователю, перед delete надо проверить привязку с помощью фильтра в

 $entityData::getList($parameters)

если она привязана, тогда

  $entityData::delete($id)

иначе

GetMessage()

а так бы везде под ошибки и успехи было

$arResult['MESSAGE']['DANGER'] = $res->getErrorMessages();

вот из-за этого без фильтра вместо одной строчки

  $entityData::delete($id)

приходится мотать портянки:

 if($delete)
{

   $parameters['filter'] = array(
      'UF_SITE_ID'    => $site_id,
      '=UF_USER_ID' => $user_id,
      '=ID'                => $section_id,
   );

   if($rowsCount = $entityData::getList($parameters)->getSelectedRowsCount())
      $res = $entityData::delete($section_id);
   else
      arResult['MESSAGE']['DANGER'] = GetMessage('ERROR_DELETE');

}

Вот так бы сделать, по аналогии с update и getList, где есть ID и ФИЛЬТР, красота

$res = $entityData::delete($id,$parameters)

Далее везде будут использоваться

$res->getErrorMessages()
$res->isSuccess()

и т.д.

не надо будет использовать GetMessage()

Ссылка 1

Пользователь 391363

09.07.2016 18:09:17

Подскажите как правильно с точки зрения D7 добовлять новые поля в сущность? Допустим при уставноке модуля - была создана сущность с полями ID, NAME, GENRE - все эти поля описаны в getMap(). Но к примеру нужно добавить еще одно поле SECOND_NAME - как поступить?

Ссылка 1

Пользователь 172942

26.07.2016 10:00:44

Если у меня есть таблица

class UserTable extends DataManager

то как выбрать произвольных пользователей?

$obUserTable = new UserTable();
$rsUsersData = $obUserTable->getList([
 'select' => [
 'ID',
 'PERSONAL_PHOTO',
 'NAME',
 'LAST_NAME',
 ],
 'filter' => [
 'UF.UF_CHARS' => null,
 ],
 'limit' => $quantity,
]);

Ссылка 0

Пользователь 4544

25.10.2016 11:05:06

Внятная и полезная статья. Всегда ею пользуюсь, когда нужно освежить что-то в памяти по апи D7.
Но в переписанном заново модуле интернет-магазине начала появляться такая сущность, как коллекции: $order->getPropertyCollection();
Нельзя ли как-то дополнить статью описанием коллекций?
Наверняка, они также создаются по определенной схеме, а не абы как в каждом случае.

Ссылка 0

Пользователь 27542

09.12.2016 01:49:37

А есть ли что-то наподобие \Bitrix\Main\Entity::createDbTable, только не для создания, а для модификации таблицы в БД, если поля сущности ORM изменились (например, добавилось новое или изменился тип существующей)?

Ссылка 0

Пользователь 129131

29.06.2021 14:31:02

В ArrayField() где-то зависимость от поля в верхнем регистре есть
Если столбец в базе в нижнем регистре, то сериализация массива не работает
configureSerializationPhp()
configureSerializationJson()

Ошибка

Array
(
    [0] => There is no data to add.
)

Если прописать в php-коде поле в верхнем регистре, а в базе оставить в нижнем, то добавление работает

Пример
Вот это добавление с полем FIELDS работает, в базе оно в нижнем регистре

Array
(
    [user_id] => 3
    [filter_id] => api_loc_district
    [FIELDS] => Array
        (
            [field1] => 123456
        )

)

Вот этот fields в нижнем регистре + в базе в нижнем, но вернет ошибку: There is no data to add.

Array
(
    [user_id] => 3
    [filter_id] => api_loc_district
    [fields] => Array
        (
            [field1] => 123456
        )

)

Ссылка 0

ORM

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером