Dienst "GetWhereUsed" verwenden
Der Dienst GetWhereUsed ermöglicht es Ihnen, die Beziehungen einer Entität in ThingWorx anzuzeigen. Sie können bestimmen, wo eine Entität oder ihre Merkmale, z.B. ein Dienst oder eine Eigenschaft, in ThingWorx verwendet werden. Dies kann hilfreich sein, wenn Sie Änderungen an Entitäten vornehmen und wissen müssen, welche Auswirkungen die Änderungen an anderen Stellen in Ihrem Modell haben werden. Diese Funktionalität ist auch in der Entitätsansicht in Composer verfügbar. Weitere Informationen finden Sie unter Referenziert von.
 |
Der Dienst GetWhereUsed ist in ThingWorx 9.3 und höher verfügbar.
|
Parameter
|
Parameter
|
Basistyp
|
Beschreibung
|
|---|---|---|
|
query
|
JSON
|
Filtert die Ergebnisse.
|
|
charType
|
STRING
|
Filtert die Ergebnisse nach allen Verwendungen von Merkmalen einer Entität. Mögliche Eingaben sind "ALL", "Property", "Service/Event" und "LocalizationToken".
|
|
charName
|
STRING
|
Filtert die Ergebnisse nach allen Verwendungen eines bestimmten Merkmals einer Entität.
|
Beispiel für Abfragefilter
Bei Verwendung des unten gezeigten Filters für GetWhereUsed werden nur Mashups mit dem Namen MashupA zurückgegeben.
{"filters":
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
Ergebnisse von "GetWhereUsed" für Entitätstypen
Die folgende Tabelle beschreibt die Ergebnisse, die bei Verwendung der optionalen Parameter charType und/oder charName zurückgegeben werden. N/A gibt an, dass die Eingabe leer ist. Systemobjekte sind nicht Teil der Ergebnisse für GetWhereUsed.
|
|
Für Zeilen, die "ALL oder Service/Event" enthalten, wird bei Auswahl beider Eingaben für charType dieselbe Ausgabe erzeugt, da diese Entität nur Dienst-/Ereignismerkmale aufweist.
|
|
Entitätstyp
|
charType
|
charName
|
Ergebnis
|
|---|---|---|---|
|
Alle Entitätstypen
|
N/A
|
N/A
|
Referenz zu Verwendungen dieser bestimmten Entität.
|
|
Authenticator
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser Authenticator-Entität.
|
|
Authenticator
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser Authenticator-Entität.
|
|
DirectoryService
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser DirectoryService-Entität.
|
|
DirectoryService
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser DirectoryService-Entität.
|
|
LocalizationTable
|
N/A
|
N/A
|
Referenz zu Verwendungen der Lokalisierungstabelle.
|
|
LocalizationTable
|
ALL oder LocalizationToken
|
N/A
|
Referenz zu Verwendungen aller Token in der Lokalisierungstabelle.
|
|
LocalizationTable
|
ALL oder LocalizationToken
|
TokenName
|
Referenz zu allen Verwendungen des spezifischen Tokens TokenName in der Lokalisierungstabelle.
|
|
NotificationDefinition
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser NotificationDefinition-Entität.
|
|
NotificationDefinition
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser NotificationDefinition-Entität.
|
|
Project
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser Project-Entität.
|
|
Project
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser Project-Entität.
|
|
Subsystem
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser Subsystem-Entität.
|
|
Subsystem
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser Subsystem-Entität.
|
|
Thing
|
ALL
|
N/A
|
Referenz zu allen Verwendungen von Merkmalen dieser Thing-Entität.
|
|
Thing
|
ALL
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser Thing-Entität.
|
|
Thing
|
Property
|
N/A
|
Referenz zu allen Verwendungen von Eigenschaften dieser Thing-Entität.
|
|
Thing
|
Dienst/Ereignis
|
N/A
|
Referenz zu allen Verwendungen von Diensten und Ereignissen dieser Thing-Entität.
|
|
ThingGroup
|
ALL oder Service/Event
|
N/A
|
Referenz zu allen Verwendungen der Merkmale dieser ThingGroup-Entität.
|
|
ThingGroup
|
ALL oder Service/Event
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser ThingGroup-Entität.
|
|
ThingShape
|
ALL
|
N/A
|
Referenz zu allen Verwendungen von Merkmalen dieser ThingShape-Entität.
|
|
ThingShape
|
ALL
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser ThingShape-Entität.
|
|
ThingShape
|
Property
|
N/A
|
Referenz zu allen Verwendungen von Eigenschaften dieser ThingShape-Entität.
|
|
ThingShape
|
Dienst/Ereignis
|
N/A
|
Referenz zu allen Verwendungen von Diensten und Ereignissen dieser ThingShape-Entität.
|
|
ThingTemplate
|
ALL
|
N/A
|
Referenz zu allen Verwendungen von Merkmalen dieser ThingTemplate-Entität.
|
|
ThingTemplate
|
ALL
|
ServiceName
|
Referenz zu allen Verwendungen des Merkmals mit dem Namen ServiceName dieser ThingTemplate-Entität.
|
|
ThingTemplate
|
Property
|
N/A
|
Referenz zu allen Verwendungen von Eigenschaften dieser ThingTemplate-Entität.
|
|
ThingTemplate
|
Dienst/Ereignis
|
N/A
|
Referenz zu allen Verwendungen von Diensten und Ereignissen dieser ThingTemplate-Entität.
|
Die folgenden Entitätstypen haben keine Merkmale und erfordern keine Eingaben, da sie nur Referenzen zu direkten Verwendungen von sich selbst zurückgeben können.
• ApplicationKey
• Dashboard
• DataShape
• DataTagVocabulary
• Mashup
• MediaEntity
• Menü
• ModelTagVocabulary
• Netzwerk
• Organisation
• StateDefinition
• StyleDefinition
• StyleTheme
• Benutzer
• Benutzergruppen
Ergebnisverhalten
Es kann den Anschein haben, dass der Ergebnissatz doppelte Zeilen enthält. In den Bildern unten wurde der Dienst GetWhereUsed zweimal für ThingA ausgeführt: einmal ohne zusätzliche Eingaben (erstes Bild) und einmal mit Festlegung von characteristicType auf ALL (zweites Bild). Eine ähnliche Zeile ist in beiden Ergebnissen rot unterstrichen. Hier enthalten die Spalten die gleichen Informationen, mit Ausnahme der Spalten für Merkmalstyp und Merkmalsname. Obwohl die Zeilen überlappende Informationen enthalten, handelt es sich um unabhängige Referenzen. Damit ThingB den Eigenschaftsnamen von ThingA verwenden kann, muss es auch ThingA verwenden. Daher ist im ersten Bild die unterstrichene Zeile eine Referenz zu ThingA, die von ThingB verwendet wird. Im zweiten Bild ist die unterstrichene Zeile eine Referenz zum Eigenschaftsnamen von ThingA, der von ThingB verwendet wird.
Berechtigungen
Ein Nicht-Administrator kann den Dienst GetWhereUsed verwenden, möglicherweise jedoch nicht alle Ergebnisse anzeigen, wenn er keine Berechtigungen zum Anzeigen bestimmter Entitäten oder Merkmale besitzt. In diesem Fall kann ein Administrator das Sicherheitsprotokoll aufrufen, in dem die ersten 50 Entitäten angezeigt werden, die der Nicht-Administrator nicht anzeigen kann, und die Berechtigungen entsprechend ändern.