Выражение
Функции выражений - это неотображаемые гаджеты, которые можно использовать для вычисления выражения JavaScript. Можно создавать выражения JavaScript для проверки, расчета, преобразования и сравнения данных в мэшапе.
Используйте опцию "Параметр", чтобы создать новые параметры для функции. Для каждого параметра можно задать тип данных и значение по умолчанию. Параметры используются функцией для хранения значений данных. Можно создать параметры для связывания данных из таких источников, как поля свойств и сервисы данных в мэшапе. Все параметры перечисляются как доступные для связывания свойства в разделе Параметры функции.
Можно выбрать тип выходных данных для параметров, используя опцию Базовый тип выходных данных. Выражения сравнения данных возвращают выходные данные с типом BOOLEAN. Вычисления или действия со строками возвращают тип данных NUMBER или STRING. Убедитесь, что целевой виджет для свойства Output поддерживает базовый тип вывода.
Поле "Выражение" позволяет определить код JavaScript. Можно определить арифметические выражения, выражения сравнения и регулярные выражения.
Арифметические выражения
• Простые выражения - используют простые операторы для выполнения сложения, вычитания, умножения и деления. Например:
(Parameter1 + Parameter2) / Parameter3 возвращает сумму Parameter1 и Parameter2, деленную на Parameter3.
• Сложные выражения, использующие функции для выполнения таких вычислений, как возведение в степень, извлечение квадратного корня и натуральный логарифм.
Math.pow(Parameter1, Parameter2) - возвращает результат возведения Parameter1 в степень, равную Parameter2.
Выражения сравнения
Для сравнения данных входных параметров можно использовать все операторы сравнения JavaScript.
Регулярные выражения
Функция выражения поддерживает нотацию JavaScript для регулярных выражений. Регулярные выражения можно применять для проверки и фильтрации входных данных, используя следующий синтаксис.
• /<expression>/.test(<parameter>)
◦ <expression> - регулярное выражение, которое нужно вычислить.
◦ test() - метод, используемый для сравнения указанного параметра данных с выражением.
◦ <parameter> - имя параметра, содержащего данные для вычисления.
• /^(?:\d{3}\-){2}\d{4}$/.test(phoneNumber)
◦ ^ - начало строки.
◦ (?:\d{3}\-){2} - соответствует комбинации из трех цифр и дефиса, повторяющейся дважды (###-###-).
◦ \d{4} - соответствует одной цифре, которая повторяется четырежды (####).
◦ $ - конец строки.
Ведение журнала исключений JavaScript
Исключения возникают, если выражение JavaScript возвращает код ошибки. Можно вести журнал исключений, используя метод TW.log.error. В следующем примере возникает исключение, поскольку функция не определена:
try {
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
 |
Ошибки регистрируются во время выполнения. Щелкните Показать/скрыть журнал на верхней панели инструментов, чтобы показать или скрыть журналы Mashup Builder.
|
Опции функции "Выражение"
Можно задать следующие опции конфигурации.
• Описание - задает описание функции.
• Параметры - задает пользовательские параметры для функции.
• Выражение - выражение JavaScript для расчета.
• Вычислять автоматически - автоматическое вычисление выражений при изменении данных входных параметров.
• Инициировать по первому значению - вычисляет выражение JavaScript при передаче первого значения. При передаче второго значения выражение не вычисляется.
• Тип изменения данных - управляет инициированием события "Изменено".
• Базовый тип выходных данных - тип выходных данных выражения.
• Отключить первоначальные выходные данные - запрещает функции назначать первоначальное неопределенное значение свойству Output перед вычислением выражения.
Создание функции "Выражение"
1. На панели Функции щелкните значок 
. Откроется диалоговое окно Создать функцию.
. Откроется диалоговое окно Создать функцию.2. Выберите Выражение из выпадающего списка.
3. Введите имя для функции, а затем щелкните Далее.
4. В поле Выражение введите выражение JavaScript, которое нужно вычислить.
5. Добавьте параметры входных данных.
a. Щелкните Добавить параметр.
b. Введите имя параметра.
c. Введите значение по умолчанию и всплывающую подсказку, а затем выберите базовый тип параметра.
6. Выберите тип данных из выпадающего списка Базовый тип выходных данных.
7. Нажмите кнопку Готово.
Функция будет добавлена на панель Функции в категории Выражения.
Свойства
Функция "Выражение" содержит следующие свойства.
Свойство | Описание | Базовый тип | Значение по умолчанию | Доступно для привязки? (Да/Нет) | Локализуемое? (Да/Нет) |
|---|---|---|---|---|---|
Evaluate | Доступный для связывания сервис, предназначенный для вычисления выражения. | Н/Д | Н/Д | Д | N |
Changed | Доступное для связывания свойство, инициирующее событие при изменении данных. | Н/Д | Н/Д | Д | N |
Output | Выходные данные вычисленного выражения. Привязку для этого свойства можно задать непосредственно в поле выражения. Чтобы задать привязку, введите output=<> Чтобы запретить этому свойству отправлять первоначальное неопределенное значение, установите флажок Отключить первоначальные выходные данные. | Н/Д | Н/Д | Д | N |