Asset Types

RealityTwin의 Asset Types는 에셋이 생성될 때 가질 속성 집합을 정의하는 데 사용되는 사전 정의된 템플릿입니다. 에셋에 Asset Type을 할당하면, 관련된 모든 사전 정의된 속성이 자동으로 연결되어, 일관성을 보장하고 강력한 검색 및 필터링 기능을 가능하게 합니다. 예를 들어, “Pump”가 Asset Type으로 정의된 경우, 나중에 해당 유형으로 필터링하기만 하면 프로젝트의 모든 펌프를 검색할 수 있습니다.

Asset Types 및 카테고리 구성

Asset Types를 구성하려면:

Organization settings → Asset settings로 이동합니다
새 Asset Type/카테고리를 생성하거나 기존 것을 편집합니다.
변경한 후, Publish를 클릭하여 적용합니다.

속성을 섹션으로 구성

Asset Type 내에서, 속성을 섹션으로 그룹화하여 명확성과 데이터 입력을 개선할 수 있습니다.
각 섹션에는 하나 이상의 관련 속성이 포함될 수 있습니다.

예:

Identification:
Technical Specifications
Monitoring & Instrumentation
Maintenance & Lifecycle

속성 정의

Asset Type에 정의된 각 속성은 다음을 포함합니다:

Key — 속성의 이름/식별자.
Value Type — 속성이 가질 데이터의 형식으로, 다음과 같습니다:
- Number(아래 자세한 내용 참조)
- Short text
- Attachment
- URL link
- Toggle(boolean)
- Dropdown(사전 정의된 선택 항목, 아래 자세한 내용 참조)
- Integration field(외부 시스템에 연결됨)

숫자 필드의 단위 구성

Value Type이 Number로 설정된 새 속성을 만들 때, 선택적으로 단위를 정의할 수 있습니다.

단위 필드는 임의의 레이블(예: mm, °C, kg)을 입력할 수 있는 자유 텍스트 필드입니다.
단위 정의는 Asset Type 구성의 일부이며 해당 유형을 사용하는 모든 에셋에 적용됩니다.

단위는 값이 에셋의 메타데이터 패널에 표시될 때 접미사 역할을 합니다.

드롭다운 옵션 구성

Value Type이 Dropdown으로 설정된 새 속성을 만들 때, 화면 오른쪽에 패널이 나타나 드롭다운 옵션을 정의할 수 있습니다.

각 옵션을 별도의 줄에 입력합니다(각 항목 후 Enter를 누름).
속성 옆의 오버플로 메뉴를 클릭하고 Edit dropdown options를 선택하여 언제든지 이러한 옵션을 편집하러 돌아올 수 있습니다.

외부 연동으로 속성 연결

일반 Asset Type 구성과 마찬가지로, 연동 쿼리에 매핑된 데이터 섹션이나 개별 필드를 만들 수 있습니다. 기본 개념은 특정 유형의 에셋이 로드될 때마다, 링크가 존재하면 일련의 연동 쿼리가 생성된다는 것입니다. 연동 쿼리가 실행되면, 결과가 에셋 유형 내의 섹션이나 필드로 구성됩니다.

Asset Types에서 속성을 매핑하기 전에, 연동이 이미 완전히 구성되어 있어야 합니다. 여기에는 연동 서버 설정과 외부 시스템과의 연결 설정이 포함됩니다.

단계별 지침은 연동 설정 문서를 참조하세요.

연동 섹션 및 필드 정보

Asset Types는 외부 시스템(예: ERP, CMMS)에서 속성을 자동으로 연결하고 채우기 위해 연동을 지원합니다. 연동을 구성하는 두 가지 주요 방법이 있습니다: 연동에서 섹션 및 연동 필드.

연동 쿼리의 전체 섹션을 에셋 유형의 섹션에 매핑할 수 있습니다. 예를 들어, 이 객체를 반환하는 쿼리는:

{
  "TankLevel": {
    "value": 73.84190097508079,
    "uom": "%",
    "_p3d_type": "urn:primitive:obj:numeric"
  },
  "TankTemperature": {
    "value": 89.4061043417307,
    "uom": "degC",
    "_p3d_type": "urn:primitive:obj:numeric"
  }
}

다음과 같이 보이도록 Asset Type의 섹션에 자동으로 매핑될 수 있습니다:

필요한 경우, 쿼리에서 단일 값을 추출하여 단일 필드에 매핑할 수도 있습니다. 예를 들어, 압력 834를 반환할 수 있는 쿼리는 다음과 같이 표현되고 일반 에셋 유형 필드와 혼합될 수 있습니다:

연동에서 구성 섹션

연동에서 직접 소싱되는 전체 섹션을 만들 수 있습니다:

새 섹션을 추가할 때 From Integration을 선택합니다.
원하는 Integration Link를 선택합니다.
연동 페이로드의 어느 부분을 이 섹션에 바인딩할지 정의하기 위해 JSONPath를 입력합니다(자세한 내용은 JSONPath 매핑 참조).
섹션은 연결된 연동에서 검색된 모든 속성으로 자동으로 채워집니다.
연동의 모든 업데이트는 동기화 구성에 따라 에셋의 데이터에 반영됩니다.

연동 필드 구성

전체 섹션을 가져오는 대신, 개별 속성을 연동에 매핑할 수 있습니다:

새 속성을 추가하고 Value Type을 Integration field로 설정합니다.
원하는 Integration Link를 선택합니다.
연동 페이로드의 어느 부분을 이 섹션에 바인딩할지 정의하기 위해 JSONPath를 입력합니다(자세한 내용은 JSONPath 매핑 참조).
해당 속성만 외부 시스템과 동기화됩니다.

JSONPath 매핑

From Integration 섹션과 Integration fields 모두 Integration Link가 반환하는 JSON 페이로드에서 데이터를 선택하기 위해 JSONPath가 필요합니다.

From Integration(섹션 수준 JSONPath):
전체 섹션에 바인딩하려는 객체로 해석되는 JSONPath를 입력합니다.
예: $.Identification은 페이로드의 전체 Identification 객체를 Asset Type 섹션에 바인딩합니다.
Integration fields(속성 수준 JSONPath):
단일 스칼라 값(문자열/숫자/불리언/날짜)으로 해석되는 JSONPath를 입력합니다.
예: $.Identification.serialNumber

변경 사항 게시

변경 사항을 게시하면 해당 Asset Type을 사용하는 모든 기존 RealityAsset에 즉시 영향을 미칩니다.

예를 들어:

속성 이름 변경은 연결된 모든 에셋에 대해 업데이트됩니다.
속성 삭제는 연결된 모든 에셋에서 해당 값을 제거합니다.

접근 제어

기본적으로, Super Admin만 Asset Types를 관리할 수 있습니다.
역할 맞춤 설정을 통해, 필요한 경우 이러한 관리 권한을 추가 구성원에게 부여할 수 있습니다.

Asset Types 사용의 이점

일관성 — 동일한 유형의 모든 에셋은 동일한 속성 구조를 공유합니다.
검색 가능성 — “모든 펌프를 보여줘” 같은 쿼리를 가능하게 합니다.
구성 — 카테고리와 섹션은 정보를 명확하고 접근 가능하게 유지합니다.
확장성 — 한 유형의 모든 향후 에셋에 대한 속성 정의를 쉽게 업데이트합니다.