BlockSync 문서

BlockSync는 타이틀 바의 알약 모양 스위치로 전환하는 두 가지 모드를 갖고 있습니다: AutoCAD → Excel(추출)과 Excel → AutoCAD(다시 기록). 추출은 Blocks/Layers/Viewports 탭 세트가 있는 화면 하나로 이루어지며, 다시 기록은 워크북과 폴더를 선택하고, 차이점을 검토하고, 기록한 뒤, 별도의 결과 화면을 보는 짧은 시퀀스입니다.

시작하기

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

AutoCAD → Excel (extract)

파일 추가 및 스캔

도면을 추가하면 BlockSync가 블록, 레이어, 뷰포트를 자동으로 스캔합니다.

Add Files…(Ctrl+O)는 개별 .dwg 파일을 선택하고, Add Folder…는 폴더 전체를 스캔해 .dwg 파일을 찾습니다 — 하위 폴더까지 스캔할지는 "Include subfolders when opening a DWG folder"(Settings → AutoCAD, 기본값 꺼짐) 설정에 따라 달라집니다.
파일을 추가, 제거, 또는 모두 지우면 전체 배치가 자동으로 다시 스캔됩니다. F5는 파일 목록을 바꾸지 않고 필요할 때 다시 스캔합니다. 스캔이 시작되면 도중에 취소할 수 없습니다 — 중간에 멈추면 Blocks/Layers/Viewports 목록이 서로 어긋나기 때문입니다.
Remove Selected는 선택된 파일을 제거하고 다시 스캔하며, Clear All은 목록을 비우고 다시 스캔합니다. Delete 키를 누르면 선택된 파일도 제거되지만, 파일 행에 포커스가 있을 때만 동작합니다 — 검색 상자에 입력 중일 때 누르면 대신 텍스트가 삭제됩니다.
파일 목록에는 이름, 경로, 색으로 구분된 Status/Details 열이 표시됩니다. 스캔에 실패한 파일은 오류와 함께 표시되고 건너뛰어지며, 나머지 배치의 정상적인 스캔을 막지 않습니다.
목록 아래의 상태 줄은 스캔된 모든 파일에 대한 종합 결과를 보고합니다: "{blocks} block definitions, {layers} layers, {viewports} viewports across {files} file(s)."

Blocks 탭

필요에 따라 블록별 세부 정보를 확인하며 추출할 블록 정의를 선택합니다.

열 구성: 체크박스, 썸네일 미리보기, 블록 이름, References(전체 배치에서의 총 인스턴스 수), In files(포함된 파일 수), Dynamic 및 Has attrs 플래그, Details… 버튼(행을 더블클릭해도 동일)입니다.
Details를 클릭하면 해당 블록의 참조/파일 수, 텍스트/MText 개수, 속성 태그 목록, 그리고 다이내믹 블록의 경우 각 다이내믹 속성의 이름과 허용 값이 표시되는 작은 팝업이 열립니다. 다른 행을 클릭해 넘어가도 스스로 닫히지 않고 계속 열려 있습니다.
Search는 입력하는 대로 블록 이름으로 목록을 필터링합니다. Select All / Select None / Invert는 전체 목록이 아니라 현재 검색 결과로 표시된 항목에만 적용됩니다.
Save Profile…은 현재 체크된 블록 집합에 이름을 붙여 저장하고, Load Profile은 저장된 집합을 다시 적용합니다(프로필에 있지만 더 이상 존재하지 않는 블록 이름은 단순히 체크되지 않은 상태로 남습니다). Free 등급은 한 번에 하나의 저장된 프로필만 유지합니다 — 두 번째 프로필을 저장하려고 하면 조용히 덮어쓰거나 실패하는 대신 업그레이드 안내가 표시됩니다.
Extract to Excel은 블록이 하나 이상 체크되어야 활성화됩니다. 파일이 로드되었지만 아직 아무것도 체크되지 않았을 때는 버튼 아래에 "Select at least one block above to enable extraction."이라는 안내가 표시됩니다.

Layers 탭

필요할 때 특정 레이어로 추출 범위를 제한합니다 — Blocks와는 별도의 필터와 저장 프로필을 갖습니다.

전체 배치에서 발견된 모든 레이어 이름을 색상 견본과 "Present in N file(s)…" 버튼(또는 행 더블클릭)과 함께 나열하며, 해당 버튼을 누르면 실제로 어느 파일에 그 레이어가 있는지 확인할 수 있습니다.
아무것도 체크하지 않으면 평소처럼 전체를 추출하며, 레이어를 하나 이상 체크하면 해당 레이어에 배치된 블록 참조만 추출합니다.
자체 Search 상자와 자체 Save Profile…/Load Profile 쌍을 갖습니다 — 레이어 선택은 Blocks 탭에서 체크된 항목과 별도로 저장되며, 두 프로필이 같은 이름으로 저장되어 있더라도 "Foo"라는 레이어 프로필을 저장해도 "Foo"라는 블록 프로필을 덮어쓰지 않습니다.

Viewports 탭

필요할 때 특정 도면 공간 뷰포트를 통해 보이는 블록으로 추출 범위를 제한합니다.

발견된 모든 뷰포트(레이아웃 이름, 레이어, 너비, 높이, 형태 기준)를 Layers 탭과 동일한 "Present in N file(s)…" 조회 기능 및 자체 Search 상자와 함께 나열합니다 — 이 탭에는 프로필 저장/불러오기가 없습니다.
하나 이상의 뷰포트를 체크하면 해당 뷰포트의 클리핑된 뷰를 통해 모델 공간에서 보이는 블록 참조만 추출합니다. 아무것도 체크하지 않으면 Layers와 같은 방식으로 전체를 추출합니다.
여기서 뷰포트를 하나라도 체크하면, 아래 Options의 Include geometry 체크박스가 꺼져 있더라도 이번 실행에 한해 강제로 켜집니다 — 뷰포트로 필터링하려면 각 블록의 위치를 뷰포트 경계와 비교해야 하기 때문입니다.

Options

속성 값 자체와 함께 무엇이 추출되는지를 정합니다 — 모두 기본적으로 켜져 있습니다.

Include nested blocks — 최상위 삽입뿐 아니라 다른 블록 안에 중첩된 블록 참조도 추출합니다.
Include dynamic block attributes — 일반 속성과 함께 다이내믹 블록 속성(가시성 상태, 사용자 지정 매개변수)을 추출합니다. 이 값을 읽는 것은 Free에서도 가능하며, 나중에 변경된 다이내믹 속성 값을 다시 기록하는 것만 Pro 전용입니다(아래 Write Selected Files 참고).
Include geometry — 각 블록 참조의 위치와 회전을 추출합니다. 이 체크박스의 설정과 상관없이 Viewports 필터가 활성화되어 있으면 자동으로 강제로 켜집니다.
Include layer info — 각 블록 참조가 배치된 레이어를 추출합니다.
Parallel processing — 파일을 한 번에 하나씩이 아니라 여러 개를 동시에 스캔/추출합니다. Free 등급은 이 체크박스나 Settings의 "Max parallel AutoCAD instances" 값과 상관없이 항상 한 번에 한 파일로 고정됩니다 — 속도 향상은 Pro에서만 적용됩니다.

Extract to Excel

워크북이 어디에 기록되는지, 그리고 한 번의 실행에 적용되는 Free 등급 제한입니다.

Extract to Excel은 항상 병합된 워크북 하나 — BlockSync_Export_{yyyyMMdd_HHmmss}.xlsx — 를 기록하며, 각 블록 정의는 자신의 워크시트를 갖습니다. 파일별로 별도의 워크북을 만드는 옵션은 없습니다.
출력 폴더는 기본적으로 추가된 모든 파일이 공유하는 상위 폴더로 설정됩니다. 파일들이 여러 폴더에 흩어져 있으면 대신 고정된 Documents\BlockSync\Exports 폴더로 대체됩니다. Open Output Folder를 클릭하면 필요하면 먼저 폴더를 생성한 뒤 바로 그곳으로 이동합니다.
Free 등급은 한 번의 실행을 DWG 파일 3개, 내보낸 행 총 300개로 제한합니다. 둘 중 하나라도 초과하면 아무것도 기록되지 않은 채로 내보내기 전체가 차단됩니다. 즉 잘려나간 결과를 조용히 내보내는 것이 아니라, 어떤 제한 때문인지 명시하는 메시지와 함께 통째로 거부됩니다. Pro는 두 제한을 모두 없앱니다.
기록이 끝나면 워크북을 바로 열지 물어보는 안내가 표시됩니다. Cancel(추출 중)은 진행 중인 파일이 끝난 뒤 멈추며, 해당 파일에 대한 AutoCAD의 백그라운드 작업도 그대로 두지 않고 종료시킵니다.

Excel → AutoCAD (write back)

워크북과 DWG 폴더 선택

편집된 내보내기 파일과 이를 적용할 도면, 그리고 백업이 기록될 위치를 BlockSync에 지정합니다.

Step 1은 내보내진(그리고 그 이후 편집된) .xlsx 워크북을 찾아 선택합니다. 옆의 버튼은 매칭 전에 빠르게 확인할 수 있도록 같은 파일을 직접 셸에서 엽니다.
Step 2는 DWG 폴더를 선택합니다. "Same folder as Excel file"(기본적으로 체크됨)은 워크북 자신의 위치에서 자동으로 폴더를 도출합니다. 폴더를 직접 찾아보면 이 체크가 해제되므로, 나중에 자동으로 도출된 폴더로 조용히 다시 돌아가지 않습니다.
워크북 행과 도면의 매칭은 해당 한 폴더 안에서 정확한 파일 이름만으로 이루어집니다 — AutoCAD → Excel 쪽의 Add Folder와 달리 여기서는 하위 폴더 재귀 탐색이 없습니다.
Enable automatic backup(기본적으로 켜짐)은 어떤 변경이 이루어지기 전에, 기록될 모든 파일을 수정 없이 백업 폴더에 먼저 복사합니다. 이를 끄면 이후 해당 실행을 롤백할 방법이 사라집니다.
백업 폴더는 기본적으로 DWG 폴더를 처음 선택할 때 그 옆에 생성되는 _BlockSyncBackup 폴더로 지정됩니다. Browse로 변경할 수 있습니다.
Restore Backup…은 별도의 독립된 창을 열며(아래 참고), 현재 백업 폴더로 미리 채워집니다 — 디스크에 있는 백업 아카이브를 직접 읽으므로, 앱을 재시작한 뒤에도 계속 동작합니다. 이는 결과 화면의 세션 내 Rollback All과 다릅니다.

차이점 미리보기

BlockSync가 적용하려는 모든 속성 변경 사항을, 먼저 읽기 전용 드라이런으로 계산한 결과입니다.

워크북과 폴더를 선택하고 매칭되는 항목이 하나라도 있으면 미리보기가 자동으로 실행되어, Excel의 각 행을 실제 도면 속성과 하나씩 비교합니다. 매칭은 행 위치나 순서가 아니라 AutoCAD 자체의 객체 핸들을 기준으로 이루어집니다.
왼쪽 파일 목록에는 매칭된 파일마다 Change 개수와 Blocked 개수가 표시됩니다. 파일을 선택하면 오른쪽에 File / Handle / Block / Attribute / Current / New 전체 표가 표시됩니다.
Show unchanged rows는 기본적으로 꺼져 있습니다 — 수백 개의 변경되지 않은 속성 사이에서 실제로 몇 건 안 되는 진짜 편집이 묻히지 않도록 하기 위해서입니다. 파일을 완전히 감사하려면 켜세요.
행이 일반 변경 대신 Blocked로 표시되는 이유는 다음과 같습니다. Excel의 핸들이 도면에 더 이상 없거나, 해당 인스턴스에 속성 태그가 없거나, (동적 속성의 경우) 새 값이 그 인스턴스의 허용 값 목록에 없거나, 속성 값이 필드에서 오는 경우(쓰면 필드가 정적 문자로 바뀜), 또는 도면 자체를 읽을 수 없는 경우입니다. 어느 경우에도 나머지 실행은 멈추지 않으며 해당 행(또는 해당 파일)만 건너뜁니다.
파일 이름이 DWG 폴더 안에서 정확히 매칭되지 않는 워크북 행은 비교 전체를 실패시키는 대신 Unmatched 탭에 표시됩니다.
Export Preview…는 변경, 미변경, 차단 여부와 관계없이 모든 파일의 모든 행을 자체 워크북에 기록합니다 — 무엇이 기록되기 전에 BlockSync 밖에서 차이점을 검토하거나 승인받아야 할 때 유용합니다.

Write Selected Files

쓰기가 일어나기 전에 정확한 범위를 확인시켜주고, 그 뒤 각 변경이 실제로 적용되었는지 검증합니다.

쓰기에는 Diff preview의 왼쪽 목록에서 여전히 체크되어 있는 파일만 포함됩니다. 포함된 파일 안에서도 실제로 변경으로 표시된 행만 전송됩니다 — 미변경 및 차단된 행은 일부라도 있는 파일이라 해도 절대 기록되지 않습니다.
확인 대화상자에는 앞으로 일어날 파일 수와 속성 변경 수가 정확히 표시되고, 백업 폴더 이름이 명시됩니다 — 백업이 꺼져 있으면 대신 롤백할 방법 없이 이 파일들이 수정된다는 경고가 명확히 표시됩니다.
다이내믹 블록 속성 값을 편집하는 것은 Pro 기능입니다. 포함된 변경 중 하나라도 다이내믹 속성 편집이면, Free 등급은 "Editing dynamic block attributes is a Pro feature."라는 메시지와 함께 쓰기 전체를 차단합니다(추출 시 다이내믹 속성 값을 읽는 것은 이와 무관하게 계속 동작합니다).
Extract와 동일한 실행당 도면 3개 제한이 여기에도 적용되며, 체크되어 포함된 파일을 기준으로 계산됩니다.
파일별로 실제 백업 파일이 디스크에 생성되므로, 파일은 병렬이 아니라 하나씩 처리됩니다 — 백업, 기록, 다시 읽어 확인 순서입니다. 파일 자체의 백업이 실패하면 해당 쓰기는 완전히 건너뛰어집니다 — 변경 자체는 안전했을 수 있더라도, BlockSync는 방금 백업에 실패한 파일을 절대 기록하지 않습니다.
쓰기 후 BlockSync는 방금 변경한 모든 항목(속성, 동적 특성, 도면층, 회전)을 다시 읽어 기록한 값과 비교합니다. 불일치가 있어도 실행이 실패하지는 않지만, 성공한 것으로 간주하지 않고 기록하여 결과 화면에 표시합니다.
Cancel은 현재 기록 중인 파일을 끝낸 뒤 다음 파일로 넘어가기 전에 멈춥니다 — 파일 중간에 쓰기를 중단하는 일은 절대 없습니다.

기록 결과

실행 중 모든 파일에 어떤 일이 있었는지, 기록된 그대로 다시 읽었을 때 일치하지 않았던 항목까지 포함해 보여줍니다.

파일당 한 행: 전체 상태, 성공/실패한 속성 변경 수, 백업이 저장된 위치(또는 없는 이유), 그리고 발견된 재확인 불일치 수입니다.
파일의 Fail 개수와 Read-back mismatches 개수는 0이 아닐 때 클릭할 수 있으며, 숫자만 보여주는 대신 구체적인 사유나 값이 담긴 팝업이 열립니다.
Export Report…는 앱 외부에서 기록을 남길 수 있도록 동일한 파일별 세부 내역을 워크북에 저장합니다.
Rollback All은 이번 실행의 모든 파일을 각각의 기록 전 백업에서 한 번에 복원합니다 — 단, 이 결과 화면이 열려 있는 동안에만 가능합니다. 화면을 벗어나면(Finish) 또는 앱을 재시작하면, 대신 독립된 Restore Backup 창을 사용하세요. 이 창은 이번 실행의 메모리 상태가 아니라 디스크의 백업 파일을 기준으로 동작합니다.
Finish는 빈 Excel → AutoCAD 화면으로 돌아가며 이번 실행의 결과를 폐기합니다 — 기록이 필요하다면 먼저 보고서를 내보내세요.

Restore Backup

Restore Backup(독립 창)

현재 화면에 어떤 실행이 표시되어 있는지와 무관하게, 과거의 백업 아카이브를 복원합니다.

메인 앱의 탭이 아니라 자체 창으로 열리므로, BlockSync를 재시작해 원래의 다시 기록 세션이 사라진 뒤에도 계속 동작합니다.
백업 폴더를 지정하면 그 안의 모든 백업을 최신순으로 표시합니다(실행 1회당 1개). 현재 백업은 Backup_{timestamp} 폴더이며, 이전 버전에서 만든 Backup_*.zip 아카이브도 함께 표시됩니다.
아카이브를 선택하면 안에 담긴 개별 DWG가 체크박스와 함께 나열됩니다. Select All / Deselect All로 전체 목록을 한 번에 전환할 수 있습니다.
Restore는 체크된 파일을 아카이브에서 선택한 대상 폴더로 복사하며, 같은 이름의 기존 파일이 있으면 덮어씁니다 — 부분 병합 옵션은 없으므로, 확정하기 전에 대상 폴더를 다시 한번 확인하세요.

설정

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

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

AutoCAD → Excel 화면의 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는 대화형으로 최소 한 번 실행된 이후에만 해당 플러그인 위치를 신뢰합니다.

스캔, 추출 또는 다시 기록 실행이 특정 파일에서 멈춘 것처럼 보이는 경우

수동으로 Cancel을 클릭하는 것 외에도 파일마다 자체 10분 제한이 있습니다 — AutoCAD가 한 파일에서 그만큼 멈춰 있으면 BlockSync가 해당 파일을 처리하던 백그라운드 프로세스를 종료하고 타임아웃으로 보고하며, 나머지 배치는 계속 진행됩니다. 해당 파일의 프로세스가 멈출 당시 무엇을 하고 있었는지는 로그 폴더에서 확인하세요.

다시 기록 중 파일이 "Unmatched"에 표시되는 경우

매칭은 선택한 DWG 폴더 안에서 정확한 파일 이름만으로 이루어지며, 하위 폴더 재귀 탐색이나 유사 매칭은 없습니다 — 워크북의 파일 이름을 해당 폴더(그 하위 폴더가 아닌)에 실제로 있는 것과 대조하고, 내보내기 이후 이름이 바뀌지 않았는지 확인하세요.

"Write Selected Files"가 다이내믹 속성 관련 메시지로 차단되는 경우

변경된 다이내믹 블록 속성 값을 도면에 다시 기록하는 것은 Pro 기능입니다. 추출 시 다이내믹 속성 값을 읽는 것은 Free에서도 계속 동작합니다 — 값을 다시 기록하는 것만 제한됩니다. Pro로 업그레이드하거나, 해당 다이내믹 속성 변경이 포함된 파일/행의 체크를 해제하세요.

백업이 켜져 있는데도 파일 쓰기가 건너뛰어지는 경우

해당 파일의 백업 복사가 실패하면(예: 백업 폴더에 쓰기 권한이 없는 경우) BlockSync는 안전 복사본 없이 진행하는 대신 그 파일의 쓰기를 완전히 건너뜁니다. 기록 보고서의 Backup 열에서 해당 파일의 오류를 확인하고(폴더 권한, 디스크 공간) 문제를 해결한 뒤 다시 실행하세요.

"Rollback All"이 보이지 않거나 동작하지 않는 경우

해당 실행 결과가 Write results 화면에 남아 있는 동안에만 작동합니다. Finish를 클릭하거나 앱을 다시 시작한 후에는 독립된 Restore Backup… 창(Excel → AutoCAD 화면에서 열기)을 사용하세요. 이전 버전의 Backup_*.zip 아카이브를 포함해 디스크에 남아 있는 모든 백업을 읽을 수 있습니다.

로컬 파일

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

Settings	%LocalAppData%\CADXChange\BlockSync\settings.json
Logs	%LocalAppData%\CADXChange\BlockSync\Logs\
기본 백업 폴더	{DWG folder}\_BlockSyncBackup
기본 내보내기 폴더	Documents\BlockSync\Exports