OpenIntegrations/docs/en/md/Bitrix24/Tasks-managment/Get-task-fields-structure.md

sidebar_position
26

Get task fields structure

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

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

Parameter	CLI option	Type	Destination
URL	--url	String	URL of webhook or a Bitrix24 domain, when token used
Token	--token	String	Access 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 :::

 URL = "https://b24-ar17wx.bitrix24.by/rest/1/4swokunb3tk7h7dt/";
 
 Result = OPI_Bitrix24.GetTaskFieldsStructure(URL);
 
 
 URL = "b24-ar17wx.bitrix24.by";
 Token = "adf89366006e9f06006b12e400000001000...";
 
 Result = OPI_Bitrix24.GetTaskFieldsStructure(URL, Token);

 
 oint bitrix24 GetTaskFieldsStructure --url "b24-ar17wx.bitrix24.by" --token "b9df7366006e9f06006b12e400000001000..."

{
 "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
 }
}