Передать данные в Case.one
выбрать объект и записать его в переменную для дальнейшего использования в диалоге;
создать объект в Case.one во время диалога с респондентом;
редактировать поля объекта в Case.one во время диалога с респондентом.
Добавление блока Case.one
Добавьте блок Case.one в диалог. Если блока Case.one нет в списке блоков, убедитесь, что интеграция с Case.one подключена. Как подключить интеграцию с Case.one для всех позователей Bot.one, читайте здесь.
Справа появится панель настройки блока. Выберите инстанс Case.one для подключения. Вы можете выбрать один из списка или настроить подключение самостоятельно – для этого выберите Ввод вручную.
Если вы выбрали подключение вручную, укажите настройки подключения:
URL-адрес инстанса – URL инстанса Case.one, к которому нужно подключиться. Например,
https://example.case.one/В поле доступен ввод переменной. Отображается, если выбран Ввод вручную.Логин – логин для авторизации на инстансе Case.one. В поле доступен ввод переменной. Отображается, если выбран Ввод вручную.
Пароль – пароль для авторизации на инстансе Case.one. В поле доступен ввод переменной. Отображается, если выбран Ввод вручную.
Выберите действие:
Выбор объекта – выбрать объект и записать его в переменную для дальнейшего использования в диалоге;
Создать объект – создать объект в Case.one;
Редактировать объект – редактировать поля объекта в Case.one.
От выбранного действия зависят настройки, которые нужно указать для блока.
Выбор объекта
Действие Выбор объекта позволяет выбрать объект и записать его в переменную для дальнейшего использования в диалоге.
Сообщение – текст сообщения, которое будет опубликовано ботом перед публикацией объектов Case.one.
Задать переменную – для использования ответа респондента введите в поле значение переменной (
name,address,orgtypeи т.п.). В процессе диалога бот присвоит соответствующее значение переменной ответу, который выберет респондент.
Нажмите кнопку Добавить фильтр.
На боковой панели появятся параметры фильтрации. Заполните параметры:
Параметры – выбор параметра для фильтрации по всем типам объектов Case.one. Параметры отображаются в иерархии Case.one. В поле доступен поиск.
Способ заполнения – выбор способа заполнения: вручную или через переменную.
Значение – поле выбора значений фильтра из Case.one. Отображается, если выбран Ввод вручную.
Переменная – поле для ввода переменной, из которой нужно взять значение для фильтрации. Отображается, если выбран Ввод из переменной.
Если значение фильтра можно указать при создании блока, и оно не изменится в зависимости от диалога – выберите способ вручную.
Если значение поля зависит от ответов респондента, каких-либо условий или импортируется из других систем, то выберите способ Ввод из переменной и укажите переменную в поле Переменная в виде @name.
Вы можете добавить несколько фильтров – тогда в диалоге будут выведены объекты, которые удовлетворяют всем фильтрам.
Наведите на заголовок фильтра.
Нажмите кнопку
.Выберите Удалить. Фильтр будет удален.
Блок Case.one в диалоге выведет список всех объектов выбранного модуля Case.one, которые удовлетворяют условиям фильтрации. Если объектов много, то они выводятся по 20 на странице, перемещаться между страницами можно кнопками Назад и Вперед.
Тот объект, который выберет респондент, будет записан в переменную и доступен в данных диалога в разделе Диалог.
Чтобы использовать данные, полученные из Case.one, вам нужно обратиться к переменной или данным, которые содержатся внутри нее. Чтобы обратиться к данным внутри переменной, пропишите их теги из JSON ответа через точку после переменной.
Например, чтобы создавать объекты в Case.one, вам нужно будет указать ответственного. Вы можете выбрать его вручную или указать через переменную.
Для этого вам нужно перед созданием объекта добавить блок выбора объекта и назначить ему переменную. Например, person.
В ответ вы получите JSON файл. Структуру этого JSON вы можете просмотреть в данных диалога на вкладке Диалог.
Из ответа видно, что имя ответственного содержится в тегах Assignee – Name. Поэтому в поле Ответственный при создании объекта вам нужно прописать: @person.Assignee.Name.
Если переменная не была задана в параметрах блока, система пропускает этот шаг и идет дальше.
Создание объекта
Действие Создать объект позволяет создать объект в Case.one во время диалога с респондентом.
Тип объекта – выбор из списка типов объектов Case.one.
Задать переменную – переменная, в которую система поместит созданный объект и информацию об ошибках. В названии переменной вы можете использовать строчные латинские буквы, цифры и символы клавиатуры, кроме пробела и
@(name, address, orgtype и т.п.).
Название – название создаваемого объекта.
Ответственный – выберите пользователя Case.one.
поля, которые в этом типе объектов указаны как обязательные.
Warning | Если Название, Ответственный и другие обязательные поля не заполнены, объект не будет создан. |
Вы также можете указать значения для других полей нового объекта.
Название – наименование поля объекта. Параметр заполнен автоматически для обязательных полей. Для остальных – выберите из списка полей объекта.
Способ заполнения – выбор способа заполнения: вручную или через переменную. Если значение поля можно указать при создании блока и оно не изменится в зависимости от диалога – выберите способ вручную. Если значение поля зависит от ответов респондента, каких-либо условий или импортируется из других систем, то выберите способ Ввод из переменной и укажите переменную в поле Переменная в виде
@name.Значение – поле выбора значений вручную. Отображается, если выбран Ввод вручную.
Переменная – поле для ввода переменной, из которой нужно взять значение для заполнения поля. Отображается, если выбран Ввод из переменной.
Прерывать блок, если переменная пуста либо невалидна – по умолчанию флаг установлен: система не будет передавать данные всего объекта в Case.one, если в процессе диалога поле не было заполнено корректно. Если данные в поле не обязательны для создания объекта Case.one, то снимите флаг. Тогда, система передаст данные объекта в Case.one с этим полем (если данные указаны корректно) или без него (если данные указаны некорректно). Флаг доступен только если в параметре Способ заполнения выбрано Ввод из переменной.
Наведите на заголовок поля.
Нажмите кнопку
.Выберите Удалить. Поле будет удалено.
В диалоге, когда бот дойдет до блока Case.one, он соберет все данные для создания объекта и передаст их на выбранный инстанс Case.one.
если объект получается создать, бот помещает в переменную объект;
если при создании объекта возникли ошибки, бот помещает в переменную информацию об ошибках.
Содержимое переменной доступно в формате JSON в разделе Собранная информация данных диалога.
Tip | Если не получилось создать объект в Case.one, перейдите в раздел Диалоги, найдите и выберите диалог, перейдите по ссылке с названием переменной в разделе Собранная информация данных диалога. В скаченном файле вы увидите, какие ошибки возникли при создании объекта. |
Редактирование объекта
Действие Редактировать объект позволяет отредактировать поля объекта в Case.one во время диалога с респондентом.
Warning | Редактирование мультиблоков Case.one через блок Редактирование объектов недоступно. |
Тип объекта – выбор из списка типов объектов Case.one.
Объект – укажите в поле ID объекта, который нужно отредактировать.
Задать переменную – переменная, в которую система поместит отредактированный объект и информацию об ошибках. В названии переменной вы можете использовать строчные латинские буквы, цифры и символы клавиаткуры, кроме пробела и
@(name, address, orgtype и т.п.).
Как указать ID объекта для редактирования?
Способ 1: Скопировать ID объекта с карточки объекта в Case.one.
Способ 2: Указать через переменную.
передать переменную через URL;
добавить блок Case.one: Выбор объекта и записать в переменную выбранный респондентом ответ;
добавить любой другой блок, который позволяет записать в переменную ID объекта из Case.one (Выбор ответа, Сбор данных и пр.).
Укажите переменную в блоке Case.one: Редактирование объекта с тегом id.
После выбора типа объекта и указания ID объекта добавьте поля, которые нужно изменить.
Нажмите кнопку Добавить поле на боковой панели.
Появятся параметры поля. Укажите, какое поле и как следует изменить:
Название – выберите поле, которое следует изменить. В списке содержатся только поля выбранного типа объектов.
Способ заполнения – выбор способа заполнения: вручную или через переменную. Если значение поля можно указать при создании блока и оно не изменится в зависимости от диалога – выберите способ вручную. Если значение поля зависит от ответов респондента, каких-либо условий или импортируется из других систем, то выберите способ Ввод из переменной и укажите переменную в поле Переменная в виде
@name.Значение – для ввода значения вручную. Отображается, если выбран Ввод вручную.
Переменная – для ввода переменной, из которой нужно взять значение для заполнения поля. Отображается, если выбран Ввод из переменной.
Прерывать блок, если переменная пуста либо невалидна – по умолчанию флаг установлен: система не будет передавать данные всего объекта в Case.one, если в процессе диалога поле не было заполнено корректно. Если данные в поле не обязательны для редактирования объекта Case.one, то снимите флаг. Тогда, система передаст данные объекта в Case.one с этим полем (если данные указаны корректно) или без него (если данные указаны некорректно). Флаг доступен только если в параметре Способ заполнения выбрано Ввод из переменной.
Наведите на заголовок поля.
Нажмите кнопку
.Выберите Удалить. Поле будет удалено.
В диалоге, когда бот дойдет до блока Case.one, он пытается изменить указанный объект.
если объект получается отредактировать, бот помещает в переменную объект;
если при редактировании объекта возникли ошибки, бот помещает в переменную информацию об ошибках.
Содержимое переменной доступно в формате JSON в разделе Собранная информация данных диалога.
Tip | Если не получилось изменить объект в Case.one, перейдите в раздел Диалоги, найдите и выберите диалог, перейдите по ссылке с названием переменной в разделе Собранная информация данных диалога. В скаченном файле вы увидите, какие ошибки возникли при создании объекта |
Добавление файла в объект Case.one
Вы можете добавить файл в объект Case.one при его создании или редактировании. Для этого в типе объектов Case.one должно быть поле с типом Object-Document.
Добавьте в бот блок, который позволит отправить в диалог файл (например, блок Сбор данных с типом Файл) и объявите переменную для этого файла.
В блоке Case.one добавьте поле.
В параметре Название добавленного поля выберите Document.
После выбора Document, будет доступен только ввод значения через переменную. Укажите в поле Переменная объявленную ранее переменную, в которую будет помещен файл, через
@.
![Добавление файла в объект Case.one]](\images\/caseone_add_file.png)
В процессе диалога бот попробует прикрепить ранее загруженный в переменную файл к объекту.
Если в переменной находится массив файлов и пользователь не уточнил, какой именно файл из массива он нужно передать, то система использует первый файл из массива.
Если система не смогла заполнить поле (в переменной не файл, либо переменная пуста), то бот запишет ошибку в JSON файл переменной объекта.
Как получить данные для создания или редактирования объекта в Case.one через бот
Указать данные напрямую в параметрах блока.
Спросить респондента.
Получить данные через бот иными способами.
Указать данные напрямую в параметрах блока
Этот способ подходит, если создается статический объект с одними и теми же данными. В этом случае в параметре Способ заполнения нужно выбрать Ввод вручную и указать данные в поле Значение.
Спросить респондента
Перед блоком Case.one нужно добавить блок Сбор данных или Форма, чтобы ответы респондента автоматически помещались в объект Case.one.
Добавить блок Сбор данных или Форма на схему бота перед блоком Case.one.
Указать для каждого блока переменную.
В блоке Case.one в поле Способ заполнения выбрать Ввод из переменной.
В поле Переменная указать через символ
@ту же переменную, которую задавали для ответа респондента на шаге 2.
В результате данные в объект Case.one будут добавляться ответы респондента в диалоге.
Получить данные через бот иными способами
Некоторые данные могут поступать в диалоге, но не через ответы респондента. Например, город респондента или время обращения доступны в метаданных диалога, информация может быть получена из других сервисов через API в блоке Webhook, посчитана в блоке Скрипт и т.д.
Добавить блок, которые получает информацию перед блоком Case.one.
Указать переменную для записи результата выполнения этого блока.
Добавить блок Case.one.
Выбрать в поле Способ заполнения выбрать Ввод из переменной.
В поле Переменная указать через символ
@ту же переменную, которую задавали на шаге 2. Чтобы обратиться к данным внутри переменной, пропишите их теги из JSON ответа через точку после переменной (см. подробнее: Выбор объекта).
Возможные ошибки
Блок Case.one отображается в списке доступных блоков, если подключен хотя бы один инстанс Case.one.
Инстанс Case.one, к которому подключается бот, должен быть 62 версии и выше.
Если настройки в выбранном подключении к модулю Case.one указные не верно, при выборе типа объекта или фильтра появится сообщение об ошибке. Обратитесь к администратору.
Если в настройках не указан инстанс Case.one, то система пропускает блок и переходит к следующему блоку.
Если выключена интеграция с Case.one, которая указана в блоке, то система пропускает блок и переходит к следующему блоку.
Если система не может авторизоваться в указанном модуле (неверный/пустой инстанс, инстанс недоступен, неверные логин или пароль), то система пропускает блок и переходит к следующему блоку.
Если фильтрация вернула пустой список объектов, то система помещает пустой ответ в переменную и переходит к следующему блоку диалога.
Если запрос на создание или редактирование объекта вернул ошибку, она записывается в переменную, а бот переходит к следующему блоку.
Если поле или фильтр в блоке настроен с нарушениями (не заполнено хотя бы одно поле), то система фиксирует ошибку и переходит к следующему фильтру/блоку.
Если поле или фильтр в блоке ссылается на переменную несоответствующего типа, либо эта переменная пустая, а для поля установлен флаг Прерывать блок, если переменная пуста либо невалидна, то система фиксирует ошибку и переходит к следующему фильтру/блоку.
Если модуль подключения Case.one отключен или удален, то все блоки Case.one, в которых был выбран данный модуль, остаются без изменений. Но система не позволяет перевыбрать выключенный/удаленный инстанс и редактировать/добавлять поля.