# ticket.getCustomData()

### Считывание произвольных полей заявки


```JavaScript
ticket.getCustomData(string $key)
```

##### Описание:

Находит значение указанного типа произвольного поля заявки.

##### Атрибуты:

<table border="1" id="bkmrk-%D0%98%D0%BC%D1%8F-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-key-1" style="border-collapse: collapse; width: 100%; height: 59.5938px;"><tbody><tr style="background-color: #ced4d9; height: 29.7969px;"><td style="width: 33.3745%; height: 29.7969px;">Имя</td><td style="width: 33.3745%; height: 29.7969px;">Тип</td><td style="width: 33.3745%; height: 29.7969px;">Описание</td></tr><tr style="height: 29.7969px;"><td style="width: 33.3745%;">key</td><td style="width: 33.3745%;">string</td><td style="width: 33.3745%;">Ключ наименование поля</td></tr></tbody></table>

<span style="font-weight: 400;">В качестве ключа можно указать:</span>

- <span style="font-weight: 400;">**названия всех произвольных полей заявки**;</span>
- <span style="font-weight: 400;">**id** - id заявки;</span>
- <span style="font-weight: 400;">**business\_id** - id бизнеса;</span>
- <span style="font-weight: 400;">**bot\_id** - id бота;</span>
- <span style="font-weight: 400;">**author\_person\_id** - id автора заявки;</span>
- <span style="font-weight: 400;">**client\_person\_id** - id клиента заявки;</span>
- <span style="font-weight: 400;">**assigned\_person\_id** - id исполнителя заявки;</span>
- <span style="font-weight: 400;">**ticket\_type\_id** - id вида заявки, виды заявки создаются вручную;</span>
- <span style="font-weight: 400;">**payment\_type\_id** - id способа оплаты. Доступные значения:</span>
    - <span style="font-weight: 400;">0 - PAYMENT\_TYPE\_NONE;</span>
    - <span style="font-weight: 400;">**1** - PAYMENT\_TYPE\_ROBOKASSA;</span>
    - <span style="font-weight: 400;">**2** - PAYMENT\_TYPE\_YANDEXKASSA;</span>
    - <span style="font-weight: 400;">**3** - PAYMENT\_TYPE\_CASH;</span>
- <span style="font-weight: 400;">**status\_id** - id статуса заявки;</span>
- <span style="font-weight: 400;">**title** - заголовок заявки;</span>
- <span style="font-weight: 400;">**description** - описание заявки;</span>
- <span style="font-weight: 400;">**created\_at** - время создания заявки;</span>
- <span style="font-weight: 400;">**updated\_at** - время обновления заявки;</span>
- <span style="font-weight: 400;">**deleted\_at** - время удаления заявки;</span>
- <span style="font-weight: 400;">все системные поля заявки (по английски).</span>

<p class="callout warning">Можно получить код значения, используя суффикс **".raw"** к имени произвольного поля. Т.е. если в заявке установлено из опций поля с именем age второе значение:  
({  
"1": "18-25 лет",  
"2": "25-30 лет",  
"3": "30-35 лет",  
"4": "35-40 лет",  
"5": "Больше 40 лет",  
"6": "Не важно"   
})  
то **ticket.getCustomData('age')** вернёт "25-30 лет", **ticket.getCustomData('age.raw')** вернёт "2". </p>

##### Возвращает:

**mixed** - если значение найдено

или

**null** - если значение не найдено.

##### Пример:

```JavaScript
let tickets = bot.findTickets();

for (let i = 0; i < tickets.length; i++) {
  lead.setAttr('tickets_' + i + '_tickets_title', tickets[i].getData('title'));
  lead.setAttr('tickets_' + i + '_client_contacts', tickets[i].getCustomData('client_contacts'));
  lead.setAttr('tickets_' + i + '_details', tickets[i].getCustomData('details'));
  lead.setAttr('tickets_' + i + '_статус_имя', tickets[i].getCustomData('статус.имя'));
}

lead.setAttr('found_tickets_count', tickets.length);
```