트윈데이터 매핑
개요
이 화면은 무엇인가요?
이 화면에서는 트윈데이터 매핑 데이터를 등록하고 관리합니다. 매핑유형(property, color, position, rotation 등)별로 분류할 수 있습니다.
누가 사용하나요?
- IoT엔지니어: 태그-트윈 매핑 설정, 변환 수식 구성
- 설비담당: 매핑 현황 확인, 데이터 정합성 점검
언제 사용하나요?
- 트윈 모델에 실시간 센서 데이터를 연결할 때
- 센서 태그와 트윈 속성 간의 변환 규칙을 설정할 때
- 매핑의 동기화 상태를 확인하거나 오류를 해결할 때
주요 기능
- 태그-속성 매핑: 센서 태그와 트윈 모델의 속성을 1:1 또는 N:1로 연결
- 변환 수식: 원본 데이터를 트윈 속성 형식으로 변환하는 수식 설정
- 동기화 상태: 실시간 매핑 동기화 상태 모니터링
- 쓰기모드: 양방향(read_write) 또는 읽기전용(read_only) 설정
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 모델ID | twin_models 테이블 참조 (model_code 표시) | ✅ | 목록에서 선택 |
| 태그ID | data_tags 테이블 참조 (tag_code 표시) | ✅ | 목록에서 선택 |
| 세션ID | 관련 데이터 선택 | 목록에서 선택 | |
| 대상속성 | 대상속성 | ✅ | 텍스트 입력 |
| 변환공식 | 변환공식 | 텍스트 입력 | |
| 갱신주기(Hz) | 갱신주기(Hz) | 숫자 입력 | |
| 매핑코드 | 고유 식별 코드 | ✅ | MAPPING-CODE-001 |
| 매핑유형 | 분류 구분 | ✅ | property / color / position |
| 소스최소값 | 소스최소값 | 숫자 입력 (소수점 가능) | |
| 소스최대값 | 소스최대값 | 숫자 입력 (소수점 가능) | |
| 대상최소값 | 대상최소값 | 숫자 입력 (소수점 가능) | |
| 대상최대값 | 대상최대값 | 숫자 입력 (소수점 가능) | |
| 색상그라데이션 | 색상그라데이션 | JSON 형식 입력 | |
| 애니메이션설정 | 애니메이션설정 | JSON 형식 입력 | |
| 보간모드 | 보간모드 | linear / smooth / step | |
| 우선순위 | 우선순위 | 숫자 입력 | |
| 사용여부 | 활성화 여부 | 예 / 아니오 | |
| 설명 | 식별하기 쉬운 이름 | 자유 텍스트 입력 |
자주 묻는 질문 (FAQ)
매핑 상태가 계속 error로 표시됩니다.
- 태그의 데이터소스 연결 상태를 확인합니다. 2) 변환수식에 오류가 없는지 점검합니다. 3) 태그의 데이터 타입과 트윈 속성의 데이터 타입이 호환되는지 확인합니다.
실무 시나리오
로봇 온도 센서 매핑
상황: 로봇 모터의 온도 센서 태그를 트윈 모델의 온도 속성에 매핑해야 합니다.
처리 순서:
- 트윈모델에서 해당 로봇 트윈을 선택합니다
- 태그에서
TEMP-ROBOT001온도 센서를 선택합니다 - 트윈속성명에
motor_temperature를 입력합니다 - 변환수식에 단위 변환이 필요하면 수식을 입력합니다
- 동기화 상태가
synced인지 확인합니다
참고: 데이터 구조
테이블: twin_data_mappings
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
model_id | 모델ID | UUID | *필수 twin_models 테이블 참조 (model_code 표시) |
tag_id | 태그ID | UUID | *필수 data_tags 테이블 참조 (tag_code 표시) |
session_id | 세션ID | UUID | |
target_property | 대상속성 | VARCHAR | *필수 |
transform_formula | 변환공식 | VARCHAR | |
update_rate_hz | 갱신주기(Hz) | INT | |
mapping_code | 매핑코드 | VARCHAR | *필수 |
mapping_type | 매핑유형 | property / color / position / rotation / scale / animation / visibility / material | *필수 |
source_min | 소스최소값 | DECIMAL | |
source_max | 소스최대값 | DECIMAL | |
target_min | 대상최소값 | DECIMAL | |
target_max | 대상최대값 | DECIMAL | |
color_gradient | 색상그라데이션 | JSONB | |
animation_config | 애니메이션설정 | JSONB | |
interpolation_mode | 보간모드 | linear / smooth / step | |
priority | 우선순위 | INT | |
is_active | 사용여부 | BOOLEAN | |
description | 설명 | TEXT |