CADXChange

P3DSync 문서

P3DSync는 일반 AutoCAD 블록 참조가 아니라 Plant3D 자산(파이프, 밸브, 장비와 그 UDA 속성)을 다룹니다. 추출하거나 다시 기록해야 할 대상이 일반적인 블록 참조와 그 속성이라면 대신 BlockSync를 사용하세요. P3DSync는 타이틀 바의 알약 모양 스위치로 전환하는 두 가지 모드를 갖고 있습니다: Plant3D → Excel(추출)과 Excel → Plant3D(다시 기록). 추출은 Assets/Layers/Viewports 탭 세트가 있는 화면 하나로 이루어지며, 다시 기록은 워크북과 폴더를 선택하고, 차이점을 검토하고, 다시 기록한 뒤, 별도의 결과 화면을 보는 짧은 시퀀스입니다. 두 모드 모두 자산의 Tag, 지오메트리, 레이어 이상을 읽거나 쓰려면 프로젝트의 Plant3D Project Database(ProcessPower.dcf)가 필요합니다 — 사용자 지정(UDA) 속성은 도면 엔터티가 아니라 그곳에 저장되어 있기 때문입니다.

시작하기

스크린샷은 비교적 최근 릴리스를 기준으로 하며, 설치된 버전과 세부적인 화면이 다를 수 있습니다.

Plant3D → Excel (extract)

파일 추가 및 스캔

도면을 추가하면 P3DSync가 자산 클래스, 레이어, 뷰포트를 자동으로 스캔합니다.

  • Add Files…는 개별 .dwg 파일을 선택하고, Add Folder…는 폴더 전체를 스캔해 .dwg 파일을 찾습니다 — 하위 폴더까지 스캔할지는 "Include subfolders when opening a DWG folder"(Settings → AutoCAD, 기본값 꺼짐) 설정에 따라 달라집니다.
  • 파일을 추가, 제거, 또는 모두 지우면 실시간 파일별 진행 표시줄과 함께 전체 배치가 자동으로 다시 스캔됩니다.
  • 파일 목록에는 이름, 경로, 색으로 구분된 Status/Details 열이 표시됩니다. 스캔에 실패한 파일은 오류와 함께 표시되고 건너뛰어지며, 나머지 배치의 정상적인 스캔을 막지 않습니다.
  • 목록 아래의 상태 줄은 스캔된 모든 파일에 대한 종합 결과를 보고합니다: "{n} asset classes, {n} layers, {n} viewports across {n} file(s)."

Plant3D Project Database 지정하기

ProcessPower.dcf를 한 번 설정해두면 Include attributes가 실제로 UDA 값을 읽을 수 있습니다.

  • P3DSync는 DWG 폴더 옆이나 한 단계 위 폴더에서 ProcessPower.dcf를 자동으로 감지합니다 — 프로젝트 데이터베이스가 다른 곳에 있다면 Browse…로 지정하세요.
  • 프로젝트 데이터베이스가 설정되어 있지 않아도 Tag, 지오메트리, 레이어 추출은 계속 동작합니다 — 다만 사용자 지정(UDA) 속성은 프로젝트 데이터베이스에 저장되어 있고 도면 엔터티 자체에는 없으므로 추출되지 않습니다.

자산 클래스, 레이어, 뷰포트 선택

정확히 어떤 클래스를 — 그리고 각 도면의 어느 부분을 — 내보낼지 선택합니다.

자산 클래스, 레이어, 뷰포트 선택 screenshot
  • Assets 탭은 스캔된 모든 클래스를 참조 횟수, 포함된 파일 수, 속성 보유 여부, 그리고 가능한 경우 인라인 미리보기 썸네일과 함께 나열합니다 — Details…를 클릭하면 내보내기를 확정하기 전에 클래스의 전체 모습을 볼 수 있습니다.
  • 이름으로 검색하거나 Select All / Select None / Invert를 사용해 클래스가 수십 종류인 프로젝트에서 체크리스트를 관리하세요.
  • Layers 또는 Viewports 탭으로 전환하면 내보내기 범위를 더 좁힐 수 있습니다 — 체크된 레이어에 배치되어 있거나 체크된 뷰포트를 통해 보이는 자산만 추출됩니다. 평소처럼 아무것도 체크하지 않으면 전체를 추출합니다.
  • Save Profile…은 현재 클래스(또는 레이어) 선택을 이름을 붙여 저장해 나중에 재사용할 수 있게 하며, Load Profile은 이를 다시 적용합니다. Free 등급은 저장된 프로필을 1개로 제한합니다 — 기존 프로필은 언제든 덮어쓸 수 있습니다.

추출 옵션 및 내보내기 실행

포함할 항목을 선택한 뒤 워크북을 생성합니다.

  • Include attributes는 각 자산의 사용자 지정(UDA) 속성을 Tag와 함께 Plant3D 프로젝트 데이터베이스에서 가져옵니다 — 프로젝트 데이터베이스가 설정되어 있어야 합니다(위 참고).
  • Include geometry는 위치/회전 열을 추가하고, Include layer info는 레이어 열을 추가합니다. Space scope는 추출 범위를 모델 공간, 도면 공간, 또는 둘 다로 제한합니다.
  • Parallel processing은 빠른 컴퓨터에서 여러 파일을 동시에 스캔하고 추출합니다 — 더 빠르지만 메모리를 더 많이 사용합니다.
  • Extract to Excel…은 화면에 표시된 출력 폴더(기본값은 DWG들이 공유하는 폴더)에 타임스탬프가 찍힌 P3DSync_Export_{date}_{time}.xlsx를 기록하며, 자산 클래스당 시트 하나와 _P3DSync 메타데이터 시트(P3DSync/AutoCAD 버전, 소스 파일 이름과 SHA-1 해시, 선택된 클래스/레이어 이름)를 포함합니다.

Excel → Plant3D (write back)

편집된 워크북을 도면과 매칭하기

Excel Workbook과, 이를 대조할 DWG 폴더를 선택합니다.

  • Choose Excel Workbook…으로 편집된 내보내기 파일을 선택합니다. "Same folder as Excel file"(기본적으로 켜짐)은 DWG 폴더를 워크북 자신의 폴더로 설정하며, 순전히 정확한 파일 이름으로만 매칭하므로 워크북을 옮겨도 혼동되지 않습니다.
  • P3DSync는 Plant3D Project Database와 DWG 옆의 백업 폴더를 모두 자동으로 감지합니다 — Browse…로 어느 쪽이든 재지정할 수 있습니다.
  • 폴더 안에 매칭되는 DWG가 없는 행은 조용히 실패하거나 나머지 실행을 막는 대신, 개수 배지와 함께 Unmatched 탭에 표시됩니다.

차이점 미리보기 검토

무언가 기록되기 전에, 파일별로 그리고 속성별로 정확히 무엇이 바뀔지 확인합니다.

차이점 미리보기 검토 screenshot
  • Diff preview 탭은 매칭된 모든 파일을 Change 개수와 Blocked 개수와 함께 나열합니다. 파일을 선택하면 전체 표가 표시됩니다: File, Handle, Class, Attribute, Current, New — 각 행은 사유와 함께 WillChange / NoChange / CannotWrite로 표시됩니다.
  • Show unchanged rows는 기본적으로 꺼져 있어, 대규모 배치에서도 실제로 중요한 몇 건의 편집이 묻히지 않습니다.
  • Export Preview…는 차이점 그리드 자체를 별도의 워크북에 저장합니다 — 기록하기 전에 예정된 정확한 변경 내용을 다른 사람에게 넘겨 승인받을 때 유용합니다.

다시 기록 및 검증

체크된 파일을 기록한 뒤, 모든 변경이 실제로 적용되었는지 확인합니다.

  • 포함할 파일을 정확히 체크한 다음 Write Back을 클릭하세요. 확인 대화상자에는 앞으로 일어날 파일 수와 속성 변경 수가 정확히 표시됩니다.
  • "Automatic backup before writing"(기본값 켜짐)은 각 파일을 수정하기 전에 원본 그대로 백업 폴더에 복사합니다. 프로젝트 데이터베이스(ProcessPower.dcf)도 실행마다 첫 쓰기 전에 한 번 백업됩니다. 둘 중 하나라도 백업에 실패하면 해당 파일에는 아무것도 쓰지 않습니다.
  • 기록 후 P3DSync는 변경된 모든 Tag와 속성을 도면과 프로젝트 데이터베이스에서 직접 다시 읽어 의도한 내용과 일치하는지 검증합니다 — 불일치가 있으면 성공했다고 가정하지 않고 결과 보고서에 명시됩니다.
  • 결과 보고서의 Rollback All은 해당 실행에서 변경한 모든 파일과 프로젝트 데이터베이스를 쓰기 전 백업에서 한 번에 복원합니다. 쓰기 화면의 Restore Backup…은 현재 실행뿐 아니라 이전의 어느 실행 백업에서든 복원합니다. 도면별 데이터베이스 변경은 해당 도면이 저장된 후에만 확정되므로, 실패한 파일 때문에 데이터베이스가 일부만 수정된 상태로 남지 않습니다.

설정

제목 표시줄의 톱니바퀴 아이콘에서 엽니다. 모든 항목은 즉시 저장되며 별도의 저장 버튼은 없습니다.

Language

Settings → General

English / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español. 언어를 변경하면 앱을 재시작해야 적용됩니다.

기본값: English

Theme

Settings → General

System / Light / Dark. 테마를 변경하면 앱을 재시작해야 적용됩니다.

기본값: Match system

AutoCAD version

Settings → AutoCAD

가장 먼저 사용할 설치된 AutoCAD 버전입니다. 로드에 실패하면 앱이 자동으로 다른 설치된 버전으로 대체합니다.

기본값: Auto (newest installed)

Max parallel AutoCAD instances

Settings → AutoCAD

AutoCAD가 백그라운드에서 한 번에 처리할 수 있는 도면 수입니다(선택 가능: 1, 2, 4, 6, 8, 12, 16). 값이 높을수록 빠르지만 CPU와 메모리를 더 많이 사용합니다 — 사양이 낮은 컴퓨터에서는 낮춰 사용하세요.

기본값: 8

Include subfolders when opening a DWG folder

Settings → AutoCAD

Add Folder…가 하위 폴더까지 재귀적으로 탐색할지, 최상위 폴더만 스캔할지를 결정합니다.

기본값: Off

라이선스

라이선스 상태는 타이틀 바에 Free, Pro, Pro (offline), Expired 중 하나로 표시되며, Settings → License에서 전체 내용을 확인할 수 있습니다.

활성화하려면 Settings → License → "License key"에 라이선스 키를 붙여넣고 Activate를 클릭하세요. 라이선스를 다른 컴퓨터로 옮기려면 기존 컴퓨터에서 먼저 "Deactivate this machine"을 클릭한 다음, 새 컴퓨터에서 활성화하세요.

앱이 라이선스 서버에 연결할 수 없는 경우(인터넷 연결이 없거나 서버를 일시적으로 사용할 수 없는 경우), 이전에 활성화한 Pro 라이선스는 "Pro (offline)"으로 14일 동안 계속 작동합니다. 그 기간 안에 다시 연결해 재확인하세요. 14일 동안 확인에 성공하지 못했거나, 구독 종료일이 지났거나, 시스템 시계가 과거로 변경된 경우에는 재확인할 수 있을 때까지 라이선스가 Expired로 표시됩니다.

문제 해결

작업을 시작할 때 "AutoCAD not found" 또는 플러그인 신뢰 오류가 발생하는 경우

이 앱은 각 도면을 열고 처리하기 위해 백그라운드에서 AutoCAD를 구동하므로, 정식 라이선스가 있는 전체 버전의 AutoCAD 2021–2027 설치가 필요합니다 — AutoCAD LT는 지원하지 않습니다. AutoCAD가 설치되어 있는데도 이 오류가 계속 발생한다면, 해당 AutoCAD 버전이 이 컴퓨터에서 한 번도 실행된 적이 없을 가능성이 높습니다. 한 번 실행해(도면 화면까지만 띄워도 됩니다) 닫은 다음 다시 시도하세요 — AutoCAD는 대화형으로 최소 한 번 실행된 이후에만 해당 플러그인 위치를 신뢰합니다.

"Include attributes"가 Tag와 레이어는 추출하지만 사용자 지정 필드는 추출하지 않는 경우

사용자 지정(UDA) 자산 속성은 도면 엔터티가 아니라 Plant3D 프로젝트 데이터베이스에 저장되어 있습니다 — Plant3D Project Database를 프로젝트의 ProcessPower.dcf로 설정하세요(DWG 옆이나 한 단계 위 폴더에서 자동 감지가 찾지 못했다면 Browse…를 사용하세요).

차이점 미리보기에서 행이 CannotWrite로 표시되는 경우

행의 Reason 열이 이유를 설명합니다 — 가장 흔한 원인은 자산의 핸들이 해당 도면에 더 이상 존재하지 않거나, 대상 속성이 그 자산 클래스에 유효하지 않은 경우입니다. CannotWrite로 표시된 행은 파일이 체크되어 있어도 절대 기록되지 않습니다.

예상했던 행이 대신 Unmatched 탭에 있는 경우

다시 기록은 선택한 폴더 안에서 순전히 정확한 파일 이름으로만 Excel 행을 DWG와 매칭합니다 — 워크북이 다른 폴더에서 내보내졌거나 내보내기 이후 파일 이름이 바뀌었다면, DWG 폴더를 다시 지정하거나 다시 내보내세요.

로컬 파일

Settings → Diagnostics → Open Log Folder를 이용하면 로그 폴더로 바로 이동할 수 있어 문제 해결에 도움이 됩니다.

Settings%LocalAppData%\CADXChange\P3DSync\settings.json
Logs%LocalAppData%\CADXChange\P3DSync\Logs\
선택 프로필%LocalAppData%\CADXChange\P3DSync\Profiles\
기본 백업 폴더{DWG folder}\_P3DSyncBackup
기본 내보내기 폴더Documents\P3DSync\Exports