使用 GetWhereUsed 服務
GetWhereUsed 服務可讓您在 ThingWorx 中查看實體的關係。您可以決定在 ThingWorx 中的何處使用實體或其特性，例如服務或內容。如果您需要對實體進行變更，且需要瞭解您的變更將在模型中其他位置上產生什麼影響，這會很有用。此功能也可在 Composer 的實體檢視中使用，如需詳細資訊，請參閱參考者。
 |
ThingWorx 9.3 及更新版本中將會提供 GetWhereUsed 服務。
|
參數
|
參數
|
基礎類型
|
描述
|
|---|---|---|
|
query
|
JSON
|
篩選結果。
|
|
charType
|
STRING
|
篩選實體特徵所有使用關係的結果。可能的輸入包括 ALL、Property、Service/Event 和 LocalizationToken。
|
|
charName
|
STRING
|
實體上特定特徵之所有使用關係的篩選結果。
|
查詢篩選器範例
針對 GetWhereUsed 使用以下篩選器僅會傳回名稱為 MashupA 的混搭。
{"filters":
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
實體類型的 GetWhereUsed 結果
下表概述使用選用 charType 和/或 charName 參數時傳回的結果。N/A 表示輸入為空。系統物件不是 GetWhereUsed 之結果的一部份。
|
|
對於涉及 "ALL 或 Service/Event" 的列，針對 charType 選取其中任何輸入都會產生相同的輸出，因為該實體僅具有 Service/Event 特徵。
|
|
實體類型
|
charType
|
charName
|
結果
|
|---|---|---|---|
|
全部實體類型
|
n/a
|
n/a
|
參考該特定實體的使用關係。
|
|
Authenticator
|
ALL 或 Service/Event
|
n/a
|
參考該驗證器實體上特徵的所有使用關係。
|
|
Authenticator
|
ALL 或 Service/Event
|
ServiceName
|
參考該驗證器實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
DirectoryService
|
ALL 或 Service/Event
|
n/a
|
參考該 DirectoryService 實體上特徵的所有使用關係。
|
|
DirectoryService
|
ALL 或 Service/Event
|
ServiceName
|
參考該 DirectoryService 實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
LocalizationTable
|
n/a
|
n/a
|
參考當地語系化表的使用關係。
|
|
LocalizationTable
|
ALL 或 LocalizationToken
|
n/a
|
參考當地語系化表上所有權杖的使用關係。
|
|
LocalizationTable
|
ALL 或 LocalizationToken
|
TokenName
|
參考當地語系化表上特定權杖 TokenName 的所有使用關係。
|
|
NotificationDefinition
|
ALL 或 Service/Event
|
n/a
|
參考該 NotificationDefinition 實體上特徵的所有使用關係。
|
|
NotificationDefinition
|
ALL 或 Service/Event
|
ServiceName
|
參考 NotificationDefinition 實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
Project
|
ALL 或 Service/Event
|
n/a
|
參考該專案實體上特徵的所有使用關係。
|
|
Project
|
ALL 或 Service/Event
|
ServiceName
|
參考該專案實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
Subsystem
|
ALL 或 Service/Event
|
n/a
|
參考該子系統實體上特徵的所有使用關係。
|
|
Subsystem
|
ALL 或 Service/Event
|
ServiceName
|
參考該子系統實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
Thing
|
ALL
|
n/a
|
參考該物件實體上特徵的所有使用關係。
|
|
Thing
|
ALL
|
ServiceName
|
參考該物件實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
Thing
|
Property
|
n/a
|
參考該物件實體上內容的所有使用關係。
|
|
Thing
|
Service/Event
|
n/a
|
參考該物件實體上服務與事件的所有使用關係。
|
|
ThingGroup
|
ALL 或 Service/Event
|
n/a
|
參考該 ThingGroup 實體上特徵的所有使用關係。
|
|
ThingGroup
|
ALL 或 Service/Event
|
ServiceName
|
參考 ThingGroup 實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
ThingShape
|
ALL
|
n/a
|
參考該 ThingShape 實體上特徵的所有使用關係。
|
|
ThingShape
|
ALL
|
ServiceName
|
參考 ThingShape 實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
ThingShape
|
Property
|
n/a
|
參考該 ThingShape 實體上內容的所有使用關係。
|
|
ThingShape
|
Service/Event
|
n/a
|
參考該 ThingShape 實體上服務與事件的所有使用關係。
|
|
ThingTemplate
|
ALL
|
n/a
|
參考該 ThingTemplate 實體上特徵的所有使用關係。
|
|
ThingTemplate
|
ALL
|
ServiceName
|
參考該 ThingTemplate 實體上名稱為 ServiceName 之特徵的所有使用關係。
|
|
ThingTemplate
|
Property
|
n/a
|
參考該 ThingTemplate 實體上內容的所有使用關係。
|
|
ThingTemplate
|
Service/Event
|
n/a
|
參考該 ThingTemplate 實體上服務與事件的所有使用關係。
|
下列實體類型沒有特徵且不需要輸入，因為它們只能傳回其自身直接使用關係的參考。
• ApplicationKey
• Dashboard
• DataShape
• DataTagVocabulary
• 混搭
• MediaEntity
• 選單
• ModelTagVocabulary
• 網路
• Organization
• StateDefinition
• StyleDefinition
• StyleTheme
• User
• 「使用者群組」
結果行為
結果集中可能會出現重複的列。在下圖中，已在 ThingA 上執行兩次 GetWhereUsed 服務：一次未使用額外輸入 (第一個圖像)，另一次將 characteristicType 設定為 All (第二個圖像)。兩個結果中相類似的列加上了紅色底線，除了「特徵類型」及「特徵名稱」欄之外的所有欄都具有相同資訊。雖然列包含重迭的資訊，但它們是單獨的參考。為了讓 ThingB 使用 ThingA 的內容名稱，它也必須使用 ThingA。因此，在第一個圖像中，加底線的列是 ThingB 所使用之 ThingA 的參考。在第二個圖像中，加底線的列是 ThingB 所使用之 ThingA 內容名稱的參考。
權限
非管理員使用者可以執行 GetWhereUsed 服務，但如果其沒有查看某些實體或特徵的權限，則可能無法查看所有結果。在此情況下，管理員使用者可以查看安全性記錄檔 (其中會顯示非管理員使用者無法查看的前 50 個實體)，並且可以相應變更權限。