Utilizzo del servizio GetWhereUsed
Il servizio GetWhereUsed consente di visualizzare le relazioni di un'entità in ThingWorx. È possibile determinare la posizione in cui un'entità o le relative caratteristiche, ad esempio un servizio o una proprietà, vengono utilizzate in ThingWorx. Questo può risultare utile quando si ha necessità di apportare modifiche alle entità e di conoscerne gli effetti in altre posizioni nel modello. Questa funzionalità è disponibile anche nella vista entità in Composer. Per ulteriori informazioni, vedere Referenziato da.
 |
Il servizio GetWhereUsed è disponibile in ThingWorx 9.3 e versioni successive.
|
Parametri
|
Parametro
|
Tipo di base
|
Descrizione
|
|---|---|---|
|
query
|
JSON
|
Filtra i risultati.
|
|
charType
|
STRING
|
Filtra i risultati per tutti gli utilizzi delle caratteristiche di un'entità. Gli input possibili sono ALL, Property, Service/Event e LocalizationToken.
|
|
charName
|
STRING
|
Filtra i risultati per tutti gli utilizzi di una caratteristica specifica di un'entità.
|
Esempio di filtro di interrogazione
Utilizzando il filtro riportato di seguito per GetWhereUsed, vengono restituiti solo i mashup con nome MashupA.
{"filters":
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
Risultati di GetWhereUsed per tipo di entità
Nella tabella seguente sono illustrati i risultati che vengono restituiti quando si utilizzano i parametri charType e/o charName opzionali: N/D indica che l'input è vuoto. Gli oggetti di sistema non fanno parte dei risultati di GetWhereUsed.
|
|
Per le righe in cui è indicato "ALL o Service/Event", se si seleziona uno di questi input per charType, si otterrà lo stesso output perché questo tipo di entità presenta solo caratteristiche di tipo Service/Event.
|
|
Tipo di entità
|
charType
|
charName
|
Risultato
|
|---|---|---|---|
|
Tutti i tipi di entità
|
n/d
|
n/d
|
Fa riferimento agli utilizzi dell'entità specifica.
|
|
Authenticator
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità Authenticator specifica.
|
|
Authenticator
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità Authenticator specifica.
|
|
DirectoryService
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità DirectoryService specifica.
|
|
DirectoryService
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità DirectoryService specifica.
|
|
LocalizationTable
|
n/d
|
n/d
|
Fa riferimento agli utilizzi della tabella di localizzazione.
|
|
LocalizationTable
|
ALL o LocalizationToken
|
n/d
|
Fa riferimento agli utilizzi di tutti i token della tabella di localizzazione.
|
|
LocalizationTable
|
ALL o LocalizationToken
|
TokenName
|
Fa riferimento a tutti gli utilizzi del token TokenName specifico della tabella di localizzazione.
|
|
NotificationDefinition
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità NotificationDefinition specifica.
|
|
NotificationDefinition
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità NotificationDefinition specifica.
|
|
Project
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità Project specifica.
|
|
Project
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità Project specifica.
|
|
Subsystem
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità Subsystem specifica.
|
|
Subsystem
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità Subsystem specifica.
|
|
Thing
|
ALL
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità Thing specifica.
|
|
Thing
|
ALL
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità Thing specifica.
|
|
Thing
|
Property
|
n/d
|
Fa riferimento a tutti gli utilizzi delle proprietà per l'entità Thing specifica.
|
|
Thing
|
Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi di servizi ed eventi per l'entità Thing specifica.
|
|
ThingGroup
|
ALL o Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità ThingGroup specifica.
|
|
ThingGroup
|
ALL o Service/Event
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità ThingGroup specifica.
|
|
ThingShape
|
ALL
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità ThingShape specifica.
|
|
ThingShape
|
ALL
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità ThingShape specifica.
|
|
ThingShape
|
Property
|
n/d
|
Fa riferimento a tutti gli utilizzi delle proprietà per l'entità ThingShape specifica.
|
|
ThingShape
|
Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi di servizi ed eventi per l'entità ThingShape specifica.
|
|
ThingTemplate
|
ALL
|
n/d
|
Fa riferimento a tutti gli utilizzi delle caratteristiche per l'entità ThingTemplate specifica.
|
|
ThingTemplate
|
ALL
|
ServiceName
|
Fa riferimento a tutti gli utilizzi della caratteristica con nome ServiceName per l'entità ThingTemplate specifica.
|
|
ThingTemplate
|
Property
|
n/d
|
Fa riferimento a tutti gli utilizzi delle proprietà per l'entità ThingTemplate specifica.
|
|
ThingTemplate
|
Service/Event
|
n/d
|
Fa riferimento a tutti gli utilizzi di servizi ed eventi per l'entità ThingTemplate specifica.
|
I tipi di entità seguenti non presentano caratteristiche e non richiedono input, in quanto possono restituire solo riferimenti agli utilizzi diretti di se stessi.
• ApplicationKey
• Dashboard
• DataShape
• DataTagVocabulary
• Mashup
• MediaEntity
• Menu
• ModelTagVocabulary
• Rete
• Organizzazione
• StateDefinition
• StyleDefinition
• StyleTheme
• Utente
• Gruppi utenti
Comportamento dei risultati
Potrebbe sembrare che nell'insieme di risultati siano presenti righe duplicate. Nelle immagini seguenti il servizio GetWhereUsed è stato eseguito due volte su ThingA: una volta senza input aggiuntivi (prima immagine) e una volta con il valore characteristicType impostato su All (seconda immagine): Nei due risultati sono sottolineate in rosso le righe che condividono le stesse informazioni di colonna, ad eccezione delle colonne Tipo di caratteristica e Nome caratteristica. Anche se le righe contengono informazioni sovrapponibili, si tratta di riferimenti separati. Perché ThingB utilizzi il nome della proprietà di ThingA, è necessario che utilizzi anche ThingA. Pertanto, nella prima immagine la riga sottolineata è un riferimento a ThingA, che viene utilizzato da ThingB. Nella seconda immagine la riga sottolineata è un riferimento al nome della proprietà di ThingA, che viene utilizzato da ThingB.
Permessi
Un utente non amministratore può eseguire il servizio GetWhereUsed ma, se non dispone dei permessi per visualizzare determinate entità o caratteristiche, potrebbe non essere in grado di visualizzare tutti i risultati. In questo caso, un utente amministratore può visualizzare il log di protezione, che mostra le prime 50 entità che l'utente non amministratore non è in grado di visualizzare, e modificare i permessi di conseguenza.