Definizione del modello ThingWorx in Composer > Modellazione > Gruppi di oggetti > Servizi dei gruppi di oggetti
Servizi dei gruppi di oggetti
Servizi del gruppo di oggetti
Per la gestione dei gruppi di oggetti sono disponibili i servizi·descritti di seguito. Tutti i servizi, ad eccezione di AssignMembers e ClearMembers, verificano che l'utente corrente che li richiama disponga dei permessi di visibilità delle entità membro. A questi servizi si applicano i comportamenti riportati di seguito.
• Se un utente non amministratore dotato dei permessi della fase di esecuzione ClearMembers appropriati esegue il servizio ClearMembers su un gruppo di oggetti, cancella tutti i membri del gruppo, indipendentemente dal fatto di avere il permesso di visibilità per i membri stessi.
• Se un utente non amministratore dotato dei permessi ella fase di esecuzione AssignMembers appropriati esegue il servizio AssignMembers su un gruppo di oggetti, cancella tutti i membri del gruppo, indipendentemente dal fatto di avere il permesso di visibilità per i membri esistenti. L'esecuzione del servizio riesce solo se l'utente non amministratore ha il permesso di visibilità per i nuovi membri nel payload della chiamata di servizio AssignMembers.
• Se un utente non amministratore dotato dei permessi della fase di esecuzione di richiamo appropriati per i servizi di aggiunta ed eliminazione esegue uno di questi servizi in un gruppo di oggetti, l'operazione riesce solo se l'utente dispone anche dei permessi di visibilità per i membri specifici che vengono aggiunti o eliminati.
• Se un utente non amministratore dotato dei permessi appropriati della fase di esecuzione di richiamo dei servizi esegue uno dei servizi Get in un gruppo di oggetti, vengono restituite solo le entità per le quali l'utente dispone dei permessi di visibilità.
Nome servizio
Parametri
Descrizione
AddMembers
members - Il nome e il tipo di membro.
Aggiunge più membri (oggetto e gruppo di oggetti) come batch al gruppo di oggetti in cui viene chiamato il servizio. AddMembers non cancella i membri esistenti come fa il servizio AssignMembers.
AddThingGroupMember
memberName - Il nome di un gruppo di oggetti.
Aggiunge un membro del gruppo di oggetti al gruppo di oggetti in cui viene chiamato il servizio.
AddThingMember
memberName - Il nome di un oggetto.
Aggiunge un membro oggetto al gruppo di oggetti in cui viene chiamato il servizio.
AssignMembers
members - Il nome e il tipo (oggetto o gruppo di oggetti) del membro.
Cancella tutti i membri e aggiunge i membri dell'oggetto e/o del gruppo di oggetti al gruppo di oggetti in cui viene chiamato il servizio.
ClearMembers
Elimina tutti i membri del gruppo di oggetti in cui viene chiamato il servizio.
DeleteMembers
members - Il nome e il tipo di membro.
Elimina più membri (oggetto e gruppo di oggetti) come batch del gruppo di oggetti in cui viene chiamato il servizio.
DeleteThingGroupMember
memberName - Il nome di un gruppo di oggetti.
Elimina un membro del gruppo di oggetti in cui viene chiamato il servizio.
DeleteThingMember
memberName - Il nome di un oggetto.
Elimina un membro oggetto del gruppo di oggetti in cui viene chiamato il servizio.
GetMembers
maxItems - Numero massimo di elementi restituiti.
Restituisce tutti i membri (oggetto e gruppo di oggetti, solo membri diretti) del gruppo di oggetti in cui viene chiamato il servizio.
GetThingGroupMembers
maxItems - Numero massimo di elementi restituiti.
Restituisce tutti i membri del gruppo di oggetti (solo membri diretti) in cui viene chiamato il servizio.
GetThingGroupParentNames
maxItems - Numero massimo di elementi restituiti.
Restituisce tutti gli elementi padre diretti del gruppo di oggetti in cui viene chiamato il servizio.
GetThingMembers
maxItems - Numero massimo di elementi restituiti.
Restituisce tutti i membri oggetto (solo membri diretti) del gruppo di oggetti in cui viene chiamato il servizio.
GetThingsInHierarchy
maxDepth - Livello massimo di profondità di ricerca. Il valore di default 1 indica il livello dei figli dell'istanza del gruppo di oggetti corrente.
maxItems - Numero massimo di elementi restituiti.
Restituisce tutti gli oggetti all'interno della gerarchia, compresi gli oggetti nipoti e pronipoti. Non restituisce gruppi di oggetti all'interno della gerarchia.
È stato utile?