介质
媒体实体可以是本地存储的媒体制品，也可以是用于您的 ThingWorx 应用程序实现的动态内容。多数情况下，这些制品包括用于实体 (例如菜单、样式定义以及混搭) 的图像和图标。本地存储的媒体实体支持 JPEG、PNG 和 BMP 图像类型。要使用其他文件类型，请将其作为动态内容，并修改 platform-settings.json 文件中的 supportedMediaEntityContentTypes 参数以包括所需的 MIME 类型。
常规信息
下列字段定义了媒体实体：
• “名称”
必填字段
• “说明”
用于描述实体的可选字段
• “项目”
此媒体实体所属对象的集合
• “标记”
包含任何适用标记的可选字段
• “图像”
由媒体实体使用的本地存储图像
• “上次修改日期”
上次编辑的日期和时间
配置
|
名称
|
默认值
|
注解
|
|---|---|---|
|
连接器名称
|
-
|
指定 ThingWorx Flow 连接器名称。
希望通过媒体实体访问 ThingWorx Flow 时，可设置此属性。
|
|
“忽略 SSL 错误”
|
未选择/false
|
选择此属性可忽略访问 URL 时遇到的任何 SSL 错误，例如自签名证书的 SSL 错误。
要在 ThingWorx 8.0.7、8.1.3 及 8.2.1 或更高版本中支持双向安全套接字层 (SSL) 身份验证，您可以使用下面的 SSL 连接配置设置。
|
|
名称
|
默认值
|
注解
|
||
|---|---|---|---|---|
|
“动态内容”
|
未选择/false
|
选择此属性以使用动态内容。如果未选择此属性，则媒体实体将使用存储在 ThingWorx 服务器上的内容。
|
||
|
URL
|
动态内容上游源服务器的 URL。这可以是指向特定文件的完整 URL，也可以是指向存储内容的服务器的基本 URL。对于单一登录 (SSO)，请输入支持 OAuth 的 URL。有关基本 URL 使用方法的详细信息，请参阅媒体实体服务方法主题中的 GetProxyUrl 部分。
|
|||
|
“忽略 SSL 错误”
|
未选择/false
|
选择此属性可忽略访问 URL 时遇到的任何 SSL 错误，例如自签名证书的 SSL 错误。
要支持双向安全套接字层 (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
|
|||
|
“转发的标头”
|
该值始终处于显示状态，哪怕其仅用于通过 POST 请求访问的动态内容。值必须是以逗号分隔的标头名称列表。此实体收到 HTTP POST 请求时，所选标头和值将从 ThingWorx 请求复制到对动态内容 URL 的请求。
|
|||
|
“验证服务器的浏览器缓存”
|
未选择/false
|
ThingWorx 缓存媒体实体以提高性能。如果“动态内容”为选定状态或为 True，则会从服务器中提取媒体实体。修改“动态内容”时，将此复选框设置为 True，然后对媒体实体执行硬刷新。
有关执行硬刷新的信息，请参阅 Internet 浏览器的帮助。
|
授权服务器范围设置
此类设置仅适用于 SSO (单一登录) 身份验证类型。
输入与身份验证服务器中所显示的范围名称完全一致的范围名称。这些范围在资源提供者处定义，并在身份验证服务器上注册。有关详细信息，请参阅使用范围。
SSL 连接配置
如果“忽略 SSL 错误”设置 (如上所述) 被选中或为 true，或者定义了以下配置设置，则在针对媒体实体执行所有代理请求时，必须使用 SSL 上下文。此配置允许双向 SSL 身份验证或交换证书。
|
名称
|
注解
|
|---|---|
|
“SSL 密钥存储路径”
|
您的证书的路径。
|
|
“SSL 密钥存储密码”
|
密钥存储文件/您的证书的密码。
|
|
“SSL 信任存储路径”
|
来自证书颁发机构 (CA) 的受信任证书或其他用户的凭据的路径。
|
|
“SSL 信任存储密码”
|
信任存储文件/其他用户的证书的密码
|
会话用户配置
当“身份验证类型”设置为“会话用户”时，需要进行此配置。
|
名称
|
默认值
|
注解
|
|---|---|---|
|
“会话用户查询参数”
|
当“身份验证类型”设置为“会话用户”时，您必须输入“会话用户查询参数”。此值和登录的会话用户 ID 将作为内容代理请求中的查询参数发送。例如，您可以使用内容代理请求将 wt.effectiveUid 发送到 Windchill。
|