method public static

UtsTasksTaskTable::getByPrimary()

Класс: \Bitrix\Tasks\Internals\Task\UtsTasksTaskTable

Сигнатура

public static getByPrimary(mixed $primary[, array<string|int, mixed> $parameters = = '[]' ]) : EO_UtsTasksTask_Result

Описание

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

Параметры

$primary mixed

Первичный ключ сущности

$parameters array<string|int, mixed> = = '[]'

Дополнительные параметры для getList()

Возвращаемое значение

EO_UtsTasksTask_Result

Как применяется в UtsTasksTaskTable

UtsTasksTaskTable::getByPrimary() — метод класса \Bitrix\Tasks\Internals\Task\UtsTasksTaskTable модуля «Задачи». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_UtsTasksTask, наборы — как EO_UtsTasksTask_Collection. Метод достаётся UtsTasksTaskTable от DataManager::getByPrimary: поведение общее для всех сущностей, а данные, поля и классы — свои.

То же, что getById(), но с параметрами getList() вторым аргументом. Для составного ключа UtsTasksTaskTable передаётся массивом.

use Bitrix\Main\Loader;
use Bitrix\Tasks\Internals\Task\UtsTasksTaskTable;

Loader::includeModule('tasks');

$primary = [/*    */];
$row = UtsTasksTaskTable::getByPrimary($primary, [
    'select' => ['VALUE_ID', 'UF_CRM_TASK'],
])->fetch();

Поля сущности UtsTasksTaskTable

Поле	Тип	Свойства
`VALUE_ID`	`int`	обязательное
`UF_CRM_TASK`	`text`	необязательное

Список — из описания класса в исходном коде; точный состав в вашей версии вернёт UtsTasksTaskTable::getEntity()->getFields().

Другие методы UtsTasksTaskTable

add() Добавляет строку в таблицу сущности
addMulti() Добавляет несколько строк в таблицу сущности.
checkFields() Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result
cleanCache() Очищает кеш таблета после модификаций данных.
createCollection()
createObject()
cryptoEnabled() Возвращает true, если для поля включено шифрование.
delete() Удаляет строку в таблице сущности по первичному ключу
enableCrypto() Устанавливает флаг, указывающий на поддержку шифрования для поля.
getById() Возвращает выборку по первичному ключу сущности
getCollectionClass() Возвращает класс коллекции объектов для текущей сущности.
getCollectionClassName() Возвращает имя класса (без пространства имён) коллекции объектов для текущей сущности.

getByPrimary() есть и у других классов модуля «Задачи»: AccessTable, CheckListTable, CheckListTable, CheckListTreeTable, CheckListTreeTable, CounterTable, DependenceTable, DependenceTable.

Исходный файл: source/tasks/lib/internals/task/utstaskstask.php