GetWhereUsed 서비스 사용
GetWhereUsed 서비스를 사용하면 ThingWorx에서 엔티티의 관계를 볼 수 있습니다. 서비스 또는 속성과 같은 엔티티 또는 해당 특징이 ThingWorx에서 사용되는 위치를 확인할 수 있습니다. 이는 엔티티를 변경해야 하는 경우 그리고 변경 내용이 모델의 다른 위치에 어떤 영향을 미치는지 알아야 하는 경우 유용할 수 있습니다. 이 기능은 Composer의 엔티티 보기에서도 사용할 수 있습니다. 자세한 내용은 참조자를 참조하십시오.
 |
GetWhereUsed 서비스는 ThingWorx 9.3 이상에서 사용할 수 있습니다.
|
매개 변수
|
매개 변수
|
기본 유형
|
설명
|
|---|---|---|
|
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 매개 변수를 사용할 때 반환되는 결과를 보여줍니다. 해당 없음은 입력이 비어 있음을 나타냅니다. 시스템 객체는 GetWhereUsed에 대한 결과의 일부가 아닙니다.
|
|
"ALL 또는 Service/Event"라고 언급되는 행의 경우 charType에 대해 이러한 입력 중 하나를 선택하면 해당 엔티티에 Service/Event 특징만 있기 때문에 동일한 출력이 생성됩니다.
|
|
엔티티 유형
|
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 엔티티에 대한 특징의 모든 사용에 대한 참조입니다.
|
|
ThingShape
|
ALL
|
ServiceName
|
해당 ThingShape 엔티티에 대한 이름이 ServiceName인 특징의 모든 사용에 대한 참조입니다.
|
|
ThingShape
|
Property
|
해당 없음
|
해당 ThingShape 엔티티에 대한 속성의 모든 사용에 대한 참조입니다.
|
|
ThingShape
|
Service/Event
|
해당 없음
|
해당 ThingShape 엔티티에 대한 서비스 및 이벤트의 모든 사용에 대한 참조입니다.
|
|
ThingTemplate
|
ALL
|
해당 없음
|
해당 ThingTemplate 엔티티에 대한 특징의 모든 사용에 대한 참조입니다.
|
|
ThingTemplate
|
ALL
|
ServiceName
|
해당 ThingTemplate 엔티티에 대한 이름이 ServiceName인 특징의 모든 사용에 대한 참조입니다.
|
|
ThingTemplate
|
Property
|
해당 없음
|
해당 ThingTemplate 엔티티에 대한 특징의 모든 사용에 대한 참조입니다.
|
|
ThingTemplate
|
Service/Event
|
해당 없음
|
해당 ThingTemplate 엔티티에 대한 서비스 및 이벤트의 모든 사용에 대한 참조입니다.
|
다음 엔티티 유형에는 특징이 없으며 자체 직접 사용에 대한 참조만 반환할 수 있기 때문에 입력이 필요하지 않습니다.
• ApplicationKey
• Dashboard
• DataShape
• DataTagVocabulary
• Mashup
• MediaEntity
• Menu
• ModelTagVocabulary
• Network
• Organization
• StateDefinition
• StyleDefinition
• StyleTheme
• User
• User Groups
결과 동작
결과 집합에 중복된 행이 있는 것처럼 보일 수 있습니다. 아래 이미지에서는 GetWhereUsed 서비스가 ThingA에서 두 번 실행되었습니다. 한 번은 추가 입력 없이 실행되었고(첫 번째 이미지) 한 번은 characteristicType이 All인 상태로 실행되었습니다(두 번째 이미지). 두 결과에서 유사한 행에 빨간색 밑줄이 있습니다. 여기서 열은 특징 유형 및 특징 이름 열의 예외와 함께 정보를 공유합니다. 이러한 행은 겹치는 정보를 포함하지만 별도의 참조입니다. ThingB에서 ThingA의 속성 이름을 사용하려면 ThingA도 사용해야 합니다. 따라서 첫 번째 이미지에서 밑줄이 있는 행은 ThingB에서 사용되는 ThingA에 대한 참조입니다. 두 번째 이미지에서 밑줄이 있는 행은 ThingB에서 사용되는 ThingA의 속성 이름에 대한 참조입니다.
권한
관리자가 아닌 사용자는 GetWhereUsed 서비스를 실행할 수 있지만 특정 엔티티나 특징을 볼 수 있는 권한이 없으면 일부 결과를 볼 수 없을 수도 있습니다. 이 경우 관리자 사용자는 관리자가 아닌 사용자가 볼 수 없는 처음 50개 엔티티를 표시하는 보안 로그를 볼 수 있으며 그에 따라 권한을 변경할 수 있습니다.