Skip to main content

JSON 특수 렌더링 / Polymorphic FK / FILE 버전관리

일반적인 텍스트/숫자 필드를 넘어서, JSON 데이터의 시각적 렌더링, 여러 테이블을 참조하는 Polymorphic FK, 파일 첨부의 버전 관리를 설명합니다.

JSON 특수 렌더링​

JSON 타입 필드에 저장된 데이터를 목적에 맞게 시각적으로 렌더링할 수 있습니다.

추적 뷰 (Trace View)​

LOT 추적이나 프로세스 흐름처럼 경로를 시각화해야 할 때 사용합니다.

JSON 필드에 다음과 같은 구조의 데이터가 저장됩니다:

{
  "nodes": [
    { "id": "RM-001", "label": "원자재 LOT", "type": "material" },
    { "id": "WIP-001", "label": "반제품 LOT", "type": "wip" },
    { "id": "FG-001", "label": "완제품 LOT", "type": "finished" }
  ],
  "edges": [
    { "from": "RM-001", "to": "WIP-001" },
    { "from": "WIP-001", "to": "FG-001" }
  ]
}

이 데이터가 화면에서는 다음과 같이 렌더링됩니다:

추적 뷰
RM-001
원자재LOT
→
WIP-001
반제품LOT
→
FG-001
완제품LOT

JSON 추적 뷰 렌더링

팁

JSON 필드의 렌더링 유형은 필드 속성에서 설정합니다. 렌더링 유형 > 추적 뷰를 선택하면 nodes/edges 구조를 자동으로 그래프로 표시합니다.

파라미터 테이블 (Params Table)​

설비 파라미터나 레시피 정보처럼 키-값 쌍 목록을 테이블 형태로 표시할 때 사용합니다.

{
  "params": [
    { "key": "온도", "value": "180", "unit": "°C", "range": "170~190" },
    { "key": "압력", "value": "2.5", "unit": "bar", "range": "2.0~3.0" },
    { "key": "시간", "value": "30", "unit": "sec", "range": "25~35" }
  ]
}

렌더링 결과:

파라미터설정값단위허용범위
온도180°C170~190
압력2.5bar2.0~3.0
시간30sec25~35

JSON 파라미터 테이블 렌더링

Polymorphic FK (다형성 외래키)​

하나의 FK 필드가 여러 테이블을 참조할 수 있는 기능입니다.

사용 예시​

예를 들어 첨부파일 테이블은 발주서, 판매주문서, 작업오더 등 다양한 전표에 첨부될 수 있습니다.

일반 FK 방식 (테이블마다 FK 필드 필요):
  첨부파일.발주서_ID (FK → 발주서)
  첨부파일.판매주문서_ID (FK → 판매주문서)
  첨부파일.작업오더_ID (FK → 작업오더)

Polymorphic FK 방식 (하나의 필드로 통합):
  첨부파일.대상_유형 = "발주서" | "판매주문서" | "작업오더"
  첨부파일.대상_ID = 참조 레코드의 ID

설정 방법​

  1. FK 필드의 속성에서 참조 유형을 Polymorphic으로 설정합니다.
  2. 참조 가능 테이블 목록에 대상 테이블들을 추가합니다.
  3. 화면에서는 드롭다운으로 대상 유형을 선택하고, 해당 테이블의 레코드를 검색합니다.

Polymorphic FK 설정

주의

Polymorphic FK는 편리하지만, 참조 무결성을 데이터베이스 수준에서 보장하기 어렵습니다. 반드시 비즈니스 로직 노드에서 유효성 검증 규칙을 추가하세요. 09. 비즈니스 로직 노드를 참고합니다.

FILE 필드 버전관리​

FILE 타입 필드에 첨부된 파일의 버전 이력을 자동으로 관리합니다.

동작 방식​

  1. 파일을 최초 업로드하면 버전 1이 됩니다.
  2. 동일 필드에 새 파일을 업로드하면 버전 2가 생성되고, 이전 버전은 이력으로 보존됩니다.
  3. 버전 목록에서 이전 버전을 조회하거나 다운로드할 수 있습니다.
파일 버전 이력
버전파일명업로드자일시
v3도면_SH100_rev3.dwg윤설계03-12 14:30현재
v2도면_SH100_rev2.dwg윤설계03-05 10:15
v1도면_SH100_rev1.dwg김설계02-20 09:00

FILE 버전관리 화면

설정 방법​

  1. FILE 필드의 속성에서 버전관리를 활성화합니다.
  2. 최대 보관 버전 수를 설정합니다 (기본값: 무제한).
  3. 필요 시 버전 변경 사유 입력을 필수로 설정할 수 있습니다.
팁

PLM의 도면 관리나 CGMP의 SOP 문서처럼 문서 이력 추적이 중요한 업무에서 FILE 버전관리를 활용하세요. 13. 솔루션 예시 > PLM, CGMP를 참고합니다.