3D 씬 인스턴스
개요
이 화면은 무엇인가요?
이 화면에서는 3D 씬 인스턴스 데이터를 등록하고 관리합니다.
누가 사용하나요?
- 3D모델러: 3D 씬 인스턴스 3D 에셋 등록, 모델 관리
- IoT엔지니어: 3D 씬 인스턴스 등록, 설정 변경, 연결 관리
- XR개발자: 3D 씬 인스턴스 XR 인터랙션 설정
언제 사용하나요?
- 신규 3D 씬 인스턴스 데이터를 등록할 때
- 기존 3D 씬 인스턴스 정보를 수정하거나 이력을 확인할 때
주요 기능
- 등록·조회: 3D 씬 인스턴스 데이터의 신규 등록 및 목록 조회
- 감사 추적: 데이터 변경 이력 자동 기록
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 트윈모델ID | twin_models 테이블 참조 (model_name 표시) | ✅ | 목록에서 선택 |
| 3D에셋ID | dt_scene_3d_assets 테이블 참조 (asset_name 표시) | ✅ | 목록에서 선택 |
| 인스턴스명 | 식별하기 쉬운 이름 | ✅ | (이름 입력) |
| X좌표 | X좌표 | ✅ | 숫자 입력 (소수점 가능) |
| Y좌표 | Y좌표 | ✅ | 숫자 입력 (소수점 가능) |
| Z좌표 | Z좌표 | ✅ | 숫자 입력 (소수점 가능) |
| X회전 | X회전 | 숫자 입력 (소수점 가능) | |
| Y회전 | Y회전 | 숫자 입력 (소수점 가능) | |
| Z회전 | Z회전 | 숫자 입력 (소수점 가능) | |
| X스케일 | X스케일 | 숫자 입력 (소수점 가능) | |
| Y스케일 | Y스케일 | 숫자 입력 (소수점 가능) | |
| Z스케일 | Z스케일 | 숫자 입력 (소수점 가능) | |
| 설비ID | 관련 데이터 선택 | 목록에서 선택 | |
| 데이터태그바인딩 | 데이터태그바인딩 | 자유 텍스트 입력 | |
| 표시여부 | 표시여부 | ✅ | 예 / 아니오 |
| 레이어 | 레이어 | 텍스트 입력 | |
| 배치자ID | 관련 데이터 선택 | 목록에서 선택 |
자주 묻는 질문 (FAQ)
3D 씬 인스턴스 데이터를 대량으로 등록하려면 어떻게 하나요?
CSV 가져오기 기능을 사용합니다. 먼저 CSV 내보내기로 템플릿을 다운로드한 후, 템플릿에 맞춰 데이터를 입력하고 CSV 가져오기로 일괄 등록합니다.
실무 시나리오
신규 3D 씬 인스턴스 등록
상황: 새로운 3D 씬 인스턴스 데이터를 등록해야 합니다.
처리 순서:
- 신규 3D 씬 인스턴스 데이터를 생성합니다
- 트윈모델ID을(를) 입력합니다
- 3D에셋ID을(를) 입력합니다
- 인스턴스명을(를) 입력합니다
- 저장하여 등록을 완료합니다
참고: 데이터 구조
테이블: dt_scene_3d_instances
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
twin_model_id | 트윈모델ID | UUID | *필수 twin_models 테이블 참조 (model_name 표시) |
asset_id | 3D에셋ID | UUID | *필수 dt_scene_3d_assets 테이블 참조 (asset_name 표시) |
instance_name | 인스턴스명 | VARCHAR | *필수 |
position_x | X좌표 | DECIMAL | *필수 |
position_y | Y좌표 | DECIMAL | *필수 |
position_z | Z좌표 | DECIMAL | *필수 |
rotation_x | X회전 | DECIMAL | |
rotation_y | Y회전 | DECIMAL | |
rotation_z | Z회전 | DECIMAL | |
scale_x | X스케일 | DECIMAL | |
scale_y | Y스케일 | DECIMAL | |
scale_z | Z스케일 | DECIMAL | |
equipment_id | 설비ID | UUID | |
data_tag_bindings | 데이터태그바인딩 | TEXT | |
is_visible | 표시여부 | BOOLEAN | *필수 |
layer | 레이어 | VARCHAR | |
placed_by_id | 배치자ID | UUID |