Методы обслуживания медиаобъектов
Следующие сервисы могут использоваться для построения URL-адреса для получения динамического содержимого для медиаобъектов.
String GetProxyUrl(String targetUrl, [Boolean isAbsoluteUrl] )
Во времени выполнения медиаобъект комбинирует сконфигурированный базовый URL-адрес и параметр url для создания полного целевого URL-адреса. Пример:
http://my.thingworx.server:8080/Thingworx/MediaEntities/
MyProxy/Content/...trailing part of real url
MyProxy/Content/...trailing part of real url
 |
Чтобы удостовериться, что URL-адрес правильно сформирован и кодирован для использования в мэшапах, используйте метод сервиса GetProxyUrl.
|
|
|
При использовании аутентификации с единой точкой входа (SSO) введите URL-адрес, который поддерживает OAuth.
|
Параметры
• targetUrl
URL-адрес содержимого на сервере источника. Должен быть доступен с сервера ThingWorx.
|
|
Если содержимое на сервере источника доступно из браузера клиента, нет необходимости использовать медиаобъект. Вместо этого можно использовать URL-адрес непосредственно в Виджете "Изображение" или Виджете "Ссылка".
|
• isAbsoluteUrl
Этот параметр является необязательным.
◦ true
Установите для этого параметра значение true, если целевой URL-адрес является полным абсолютным URL-адресом сервера источника. Параметр targetUrl должен начинаться с настроенного базового URL-адреса.
◦ false
Установите для этого параметра значение false, если целевой URL-адрес является относительным для настроенного базового URL-адреса. Параметр targetUrl добавляется к базовому URL-адресу для определения фактического целевого URL-адреса.
Если этот параметр не задан, используется значение по умолчанию false (относительный URL-адрес). Относительные URL-адреса удобно использовать из мэшапов, так как настроенный базовый URL-адрес медиаобъекта может быть неизвестен.
• twxME_ClientFollowRedirect
По умолчанию этот параметр имеет значение false. Если задано значение true, будет выполнено перенаправление на заданный URL-адрес.
Примеры
В этих примерах предполагается, что содержимое недоступно для браузера конечного пользователя. Если URL-адреса доступны для браузера, используйте их в мэшапе; нет необходимости использовать медиаобъект в качестве прокси для содержимого.
• В этих примерах используется новый медиаобъект под названием MyProxy.
• URL-адрес на сервере ThingWorx, по которому будет доступно содержимое, - URL-адрес содержимого.
• В примерах предполагается, что сервер ThingWorx находится по адресу thingworx.my, а фактическое содержимое находится по адресу content.acme.com.
Одиночный простой URL-адрес
• Целевой URL: http://content.acme.com/images/example.jpg
Это то, что требуется показать.
• MyProxy.URL: http://content.acme.com/images/example.jpg
• URL содержимого: http://thingworx.my/MediaEntities/MyProxy/Content
Это URL-адрес, где ThingWorx выступает в качестве прокси для фактического содержимого.
Несколько URL-адресов содержимого
Обычно один сервер источника обслуживает содержимое для множества связанных URL-адресов. Вместо настройки отдельного медиаобъекта для каждого URL-адреса можно использовать один медиаобъект в качестве прокси для множества связанных URL-адресов источников.
• Целевые URL: http://content.acme.com/images/[image1.jpg, image2.jpg, image3.jpg…]
• MyProxy.URL: http://content.acme.com/images/
• URL-адреса содержимого:
◦ http://thingworx.my/MediaEnties/MyProxy/Content/image1.jpg
◦ http://thingworx.my/MediaEnties/MyProxy/Content/image2.jpg
◦ http://thingworx.my/MediaEnties/MyProxy/Content/image3.jpg
◦ http://thingworx.my/MediaEnties/MyProxy/Content/...
В этом случае медиаобъект последовательно соединяет базовый URL-адрес и параметр url и использует результат в качестве фактического целевого URL-адреса для проксирования содержимого.