Форматы вывода

Форматы накладываются на тип данных, а не на саму переменную, то есть две разные переменные одного и того же типа данных можно вывести в одном и том же формате, без необходимости настраивать формат для каждой из этих переменных.

Сейчас возможность настройки форматов доступна для 4 типов данных:

В редакторе сценария на панели сверху выберите “Форматы”.

Вам откроется окно с двумя вкладками:

Чтобы настроить новый формат типа данных, сначала нужно настроить формат для каждого из атрибутов этого типа данных, которые вы будете использовать при выводе. Откройте вкладку “Формат атрибута”, слева выберите раздел “Пользовательские” и в выпадающем списке по типам данных выберите нужный атрибут. Нажмите кнопку “Создать формат атрибута”.

Заполните название формата и его содержание. Содержание формата — это распознанное значение выбранного атрибута “_$” и текст, который нужно к нему добавить, например, для атрибута Часы можно задать формат “_$ ч”, а для атрибута Минуты — “_$ мин” и вывести время 15:30 как “15 ч 30 мин”.

Вы также можете добавить замены — если робот распознает выбранное значение, то при выводе оно заменится на значение, введенное в поле “Замена”.

После того как вы создали форматы для всех нужных атрибутов, перейдите во вкладку “Формат типа данных” и в разделе “Пользовательские” создайте тип отображения — группу форматов по каждому типу данных для использования при выводе, именно на тип отображения мы будем ссылаться, когда захотим вывести переменную в каком-либо формате.

Выберите тип данных и заполните содержание формата — введите в строке названия форматов атрибутов этого типа данных и текст, который нужно к ним добавить. Например, мы хотим создать формат для вывода текущего времени, используя те форматы атрибутов, что мы создали в предыдущем примере. Мы хотим, чтобы время было представлено так: “точное время: 15 ч 30 мин”. Для этого в строке “Содержание формата” мы добавляем названия форматов Часов и Минут и фразу “точное время” с двоеточием. Получается такая строка содержания:

Вы можете ввести название формата атрибута вручную или добавить его из выпадающего списка поиска. Чтобы найти нужный формат, в строке “Содержание формата типа данных” введите символ @ и выберите нужный формат из списка.

Системные форматы можно использовать для вывода значений переменных так же, как и пользовательские. Системные типы отображения настроены заранее, они используются по умолчанию для всех переменных всех типов данных, если не рядом с переменной не указан другой тип отображения.

При желании можно использовать системные форматы там, где вы хотите — для этого просто укажите название нужного системного типа отображения рядом с переменной.

Чтобы наложить формат на переменную, нужно указать рядом с названием переменной название типа отображения. Система автоматически определит тип данных этой переменной и наложит на нее формат того же типа данных, которому принадлежит переменная.

Вы можете вывести значение переменной в каком-либо формате в реплике контакту, при передаче значения в сторонний сервис или при отправке контакту SMS.

В Настройках узла в поле реплики введите символ @ и выберите переменную, значение которой нужно озвучить контакту.

Затем введите символ : и выберите нужный тип отображения

Переменная отобразится с выбранным типом отображения. Вы можете заменить переменную или тип отображения по клику на них.

Форматы вывода экспортируются и импортируются вместе со сценарием.

Если названия форматов атрибутов/типов отображения в импортируемом сценарии не совпадают с названиями форматов атрибутов/типов отображения, уже существующих в системе — импортируемые форматы создадутся в системе и будут использоваться в импортированном сценарии.

Если названия импортируемых форматов/типов отображения совпадают с названиями уже существующих в системе (независимо от совпадения/несовпадения их содержания) — импортируемые форматы не создадутся в системе. В импортируемом сценарии они заменятся на существующие в системе форматы/типы отображения.

В системе уже существует:

В импортируемом сценарии после импорта будут использоваться: