Composer 中的 ThingWorx 模型定义 > 建模 > 事物组 > 事物组服务
事物组服务
事物组服务
以下服务适用于事物组管理。以下所有服务 (除 AssignMembers 与 ClearMembers 外) 将针对调用这些服务的当前用户检查成员实体的可见性权限。以下行为适用于这些服务：
• 如果非管理员用户已获得适当的 ClearMembers 运行时权限，且其在事物组上运行 ClearMembers 服务，则无论该非管理员用户对事物组内的成员具有可见性与否，均会清除事物组中的所有成员。
• 如果非管理员用户已获得适当的 AssignMembers 运行时权限，且其在事物组上运行 AssignMembers 服务，则无论该非管理员用户对事物组内的现有成员具有可见性与否，均会清除事物组中的所有成员。只有当非管理员用户对 AssignMembers 服务调用有效负载中的新成员具有可见性时，服务才会成功执行。
• 如果非管理员用户已获得“添加”和“删除”服务的相应服务调用运行时权限，并且其在事物组上运行其中任一服务，则只有在非管理员用户对添加或删除的特定成员具有可见性权限时，才会成功执行此操作。
• 如果非管理员用户已获得相应服务调用运行时权限，并且其在事物组上运行其中任一“获取”服务，将仅返回非管理员用户具有可见性权限的实体。
服务名称
参数
说明
AddMembers
members - 成员的 name 和 type。
用于以批处理方式将多个成员 (事物和事物组) 添加到调用该服务的事物组中。与 AssignMembers 服务不同，AddMembers 不会清除现有成员。
AddThingGroupMember
memberName - 事物组的名称。
用于将一个事物组成员添加到调用该服务的事物组中。
AddThingMember
memberName - 事物的名称。
用于将一个事物成员添加到调用该服务的事物组中。
AssignMembers
members - 成员的 name 和 type (事物或事物组)。
用于清除所有成员，并将事物和/或事物组成员添加到调用该服务的事物组中。
ClearMembers
用于删除调用该服务的事物组中的所有成员。
DeleteMembers
members - 成员的 name 和 type。
用于以批处理方式删除调用该服务的事物组中的多个成员 (事物和事物组)。
DeleteThingGroupMember
memberName - 事物组的名称。
用于删除调用该服务的事物组中的一个事物组成员。
DeleteThingMember
memberName - 事物的名称。
用于删除调用该服务的事物组中一个事物成员。
GetMembers
maxItems - 返回项的最大数量。
将返回调用该服务的事物组中的所有成员 (事物和事物组，仅限直接成员)。
GetMembersV2
maxItems - 返回项的最大数量。
将返回调用该服务的事物组中的所有成员 (事物和事物组，仅限直接成员)。此服务还会返回 accessModifier、Deprecated、ProjectName 和 Namespace 属性。
GetThingGroupMembers
maxItems - 返回项的最大数量。
将返回调用该服务的事物组的所有事物组成员 (仅限直接成员)。
GetThingGroupParentNames
maxItems - 返回项的最大数量。
用于删除调用该服务的事物组中所有直接事物组父项。
GetThingMembers
maxItems - 返回项的最大数量。
将返回调用该服务的事物组的所有事物成员 (仅限直接成员)。
GetThingsInHierarchy
maxDepth - 深度搜索的最大级别。默认值 1 表示当前事物组实例子项级别。
maxItems - 返回的项的最大数量。
将返回层次结构内的所有事物，包括孙项事物和曾孙事物。不会返回层次结构内的事物组。
这对您有帮助吗?