RealAdmin.ru

Работа с инфоблоками через API Bitrix

Bitrix
Категория: Сайтострой
07 апр 2017 г. в 14:43

1С Битрикс имеет широкие возможности по работе с разделами и элементами инфоблоков на низкоуровневом API. Рассмотрим примеры, которые позволят выбрать и обработать содержимое инфоблока. Применятся они могут как в шаблонах, так и непосредственно на страницах.

Для тестирования примеров создайте новый файл с содержимым:

<? 
    require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php");
    $APPLICATION->SetTitle("API Bitrix");
    CModule::IncludeModule("iblock");
    
    // примеры
    
    require($_SERVER["DOCUMENT_ROOT"]."/bitrix/footer.php"); 
?>

Работа с элементами инфоблока

Начнём с самого простого — получение родительской секции по ID элемента. Допустим, есть каталог с карточкой товара с идентификатром 2138. Требуется узнать название раздела, к которому она относится.

$itemElement = CIBlockElement::GetByID(2138)->Fetch();
echo 'Название элемента: ' . $itemElement['NAME'] . '<br>';
$itemSection = CIBlockSection::GetByID($itemElement["IBLOCK_SECTION_ID"])->Fetch();
echo 'Название родительской секции: ' . $itemSection['NAME'];

А вот пример получения свойства элемента:

$arIBlockElement = GetIBlockElement(2138);
$MINIMUM_WEIGHT = $arIBlockElement['PROPERTIES']['MINIMUM_WEIGHT']['VALUE'];

Выборка элементов раздела с ID 101 инфоблока с ID 12:

$itemsElement = GetIBlockElementList(12, 101, Array("SORT"=>"DESC"));
while($arItem = $itemsElement->GetNext()) { 
    echo $arItem["NAME"]."<br>";
}

При такой выборке свойства полей инфоблока не попадут в результат, поэтому следует в цикле использовать предыдущий пример.

Изменение элемента инфоблока

элемент инфоблока

Кроме выборки API Bitrix позволяет так же создавать, удалять и редактировать элементы инфоблоков. Рассмотрим пример с изменением названия и детального описания у карточки товара с идентификатром 2138.

$element = new CIBlockElement;
$res = $element->Update(2138, array(
    "NAME" => "Хачапури с сыром",
    "DETAIL_TEXT" => '<p>Текст <b>детального</b> описания</p>', 
    "DETAIL_TEXT_TYPE" => 'html', 
    "TIMESTAMP_X" => FALSE
));

В качестве параметра передаётся массив с полями, которые требуют перезаписи. Чтобы у элемента не поменялась дата последнего изменения, добавьте в массив параметр 'TIMESTAMP_X' => FALSE.

Аналогичным образом осуществляется удаление и добавление новых элементов, смотрите официальную документацию по CIBlockElement::Delete и CIBlockElement::Add.

Выборка разделов инфоблока

разделы инфоблока

Получаем все разделы и подразделы инфоблока c ID 12:

$itemsSection = GetIBlockSectionList(12);
while($arItem = $itemsSection->GetNext()) { 
    echo $arItem["NAME"]."<br>"; 
}

Выбираем подразделы из раздела c ID 99 инфоблока с ID 12:

$itemsSection = GetIBlockSectionList(12, 99, Array("SORT"=>"DESC"));
while($arItem = $itemsSection->GetNext()) { 
    echo $arItem["NAME"]."<br>";
}

Выборка из инфоблока (ID=12) 20 активных разделов/подразделов:

$arFilter = array("ACTIVE" => "Y","GLOBAL_ACTIVE"=>"Y");
$arSort = array("SORT"=>"DESC");
$itemsSection = GetIBlockSectionList(12, false, $arSort, 20, $arFilter);
while($arItemSection = $itemsSection->GetNext()) {
    echo $arItemSection["NAME"]."<br>";
} 

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

  • 12 — идентификатор инфоблока.
  • false — указывает что выбираем все разделы/подразделы. Вместо этого параметра можно указать ID любого раздела, чтобы выбирать уже его подразделы.
  • $arSort — массив с параметрами сортировки результатов. Подробности смотрите в официальной документации.
  • 20 — ограничение по выборке, по-умолчанию — 0.
  • $arFilter — массив с условиями выборки. В нашем случае в него записано два условия:
    • ACTIVE — раздел/подраздел должен быть активным;
    • GLOBAL_ACTIVE — вся цепочка родительских разделов так же должна быть активна.

Перебор и обработка активных элементов

Код перебора всех разделов каталога с обработкой названия у активных карточект товаров. Обработка заключается в подмене «Машина» на «Авто». Комментарии в коде.

$countEditElements = 0;
$arrayIdElem = array();

// Вынимаем все активные секции инфоблока 12 (max = 6000)
$itemsSection = GetIBlockSectionList(12, false, array("SORT"=>"DESC"), 6000, array("ACTIVE" => "Y","GLOBAL_ACTIVE"=>"Y"));
while($arItemSection = $itemsSection->GetNext()) { 

  // Выбираем все элементы текущей секции
  $itemsElement = GetIBlockElementList(12, $arItemSection["ID"]);

  while($arItem = $itemsElement->GetNext()) { 
    
    // Если элемент уже был в другом разделе, то пропускаем
    if (in_array($arItem["ID"], $arrayIdElem)) { continue; }
    else $arrayIdElem[] = $arItem["ID"];

    $currentName = $arItem["NAME"];
    $newName = preg_replace('|^Машина (.+)$|i', 'Авто $1', $currentName);
    if ($currentName != $newName) {
      $element = new CIBlockElement;
      $res = $element->Update($arItem[ID], array("NAME" => $newName, 'TIMESTAMP_X' => FALSE));
      $countEditElements++;      
    }
  }
}

echo 'Было изменено элементов: ' . $countEditElements;

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

Получение пользовательских полей

Часто элементы и разделы дополняют пользовательскими полями. Это поля, которые носят префикс «UF_» (user field). Для получения значений предыдущие способы не подходят, так как результирующий набор их просто не может содержать. Следует использовать методы «CIBlockSection::GetList» для разделов и «CIBlockElement::GetList» для элементов.

Пример получения пользовательского поля «UF_H1» раздела (ID 99), инфоблока с ID 12:

$arFilter = array(
    "IBLOCK_ID" => 12,
    "ID" => $arCurSection['ID'], 
    "ACTIVE" => "Y",
    "GLOBAL_ACTIVE"=>"Y", 
    "CODE" => 99
);

$arSort = array("SORT"=>"DESC");

$itemsSection = CIBlockSection::GetList(
    $arSort,
    $arFilter,
    false,
    $arSelect = array("UF_H1")
);

$UF_H1 = '';

while($arItemSection = $itemsSection->GetNext()) {
    $UF_H1 = $arItemSection["UF_H1"];
} 
Теги:
Посмотрите похожее — 1
Комментарии — 0
    © REALADMIN.RU   2017 г.
    Страница сгенерирована: 0,0779 s | 10 mb.
    На каком уровне Вы играете в шахматы?
    О П Р О С
    Home Question Top