﻿---
sidebar_position: 26
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# 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 | Required | Description |
  |-|-|-|-|-|
  | URL | --url | String | &#x2714; | URL of webhook or a Bitrix24 domain, when token used |
  | Token | --token | String | &#x2716; | Access token, when app auth method used |

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

<br/>

:::tip
Method at API documentation: [tasks.task.getFields](https://dev.1c-bitrix.ru/rest_help/tasks/task/tasks/tasks_task_getFields.php)
:::
<br/>



```bsl title="1C:Enterprise/OneScript code example"
    URL = "https://b24-ar17wx.bitrix24.by/rest/1/ps5...";

    Result = OPI_Bitrix24.GetTaskFieldsStructure(URL);

    URL   = "b24-ar17wx.bitrix24.by";
    Token = "70f46a67006e9f06006b12e400000001000...";

    Result = OPI_Bitrix24.GetTaskFieldsStructure(URL, Token);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint bitrix24 GetTaskFieldsStructure \
             --url "b24-ar17wx.bitrix24.by" \
             --token "***"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint bitrix24 GetTaskFieldsStructure ^
             --url "b24-ar17wx.bitrix24.by" ^
             --token "***"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "result": {
  "fields": {
   "ID": {
    "title": "ID",
    "type": "integer",
    "primary": true
   },
   "PARENT_ID": {
    "title": "ID базовой задачи",
    "type": "integer",
    "default": 0
   },
   "TITLE": {
    "title": "Название",
    "type": "string",
    "required": true
   },
   "DESCRIPTION": {
    "title": "Описание",
    "type": "string"
   },
   "MARK": {
    "title": "Оценка",
    "type": "enum",
    "values": {
     "N": "Отрицательная",
     "P": "Положительная"
    },
    "default": null
   },
   "PRIORITY": {
    "title": "Приоритет",
    "type": "enum",
    "values": {
     "2": "Высокий",
     "1": "Средний",
     "0": "Низкий"
    },
    "default": 1
   },
   "STATUS": {
    "title": "Статус",
    "type": "enum",
    "values": {
     "2": "Ждёт выполнения",
     "3": "Выполняется",
     "4": "Ожидает контроля",
     "5": "Завершена",
     "6": "Отложена"
    },
    "default": 2
   },
   "MULTITASK": {
    "title": "Множественная задача",
    "type": "enum",
    "values": {
     "Y": "Да",
     "N": "Нет"
    },
    "default": "N"
   },
   "NOT_VIEWED": {
    "title": null,
    "type": "enum",
    "values": {
     "Y": "Да",
     "N": "Нет"
    },
    "default": "N"
   },
   "REPLICATE": {
    "title": "Повторяемая задача",
    "type": "enum",
    "values": {
     "Y": "Да",
     "N": "Нет"
    },
    "default": "N"
   },
   "GROUP_ID": {
    "title": "Проект",
    "type": "integer",
    "default": 0
   },
   "STAGE_ID": {
    "title": "Стадия",
    "type": "integer",
    "default": 0
   },
   "CREATED_BY": {
    "title": "Постановщик",
    "type": "integer",
    "required": true
   },
   "CREATED_DATE": {
    "title": null,
    "type": "datetime"
   },
   "RESPONSIBLE_ID": {
    "title": "Исполнитель",
    "type": "integer",
    "required": true
   },
   "ACCOMPLICES": {
    "title": null,
    "type": "array"
   },
   "AUDITORS": {
    "title": null,
    "type": "array"
   },
   "CHANGED_BY": {
    "title": "Изменил",
    "type": "integer"
   },
   "CHANGED_DATE": {
    "title": "Дата изменения",
    "type": "datetime"
   },
   "STATUS_CHANGED_BY": {
    "title": "Изменил статус",
    "type": "integer"
   },
   "STATUS_CHANGED_DATE": {
    "title": "Дата изменения статуса",
    "type": "datetime"
   },
   "CLOSED_BY": {
    "title": "Закрыл задачу",
    "type": "integer",
    "default": null
   },
   "CLOSED_DATE": {
    "title": "Дата закрытия",
    "type": "datetime",
    "default": null
   },
   "ACTIVITY_DATE": {
    "title": null,
    "type": "datetime",
    "default": null
   },
   "DATE_START": {
    "title": "Дата начала",
    "type": "datetime",
    "default": null
   },
   "DEADLINE": {
    "title": "Крайний срок",
...
```
