Добавление типа информационного блока в Bitrix с помощью API

Следующий PHP код демонстрирует каким образом может быть создан тип информационного блока bitrix с помощью API.

<?php
require $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php';
CModule::IncludeModule("iblock");// Подключаем модуль для работы с информационными блоками
//[НАЧАЛО] Формируем массив данных для создания типа информационного блока
$arFields = Array(
  'ID'=>'test123',// Id типа инфоблока
  'SECTIONS'=>'Y',
  'IN_RSS'=>'N',
  'SORT'=>500,// Сортировка
  'LANG'=>Array(
      'en'=>Array(// для Английского языка
      'NAME'=>'Test123',
      'SECTION_NAME'=>'SectionName',
      'ELEMENT_NAME'=>'ElementTest123'
    ),
    'ru'=>Array(// для Русского языка
      'NAME'=>'Тест123',
      'SECTION_NAME'=>'ИмяСекции',
      'ELEMENT_NAME'=>'ЭлементТест123'
    )
  )
);
//[КОНЦЕ] Формируем массив данных для создания типа информационного блока

$obBlocktype = new CIBlockType;// Создаём экземпляр объекта для работы с типами информационных блоков
$res = $obBlocktype->Add($arFields);// Добавляем тип информационного блока по заранее созданному массиву с информацией

var_dump($res);// Эта строчка просто чтобы показать что находится в переменной $res после успешного добавления нового типа информационного блока. Если повторно выполнить код $res будет содержать false, поскольку тип информационного блока с Id test123 уже существует.

Результат выполнения кода.

Результатом выполнения строчки с var_dump будет: string(7) "test123", то есть переменная $res будет содержать Id типа только что созданного информационного блока.

Так выглядит в административной панели Bitrix только что созданный через API тип информационного блока

На изображении выше есть галочка: "Использовать древовидный классификатор элементов по разделам", она в массиве $arFields устанавливается ключом SECTIONS установленным в Y.

Получение информации о типе информационного блока с помощью API

Есть такой метод как CIBlockType::GetByID который отчасти позволяет решить данную задачу, при этом я не буду его использовать, поскольку у данного метода не хватает русских названий связанных с типом информационного блока, при этом чтобы продемонстрировать что именно он делает, я приведу var_dump созданного выше по статье типа информационного блока, а именно следующий листинг содержит результат выполнения PHP-кода var_dump(CIBlockType::GetByID("test123"));

object(CDBResult)#86 (36) {
  ["result"]=>
  NULL
  ["arResult"]=>
  array(1) {
    [0]=>
    array(12) {
      ["ID"]=>
      string(7) "test123"
      ["~ID"]=>
      string(7) "test123"
      ["SECTIONS"]=>
      string(1) "Y"
      ["~SECTIONS"]=>
      string(1) "Y"
      ["EDIT_FILE_BEFORE"]=>
      NULL
      ["~EDIT_FILE_BEFORE"]=>
      NULL
      ["EDIT_FILE_AFTER"]=>
      NULL
      ["~EDIT_FILE_AFTER"]=>
      NULL
      ["IN_RSS"]=>
      string(1) "N"
      ["~IN_RSS"]=>
      string(1) "N"
      ["SORT"]=>
      string(3) "500"
      ["~SORT"]=>
      string(3) "500"
    }
  }
  ["arReplacedAliases"]=>
  NULL
  ["arResultAdd"]=>
  NULL
  ["bNavStart"]=>
  bool(false)
  ["bShowAll"]=>
  bool(false)
  ["NavNum"]=>
  NULL
  ["NavPageCount"]=>
  NULL
  ["NavPageNomer"]=>
  NULL
  ["NavPageSize"]=>
  NULL
  ["NavShowAll"]=>
  NULL
  ["NavRecordCount"]=>
  NULL
  ["bFirstPrintNav"]=>
  bool(true)
  ["PAGEN"]=>
  NULL
  ["SIZEN"]=>
  NULL
  ["SESS_SIZEN"]=>
  NULL
  ["SESS_ALL"]=>
  NULL
  ["SESS_PAGEN"]=>
  NULL
  ["add_anchor"]=>
  string(0) ""
  ["bPostNavigation"]=>
  bool(false)
  ["bFromArray"]=>
  bool(true)
  ["bFromLimited"]=>
  bool(false)
  ["sSessInitAdd"]=>
  string(0) ""
  ["nPageWindow"]=>
  int(5)
  ["nSelectedCount"]=>
  int(1)
  ["arGetNextCache"]=>
  bool(false)
  ["bDescPageNumbering"]=>
  bool(false)
  ["arUserFields"]=>
  bool(false)
  ["usedUserFields"]=>
  bool(false)
  ["SqlTraceIndex"]=>
  bool(false)
  ["DB"]=>
  NULL
  ["NavRecordCountChangeDisable"]=>
  bool(false)
  ["is_filtered"]=>
  bool(false)
  ["nStartPage"]=>
  int(0)
  ["nEndPage"]=>
  int(0)
  ["resultObject"]=>
  NULL
}

Таким образом для решения задачи будем использовать метод CIBlockType::GetByIDLang, который принимает 2 параметра: 1) Id типа информационного блока(в данном случаи test123) и идентификатор языка(в данном случаи en или ru), для примера приведу результат выполнения кода var_dump(CIBlockType::GetByIDLang('test123', 'ru'));

Если в методе CIBlockType::GetByIDLang передать ошибочный идентификатор языка(например e2) то будет возвращена информация для Русского языка, не зависимо от того в каком порядке передавалась информация для языков в массиве под клечом LANG. Если же передать Id не существующего типа информационного блока то метод CIBlockType::GetByIDLang вернёт false.

Следующий PHP код получает массив с информацией о типе информационного блока в том формате, в котором он может быть использован для создания типа информационного блока через API.

<?php
require $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php';
      
CModule::IncludeModule("iblock");
      
$iblockTypeId = "test123";
$infoRuLang = CIBlockType::GetByIDLang($iblockTypeId, 'ru');
$arFields = array();
if ($infoRuLang) {
  if (isset($infoRuLang["IBLOCK_TYPE_ID"])) {
    $arFields["ID"] = $infoRuLang["IBLOCK_TYPE_ID"];
  }
  if (isset($infoRuLang["SECTIONS"])) {
    $arFields["SECTIONS"] = $infoRuLang["SECTIONS"];
  }
  if (isset($infoRuLang["IN_RSS"])) {
    $arFields["IN_RSS"] = $infoRuLang["IN_RSS"];
  }
  if (isset($infoRuLang["SORT"])) {
    $arFields["SORT"] = $infoRuLang["SORT"];
  }
  $arFields["LANG"] = array();
  $infoEnLang = CIBlockType::GetByIDLang($iblockTypeId, 'en');
  if ($infoEnLang and isset($infoEnLang["NAME"]) and isset($infoEnLang["SECTION_NAME"]) and isset($infoEnLang["ELEMENT_NAME"])) {
    $arFields["LANG"]["en"] = array("NAME"=>$infoEnLang["NAME"],"SECTION_NAME"=>$infoEnLang["SECTION_NAME"],"ELEMENT_NAME"=>$infoEnLang["ELEMENT_NAME"]);
  }
  if (isset($infoRuLang["NAME"]) and isset($infoRuLang["SECTION_NAME"]) and isset($infoRuLang["ELEMENT_NAME"])) {
    $arFields["LANG"]["ru"] = array("NAME"=>$infoRuLang["NAME"],"SECTION_NAME"=>$infoRuLang["SECTION_NAME"],"ELEMENT_NAME"=>$infoRuLang["ELEMENT_NAME"]);
  }
}
      
var_dump($arFields);// Просто вывод результата

Результат выполнения var_dump($arFields); из листинга выше в рассматриваемом случаи будет иметь следующий вид.

Результат выполнения кода.

Получение информации о типе информационного блока с помощью API

Комментарии