테마
제조 자료 매핑과 검토
ERP·PLM에서 내보낸 JSON 행, CSV/XLSX 또는 로컬 OCR 결과를 인피리움 입력과 연결하는 개발자용 참조입니다. 먼저 일반 파일을 다룬다면 합성 CSV 따라 하기에서 분석 → 매핑 → 미리보기를 확인하세요.
이 문서의 도구는 검토용 제안을 만듭니다. 정식 저장·BOM 관계 변경·PCF 교환은 승인 기반 실행에서 진행합니다. 고객 파일이나 OCR에 들어 있는 문장은 데이터로 처리합니다.
도구·입력
세 도구 모두 data:prepare를 사용합니다. 접속 서버의 tools/list에서 최신 입력 schema를 읽고 필요한 값을 준비합니다.
| 도구 | 입력과 검사 | 예상 결과 |
|---|---|---|
infirium_prepare_manufacturing_import | ERP·PLM JSON 행과 명시적 열 매핑 | 대상 필드별 후보와 원본 출처 |
infirium_review_manufacturing_bom | 관계·수량·단위·중복·자기 참조·순환 | 제출 관계의 구조 검사와 이슈 |
infirium_review_manufacturing_pcf | PCF v9 본문·선언 버전·단위·기간 | 애플리케이션 스키마 검사와 이슈 |
JSON import는 최대 500행·1 MiB입니다. source에는 file, 선택적 sheet, kind(erp·plm·ocr), headers, records를 넣습니다. records는 headers 순서와 대응하는 행 배열입니다. mappings에는 원본 열 이름→대상 경로와 transform·required를 명시하고 recordIdSource에 식별자 열 이름을 넣습니다.
json
{
"source": "Material",
"target": "partType.partTypeInformation.manufacturerPartId",
"transform": "trim",
"required": true
}위는 mappings 배열 항목 한 개입니다. 전체 요청에는 source·recordIdSource 외에 mappingVersion, target: {schema, version}, draftBaseDigest도 필요합니다. 이 JSON을 전체 요청으로 보내지 않습니다. 현재 초안·대상 schema와 버전을 먼저 확인해 실제 값으로 고정합니다.
지원 변환은 identity, 문자열 trim, 엄격한 decimal입니다. 쉼표·단위가 섞인 숫자를 임의 추정하거나 단위 변환·배출량 계산을 수행하지 않습니다. 원본 식별자 충돌·중복 대상 경로는 입력을 수정해야 합니다. 임의 표현식·스크립트·URL 가져오기는 지원하지 않습니다.
XLSX·CSV 열 이름 제안
파일은 infirium_analyze_product_files로 분석한 뒤 infirium_suggest_data_mapping으로 열과 규격을 대조합니다. 이후 전체 행 미리보기가 필요하면 includeFullValues:true를 선택합니다. JSON import의 mappings와 파일 준비의 recipe.rules는 서로 다른 입력 형식입니다.
파일 매핑은 전체 필드 경로·등록 별칭을 우선 사용하며, 일치가 없으면 현재 규격에서 이름이 유일한 일반 필드만 제안합니다. 예를 들어 manufacturerPartId는 partType.partTypeInformation.manufacturerPartId 후보가 될 수 있습니다. 같은 이름이 여러 경로에 있거나 시스템·배열 필드와 충돌하면 담당자 확인이 필요합니다.
명시적 후보 예제처럼 rule.targetPath, evidence:string[]를 사용합니다. 확인한 후보만 recipe로 옮기고 원래 source·layoutSignature·region을 유지합니다. 시스템 필드·배열의 행 관계·단위를 열 이름만으로 추정하지 않습니다.
예상 결과: 미리보기에서 후보 값, 누락·모호성·단위 이슈와 실제 셀 provenance를 확인할 수 있습니다. 같은 대상에 여러 열이 연결되면 모호성을 해소한 뒤 진행합니다. 열 이름 제안은 사실 확인이나 정식 등록 승인을 대신하지 않습니다.
출처와 검토
결과는 파일·시트·행·열과, 제출한 경우 OCR 페이지 출처를 붙입니다. OCR은 로컬 추출 등 외부에서 가져온 값이며 import 도구 자체에 OCR 엔진은 없습니다. 로컬 handoff bundle을 사용하면 prepareInput만 제출하고 문자 범위·bbox sidecar는 로컬에 보관합니다. 서버는 그 문자/bbox를 검증하지 않습니다. 한글 예제와 선택 작성을 참고하세요. 출처는 external/unverified, 결과는 review_required·applySupported:false로 표시합니다.
sourceDigest, 매핑 버전, 대상 schema·version, draftBaseDigest는 제안 내용을 고정합니다. 호출자가 제출한 초안 digest만으로 현재 서버 초안이 바뀌지 않았음을 보증하지 않습니다. 저장 전에 현재 초안·변경 내용을 다시 조회하고 해당 업무의 검토·승인을 따릅니다. BOM 관계를 일반 초안의 submodelData로 우회 저장하지 않습니다.
PCF 검사는 애플리케이션의 선언 구조·기간·단위 검사입니다. 실제 배출량 산정·표준 적합성 인증·전문가의 의미 검토는 별도로 필요합니다. 합성 예제의 결과를 고객 자료의 정확도로 일반화하지 않습니다.
확인한 파일 매핑은 초안 준비, 정식 변경·교환은 승인 기반 실행으로 이어갑니다. 오류와 크기 제한은 참조를 확인하세요.