Функция "Навигация" является невизуальным виджетом, который можно использовать для перехода между мэшапами в приложении. Чтобы открыть указанный целевой мэшап, привяжите событие к сервису Navigate. Можно привязывать события из других функций, таких как свойство True функции "Валидатор". Это позволяет определять выражения JavaScript, которые управляют навигацией в мэшапе. Кроме того, можно передавать значения параметров между мэшапами, если целевой мэшап содержит привязываемые параметры.

В ThingWorx 9.3 или более поздних версиях можно использовать функцию для отправки и загрузки данных с удаленного сервера. Соединения с удаленным сервером, размещенным в другом домене, часто блокируются веб-браузером в целях безопасности. Однако можно по-прежнему использовать функцию навигации для отправки и загрузки запросов к удаленному серверу, если для типа целевого окна задана настройка Всплывающее окно или Модальное всплывающее окно. Используйте свойство функции Result, чтобы загрузить данные с сервера и привязать их к виджетам, функциям или службам данных в мэшапе.

Опции функции

При создании или изменении функции навигации можно сконфигурировать следующие опции.

Опция	Описание
Описание	Задает описание функции.
Целевой мэшап	Указывает имя мэшапа для перенаправления.
Тип целевого окна	Задает для типа целевого окна одну из следующих опций: • Новое - в новом окне. • Заменить - в текущем окне. • Всплывающее окно - во всплывающем окне. • Модальное всплывающее окно - во всплывающем окне, которое может быть закрыто только из всплывающего окна. • Полный экран - в полноэкранном режиме.
Сообщение об отсутствии мэшапа	Указывает сообщение, которое отображается, если целевой мэшап недоступен.
Название всплывающего окна	Определяет заголовок всплывающего окна.
Ширина всплывающего окна	Задает ширину всплывающего окна.
Высота всплывающего окна	Задает высоту всплывающего окна.
Включить увеличение унаследованной высоты	Определяет, нужно ли добавлять 21 пиксель к высоте всплывающего окна. Эта опция доступна для функций, созданных в ThingWorx 9.3.3 или более ранней версии. Чтобы отключить увеличение высоты, задайте для этого свойства значение false. При создании новой функции в ThingWorx 9.3.4 или более поздней версии для задания высоты всплывающего окна используется фактическое значение.
Перезагрузить при замене	Перезагружает окно браузера, когда текущий мэшап заменяется новым мэшапом.
Кнопка закрытия	Отображение кнопки закрытия во всплывающем окне.
Закрывать щелчком вне окна	Закрывает всплывающее окно, когда пользователь щелкает область за пределами окна.
Полоса прокрутки всплывающего окна	Добавляет полосы прокрутки во всплывающее окно.
Куда перенаправить	Задает тип целевого объекта для перехода. Целевой объект можно задать как Мэшап или URL.
URL	URL-адрес для перенаправления пользователя.
Тип целевого URL-адреса	Позволяет указать, как открывается целевой URL-адрес. Можно открыть URL-адрес в новом окне, в текущем окне, во всплывающем окне или в модальном всплывающем окне. Чтобы отправить или загрузить данные, необходимо открыть целевой URL-адрес во всплывающем окне или в модальном всплывающем окне.
Отобразить сообщение блокировки всплывающего окна	При блокировке всплывающего окна браузером отображается предупреждение.
Сообщение блокировки всплывающего окна	Задает сообщение, которое отображается, если всплывающее окно заблокировано.

Создание функции навигации

1. На панели Функции щелкните значок

. Откроется диалоговое окно Создать функцию.

2. Выберите опцию Навигация в выпадающем списке.

3. Введите имя для функции, а затем щелкните Далее.

4. В разделе Целевой мэшап введите мэшап для перехода.

5. Измените опции согласно требованиям.

6. Нажмите кнопку Готово.

Функция навигации будет добавлена на панель Функции.

Параметры целевого мэшапа

Функция навигации позволяет передавать значения из текущего мэшапа в параметры в целевом мэшапе. При выборе целевого мэшапа его параметры отображаются в разделе Значения по умолчанию для мэшапа в диалоговом окне опций для функции навигации. Можно указать значение по умолчанию для каждого параметра:

Параметры целевого мэшапа также перечисляются в функции навигации. Значение по умолчанию переписывается при привязке свойства к параметру мэшапа.

Свойства функции

Свойство	Описание	Базовый тип	Значение по умолчанию	Доступно для привязки? (Д/Н)	Локализуемое? (Д/Н)
Navigate	Сервис, который перенаправляет пользователей в указанный мэшап или URL.	Н/Д	Н/Д	Д	Н
MissingMashupMessage	Задает сообщение, если целевой мэшап недоступен.	STRING	Н/Д	Д	Д
PopupBlockedMessage	Задает сообщение, которое отображается, если всплывающее окно заблокировано.	STRING	Н/Д	Д	Д
PopupTitle	Задает заголовок всплывающего окна.	STRING	Н/Д	Д	Д
PopupWidth	Задает фиксированную ширину всплывающего окна.	NUMBER	Н/Д	Д	Н
PopupHeight	Задает фиксированную высоту всплывающего окна.	NUMBER	Н/Д	Д	Н
Result	Данные этого свойства возвращаются из всплывающего окна.	STRING	Н/Д	Д	Д
URL		STRING	Н/Д	Д	Н
URLTargetType	Управляет открытием окна целевого URL. Поддерживаемые значения: "Новое", "Замена", "Всплывающее окно" и "Модальное всплывающее окно". Необходимо открывать URL-адреса, которые используются для отправки и загрузки данных во всплывающем окне или в модальном всплывающем окне.	STRING	Н/Д	Д	Н

События функции

Свойство	Описание	Базовый тип	Значение по умолчанию	Доступно для привязки? (Д/Н)	Локализуемое? (Д/Н)
WindowClosed	Событие, которое инициируется при закрытии всплывающего окна.	Н/Д	Н/Д	Д	Н
PopupDone	Событие, инициируемое при закрытии всплывающего окна и отправке данных.	Н/Д	Н/Д	Д	Н/Д
PopupCanceled	Событие, инициируемое при закрытии всплывающего окна до отправки данных.	Н/Д	Н/Д	Д	Н/Д
PopupBlocked	Событие, инициируемое при блокировке всплывающего окна браузером.	Н/Д	Н/Д	Д	Н/Д

Было ли это полезно?