# Выбор элемента приложения

> [HTML Version](get-item.html)

С помощью этого действия бот в ходе диалога с пользователем может запросить название элемента и проверить его наличие в приложении из ELMA365. Если бот найдёт несколько элементов, названия которых совпадают с запросом пользователя, в чат выведется список всех подходящих элементов с полным наименованием, чтобы клиент выбрал нужный. Найденный элемент записывается в переменную, которую можно передавать в [запускаемые ботом бизнес-процессы](start-process.md). 

Например, сотрудник хочет запустить процесс на отгул и прикрепить к нему элемент приложения, который хранит заявление. В таком случае перед элементом [Запуск бизнес-процесса](start-process.md) необходимо разместить **Выбор элемента приложения**. С его помощью бот запросит название элемента у пользователя, а затем проверит, имеется ли такой элемент в приложении, указанном в настройках. Найденный элемент запишется в переменную. После этого переменную можно передать в бизнес-процесс, отвечающий за оформление отгула.  

````
Начало внимание 

````
Для работы элемента необходима настроенная интеграция с ELMA365. Подробнее об этом читайте в статье [«Настройки бота»](bot-settings.md#bot-integration). 

````
Конец внимание

## ````
Настроить элемент 

Введите текст сообщения, который увидит пользователь. Можно использовать смайлы (**(smile-icon.png)**), изображения (**(image-icon.png)**), переменные (**(bot-variable-icon.png)**) и файлы (**(file-icon.png)**). Для изменения сообщения нажмите на текст. 

(request-item-1.png)

Вы можете ввести несколько фраз для запроса элемента приложения. Бот при разговоре с пользователем воспользуется одной из них. Для этого выделите текст и нажмите **Добавить вариант**.

Уберите вариант реплики бота, нажав **Удалить**.

### Записать результат в переменную 

Чтобы завершить настройку элемента, необходимо добавить переменную, в которую будет сохранён полученный элемент приложения. Для этого в поле **Ответ пользователя** нажмите **Добавить** и выберите из списка переменную типа [Объект](bot-variable-settings.md#object) или создайте новую. 

(request-item-2.png)

Бот запомнит всю полученную об элементе информацию: его название, дату создания, ID и т. д., чтобы ссылаться на неё при дальнейшем взаимодействии. 

Все переменные сохраняются внутри сценария. Вы можете просматривать список используемых в сценарии переменных и изменять их настройки. Подробнее об этом читайте в статье [«Настройка переменных бота»](bot-variable-settings.md).

### Настроить ввод 

Для элементов, которые уточняют информацию у пользователя, доступны **Настройки ввода**. Наведите курсор на элемент, а затем на появившиеся рядом с его названием три точки и выберите значок шестерёнки (bot-gear-icon.png). В открывшемся окне вы можете включить дополнительные опции и указать приложение, из которого нужно получить элемент. 

#### Вкладка «Общие» 

(request-item-3.png)

- **Обязательный ввод** — взаимодействие не будет идти дальше по ветке сценария, пока пользователь не укажет название элемента, находящегося в приложении;

- **Показать кнопку ‘Отмена’** — в диалоге с пользователем будет отображаться кнопка, которая отменяет запрос данных; 

- **Максимальное количество попыток ввода** — если вводимый пользователем элемент не найден, бот будет повторять запрос указанное количество раз. Если включена опция **Обязательный ввод**, после заданного числа повторов сценарий будет прерван. Если опция отключена, сценарий продолжится, но в переменную ничего не запишется; 

- **Показывать кнопку ‘Помощь’** — в диалоге будет отображаться кнопка, нажав на которую пользователь увидит сообщение с подсказкой от бота; 

- **Сообщение при запросе помощи** — введите текст подсказки, которую увидит пользователь. Например, укажите формат ввода данных или переформулируйте первоначальный запрос. Поле появляется, если включена опция **Показывать кнопку ‘Помощь’**; 

- **Показывать кнопку ‘Оператор’** — в диалоге будет отображаться кнопка, при нажатии на которую произойдёт перевод беседы на оператора;   

- **Спрашивать** — укажите, в каком случае бот будет запрашивать название элемента приложения: 

	- **Каждый раз** — бот будет делать запрос каждый раз, как сценарий дойдёт до элемента **Запрос пользователя**; 

	- **Только когда значение не заполнено** — бот будет делать запрос только в случае, если переменная для ответа пользователя пустая. 

#### Вкладка «Приложение ELMA365»

(request-item-4.png)

Выберите из раскрывающегося списка приложение, из которого будет запрашиваться элемент. 

После настройки параметров элемента нажмите кнопку **Сохранить**. 

## Копировать и удалить элемент

Добавленный в сценарий элемент можно скопировать ((bot-copy-icon.png)) или удалить ((bot-close-icon.png)). Для этого наведите курсор на элемент, а затем на три точки и выберите нужную опцию.