Skip to main content

Add task time accounting

Adds information about the user's time spent to the task

Function AddTaskTimeAccounting(Val URL, Val TaskID, Val Time, Val UserID = "", Val Text = "", Val SetupDate = "", Val Token = "") Export

ParameterCLI optionTypeDescription
URL--urlStringURL of webhook or a Bitrix24 domain, when token used
TaskID--taskString, NumberID of task for time accounting
Time--amountString, NumberTime spent in seconds
UserID--userString, NumberID of user for time accounting
Text--textStringComment text
SetupDate--dateStringDate the record was set
Token--tokenStringAccess token, when app auth method used

Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API


tip

Method at API documentation: task.elapseditem.add


Code example
    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/1o2...";
TaskID = "1524";

Time = 3600;

Result = OPI_Bitrix24.AddTaskTimeAccounting(URL, TaskID, Time);

URL = "b24-ar17wx.bitrix24.by";
Token = "b529cb66006e9f06006b12e400000001000...";

Text = "Time spent on work";
UserID = 10;
Time = 7200;
SetupDate = AddMonth(OPI_Tools.GetCurrentDate(), -1);

Result = OPI_Bitrix24.AddTaskTimeAccounting(URL
, TaskID
, Time
, UserID
, Text
, SetupDate
, Token);
CLI command example
    
oint bitrix24 AddTaskTimeAccounting --url "b24-ar17wx.bitrix24.by" --task "1088" --amount "7200" --user "10" --text "Time spent on work" --date %date% --token "fe3fa966006e9f06006b12e400000001000..."

Result
{
"result": 42,
"time": {
"start": 1720816582.16849,
"finish": 1720816582.22964,
"duration": 0.0611569881439209,
"processing": 0.0315871238708496,
"date_start": "2024-07-12T20:36:22+00:00",
"date_finish": "2024-07-12T20:36:22+00:00",
"operating_reset_at": 1720817182,
"operating": 0
}
}