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

calendar.resource.booking.list

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

calendar.resource.booking.list(filter)

Предоставляет возможность выбрать бронирования ресурсов.

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

Возвращает данные о каждом бронировании. Бронирования имеют идентичные событиям поля, т.к. являются, по сути, событиями.

Параметры

ПараметрОписание
* filterПоля фильтра.
* - обязательные параметры

Примеры использования

Первый вариант: для возможности оценить бронирования (занятость) определенных ресурсов на какой-то период. Может использоваться для создания собственных представлений занятости или для использования в логике.

BX24.callMethod("calendar.resource.booking.list", {
	filter: {
		resourceTypeIdList: [10852, 10888, 10873, 10871, 10853] // передается список id ресурсов, которые можно выбрать методом calendar.resource.list
		from: '2018-06-20',
		to: '2018-08-20',
	}
});

Второй вариант: возможность выбрать бронирования по их id (это значения UF-поля Маска "UF_*"- для выборки всех пользовательских полей (без множественных) , привязанного к CRM сущности).

BX24.callMethod("calendar.resource.booking.list", {
	filter: {
		resourceIdList: [10, 18, 17] // эти ID берутся из значения UF-поля типа resourcebooking у CRM сущностей LEAD|DEAL
	}
});


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
7
Роман Зебров
Как правильно с помощью rest api заполнить поле типа "бронирование ресурсов" в какой либо сущности (лид, сделка) ?
Надо передать в метод update массив строк определенного формата:
Код
#тип_ресурса#|#ID_ресурса#|#дата_время_начала#|#длительность_в_секундах#|#название_услуги#
#тип_ресурса# - "user" для пользователя, "resource" для ресурса
#ID_ресурса# - ID пользователя если тип "user", ID ресурса если тип "resource"

Пример:
Код
BX24.callMethod('crm.lead.update', {
    id: 2, 
    fields: {
        UF_CRM_1584347789573: [
            "resource|7|20.03.2020 13:00:00|3660|Услуга321"
            "resource|9|20.03.2020 13:00:00|3660|Услуга321",
            "user|1|20.03.2020 13:00:00|3660|Услуга321"
            "user|3|20.03.2020 13:00:00|3660|Услуга321",
        ]
}}, console.log);
В данном примере будут забронированы ресурсы с ID 7, 9 и пользователи с ID 1, 3.
На 20 марта 2020 года 13:00, длительностью 61 минута и услугой "Услуга321".  
© «Битрикс», 2001-2024, «1С-Битрикс», 2024