Глобальная область данных

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

class Element4Table extends \Bitrix\Iblock\ElementTable
{
	public static function getTableName()
		{
		return 'b_iblock_element';
		}

	public static function setDefaultScope(Query $query)
		{
		$query->where("IBLOCK_ID", 4);
		}

}
    
class Element5Table extends \Bitrix\Iblock\ElementTable
{
		public static function getTableName()
		{
		return 'b_iblock_element';
		}
        
	public static function setDefaultScope(Query $query)
		{
		$query->where("IBLOCK_ID", 5);
		}
}

Метод setDefaultScope будет выполняться при каждом запросе, пропуская через себя объект запроса. В нем можно задавать не только фильтр, но и любые другие параметры запроса.

  Локальная область данных

Начиная с версии 20.5.500 появилась возможность задать предустановленные выборки – методы with*. Это аналог setDefaultScope, но не на глобальном уровне, а на пользовательском – вызов при необходимости. После описания метода в сущности можно вызывать его в конструкторе запросов:

class UserTable
{
	public static function withActive(Query $query)
		{
		$query->where('ACTIVE', true);
		}
}
    
$activeUsers = UserTable::query()
	->withActive()	
	->fetchCollection();

// WHERE `ACTIVE`='Y'

В качестве аргумента используется объект Bitrix\Main\ORM\Query\Query, поэтому можно задавать не только фильтр, но и любые другие параметры запроса. Кроме того, можно дополнить метод своими аргументами, которые также будут переданы при вызове из конструктора запросов:

class UserTable
{
	public static function withActive(Query $query, $value)
	{
	$query
		->addSelect('LOGIN')
		->where('ACTIVE', $value);	
	}
}
    
$activeUsers = UserTable::query()
	->withActive(false)
	->fetchCollection();
        
// SELECT `LOGIN` ... WHERE `ACTIVE`='N'