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

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
Наверх