Definición del modelo de ThingWorx en Composer > Modelado > Grupos de cosas > Servicios de grupos de cosas
Servicios de grupos de cosas
Servicios de grupo de cosas
Los siguientes servicios están disponibles para la gestión de grupos de cosas. Todos los servicios que se indican a continuación, excepto AssignMembers y ClearMembers, verifican los permisos de visibilidad de las entidades de miembro con el usuario actual que invoca dichos servicios. A estos servicios se aplican los siguientes comportamientos:
• Si a un usuario, que no es administrador, se le dan los permisos adecuados de tiempo de ejecución de ClearMembers y el usuario ejecuta el servicio ClearMembers en un grupo de cosas, se borran todos los miembros del grupo de cosas, independientemente de si el usuario que no es administrador tiene visibilidad sobre los miembros del grupo de cosas.
• Si a un usuario, que no es administrador, se le dan los permisos adecuados de tiempo de ejecución de AssignMembers y el usuario ejecuta el servicio AssignMembers en un grupo de cosas, se borran todos los miembros del grupo de cosas, independientemente de si el usuario que no es administrador tiene visibilidad sobre los miembros existentes dentro del grupo de cosas. El servicio solo se ejecutará correctamente si el usuario que no es administrador tiene visibilidad para los nuevos miembros de la carga útil de llamada del servicio AssignMembers.
• Si a un usuario, que no es administrador, se le dan los permisos de tiempo de ejecución para invocar al servicio adecuados para los servicios de añadir y borrar, y el usuario ejecuta alguno de estos servicios en un grupo de cosas, solo se ejecutará correctamente si el usuario que no es administrador también tiene permisos de visibilidad para los miembros específicos que se añaden o borran.
• Si a un usuario, que no es administrador, se le dan los permisos adecuados de tiempo de ejecución para invocar al servicio y el usuario ejecuta cualquiera de los servicios Obtener en un grupo de cosas, solo se devolverán las entidades para las que el usuario que no es administrador tiene visibilidad.
Nombre del servicio
Parámetros
Descripción
AddMembers
members: los parámetros name y type del miembro.
Permite añadir varios miembros (cosa y grupo de cosas) como lote al grupo de cosas en el que se llama al servicio. AddMembers no despeja los miembros existentes, como sucede con el servicio AssignMembers.
AddThingGroupMember
memberName: nombre de un grupo de cosas.
Permite añadir un miembro de grupo de cosas al grupo de cosas en el que se llama al servicio.
AddThingMember
memberName: nombre de una cosa.
Permite añadir un miembro de cosa al grupo de cosas en el que se llama al servicio.
AssignMembers
members: los parámetros name y type (cosa o grupo de cosas) del miembro.
Permite despejar todos los miembros y añadir miembros de cosa o grupo de cosas al grupo de cosas en el que se llama al servicio.
ClearMembers
Permite borrar todos los miembros del grupo de cosas en el que se llama al servicio.
DeleteMembers
members: los parámetros name y type del miembro.
Permite borrar varios miembros (cosa y grupo de cosas) como un lote del grupo de cosas en el que se llama al servicio.
DeleteThingGroupMember
memberName: nombre de un grupo de cosas.
Permite borrar un miembro de grupo de cosas del grupo de cosas en el que se llama al servicio.
DeleteThingMember
memberName: nombre de una cosa.
Permite borrar un miembro de cosa del grupo de cosas en el que se llama al servicio.
GetMembers
maxItems: el número máximo de elementos devueltos.
Permite devolver todos los miembros (cosa y grupo de cosas, solo miembros directos) del grupo de cosa en el que se llama al servicio.
GetThingGroupMembers
maxItems: el número máximo de elementos devueltos.
Permite devolver todos los miembros de grupo de cosas (solo miembros directos) del grupo de cosas en el que se llama al servicio.
GetThingGroupParentNames
maxItems: el número máximo de elementos devueltos.
Permite devolver todos los padres directos de grupo de cosas del grupo de cosas en el que se llama al servicio.
GetThingMembers
maxItems: el número máximo de elementos devueltos.
Permite devolver todos los miembros de cosa (solo los miembros directos) del grupo de cosas en el que se llama al servicio.
GetThingsInHierarchy
maxDepth: el nivel de profundidad máximo de la búsqueda. El valor por defecto 1 indica el nivel actual de los hijos de la instancia del grupo de cosas.
maxItems: el número máximo de elementos devueltos.
Permite devolver todas las cosas de la jerarquía, incluidas las cosas nietas y las cosas bisnietas. No se devuelven los grupos de cosas dentro de la jerarquía.
¿Fue esto útil?