Skip to main content

Get task fields structure

Gets a structure with a description of the fields for creating a task

Function GetTaskFieldsStructure(Val URL, Val Token = "") Export

ParameterCLI optionTypeDescription
URL--urlStringURL of webhook or a Bitrix24 domain, when token used
Token--tokenStringAccess token, when app auth method used

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


tip

Method at API documentation: tasks.task.getFields


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

Result = OPI_Bitrix24.GetTaskFieldsStructure(URL);

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

Result = OPI_Bitrix24.GetTaskFieldsStructure(URL, Token);
CLI command example
    
oint bitrix24 GetTaskFieldsStructure --url "b24-ar17wx.bitrix24.by" --token "fe3fa966006e9f06006b12e400000001000..."

Result
{
"result": {
"fields": {
"ID": {
"title": "ID",
"type": "integer",
"primary": true
},
"PARENT_ID": {
"title": "ID of base task",
"type": "integer",
"default": 0
},
"TITLE": {
"title": "Name",
"type": "string",
"required": true
},
"DESCRIPTION": {
"title": "Description",
"type": "string"
},
"MARK": {
"title": "Mark",
"type": "enum",
"values": {
"N": "Negative",
"P": "Positive"
},
"default": null
},
"PRIORITY": {
"title": "Priority",
"type": "enum",
"values": {
"2": "High",
"1": "Normal",
"0": "Low"
},
"default": 1
},
"STATUS": {
"title": "Status",
"type": "enum",
"values": {
"2": "Waiting of completing",
"3": "In work",
"4": "On controll",
"5": "Complete",
"6": "Deferred"
},
"default": 2
},
"MULTITASK": {
"title": "Multiple task",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"NOT_VIEWED": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"REPLICATE": {
"title": "Repeatable task",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"GROUP_ID": {
"title": "Project",
"type": "integer",
"default": 0
},
"STAGE_ID": {
"title": "Stage",
"type": "integer",
"default": 0
},
"CREATED_BY": {
"title": "Producer",
"type": "integer",
"required": true
},
"CREATED_DATE": {
"title": null,
"type": "datetime"
},
"RESPONSIBLE_ID": {
"title": "Responsible",
"type": "integer",
"required": true
},
"ACCOMPLICES": {
"title": null,
"type": "array"
},
"AUDITORS": {
"title": null,
"type": "array"
},
"CHANGED_BY": {
"title": "Changer",
"type": "integer"
},
"CHANGED_DATE": {
"title": "Date change",
"type": "datetime"
},
"STATUS_CHANGED_BY": {
"title": "Changer status",
"type": "integer"
},
"STATUS_CHANGED_DATE": {
"title": "Date change of status",
"type": "datetime"
},
"CLOSED_BY": {
"title": "Close task",
"type": "integer",
"default": null
},
"CLOSED_DATE": {
"title": "Date of closing",
"type": "datetime",
"default": null
},
"ACTIVITY_DATE": {
"title": null,
"type": "datetime",
"default": null
},
"DATE_START": {
"title": "Date of start",
"type": "datetime",
"default": null
},
"DEADLINE": {
"title": "Last deadline",
"type": "datetime",
"default": null
},
"START_DATE_PLAN": {
"title": "Planned start",
"type": "datetime",
"default": null
},
"END_DATE_PLAN": {
"title": "Planned end",
"type": "datetime",
"default": null
},
"GUID": {
"title": "GUID",
"type": "string",
"default": null
},
"XML_ID": {
"title": "XML_ID",
"type": "string",
"default": null
},
"COMMENTS_COUNT": {
"title": "Comments count",
"type": "integer",
"default": 0
},
"SERVICE_COMMENTS_COUNT": {
"title": null,
"type": "integer",
"default": 0
},
"NEW_COMMENTS_COUNT": {
"title": null,
"type": "integer",
"default": 0
},
"ALLOW_CHANGE_DEADLINE": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"ALLOW_TIME_TRACKING": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"TASK_CONTROL": {
"title": "Approve task",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"ADD_IN_REPORT": {
"title": "Add in report",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"FORKED_BY_TEMPLATE_ID": {
"title": "Created from template",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"TIME_ESTIMATE": {
"title": "Time spend",
"type": "integer"
},
"TIME_SPENT_IN_LOGS": {
"title": "Time spend from changes history",
"type": "integer"
},
"MATCH_WORK_TIME": {
"title": "Skip weekends",
"type": "integer"
},
"FORUM_TOPIC_ID": {
"title": "FORUM_TOPIC_ID",
"type": "integer"
},
"FORUM_ID": {
"title": "FORUM_ID",
"type": "integer"
},
"SITE_ID": {
"title": "SITE_ID",
"type": "string"
},
"SUBORDINATE": {
"title": "Task of dependent",
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": null
},
"FAVORITE": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": null
},
"EXCHANGE_MODIFIED": {
"title": "EXCHANGE_MODIFIED",
"type": "datetime",
"default": null
},
"EXCHANGE_ID": {
"title": "EXCHANGE_ID",
"type": "integer",
"default": null
},
"OUTLOOK_VERSION": {
"title": "OUTLOOK_VERSION",
"type": "integer",
"default": null
},
"VIEWED_DATE": {
"title": "Date of last view",
"type": "datetime"
},
"SORTING": {
"title": "Index of sorting",
"type": "double"
},
"DURATION_PLAN": {
"title": "Spend (plan)",
"type": "integer"
},
"DURATION_FACT": {
"title": "Spend (fact)",
"type": "integer"
},
"CHECKLIST": {
"title": null,
"type": "array"
},
"DURATION_TYPE": {
"title": "DURATION_TYPE",
"type": "enum",
"values": [
"secs",
"mins",
"hours",
"days",
"weeks",
"monts",
"years"
],
"default": "days"
},
"IS_MUTED": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"IS_PINNED": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"IS_PINNED_IN_GROUP": {
"title": null,
"type": "enum",
"values": {
"Y": "Yes",
"N": "No"
},
"default": "N"
},
"FLOW_ID": {
"title": null,
"type": "integer",
"default": 0
},
"UF_CRM_TASK": {
"title": "Items CRM",
"type": "crm"
},
"UF_TASK_WEBDAV_FILES": {
"title": "Load files",
"type": "disk_file"
},
"UF_MAIL_MESSAGE": {
"title": null,
"type": "mail_message"
}
}
},
"time": {
"start": 1718473322.5296,
"finish": 1718473322.56673,
"duration": 0.0371248722076416,
"processing": 0.00164389610290527,
"date_start": "2024-06-15T17:42:02+00:00",
"date_finish": "2024-06-15T17:42:02+00:00",
"operating_reset_at": 1718473922,
"operating": 0
}
}