# bot.findPersons()

### Поиск персоны

```JavaScript
bot.findPersons($where = [], $orderBy = [], ?int $limit = null, ?int $offset = null, bool $isLogErrorIfManyPersonsFound = false)
```

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

Находит персоны в соответствии с указанными параметрами и возвращает их массив.

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

<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-whe" style="border-collapse: collapse; width: 100%; height: 297.156px;"><tbody><tr style="background-color: #ced4d9; height: 29.7969px;"><td style="width: 33.2909%; height: 29.7969px;">Имя</td><td style="width: 33.2909%; height: 29.7969px;">Тип</td><td style="width: 33.2948%; height: 29.7969px;">Описание</td></tr><tr style="height: 66.3906px;"><td style="width: 33.2909%; height: 66.3906px;">where

</td><td style="width: 33.2909%; height: 66.3906px;">array</td><td style="width: 33.2948%; height: 66.3906px;">Параметр по которому будет проверяться соответствие с найденными персонами</td></tr><tr style="height: 49.5938px;"><td style="width: 33.2909%; height: 49.5938px;">orderBy

</td><td style="width: 33.2909%; height: 49.5938px;">array</td><td style="width: 33.2948%; height: 49.5938px;">Параметр сортирующий найденные персоны</td></tr><tr style="height: 49.5938px;"><td style="width: 33.2909%; height: 49.5938px;">limit

</td><td style="width: 33.2909%; height: 49.5938px;">?int</td><td style="width: 33.2948%; height: 49.5938px;">Максимальное количество персон, которое будет возвращено</td></tr><tr style="height: 66.3906px;"><td style="width: 33.2909%; height: 66.3906px;">offset

</td><td style="width: 33.2909%; height: 66.3906px;">?int</td><td style="width: 33.2948%; height: 66.3906px;">Параметр показывающий с какой по счету найденной персоны начать возвращать значения</td></tr><tr style="height: 35.3906px;"><td style="width: 33.2909%; height: 35.3906px;">isLogErrorIfManyPersonsFound

</td><td style="width: 33.2909%; height: 35.3906px;">bool</td><td style="width: 33.2948%; height: 35.3906px;">Возвращать ли лог с ошибкой, если найдено больше персон чем указано в limit</td></tr></tbody></table>

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

**array** - массив с id всех найденных персон.

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

```JavaScript
//let persons = bot.findPersons([["firstname", "Alex"]], {}, null, null, true);
//let persons = bot.findPersons([["firstname", "Alex"], ["is_external", "=", 0]], {}, null, null, true);
//let persons = bot.findPersons([["persons.firstname", "=", "Alex"], ["persons.is_external", "=", 0], ["person_roles.name", "=", "test"]], {}, null, null, true);

let persons = bot.findPersons([["firstname", "Alex"]]);

for (let i = 0; i < persons.length; i++) {
  lead.setAttr('person_' + i + '_role_name', persons[i].getRoleName()); 
}

lead.setAttr('found_persons_count', persons.length);
```