アセットのミュートとミュート解除
アセットのミュートは Thing とプラットフォームの間のすべての通信をブロックするプロセスであり、プラットフォームに対して指示した Thing へのメッセージは送信も保持もされません。同様に、Thing がプラットフォームに送信しようとするメッセージもブロックされ、保持されません。
Thing をミュートする機能は、さまざまなビジネスケースで役立ちます。プラットフォームにより、通信の頻度が低い Thing がデプロイされたり、不正確または不要なメッセージが送信されたりする可能性があります。たとえば、エージェントが送信するデータの量やプラットフォームとの通信頻度に関する懸念がある場合、Thing をミュートすることで即座に問題を解決できます。Thing をミュートすると、Thing との間のメッセージが停止し、プラットフォーム管理者が通信パターン、データ量、転送速度のトラブルシューティングを行う時間を確保できます。
Thing のミュート/ミュート解除機能は、AxedaBaseModel Thing Template またはそこから派生した Thing Template を使用して作成された Axeda ベースの Remote Thing にのみ適用されます。Axeda Thing Template の詳細については、「ACE Thing Template」を参照してください。
• ユーザーは、AxedaStandaloneModel Thing Template、AxedaEMessageGatewayModel Thing Template を使用して作成された Thing をミュートまたはミュート解除できます。ゲートウェイ Thing がミュートまたはミュート解除されると、その管理対象デバイスも自動的にミュートまたはミュート解除されます。
• ミュートまたはミュート解除は、AxedaManagedModel Thing Template を使用して管理されるデバイスではサポートされません。管理対象デバイスのミュートまたはミュート解除は、そのゲートウェイ Thing を使用して行う必要があります。
• AxedaBaseModel Thing Template を使用して作成された Axeda ベースの Remote Thing では、ミュート可能な Thing Shape が自動的に実装されます。その他のすべての Thing では、ミュート可能な Thing Shape を実装すると、例外が発生します。
ミュートおよびミュート解除機能を使用するには、ThingWorx 9.7.0 および Axeda Compatibility Package 2.6.0 (eMessage Server、Axeda Compatibility Extension、Remote Access Extension を含む) を使用します。互換性のあるバージョンの詳細については、Release Advisorを参照してください。
Axeda ベースの Remote Thing のミュートとミュート解除
Thing をミュートまたはミュート解除するには、次の方法を使用します。
• サービス:
ミュート可能な ThingShape を介して、Axeda ベースの Remote Thing で次の 2 つのサービスを使用できます。
◦ Mute: このサービスは Thing をミュートし、Thing とプラットフォームの間のすべての通信をブロックします。Thing がゲートウェイの場合は、すべての管理対象 Thing もミュートされます。
◦ Unmute: このサービスは Thing のミュートを解除し、Thing とプラットフォームの間のすべての通信を許可します。Thing がゲートウェイの場合は、すべての管理対象 Thing のミュートも解除されます。
• Composer UI
Axeda デバイスの場合のみ、「一般情報」ページのチェックボックスを使用して Thing をミュートまたはミュート解除できます。
 |
• Axeda アセットテンプレートを使用して Thing を初めて作成する場合は、その Thing の「一般情報」ページに「ミュート」フィールドが表示されるまでに少し時間がかかります。しばらく待ってから、「ミュート」フィールドを表示するには、Thing (エンティティ) を閉じて再度開くか、Composer を再表示します。
• Thing が Axeda デバイスでない場合は、ミュート可能な ThingShape を追加し、「ミュート」チェックボックスをオンに設定して、その Thing を保存しようとすると、エラーが発生します。
• デバイスのミュートとミュート解除は、ミュートサービスおよびミュート解除サービスを介して、Composer UI でのみサポートされています。xml インポートを使用してミュートのコンフィギュレーションを変更しないようにしてください。
• ミュートとミュート解除の機能では、次のエラーメッセージが表示されます。
◦ Axeda 以外の Remote Thing をミュートしようとした場合: Muting/Unmuting is not supported for this thing.
◦ 管理対象 Thing をミュートしようとした場合: Muting/Unmuting of managed Things is not supported.
◦ ゲートウェイの実行中に、管理対象 Thing のミュートに失敗した場合: An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
アセットがミュートまたはミュート解除されていることの確認
Thing がミュートまたはミュート解除されているかどうかを確認するには、次の方法を使用します。
• サービス
最新の ThingWorx および ThingWorx 拡張機能では、Axeda ベースの Remote Thing に対して (ミュート可能な ThingShape を介して) IsMuted サービスを使用できます。
IsMuted: このサービスは、Thing がミュートされているかどうかを示します。
• Composer
◦ 「Remote Thing」ページの「監視」に、新しい列「ミュート」が表示されます。Thing がミュートされている場合は「はい」、Thing がミュート解除されている場合は「いいえ」、Axeda 以外の Thing がある場合は「該当なし」と応答に表示されます。
◦ 「Remote Thing」ページの「監視」で、「ミュート」フィルタを使用して、ミュートされている Thing とミュート解除されている Thing を確認します。
◦ Thing の「一般情報」ページに、「ミュート」チェックボックスが表示されます。
アセットのミュートとミュート解除の動作
ゲートウェイ
◦ ゲートウェイがミュートされると、そのゲートウェイに関連付けられている管理対象の Thing も自動的にミュートされます。
◦ ゲートウェイがミュートされているときに、管理対象の Thing をミュート解除することはできません。
◦ ゲートウェイがミュート解除されると、そのゲートウェイに関連付けられている管理対象の Thing も自動的にミュート解除されます。
◦ ゲートウェイがミュート解除されているときに、管理対象の Thing をミュートすることはできません。
Axeda ベースの Remote Thing のプロパティ
Thing がミュートされている場合、リモートプロパティを使用したプロパティの更新は AssetMutedException によって失敗します。
たとえば、「Thing is Muted, Unable to update <プロパティ名> on <Thing 名>」というエラーが表示されます。
Axeda ベースの Remote Thing のサービス
Thing がミュートされている場合、リモートサービスを実行しようとすると、AssetMutedException によって失敗します。
たとえば、「Thing is Muted, Unable to invoke <サービス名> on <Thing 名>」というエラーが表示されます。
ファイル転送操作
Thing がミュートされている場合、新しいファイル転送操作は AssetMutedException によって失敗します。
アクティブなファイル転送操作は、ミュートされた Thing に対しても引き続き機能します。
リモートセッション
◦ Thing がミュートされている場合、新しいリモートセッションは例外によって失敗します。
例: You are not allowed to start a remote session on a muted asset <name>.
◦ アクティブなリモートセッションは、Thing がミュートされても引き続き機能します。
ミュートとミュート解除に対するユーザーのアクセス許可
MuteUnmuteUsers という名前の既成のユーザーグループが追加され、選択したグループのユーザーがアセットをミュートおよびミュート解除できるようになりました。サービスのアクセス許可に関するかぎり、これは ThingWorx アクセス許可の枠組みに従います。詳細については、ユーザーグループを参照してください。
監査ログ
監査ログが有効になっている場合、以下のログエントリがログに記録されます。
• 操作のタイプ: ミュートまたはミュート解除。
• 影響を受ける Thing の名前。
• 操作の日時を示すタイムスタンプ。
• 操作を実行したユーザータイプ。
