介质
媒体实体可以是本地存储的媒体制品,也可以是用于您的 ThingWorx 应用程序实现的动态内容。多数情况下,这些制品包括用于实体 (例如菜单、样式定义以及混搭) 的图像和图标。本地存储的媒体实体支持 JPEG、PNG 和 BMP 图像类型。要使用其他文件类型,请将其作为动态内容,并修改 platform-settings.json 文件中的 supportedMediaEntityContentTypes 参数以包括所需的 MIME 类型。
常规信息
下列字段定义了媒体实体:
“名称”
必填字段
“说明”
用于描述实体的可选字段
“项目”
此媒体实体所属对象的集合
“标记”
包含任何适用标记的可选字段
“图像”
由媒体实体使用的本地存储图像
“上次修改日期”
上次编辑的日期和时间
配置
内容源连接信息
名称
默认值
注解
“动态内容”
未选择/false
选择此属性以使用动态内容。如果未选择此属性,则媒体实体将使用存储在 ThingWorx 服务器上的内容。
URL
动态内容上游源服务器的 URL。这可以是指向特定文件的完整 URL,也可以是指向存储内容的服务器的基本 URL。对于单一登录 (SSO),请输入支持 OAuth 的 URL。有关基本 URL 使用方法的详细信息,请参阅 媒体实体服务方法主题中的 GetProxyUrl 部分。
“忽略 SSL 错误”
未选择/false
选择此属性可忽略访问 URL 时遇到的任何 SSL 错误,例如自签名证书的 SSL 错误。
要在 ThingWorx 8.0.7、8.1.3 及 8.2.1 或更高版本中支持双向安全套接字层 (SSL) 身份验证,您可以使用下面的 SSL 连接配置设置。
“超时”
60
来自 URL 中指定的源服务器的响应等待时间 (以秒为单位)。如果源服务器在这段时间内没有响应,则请求失败。
“身份验证类型”
“无”
URL 中指定的源服务器所需的身份验证。选项如下:
“无”:不需要身份验证。这是默认设置。
“基本”:如果内容位于需要基本身份验证的服务器上,请选择此选项。如果选择此选项,“用户名”“密码”属性将用于对服务器进行身份验证。
* 
使用一个系统帐户访问每个媒体实体的源服务器。
SSO (单一登录):
有关 SSO 的信息,请参阅 ThingWorx 单一登录功能
“会话用户”
选择此选项,可以在不使用 SSO 的情况下支持用户帐户的身份验证。选择此选项时,您必须在下面提供会话用户查询参数,该参数将作为内容代理请求中的查询参数发送。
“用户名”
用于基本身份验证的用户名。即使仅在选择“基本”作为“身份验证类型”时才使用,系统会始终显示该属性。
* 
使用一个系统帐户访问每个媒体实体的源服务器。
密码
用于基本身份验证的密码。即使仅在选择“基本”作为“身份验证类型”时才使用,系统会始终显示该属性。
“授权服务器 ID”
此设置仅适用于单一登录 (SSO) 身份验证类型。输入要连接的身份验证服务器的 ID。配置 ThingWorx 时,服务器管理员针对 SSO 身份验证分配的 ID。要检索此值,请参阅安装 ThingWorx 的 sso-settings.json 文件中 authServerId.clientID 设置所使用的 <authServerId> 变量。您可能需要与 Apache Tomcat 服务器管理员联系以请求身份验证服务器 ID。有关详细信息,请参阅 配置 sso-settings.json 文件
“测试连接 URL”
用于验证您的媒体实体配置的 URL。如果媒体实体配置无效,则保存时将显示连接错误消息。必须由管理员来修复配置并保存。如果要导入或就地迁移无效的媒体实体配置,则 应用程序日志中会记录一条错误消息,媒体实体的“动态内容”标志将设置为 false,且导入或就地迁移过程将继续。然后,管理员必须修复配置,其中包括将“动态内容”标志重新设置为 true。
例如,下面的 URL 可基于“身份验证类型”来测试 Windchill 服务器的代理:
“基本” https://HOST/Windchill/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
SSO https://HOST/Windchill/oauth/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
“会话用户” https://HOST/Windchill/sslClientAuth/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
授权服务器范围设置
此类设置仅适用于 SSO (单一登录) 身份验证类型。
输入与身份验证服务器中所显示的范围名称完全一致的范围名称。这些范围在资源提供者处定义,并在身份验证服务器上注册。有关详细信息,请参阅 使用范围
SSL 连接配置
* 
下列设置适用于 ThingWorx 8.0.7、8.1.3 和 8.2.1 或更高版本。
如果“忽略 SSL 错误”设置 (如上所述) 被选中或为 true,或者定义了以下配置设置,则在针对媒体实体执行所有代理请求时,必须使用 SSL 上下文。此配置允许双向 SSL 身份验证或交换证书。
名称
注解
“SSL 密钥存储路径”
您的证书的路径。
“SSL 密钥存储密码”
密钥存储文件/您的证书的密码。
“SSL 信任存储路径”
来自证书颁发机构 (CA) 的受信任证书或其他用户的凭据的路径。
“SSL 信任存储密码”
信任存储文件/其他用户的证书的密码
会话用户配置
“身份验证类型”设置为“会话用户”时,需要进行此配置。
名称
默认值
注解
“会话用户查询参数”
“身份验证类型”设置为“会话用户”时,您必须输入“会话用户查询参数”。此值和登录的会话用户 ID 将作为内容代理请求中的查询参数发送。例如,您可以使用内容代理请求将 wt.effectiveUid 发送到 Windchill。