Assets stummschalten und Stummschaltung aufheben
Beim Stummschalten von Assets wird die gesamte Kommunikation zwischen einem Ding und der Plattform blockiert. Wenn ein Ding stummgeschaltet wird, werden Nachrichten von der Plattform an das Ding weder gesendet noch beibehalten. Ebenso werden Nachrichten, die vom Ding an die Plattform gesendet werden, ebenfalls blockiert und nicht beibehalten.
Die Möglichkeit, Dinge stummzuschalten, ist für verschiedene geschäftliche Anwendungsfälle nützlich. Die Plattform stellt möglicherweise Dinge bereit, die nicht häufig kommunizieren, und wenn sie online sind, können sie ungenaue oder unnötige Nachrichten senden. Wenn beispielsweise Bedenken hinsichtlich des Datenvolumens bestehen, das ein Agent sendet, oder der Häufigkeit seiner Kommunikation mit der Plattform, kann das Stummschalten des Dings sofortige Abhilfe schaffen. Durch das Stummschalten des Dings werden Nachrichten von und zu dem Ding gestoppt, sodass Plattformadministratoren Zeit haben, Probleme mit Kommunikationsmustern, Datenvolumen und Übertragungsraten zu beheben.
Die Funktion zum Stummschalten oder Aufheben der Stummschaltung von Dingen gilt nur für Remote-Dinge auf Axeda Basis, die mit der Dingvorlage AxedaBaseModel oder der davon abgeleiteten Dingvorlagen erstellt werden. Weitere Informationen zu Axeda Dingvorlagen finden Sie unter ACE Thing Templates.
• Benutzer können Dinge, die mithilfe der Dingvorlagen AxedaStandaloneModel und AxedaEMessageGatewayModel erstellt wurden, stummschalten oder deren Stummschaltung aufheben. Wenn ein Gateway-Ding stummgeschaltet bzw. seine Stummschaltung aufgehoben wird, werden die ihm zugeordneten verwalteten Geräte automatisch stummgeschaltet bzw. deren Stummschaltung aufgehoben.
• Das Stummschalten bzw. Aufheben der Stummschaltung wird für Geräte, die mit der Dingvorlage AxedaManagedModel verwaltet werden, nicht unterstützt. Das Stummschalten bzw. Aufheben der Stummschaltung eines verwalteten Geräts muss über das zugehörige Gateway-Ding erfolgen.
• Die stummschaltbare Dingform wird automatisch für Axeda-basierte Remote-Dinge implementiert, die mit den Dingvorlagen AxedaBaseModel erstellt werden. Für alle anderen Dinge löst die Implementierung der stummschaltbaren Dingform eine Ausnahme aus.
Wenn Sie die Funktion zum Stummschalten und Aufheben der Stummschaltung verwenden möchten, benötigen Sie ThingWorx 9.7.0 und das Axeda Compatibility Package 2.6.0 (einschließlich eMessage Server, der Erweiterung Axeda Compatibility und der Erweiterung Remote Access). Weitere Informationen zu kompatiblen Versionen finden Sie im Release Advisor.
 |
Sie müssen über Sichtbarkeitsberechtigungen für die Dingformen Mutable, MutableGateway und MutableManagedDevice verfügen, um Dinge manuell oder programmgesteuert basierend auf der Dingvorlage AxedaBaseModel oder ihren abgeleiteten Dingvorlagen erstellen zu können.
|
Auf Axeda basierende Remote-Dinge stummschalten und ihre Stummschaltung aufheben
Verwenden Sie die folgenden Methoden, um ein Ding stummzuschalten oder seine Stummschaltung aufzuheben:
• Dienste:
Für Axeda-basierte Remote-Dinge stehen über die stummschaltbare Dingform zwei Dienste zur Verfügung.
◦ Mute: Dieser Dienst schaltet das Ding stumm und blockiert die gesamte Kommunikation zwischen einem Ding und der Plattform. Wenn es sich bei dem Ding um einen Gateway handelt, werden auch alle verwalteten Dinge stummgeschaltet.
◦ Unmute: Dieser Dienst hebt die Stummschaltung des Dings auf und lässt die gesamte Kommunikation zwischen einem Ding und der Plattform zu. Wenn es sich bei dem Ding um einen Gateway handelt, wird auch die Stummschaltung aller verwalteten Dinge aufgehoben.
• Benutzeroberfläche von Composer
Der Benutzer kann das Ding nur für Axeda Geräte über das entsprechende Kontrollkästchen auf der Seite Allgemeine Informationen stummschalten oder seine Stummschaltung aufheben.
|
|
• Wenn Sie ein Ding zum ersten Mal mit den Axeda Asset-Vorlagen erstellen, wird das Feld Stummgeschaltet möglicherweise nicht sofort auf der Seite Allgemeine Informationen des Dings angezeigt. Warten Sie einen Augenblick, bis das Feld angezeigt wird, und aktualisieren Sie dann Composer, oder schließen Sie das Ding (die Entität), und öffnen Sie es erneut.
Wenn das Ding kein Axeda-Gerät ist, führen das Hinzufügen der stummschaltbaren Dingform, das Aktivieren des Kontrollkästchens Stummgeschaltet und der Versuch, das Ding zu speichern, zu einem Fehler.
• Das Stummschalten und Aufheben der Stummschaltung wird nur über die Dienste zum Stummschalten und Aufheben der Stummschaltung oder über die Composer-Benutzeroberfläche unterstützt. Es wird empfohlen, die Stummschalten-Konfiguration nicht über den XML-Import zu ändern.
• Die folgenden Fehlermeldungen sind beim Verwenden der Funktionen zum Stummschalten oder zum Aufheben der Stummschaltung verfügbar:
◦ Beim Versuch, ein Nicht-Axeda-Remote-Ding stummzuschalten: Muting/Unmuting is not supported for this Thing.
◦ Beim Versuch, ein verwaltetes Ding stummzuschalten: Muting/Unmuting of managed Things is not supported.
◦ Wenn das verwaltete Ding während der Ausführung eines Gateway nicht stummgeschaltet werden kann, gilt Folgendes: An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
Prüfen, ob ein Asset stummgeschaltet oder seine Stummschaltung aufgehoben ist
Verwenden Sie die folgenden Methoden, um zu prüfen, ob ein Ding stummgeschaltet ist oder nicht:
• Dienste
Mit der neuesten ThingWorx Version und den ThingWorx Erweiterungen und ist der Dienst IsMuted (über die stummschaltbare Dingform) für Axeda-basierte Remote-Dinge verfügbar.
IsMuted: Dieser Dienst zeigt an, ob das Ding stummgeschaltet ist.
• Composer
◦ Unter Überwachung auf der Seite Remote-Dinge wird dem Benutzer eine neue Spalte Stummgeschaltet angezeigt. Wenn das Ding stummgeschaltet ist, wird Ja angezeigt, wenn die Stummschaltung des Dings aufgehoben ist, wird Nein angezeigt, und im Fall von Nicht-Axeda-Dingen wird in der Antwort Nicht zutreffend angezeigt.
◦ Verwenden Sie unter Überwachung auf der Seite Remote-Dinge den Filter Stummgeschaltet, um anzuzeigen, welche Dinge stummgeschaltet sind und für welche die Stummschaltung aufgehoben ist.
◦ Auf der Seite Allgemeine Informationen des Dings wird das Kontrollkästchen Stummgeschaltet angezeigt.
Verhalten beim Stummschalten und Aufheben der Stummschaltung für Assets
Gateway
◦ Wenn das Gateway stummgeschaltet wird, werden die dem Gateway zugeordneten verwalteten Dinge automatisch stummgeschaltet.
◦ Wenn das Gateway stummgeschaltet ist, kann die Stummschaltung des verwalteten Dings nicht aufgehoben werden.
◦ Wenn die Stummschaltung des Gateways aufgehoben wird, wird die Stummschaltung der dem Gateway zugeordneten verwalteten Dinge automatisch aufgehoben.
◦ Wenn die Stummschaltung des Gateways aufgehoben ist, kann das verwaltete Ding nicht stummgeschaltet werden.
Eigenschaften des auf Axeda basierenden Remote-Dings
Wenn ein Ding stummgeschaltet ist, schlägt jede Eigenschaftsaktualisierung mit der Remote-Eigenschaft AssetMutedException fehl.
Beispielsweise wird der Fehler Thing is Muted, Unable to update <Eigenschaftsname> on <Dingname> angezeigt.
Dienst des auf Axeda basierenden Remote-Dings
Wenn ein Ding stummgeschaltet ist, schlägt der Versuch, einen Remotedienst auszuführen, mit AssetMutedException fehl.
Beispielsweise wird der Fehler Thing is Muted, Unable to invoke <Dienstname> on <Dingname> angezeigt.
Dateiübertragungsoperationen
Wenn das Ding stummgeschaltet ist, schlagen neue Dateiübertragungsoperationen mit AssetMutedException fehl.
Aktive Dateiübertragungsoperationen werden auch für stummgeschaltete Dinge weiterhin ausgeführt.
Remotesitzungen
◦ Wenn das Ding stummgeschaltet ist, schlagen neue Remotesitzungen mit einer Ausnahme fehl.
Beispiel: You are not allowed to start a remote session on a muted asset <name>.
◦ Aktive Remotesitzungen werden auch für stummgeschaltete Dinge weiterhin ausgeführt.
Benutzerberechtigungen zum Stummschalten und Aufheben der Stummschaltung
Eine vordefinierte Benutzergruppe namens MuteUnmuteUsers wird hinzugefügt, die es einer ausgewählten Gruppe von Benutzern ermöglicht, Assets stummzuschalten und die Stummschaltung aufzuheben. In Bezug auf die Dienstberechtigungen folgt sie dem Paradigma der ThingWorx Berechtigungen. Weitere Informationen finden Sie unter Benutzergruppen.
Prüfungsprotokolle
Wenn die Prüfungsprotokolle aktiviert sind, werden die folgenden Protokolleinträge festgehalten:
• Art der Aktion: Stummschalten oder Stummschaltung aufheben
• Name des betroffenen Dings
• Zeitstempel mit Datum und Uhrzeit der Aktion
• Benutzertyp, der die Aktion ausgeführt hat
