ThingWorx Modelldefinition in Composer > Modellierung > Dinggruppen > Dinggruppen-Dienste
Dinggruppen-Dienste
Dinggruppen-Dienste
Die folgenden Dienste stehen für die Verwaltung von Dinggruppen zur Verfügung. Alle Dienste unten außer AssignMembers und ClearMembers prüfen die Sichtbarkeitsberechtigungen von Mitgliedsentitäten für den aktuellen Benutzer, der diese Dienste aufruft. Für diese Dienste gelten die folgenden Verhaltensweisen:
• Wenn ein Nicht-Administrator entsprechende ClearMembers-Laufzeitberechtigungen erhält und den ClearMembers-Dienst für eine Dinggruppe ausführt, werden alle Mitglieder aus der Dinggruppe gelöscht, unabhängig davon, ob der Nicht-Administrator über Sichtbarkeitsberechtigungen für Mitglieder innerhalb der Dinggruppe verfügt.
• Wenn ein Nicht-Administrator entsprechende AssignMembers-Laufzeitberechtigungen erhält und den AssignMembers-Dienst für eine Dinggruppe ausführt, werden alle Mitglieder aus der Dinggruppe gelöscht, unabhängig davon, ob der Nicht-Administrator über Sichtbarkeitsberechtigungen für vorhandene Mitglieder innerhalb der Dinggruppe verfügt. Der Dienst wird nur erfolgreich ausgeführt, wenn der Nicht-Administrator über Sichtbarkeitsberechtigungen für die neuen Mitglieder in der AssignMembers-Dienstaufruf-Payload verfügt.
• Wenn ein Nicht-Administrator die entsprechenden Laufzeitberechtigungen für Dienstaufrufe für die Dienste zum Hinzufügen und Löschen erhält und er einen dieser Dienste für eine Dinggruppe ausführt, wird dieser nur erfolgreich ausgeführt, wenn der Nicht-Administrator auch Sichtbarkeitsberechtigungen für die spezifischen hinzugefügten oder gelöschten Mitglieder hat.
• Wenn ein Nicht-Administrator die entsprechenden Laufzeitberechtigungen für Dienstaufrufe erhält und einen der Dienste zum Anrufen für eine Dinggruppe ausführt, werden nur Entitäten zurückgegeben, für die der Nicht-Administrator Sichtbarkeitsberechtigungen hat.
Dienstname
Parameter
Beschreibung
AddMembers
members – name und type des Mitglieds.
Fügt der Dinggruppe, in der der Dienst aufgerufen wird, mehrere Mitglieder (Ding und Dinggruppe) als Batch hinzu. AddMembers löscht vorhandene Mitglieder wie den AssignMembers-Dienst nicht.
AddThingGroupMember
memberName – Name einer Dinggruppe.
Fügt der Dinggruppe, in der der Dienst aufgerufen wird, ein Dinggruppen-Mitglied hinzu.
AddThingMember
memberName – Name eines Dings.
Fügt der Dinggruppe, in der der Dienst aufgerufen wird, ein Ding-Mitglied hinzu.
AssignMembers
members – name und type (Ding oder Dinggruppe) des Mitglieds.
Deaktiviert alle Mitglieder und fügt Ding- und/oder Dinggruppen-Mitglieder zur Dinggruppe hinzu, in der der Dienst aufgerufen wird.
ClearMembers
Löscht alle Mitglieder der Dinggruppe, in der der Dienst aufgerufen wird.
DeleteMembers
members – name und type des Mitglieds.
Löscht mehrere Mitglieder (Ding und Dinggruppe) als Batch der Dinggruppe, in der der Dienst aufgerufen wird.
DeleteThingGroupMember
memberName – Name einer Dinggruppe.
Löscht ein Dinggruppen-Mitglied der Dinggruppe, in der der Dienst aufgerufen wird.
DeleteThingMember
memberName – Name eines Dings.
Löscht ein Ding-Mitglied der Dinggruppe, in der der Dienst aufgerufen wird.
GetMembers
maxItems – Maximale Anzahl der zurückgegebenen Elemente.
Gibt alle Mitglieder (Ding und Dinggruppe, nur direkte Mitglieder) der Dinggruppe zurück, in der der Dienst aufgerufen wird.
GetThingGroupMembers
maxItems – Maximale Anzahl der zurückgegebenen Elemente.
Gibt alle Dinggruppen-Mitglieder (nur direkte Mitglieder) der Dinggruppe zurück, in der der Dienst aufgerufen wird.
GetThingGroupParentNames
maxItems – Maximale Anzahl der zurückgegebenen Elemente.
Gibt alle direkten Dinggruppen-Eltern für die Dinggruppe zurück, in der der Dienst aufgerufen wird.
GetThingMembers
maxItems – Maximale Anzahl der zurückgegebenen Elemente.
Gibt alle Ding-Mitglieder (nur direkte Mitglieder) der Dinggruppe zurück, in der der Dienst aufgerufen wird.
GetThingsInHierarchy
maxDepth – Maximale Tiefe der Suche. Der Standardwert 1 gibt die aktuelle Kind-Ebene der Dinggruppen-Instanz an.
maxItems – Maximale Anzahl der zurückgegebenen Elemente.
Gibt alle Dinge innerhalb der Hierarchie zurück, einschließlich Enkel- und Urenkel-Dinge. Gibt keine Dinggruppen innerhalb der Hierarchie zurück.
War dies hilfreich?