使用 GetWhereUsed 服务
GetWhereUsed 服务用于在 ThingWorx 中查看实体的关系。您可以确定在 ThingWorx 中使用的实体或其特征 (如服务或属性) 的位置。如果需要对实体进行更改，并且需要了解此更改对模型中其他位置的影响，这会很有用。Composer 的实体视图中也提供了此功能，有关详细信息，请参阅引用者。
 |
GetWhereUsed 服务在 ThingWorx 9.3 及更高版本中可用。
|
参数
|
参数
|
基本类型
|
说明
|
|---|---|---|
|
query
|
JSON
|
筛选结果。
|
|
charType
|
STRING
|
筛选出实体特征的所有使用实例的结果。可能的输入包括 ALL、Property、Service/Event 和 LocalizationToken。
|
|
charName
|
STRING
|
将结果过滤为实体上特定特征的所有使用。
|
查询筛选器示例
使用下面的筛选器将仅返回名称为 MashupA 的混搭 GetWhereUsed。
{"filters":
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
{
"type": "And",
"filters": [
{
"type": "EQ",
"fieldName": "entityName",
"value": "MashupA"
}]}}
实体类型的 GetWhereUsed 结果
下表概述了使用可选 charType 和/或 charName 参数时返回的结果。“不适用”表示输入为空。系统对象不是 GetWhereUsed 结果的一部分。
|
|
对于涉及 "ALL 或 Service/Event" 的行，选择任一 charType 将产生相同的输出，因为该实体仅具有服务/事件特征。
|
|
实体类型
|
charType
|
charName
|
结果
|
|---|---|---|---|
|
所有实体类型
|
不适用
|
不适用
|
特定实体的使用关系的引用。
|
|
Authenticator
|
ALL 或 Service/Event
|
不适用
|
引用该身份验证器实体上特征的所有使用。
|
|
Authenticator
|
ALL 或 Service/Event
|
ServiceName
|
引用该身份验证器实体上名称为 ServiceName 的特征的所有使用。
|
|
DirectoryService
|
ALL 或 Service/Event
|
不适用
|
引用该 DirectoryService 实体上特征的所有使用。
|
|
DirectoryService
|
ALL 或 Service/Event
|
ServiceName
|
引用该 DirectoryService 实体上名称为 ServiceName 的特征的所有使用。
|
|
LocalizationTable
|
不适用
|
不适用
|
引用本地化表的使用。
|
|
LocalizationTable
|
ALL 或 LocalizationToken
|
不适用
|
引用本地化表上所有令牌的使用。
|
|
LocalizationTable
|
ALL 或 LocalizationToken
|
TokenName
|
引用本地化表中特定令牌 TokenName 的所有使用。
|
|
NotificationDefinition
|
ALL 或 Service/Event
|
不适用
|
引用该 NotificationDefinition 实体上特征的所有使用。
|
|
NotificationDefinition
|
ALL 或 Service/Event
|
ServiceName
|
引用该 NotificationDefinition 实体上名称为 ServiceName 的特征的所有使用。
|
|
Project
|
ALL 或 Service/Event
|
不适用
|
引用该项目实体上特征的所有使用。
|
|
Project
|
ALL 或 Service/Event
|
ServiceName
|
引用该项目实体上名称为 ServiceName 的特征的所有使用。
|
|
Subsystem
|
ALL 或 Service/Event
|
不适用
|
引用该子系统实体上特征的所有使用。
|
|
Subsystem
|
ALL 或 Service/Event
|
ServiceName
|
引用该子系统实体上名称为 ServiceName 的特征的所有使用。
|
|
Thing
|
ALL
|
不适用
|
引用该事物实体上特征的所有使用。
|
|
Thing
|
ALL
|
ServiceName
|
引用该事物实体上名称为 ServiceName 的特征的所有使用。
|
|
Thing
|
Property
|
不适用
|
引用该事物实体上属性的所有使用。
|
|
Thing
|
Service/Event
|
不适用
|
引用该事物实体上服务和事件的所有使用。
|
|
ThingGroup
|
ALL 或 Service/Event
|
不适用
|
引用该 ThingGroup 实体上特征的所有使用。
|
|
ThingGroup
|
ALL 或 Service/Event
|
ServiceName
|
引用该 ThingGroup 实体上名称为 ServiceName 的特征的所有使用。
|
|
ThingShape
|
ALL
|
不适用
|
引用该事物形态实体上特征的所有使用。
|
|
ThingShape
|
ALL
|
ServiceName
|
引用该事物形态实体上名称为 ServiceName 的特征的所有使用。
|
|
ThingShape
|
Property
|
不适用
|
引用该事物形态实体上属性的所有使用。
|
|
ThingShape
|
Service/Event
|
不适用
|
引用该事物形态实体上服务和事件的所有使用。
|
|
ThingTemplate
|
ALL
|
不适用
|
引用该事物模板实体上特征的所有使用。
|
|
ThingTemplate
|
ALL
|
ServiceName
|
引用该事物模板实体上名称为 ServiceName 的特征的所有使用。
|
|
ThingTemplate
|
Property
|
不适用
|
引用该事物模板实体上属性的所有使用。
|
|
ThingTemplate
|
Service/Event
|
不适用
|
引用该事物模板实体上服务和事件的所有使用。
|
以下实体类型没有特征，且不需要输入，因为它们只能返回其自己的直接使用关系的引用。
• ApplicationKey
• Dashboard
• DataShape
• DataTagVocabulary
• 混搭
• MediaEntity
• 菜单
• ModelTagVocabulary
• Network
• “组织”
• StateDefinition
• StyleDefinition
• StyleTheme
• “用户”
• “用户组”
结果行为
结果集中似乎有重复行。在下图中，GetWhereUsed 服务已在 ThingA 上运行两次：一次没有进行其他输入 (第一张图)，一次将 characteristicType 设置为 All (第二张图)。两个结果中类似的行都以红色下划线加以标记，除“特征类型”和“特征名称”之外的其他列都具有相同信息。尽管行包含重叠信息，但它们是单独的引用。要使 ThingB 能够使用 ThingA 中的属性名称，它还必须使用 ThingA。因此，在第一张图中，带有下划线的行是对由 ThingB 使用的 ThingA 的引用。在第二张图中，带下划线的行是对 ThingB 所使用的 ThingA 属性名称的引用。
权限
非管理员用户可以运行 GetWhereUsed 服务，但如果其没有查看某些实体或特征的权限，则可能无法查看所有结果。在这种情况下，管理员用户可以查看安全日志 (其中显示非管理员用户无法查看的前 50 个实体)，并相应更改权限。