自定义信息内容和访问 > 管理上下文和设备的权限 > 用于授予、传播和查看权限的服务
用于授予、传播和查看权限的服务
以下各节详细介绍了上下文管理器事物 (PTC.SCA.SCO.DefaultContextManager) 上用于对上下文和设备进行 授予权限、 传播权限和 查看权限设置的服务。
用于授予权限的服务
提供了用于向用户或用户组授予权限的服务。使用这些服务授予权限的结果如下：
• 授予 Read 权限会将读取 (Read) 权限设置为 true，写入 (Write) 权限为 false。
• 授予 Write 权限会将读取 (Read) 和写入 (Write) 权限设置为 true。
• 授予 None 权限会将读取 (Read) 和写入 (Write) 权限设置为 false。
这些服务中的权限类型值 (Read、Write、和 None) 和实体类型值 (Context 和 Equipment) 区分大小写。
以下服务可用于向用户或用户组授予权限：
服务
说明
GrantUserGroupPermissionsOnEntities
授予指定的用户组对指定实体的特定权限 (Read、Write 或 None)。可以对该服务的同一个执行实例同时指定上下文和设备两种实体。将实体添加到 entities 信息表时，请提供以下信息：
• Name - 上下文或设备事物在 ThingWorx Composer 中的显示名称。
• Type - 输入实体类型：Context 或 Equipment。
GrantUserPermissionsOnEntities
授予指定的用户对指定实体的特定权限 (Read、Write 或 None)。可以对该服务的同一个执行实例同时指定上下文和设备两种实体。将实体添加到 entities 信息表时，请提供以下信息：
• Name - 上下文或设备事物在 ThingWorx Composer 中的显示名称。
• Type - 输入实体类型：Context 或 Equipment。
GrantPermissionsOnEntities
上述服务所用的基础服务。不适合独立使用。
用于传播权限的服务
以下服务可用于授予对特定实体 (设备) 的权限，并将该权限传播至该实体在上下文的设备结构中的所有子项。
这些服务中的权限类型值 (Read、Write和 None) 区分大小写。
服务
说明
PropagateUserGroupPermissionsOnEntities
授予指定用户组对指定上下文中实体 (设备) 的特定权限 (Read、Write 或 None)。
• 如果将 entityName 参数留空，则指定的权限将被授予至指定上下文中所有设备上的指定用户组。
• 如果为 entityName 参数指定了一个实体，则为指定用户组授予对指定上下文中该实体的指定权限，并将该权限传播至该实体在设备结构中的所有子项。
PropagateUserPermissionsOnEntities
授予指定用户对指定上下文中实体 (设备) 的特定权限 (Read、Write 或 None)。
• 如果将 entityName 参数留空，则指定的权限将被授予指定上下文中所有设备上的指定用户。
• 如果为 entityName 参数指定了一个实体，则为指定用户授予对指定上下文中该实体的指定权限，并将该权限传播至该实体在设备结构中的所有子项。
PropagatePermissionsOnEntities
上述服务所用的基础服务。不适合独立使用。
用于查看权限设置的服务
以下服务可用于查看当前权限设置。
这些服务中的权限类型值 (Read、Write和 None) 区分大小写。
服务
说明
GetContextPermissionByUser
返回指定用户对其具有权限的上下文列表，以及权限类型 (Read 或 Write)。
GetContextPermissionByUserGroup
返回指定用户组对其具有权限的上下文列表，以及权限类型 (Read 或 Write)。
GetContextsByUserAndPermission
返回指定用户对其具有指定权限 (Read 或 Write) 的上下文列表，以及每个上下文的详细信息。
GetEntityPermissionsByUserGroupOnContext
返回指定用户组在指定上下文中对其具有权限的实体 (设备) 列表，以及每个实体的权限类型 (Read 或 Write)。
GetEntityPermissionsByUserOnContext
返回指定用户在指定上下文中对其具有权限的所有实体 (设备) 列表，以及权限类型 (Read 或 Write)。
GetPermissionsByContext
对于指定的上下文，返回其中所有实体 (设备) 的列表；对于每个实体，通过一个信息表显示每个用户和用户组对该实体的权限 (Read、Write 或 None)。
GetContextPermission 和 GetEntityPermissionsOnContext
上述服务所用的基础服务。不适合独立使用。