관계

관계는 같은 테넌트 안의 두 엔티티를 연결해 계층, 소유, 의존 같은 실제 관계를 모델링합니다.

관계는 다음으로 이루어집니다.

• from — 출발 엔티티(엔티티 유형 + UUID)
• to — 대상 엔티티(엔티티 유형 + UUID)
• type — 관계의 종류를 나타내는 자유 형식 문자열(예: Contains)
• additionalInfo — 사용자 정의 메타데이터를 담는 선택 JSON 객체

관계에는 타임스탬프가 없습니다. 이벤트가 아니라 구조적인 연결을 나타내기 때문입니다.

예시:

{
  "from": { "entityType": "ASSET", "id": "156c853f-89b1-321b-635j-y8febb2784h4" },
  "to":   { "entityType": "DEVICE", "id": "784f394c-42b6-435a-983c-b7beff2784f9" },
  "type": "Contains",
  "additionalInfo": {}
}

관계는 항상 출발 엔티티(보내는 사람)에서 대상 엔티티(받는 사람)로 향합니다.

조회할 때는 방향이 중요합니다. 엔티티에서 나가는 관계를 조회하면 하위 엔티티가, 엔티티로 들어오는 관계를 조회하면 상위 엔티티가 나옵니다.

유형은 자유 형식 문자열입니다. 기본 관례를 쓰거나 직접 정의할 수 있습니다.

어떤 문자열이든 쓸 수 있습니다. MX On Cloud는 유형 이름을 제한하지 않습니다.

Contains 관계는 상위–하위 구조를 자연스럽게 모델링합니다.

Region A에서 나가는 관계를 조회하면 Field A와 Field B가 나옵니다. Moisture Sensor로 들어오는 관계를 조회하면 상위인 Field A가 나옵니다.

1. 엔티티 상세 페이지를 엽니다.
2. 관계 탭으로 이동합니다.
3. 방향을 선택합니다. 보내는 사람(이 엔티티가 출발) 또는 받는 사람(이 엔티티가 대상)입니다.
4. + 버튼을 클릭해 관계 추가 대화상자를 엽니다.
5. 관계 유형을 입력합니다. Contains 같은 기본값을 고르거나 원하는 문자열을 입력합니다.
6. 대상 엔티티를 선택합니다.
7. 필요하면 메타데이터를 Additional info (JSON) 필드에 입력합니다.
8. 추가를 클릭합니다.

REST API로 관계를 만들고, 조회하고, 삭제할 수 있습니다. 인증은 X-Authorization 헤더의 JWT 토큰으로 합니다. 방향(from/to)별 조회와 엔티티 유형·관계 유형별 필터링을 위한 엔드포인트가 따로 있습니다.