USM Content
Утилиты моста: JavaScript
Утилита JavaScript в Bridge включает только один модуль: Run Script. Используйте этот модуль для написания функций JavaScript и запуска написанных вами функций.
Утилита JavaScript
- Войдите в систему Bridge.
- Перейдите на страницу интеграции.
- Найдите и выберите JavaScript.
Модуль запуска сценария
Модуль содержит следующие поля, во всех из которых вы можете использовать ссылки на данные:
- Имя сценария: имя запускаемого сценария.
- Параметры сценария: параметры, ожидаемые скриптом при запуске и представленные в виде карты объектов key: Value.
- Ключ: имя параметра, отображаемое в скрипте.
- Значение: значение, присвоенное ключу, который скрипт использует при запуске сценария.
Допустимое количество параметров скрипта не ограничено и добавляется динамически.
Чтобы настроить сценарий, который вы хотите запустить, выполните следующие действия:
- Выберите значок шестеренки в верхней части модуля.
- Разверните раздел «Сценарии».
- Выберите «Добавить в сценарии».
- Заполните поля «Имя сценария» и «Текст сценария».
- Выберите «Сохранить».
Как только Bridge запустит модуль Run Script, на панели Run Log появится следующая информация:
- Данные
- результат: вывод JavaScript
- Состояние: раздел, в котором указано, работал ли модуль
- Код: код успешности/ошибки, полученный модулем из Smartsheet
- Сообщение: генерируемое системой сообщение, которое модуль извлекает из Smartsheet. Например, если модуль не может найти значение, появится сообщение «Не найдено»
- Состояние: статус, полученный модулем из Smartsheet. Вы можете столкнуться с такими статусами, как «Успешно» и «Не удалось».
Примеры
Пример 1: Привет, мир
- Создайте сценарий, в котором текст сценария выглядит следующим образом: верните «Hello» + a.
Чтобы получить результат, необходимо ввести return в каждом скрипте.
- В модуле добавьте параметр a со значением world.
- Запустите рабочий процесс.
Убедитесь, что ключ в конструкторе модулей соответствует параметру в поле Текст сценария.
Значение — это взаимозаменяемые входные данные. Например, это может быть результат предыдущего ответа модуля.
Имя сценария не требует кавычек для строковых входов, но тело сценария требует кавычек. В противном случае вы получите сообщение об ошибке.
Пример 2. Основные операции
Чтобы объединить две строки, выполните следующие действия:
- Создайте сценарий с телом сценария: верните a + b.
- В модуле добавьте параметры a и b со значениями 3 и 2 соответственно.
- Запустите рабочий процесс.
Этот метод объединяет два значения, но не добавляет их.
Переменные, заданные через Bridge, обрабатываются как строки.
Для суммирования чисел:
- Создайте сценарий с полем «Текст сценария»: верните значение Number (a) + Number (b).
- Запустите рабочий процесс.
При тех же параметрах, что и в примере ниже, результат на этот раз равен 5.
Пример 3. Итерация по массиву
В этом примере у нас есть рабочий процесс с модулем List Sheets. При запуске рабочего процесса в журнале выполнения отображаются следующие выходные данные, где данные помечены как Array [100]. Это означает, что поле представляет собой массив.
Чтобы получить информацию из журнала выполнения, необходимо запустить рабочий процесс.
- Выберите три точки рядом с данными, затем выберите Скопировать ссылку на данные.
- Добавьте новый модуль Run Script в рабочий процесс.
- Создайте новый JavaScript-скрипт. В этом примере мы называем его GetFirstElementOfListSheets, а тело скрипта — ReturnListSheets [0]. Это возвращает первый элемент массива данных.
Число в квадратных скобках определяет, какой элемент массива будет возвращен. 0 возвращает первое, 1 возвращает второе и так далее.
В модуле JavaScript:
- Задайте GetFirstElementOfListSheets в качестве имени скрипта.
- Добавьте параметр скрипта с ключом #1 под названием ListSheets.
- Вставьте ссылку на данные, скопированную на шаге 1, в Value #1
Если мы запустим рабочий процесс, журнал выполнения предоставит следующие выходные данные.
Элементы, приведенные ниже, являются частью первого элемента массива.
Ограничения по продуктам/функциям
Запросы и ответы на полезную нагрузку объемом не более 6 МБ можно обрабатывать.
Это может измениться в связи с предстоящими обновлениями.
- При создании сценария проверка сценария не производится. Если скрипт неисправен, разработчик должен отлаживать/исправить все проблемы и ошибки, возникшие при запуске скрипта.
- Вы не можете отслеживать версии и историю сценариев или управлять ими.
- Bridge подходит для рабочих процессов на основе событий или фиксированного расписания. Это не замена функции односторонней или двусторонней синхронизации зеркал, обеспечиваемой разъемами. По замыслу Bridge не гарантирует порядок и не сообщает об изменениях, внесенных в ту или иную систему. Настройки, подобные разъемам, ненадежны и настоятельно не рекомендуются.