资产静音和取消静音
资产静音是阻止事物与平台之间所有通信的过程，这意味着平台既不会向事物发送任何消息，也不会保留任何消息。同样，事物尝试向平台发送的任何消息均会被阻止，且不会保留。
事物静音功能对于多种商业案例都很有价值。平台可能会部署不经常通信的事物，且可能发送不准确或不必要的消息。例如，如果担心代理发送的数据量或代理与平台的通信频率，将事物静音可以立即缓解这种情况。将事物静音会停止与事物之间的消息往来，从而使平台管理员有时间对通信模式、数据量和传输速率进行故障排除。
事物静音或取消静音功能仅适用于基于 Axeda 的远程事物，这些事物是使用 AxedaBaseModel 事物模板或其衍生事物模板创建的。有关 Axeda 事物模板的详情，请参阅 ACE 事物模板。
• 用户可使用 AxedaStandaloneModel、AxedaEMessageGatewayModel 事物模板将创建的事物静音或取消静音。将网关事物静音或取消静音时，其托管的设备将自动静音或取消静音。
• 使用 AxedaManagedModel 事物模板托管的设备不支持静音或取消静音。对托管的设备进行静音或取消静音必须通过其网关事物来完成。
• 对于使用 AxedaBaseModel 事物模板创建的基于 Axeda 的远程事物，将自动实施可变事物形态。对于所有其他事物，实施可变事物形态将抛出异常。
要使用静音和取消静音功能，请使用 ThingWorx 9.7.0 和 Axeda Compatibility Package 2.6.0 (包括 eMessage 服务器、Axeda Compatibility Extension 和 Remote Access Extension)。有关兼容版本的详情，请参阅 Release Advisor。
将基于 Axeda 的远程事物静音和取消静音
要将事物静音或取消静音，可使用以下方式：
• 服务：
借助可变事物形态，基于 Axeda 的远程事物可使用以下两种服务。
◦ Mute：此服务可将事物静音并阻止事物与平台之间的所有通信。如果事物为网关，此服务还会静音所有托管的事物。
◦ Unmute：此服务可将事物取消静音，并允许事物与平台之间进行的所有通信。如果事物为网关，此服务还会取消静音所有托管的事物。
• Composer 用户界面
用户可以通过“常规信息”页面上的复选框将事物静音或取消静音 (仅限 Axeda 设备)。
 |
• 首次使用 Axeda 资产模板创建事物时，要查看事物“常规信息”页面上的“静音”字段，需要等待一段时间。等待之后，要查看“静音”字段，请关闭或重新打开事物 (实体)，或者刷新 Composer。
• 如果事物不是 Axeda 设备，则添加可变事物形态、将“静音”复选框设置为 true 并尝试保存事物时，将会出错。
• 仅支持通过静音和取消静音服务以及 Composer 用户界面进行设备的静音和取消静音。建议不要通过 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 权限范例。有关详情，请参阅用户组。
审计日志
如果启用了审计日志，则会记录以下日志条目：
• 操作类型：静音或取消静音。
• 受影响事物的名称。
• 带有操作日期和时间的时间戳。
• 已执行操作的用户类型。
