Документация для разработчиков
Темная тема

createMnemonicCode

?string
public function CIBlockElement::createMnemonicCode
(
	array $element,
	array array $options = []
);

Нестатичный метод создания символьного кода. От метода генерации отличается проверкой существования в базе, проверкой на уникальность и добавления в конец числового индекса, если сгенерированный код существует. Для работы рекомендуется использовать его. Для работы функции необходимо отключить опцию Использовать внешний сервис для перевода в настройках инфоблока.

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

  • null - в случае ошибок
  • string - строка с символьным кодом

Параметры функции

Параметр Описание
$element Массив, описывающий элемент инфоблока. Тип - массив (array), ключи массива:
  • NAME - непустая строка названия, для которого необходимо сгенерировать символьный код. Тип - строка (string), обязательный.
  • IBLOCK_ID - идентификатор инфоблока. Тип - целое число (int), обязательный
  • ID - идентификатор элемента. Тип - целое число (int) или null, необязательный. Если указать не null - в фильтр будет добавлено условие по ID записи
$options Переопределяемые настройки траслитерации. Тип - массив (array), необязательный в общем случае. Содержит ключи, идентичные $options метода CIBlockElement::generateMnemonicCode с одним дополнением:
CHECK_SIMILAR - проверять похожие. Тип строка (string), значения Y/N, необязательный. Используется, если символьный код должен быть уникальным. После проверки, что сгенеренный код уже существует, будет выполнен поиск по всем вариантам "символьныйКод_ЧИСЛО". К символьному коду будет добавлено число, вариант с которым в базе еще не существует.

© «Битрикс», 2001-2024, «1С-Битрикс», 2024