1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2025-11-25 22:12:29 +02:00
Files
OpenIntegrations/docs/en/md/Bitrix24/Calendars-management/Get-user-busy.mdx
Vitaly the Alpaca (bot) 73e1617628 Main build (Jenkins)
2025-03-18 11:35:12 +03:00

236 lines
6.2 KiB
Plaintext
Vendored

---
sidebar_position: 5
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
# Get user busy
Gets an array of user events in the specified interval
`Function GetUserBusy(Val URL, Val Users, Val StartDate, Val EndDate, Val Token = "") Export`
| Parameter | CLI option | Type | Required | Description |
|-|-|-|-|-|
| URL | --url | String | ✔ | URL of webhook or a Bitrix24 domain, when token used |
| Users | --users | Number, Array Of Number | ✔ | IDs of users or a single user |
| StartDate | --from | Date | ✔ | Start date of the period |
| EndDate | --to | Date | ✔ | End date of the period |
| Token | --token | String | ✖ | Access token, when app auth method used |
Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API
<br/>
:::tip
Method at API documentation: [calendar.accessibility.get](https://apidocs.bitrix24.ru/api-reference/calendar/calendar-accessibility-get.html)
:::
<br/>
```bsl title="1C:Enterprise/OneScript code example"
URL = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
CalendarID = "462";
User = 1;
Week = 604800;
CurrentDate = OPI_Tools.GetCurrentDate();
StartDate = CurrentDate;
EndDate = CurrentDate + Week;
Result = OPI_Bitrix24.GetUserBusy(URL, User, StartDate, EndDate);
URL = "b24-ar17wx.bitrix24.by";
Token = "2f89d867006e9f06006b12e400000001000...";
CalendarID = "464";
Result = OPI_Bitrix24.GetUserBusy(URL, User, StartDate, EndDate, Token);
```
<Tabs>
<TabItem value="bash" label="Bash" default>
```bash
oint bitrix24 GetUserBusy \
--url "b24-ar17wx.bitrix24.by" \
--users 1 \
--from "2025-03-18T11:12:25.5786477" \
--to "2025-03-25T11:12:25.5786477" \
--token "***"
```
</TabItem>
<TabItem value="bat" label="CMD/Bat" default>
```batch
oint bitrix24 GetUserBusy ^
--url "b24-ar17wx.bitrix24.by" ^
--users 1 ^
--from "2025-03-18T11:12:25.5786477" ^
--to "2025-03-25T11:12:25.5786477" ^
--token "***"
```
</TabItem>
</Tabs>
```json title="Result"
{
"result": {
"1": [
{
"ID": "14",
"NAME": "Новое событие",
"DATE_FROM": "16.02.2025 13:01:00",
"DATE_TO": "16.02.2025 14:01:00",
"DATE_FROM_TS_UTC": "1737961252",
"DATE_TO_TS_UTC": "1740567660",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "74",
"NAME": "Новое событие",
"DATE_FROM": "12.02.2025 18:49:00",
"DATE_TO": "12.02.2025 19:49:00",
"DATE_FROM_TS_UTC": "1738500517",
"DATE_TO_TS_UTC": "1741106940",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "78",
"NAME": "Новое событие",
"DATE_FROM": "12.02.2025 18:49:00",
"DATE_TO": "12.02.2025 19:49:00",
"DATE_FROM_TS_UTC": "1738500517",
"DATE_TO_TS_UTC": "1741106940",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "130",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:38:00",
"DATE_TO": "08.02.2025 10:38:00",
"DATE_FROM_TS_UTC": "1738985853",
"DATE_TO_TS_UTC": "1741592280",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "134",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:38:00",
"DATE_TO": "08.02.2025 10:38:00",
"DATE_FROM_TS_UTC": "1738985853",
"DATE_TO_TS_UTC": "1741592280",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "138",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:40:00",
"DATE_TO": "08.02.2025 10:40:00",
"DATE_FROM_TS_UTC": "1738986021",
"DATE_TO_TS_UTC": "1741592400",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "142",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:40:00",
"DATE_TO": "08.02.2025 10:40:00",
"DATE_FROM_TS_UTC": "1738986021",
"DATE_TO_TS_UTC": "1741592400",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "146",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:48:00",
"DATE_TO": "08.02.2025 10:48:00",
"DATE_FROM_TS_UTC": "1738986498",
"DATE_TO_TS_UTC": "1741592880",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "150",
"NAME": "Новое событие",
"DATE_FROM": "08.02.2025 09:48:00",
"DATE_TO": "08.02.2025 10:48:00",
"DATE_FROM_TS_UTC": "1738986498",
"DATE_TO_TS_UTC": "1741592880",
"~USER_OFFSET_FROM": 0,
"~USER_OFFSET_TO": 0,
"DT_SKIP_TIME": "N",
"TZ_FROM": "Europe/Minsk",
"TZ_TO": "Europe/Minsk",
"ACCESSIBILITY": "busy",
"IMPORTANCE": "high",
"EVENT_TYPE": null
},
{
"ID": "158",
"NAME": "Новое событие",
...
```