entity.item.add

Scope: entity Права на выполнение: для всех

Описание и пример

Добавление элемента хранилища. Пользователь должен обладать хотя бы правами на запись (W) в хранилище.

Пример

Вызов

BX24.callMethod('entity.item.add', {
	ENTITY: 'menu_new',
	DATE_ACTIVE_FROM: new Date(),
	DETAIL_PICTURE: '',
	NAME: 'Hello, world!',
	PROPERTY_VALUES: {
		test: 11,
		test1: 22,
		test_file: ''
	},
	SECTION: 219
});

Запрос

https://my.bitrix24.ru/rest/entity.item.add.json?DATE_ACTIVE_FROM=2013-06-26T11%3A54%3A30.421Z&DETAIL_PICTURE=&ENTITY=menu_new&NAME=Hello%2C%20world!&PROPERTY_VALUES%5Btest1%5D=22&PROPERTY_VALUES%5Btest%5D=11&PROPERTY_VALUES%5Btest_file%5D=&SECTION=219&auth=9affe382af74d9c5caa588e28096e872

Ответ

{"result":842}

Параметры

Параметр	Описание
ENTITY	Обязательный. Строковой идентификатор хранилища.
NAME	Обязательный. Наименование элемента.
ACTIVE	Флаг активности элемента (Y\|N).
DATE_ACTIVE_FROM	Дата начала активности элемента.
DATE_ACTIVE_TO	Дата окончания активности элемента.
SORT	Сортировочный вес элемента.
PREVIEW_PICTURE	Картинка анонса элемента.
PREVIEW_TEXT	Анонс элемента.
DETAIL_PICTURE	Детальная картинка элемента.
DETAIL_TEXT	Детальный текст элемента.
CODE	Символьный код элемента.
SECTION	Идентификатор раздела хранилища.
PROPERTY_VALUES	Ассоциативный список значений свойств элемента. Свойства хранилища создаются при помощи entity.item.property.add.

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

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

Вадим Солуянов 10.02.2017 10:31:20

Добавление картинки в PREVIEW_PICTURE или DETAIL_PICTURE

Код

$picUrl = 'http://some.org/somepic.jpg';
$name = urldecode(basename($picUrl));
$base64cont = base64_encode(file_get_contents($picUrl));

BX24.callMethod('entity.item.add', {
    ENTITY: 'menu_new',
    DATE_ACTIVE_FROM: new Date(),
    DETAIL_PICTURE: array($name, $base64cont),
    NAME: 'Hello, world!',
    PROPERTY_VALUES: {
        test: 11,
        test1: 22,
        test_file: ''
    },
    SECTION: 219
});