資產靜音與取消靜音
資產靜音是封鎖物件與平台間所有通訊的流程。當物件靜音時，系統不會傳送或保留從平台到物件的訊息。同樣地，還會封鎖從物件傳送至平台的任何訊息且不予以保留。
使物件靜音的能力對於各種商業個案來說都很寶貴。平台可能會部署不經常通訊的物件，且可能會傳送不準確或不必要的訊息。例如，如果擔心代理程式正在傳送的資料量或其與平台通訊的頻率，則靜音物件可以立即緩解情況。將物件靜音會停止進出物件的訊息，讓平台管理員有時間對通訊模式、資料量及傳輸速率進行疑難排解。
物件靜音或取消靜音功能僅適用於使用 AxedaBaseModel 物範本或其衍生物範本建立之以 Axeda 為基礎的遠端物件。如需有關 Axeda 物範本的詳細資訊，請參閱 ACE 物範本。
• 使用者可將使用 AxedaStandaloneModel、AxedaEMessageGatewayModel 物範本建立的物件靜音或取消靜音。當將「閘道物件」靜音或取消靜音時，會將其受管理裝置自動靜音或取消靜音。
• 使用 AxedaManagedModel 物範本管理的裝置不支援靜音或取消靜音。將受管理裝置靜音或取消靜音必須透過其閘道物件執行。
• 針對使用 AxedaBaseModel 物範本建立之以 Axeda 為基礎的遠端物件，將自動實行「可變物形式」。針對其他所有物件，實行「可變物形式」將會擲出例外。
欲使用靜音與取消靜音功能，請使用 ThingWorx 9.7.0 與 Axeda Compatibility Package 2.6.0 (包含 eMessage 伺服器、Axeda Compatibility Extension 與遠端存取延伸功能)。如需有關相容版本的詳細資訊，請參閱 Release Advisor。
 |
欲根據 AxedaBaseModel 物範本或其衍生物範本手動或以程式方式建立物件，您必須擁有 MutableGateway、MutableManagedDevice 與 Mutable 物形式的可見度權限。
|
將以 Axeda 為基礎的遠端物件靜音及取消靜音
欲將物件靜音或取消靜音，請使用下列方法：
• 服務：
有兩個服務可用於以 Axeda 為基礎的遠端物件 (透過「可變物形式」)。
◦ Mute：此服務會將物件靜音並封鎖物件與平台間的所有通訊。如果物件是閘道，它還會將所有受管理物件靜音。
◦ Unmute：此服務會將物件取消靜音並允許物件與平台間的所有通訊。如果物件是閘道，它還會將所有受管理物件取消靜音。
• Composer UI
使用者只能針對 Axeda 裝置，使用「一般資訊」頁上的核取方塊來將物件靜音或取消靜音。
|
|
• 當您第一次使用 Axeda 資產範本建立物件時，「已靜音」欄位可能不會立即顯示在物件的「一般資訊」頁上。欲檢視欄位，請稍等片刻，然後重新整理 Composer；或關閉物件 (實體)，然後重新開啟它。
如果物件不是 Axeda 裝置，新增「可變物形式」、將「已靜音」核取方塊設定為 true 以及嘗試儲存物件，都將會導致發生錯誤。
• 靜音和取消靜音動作僅支援透過靜音與取消靜音服務或 Composer UI 執行。建議不要透過 xml 匯入來變更靜音組態。
• 下列錯誤訊息在使用靜音與取消靜音功能的情況下適用：
◦ 嘗試將非 Axeda 遠端物件靜音時：Muting/Unmuting is not supported for this Thing.
◦ 嘗試將受管理物件靜音時：Muting/Unmuting of managed Things is not supported.
◦ 執行「閘道」時，如果受管理物件無法靜音：An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
檢查資產是靜音還是取消靜音
欲檢查物件是已靜音還是已取消靜音狀態，請使用下列方法：
• 服務
隨附於最新 ThingWorx 與 ThingWorx 延伸功能，IsMuted 服務可用於 (透過「可變物形式」) 以 Axeda 為基礎的遠端物件。
IsMuted：此服務會顯示物件是否已靜音。
• Composer
◦ 在「遠端物件」頁的「監視」下，使用者可以看到新欄「已靜音」。如果物件已靜音，它會顯示「是」，如果物件已取消靜音，它會顯示「否」，且如果有非 Axeda 物件，它將會在回應中顯示「不適用」。
◦ 在「遠端物件」頁的「監視」下，使用「已靜音」篩選器可查看哪些物件已靜音及取消靜音。
◦ 在物件的「一般資訊」頁上，將會顯示「已靜音」核取方塊。
資產靜音與取消靜音的行為
閘道
◦ 如果「閘道」已靜音，則與「閘道」相關聯的受管理物件將會自動靜音。
◦ 如果將「閘道」靜音，無法將受管理物件取消靜音。
◦ 如果「閘道」已取消靜音，則與「閘道」相關聯的受管理物件將會自動取消靜音。
◦ 如果將「閘道」取消靜音，無法將受管理物件靜音。
以 Axeda 為基礎之遠端物件的內容
當物件已靜音時，任何包含遠端內容的內容更新都會失敗，並顯示 AssetMutedException。
例如，會看到 Thing is Muted, Unable to update <propertyName> on <thingName> 錯誤。
以 Axeda 為基礎之遠端物件的服務
當物件已靜音時，嘗試執行任何遠端服務都將會失敗，並顯示 AssetMutedException。
例如，會看到 Thing is Muted, Unable to invoke <ServiceName> on <thingName> 錯誤。
檔案傳輸操作
如果物件已靜音，新檔案傳輸操作會因 AssetMutedException 而失敗。
即使是已靜音物件，使用中檔案傳輸操作也能繼續運作。
遠端工作階段
◦ 如果物件已靜音，新遠端工作階段會因例外而失敗。
例如：You are not allowed to start a remote session on a muted asset <name>.
◦ 即使物件已靜音，使用中遠端工作階段仍將繼續運作。
靜音與取消靜音的使用者權限
會新增名為 MuteUnmuteUsers 的現成使用者群組，讓所選使用者群組將資產靜音及取消靜音。就服務權限而言，它將遵循「ThingWorx 權限」範例。如需詳細資訊，請參閱使用者群組。
稽核記錄
如果啟用稽核記錄，則會記錄下列記錄項目：
• 動作的類型：靜音或取消靜音。
• 受影響物件的名稱。
• 包含動作日期與時間的時間戳記。
• 執行動作的使用者類型。
