媒體
媒體實體可以是儲存在本機的媒體加工品，或是用於 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> 變數。欲請求驗證伺服器 ID，您可能需要與您的 Apache Tomcat 伺服器管理員聯繫。如需詳細資訊，請參閱配置 sso-settings.json 檔案。
|
|||
|
「測試連線 URL」
|
用來驗證媒體實體組態的 URL。若嘗試儲存時媒體實體組態無效，則會顯示連線錯誤訊息。管理員必須修復組態並儲存。若您要匯入或執行無效媒體實體組態的就地移轉，錯誤訊息則會記錄在應用程式記錄檔中，媒體實體的「動態內容」旗標將設定為 false，但匯入或就地移轉仍會繼續。管理員隨後必須修復組態，包括將「動態內容」旗標重設為 true。
例如，下列 URL 可用來根據「驗證類型」測試 Windchill 伺服器的 Proxy：
• 「基本」： 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 並執行媒體實體的硬重新整理。
如需有關執行硬重新整理的資訊，請查閱網際網路瀏覽器的說明。
|
授權伺服器範圍設定
這些設定僅適用於 SSO (單一登入) 驗證類型。
輸入與授權伺服器中顯示的內容完全相同的範圍名稱。這些範圍是在資源提供者處定義，並在驗證伺服器上註冊。如需詳細資訊，請參閱使用範圍。
SSL 連線組態
如果「略過 SSL 錯誤」設定 (如上所述) 為已選取/true，或已定義下列組態設定，則針對媒體實體執行所有代理請求時，都必須使用 SSL 前後關聯。此組態可啟用雙向 SSL 驗證或憑證交換。
|
名稱
|
註記
|
|---|---|
|
「SSL 金鑰庫路徑」
|
憑證的路徑。
|
|
「SSL 金鑰庫密碼」
|
金鑰庫檔案/您憑證的密碼。
|
|
「SSL 信任庫路徑」
|
「憑證授權單位」(CA) 中之受信任憑證或其他憑證的路徑。
|
|
「SSL 信任庫密碼」
|
信任庫檔案/其他憑證的密碼。
|
工作階段使用者組態
「驗證類型」設定為「工作階段使用者」時需要此組態。
|
名稱
|
預設值
|
註記
|
|---|---|---|
|
「工作階段使用者查詢參數」
|
「驗證類型」設定為「工作階段使用者」時，您必須輸入「工作階段使用者查詢參數」。此值與已登入的工作階段使用者 ID 會在內容代理請求中作為查詢參數傳送。例如，您可以使用內容代理請求將 wt.effectiveUid 傳送至 Windchill。
|