TextSync 문서

TextSync는 타이틀 바의 알약 모양 스위치로 전환하는 세 가지 모드를 갖고 있습니다: Text → Excel(내보내기), Excel → Text(다시 기록), Batch Edit Styles. Text → Excel은 화면 하나이며, Excel → Text는 워크북과 폴더를 선택하고, 기록하고, 별도의 보고서 화면을 보는 짧은 시퀀스입니다. Batch Edit Styles는 공유 그리드를 사용하는 자체 단일 화면입니다.

시작하기

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

Text → Excel (export)

파일 추가(Text → Excel)

텍스트를 내보낼 도면 배치를 구성합니다.

Add Files…는 개별 .dwg 파일을(다중 선택 가능) 선택하고, Add Folder…는 폴더 전체를 스캔해 .dwg 파일을 찾습니다 — 하위 폴더까지 스캔할지는 "Include subfolders when adding a folder"(Settings → AutoCAD, 기본값 꺼짐) 설정에 따라 달라집니다. 두 방법 모두 대소문자를 구분하지 않고 이미 목록에 있는 파일과 중복을 제거합니다.
Clear All은 목록을 비웁니다. Remove Selected는 선택된 행을 제거합니다 — 이는 단순 버튼이며 단축키가 아닙니다. 이 화면에는 다른 CADXChange 도구의 일부 파일 목록과 달리 Delete 키 처리가 없습니다.
파일 목록에는 이름과 경로가 표시되며, 열 헤더를 클릭해 정렬할 수 있습니다. 아직 파일이 추가되지 않았을 때는 빈 표 대신 빈 상태 안내가 표시됩니다.
DBText와 MText를 구분하는 엔터티 타입 필터는 없습니다 — 배치의 모든 DBText와 MText 엔터티가 항상 읽힙니다.

Options 및 Export to Excel

일반 텍스트와 함께 무엇이 내보내지는지, 그리고 실행에 적용되는 Free 등급 제한입니다.

Parallel processing(기본적으로 켜짐)은 파일을 한 번에 하나씩이 아니라 여러 개를 동시에 읽습니다. Free 등급은 이 체크박스나 Settings의 "Max parallel AutoCAD instances" 값과 상관없이 항상 한 번에 한 파일로 고정됩니다 — 속도 향상은 Pro에서만 적용됩니다.
Free 등급은 실행을 DWG 파일 3개로 제한합니다 — 초과하면 부분 배치를 내보내는 대신 실행 전체가 제한을 명시하는 메시지와 함께 차단됩니다. Pro는 이 제한을 없앱니다. TextSync는 내보낸 워크북 자체에 별도의 행 수 제한을 두지 않습니다.
Export to Excel은 항상 타임스탬프가 찍힌 워크북 하나 — TextSync_Export_{yyyyMMdd_HHmmss}.xlsx — 를 기록하며, 일치하는 모든 엔터티에 대해 file, handle, entity type, layer, content를 담습니다. 파일 이름은 입력 파일 자체의 이름과 무관합니다.
출력 폴더는 기본적으로 추가된 모든 파일이 공유하는 상위 폴더로 설정됩니다. 파일들이 여러 폴더에 흩어져 있으면 대신 고정된 Documents\TextSync\Exports 폴더로 대체됩니다.
쓰기가 끝나면 통합 문서를 바로 열지 묻는 프롬프트가 표시됩니다. 내보내는 중 Cancel을 누르면 현재 처리 중인 파일이 끝난 후 멈춥니다. AutoCAD가 응답하지 않는 파일은 10분 후 중단되어 실패로 보고되며, 나머지 배치는 계속 진행됩니다.

Excel → Text (write back)

워크북과 DWG 폴더 선택(Excel → Text)

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

Step 1: Excel Workbook에서 내보내진(그리고 그 이후 편집된) .xlsx 파일을 찾습니다.
Step 2: DWG Folder. "Use the Excel file's folder"(기본적으로 체크됨)는 워크북 자신의 위치에서 자동으로 폴더를 도출합니다. 폴더를 직접 찾아보면 이 체크가 해제되므로, 나중에 자동으로 도출된 폴더로 조용히 다시 돌아가지 않습니다.
워크북 행과 도면의 매칭은 해당 한 폴더 안에서 정확한 파일 이름만으로 이루어집니다 — Text → Excel 쪽의 Add Folder와 달리, 이 폴더는 "Include subfolders" 설정과 무관하게 절대 재귀적으로 스캔되지 않습니다.
Automatic backup(기본적으로 켜짐)은 어떤 변경이 이루어지기 전에, 기록될 모든 파일을 수정 없이 백업 폴더에 먼저 복사합니다. 백업 폴더는 기본적으로 DWG 폴더를 처음 선택할 때 그 옆에 생성되는 _TextSyncBackup 폴더로 지정됩니다.
Restore Backup…은 별도의 독립된 창을 열며(아래 참고), 현재 백업 폴더로 미리 채워집니다 — 디스크에 있는 백업 아카이브를 직접 읽으므로, 앱을 재시작한 뒤에도 계속 동작합니다. 이는 보고서 화면의 세션 내 Rollback All과 다릅니다.

Matched Files와 Unmatched

무언가 기록되기 전에 TextSync가 찾아낸 결과 — 필드 단위 차이점이 아니라 매칭 개수입니다.

워크북과 폴더를 선택하고 매칭되는 항목이 하나라도 있으면 비교가 자동으로 실행됩니다. 다른 일부 CADXChange 다시 기록 도구와 달리, 여기에는 드라이런 차이점/미리보기 단계가 없습니다 — Matched Files 탭은 각 매칭된 파일과 그 안에서 변경될 엔터티 수만 보여주며, 이전/이후 값 표는 보여주지 않습니다.
파일 이름이 DWG 폴더 안에서 정확히 매칭되지 않는 워크북 행은 전체 실행을 실패시키는 대신 Unmatched 탭에 표시됩니다 — 탭 헤더에 현재 미매칭 개수가 표시됩니다.
워크북 자체를 읽지 못하면(잘못된 파일, 손상, 잘못된 형식) 상태 메시지가 빈 목록이나 오래된 목록을 보여주는 대신 오류를 명시합니다.

Write Back

쓰기가 일어나기 전에 범위를 확인시켜줍니다 — 쓰기 후 검증 단계는 없습니다.

확인 대화상자에는 앞으로 변경될 파일 수와 엔터티 수가 정확히 표시되고, 백업 폴더 이름이 명시됩니다 — 백업이 꺼져 있으면 변경을 되돌릴 수 없다고 명확히 경고합니다.
Free 등급의 실행당 3파일 제한이 여기에도 적용되며, 기록 대상으로 매칭된 파일을 기준으로 계산됩니다.
파일별로 쓰기 전에 실제 백업 파일이 디스크에 생성되므로, 파일은 병렬이 아니라 하나씩 기록됩니다. 파일 자체의 백업이 실패하면 해당 쓰기는 완전히 건너뛰어집니다 — TextSync는 방금 백업에 실패한 파일을 절대 기록하지 않습니다.
BlockSync의 동등한 다시 기록 기능과 달리, TextSync는 기록 후 변경이 실제로 적용되었는지 확인하기 위해 파일을 다시 읽지 않습니다 — 파일별 결과는 오직 AutoCAD 자체의 쓰기 명령이 기록 시점에 보고한 성공/실패만 반영합니다. 도면과 실제로 다른 값만 기록됩니다. 텍스트가 바뀌지 않은 MText는 서식(글꼴, 색상, 스택 등)이 모두 유지되고, 값이 필드에서 오는 문자는 덮어쓰지 않으며(이유와 함께 실패로 보고), 변경할 것이 없는 파일은 아예 저장하지 않습니다.
Cancel은 쓰기 도중 중단하는 대신 현재 기록 중인 파일이 끝나도록 둔 뒤 멈춥니다 — 파일 중간에 멈추면 해당 DWG가 절반만 기록된 상태로 남을 위험이 있기 때문입니다.

Write-Back Report

쓰기가 끝난 뒤, 실행 중 모든 파일에 어떤 일이 있었는지 보여줍니다.

파일당 한 행: 전체 상태, 성공/실패한 엔터티 수, 백업이 저장된 위치(또는 없는 이유)입니다.
파일의 Fail 개수는 0이 아닐 때 클릭할 수 있으며, 숫자만 보여주는 대신 구체적인 엔터티별 사유가 담긴 Write Errors 팝업이 열립니다.
Export Report는 동일한 파일별 세부 내역을 워크북에 저장합니다.
Rollback All은 이번 실행의 모든 파일을 각각의 기록 전 백업에서 한 번에 복원합니다 — 단, 이 보고서 화면이 열려 있는 동안에만 가능합니다. 이는 이번 실행의 메모리 상 결과를 기준으로 동작하기 때문입니다. Finish를 클릭하거나 앱을 재시작한 뒤에는 대신 디스크의 백업 아카이브를 직접 읽는 독립된 Restore Backup… 창을 사용하세요.
Finish는 빈 Excel → Text 화면으로 돌아가며 이번 실행의 결과를 폐기합니다 — 기록이 필요하다면 먼저 보고서를 내보내세요.

Batch Edit Styles

스타일 읽기 및 필터링(Batch Edit Styles)

파일을 추가하면 그 안의 모든 TextStyle이 자동으로 하나의 공유 그리드에 읽혀집니다.

Add Files는 .dwg 파일을(다중 선택 가능) 선택하며, 파일이 추가되는 즉시 TextSync는 각 파일에서 모든 TextStyle을 자동으로 읽습니다 — 별도의 "불러오기" 단계는 없습니다. Clear All은 그리드를 비웁니다.
그리드에는 File, Style Name, Font, Big Font, Width Factor, Fixed Height, Current(해당 파일의 활성 스타일에 체크 표시)와 행별 Make Current 버튼이 표시됩니다 — 이를 클릭하면 해당 행이 현재 스타일로 표시되고 같은 파일에 속한 다른 스타일 행의 표시는 해제되어, 각 파일은 항상 하나의 현재 스타일만 갖게 됩니다.
"Name contains:"는 스타일 이름으로 그리드를 실시간으로 필터링하며, Apply to All과 아래의 일괄 편집 필드가 작동할 범위를 좁혀줍니다(다음 섹션 참고).
Batch Edit Styles의 Automatic backup은 기본적으로 처음 추가된 파일 옆(_TextSyncBackup 하위 폴더)을 폴더로 지정합니다. 백업 폴더가 한 번도 설정되지 않았다면 TextSync는 기록 시점에 애플리케이션 자체 옆의 폴더로 대체합니다 — Excel → Text와는 다른 대체 방식이므로, 백업이 예상치 못한 곳에 생기면 참고하세요.

일괄 편집과 Create Text Style

여러 행에 걸쳐 한 번에 필드를 변경하거나, 로드된 모든 파일에 새 스타일을 추가합니다.

Font, Big Font, Width Factor, Fixed Height — 네 개의 독립적인 체크박스+필드 쌍이며, 각각 자신의 체크박스가 체크되어 있을 때만 적용됩니다. 체크되지 않은 필드는 값이 입력되어 있어도 그대로 유지됩니다.
Apply to Selected는 체크된 필드를 강조 표시된 그리드 행에만 적용합니다. Apply to All은 선택 여부와 무관하게 현재 "Name contains" 필터로 표시된 모든 행에 적용합니다 — 특정 스타일로 일괄 편집 범위를 좁히려면 먼저 필터를 좁히세요.
Width Factor/Fixed Height의 경우, 숫자로 해석되지 않는 값을 입력하면 오류를 표시하는 대신 해당 필드에 대해 조용히 무시됩니다 — 일괄 편집이 적용되지 않는 것 같다면 입력한 값이 실제로 숫자인지 확인하세요.
Create Text Style은 이름과 Font/Big Font/Width Factor/Fixed Height를 입력받은 뒤, 현재 로드된 모든 DWG 중 정확히 같은 이름(대소문자 구분 없음)의 스타일이 아직 없는 파일에 추가합니다 — 이미 해당 스타일이 있는 파일은 덮어쓰지 않고 건너뛰고 따로 보고됩니다. 새 행이 그리드에 추가되고 화면에 스크롤되어 보입니다.

Write Styles Back

스타일 정의를 다시 기록한 뒤, 기존 텍스트를 스타일뿐 아니라 지오메트리까지 맞춰 업데이트합니다.

확인 대화상자에는 기록될 파일 수와, 백업이 켜져 있다면 그 위치가 표시됩니다. 백업이 꺼져 있으면 변경을 되돌릴 수 없다고 경고합니다. Batch Edit Styles에는 다른 두 모드와 달리 Free 등급 파일 수 제한이 없습니다 — 여기서의 실행은 3파일로 제한되지 않습니다.
파일에 이미 존재하는 스타일의 경우, Write Styles Back은 중복을 만드는 대신 기존 정의의 Font, Big Font, Width Factor, Fixed Height를 업데이트합니다(그리고 Current로 표시되어 있으면 해당 파일의 현재 스타일로 설정합니다).
그런 다음 모델 공간과 모든 도면 공간 레이아웃에서 해당 스타일을 사용하는 모든 DBText를 찾아, Width Factor는 무조건 맞춰 설정하지만 높이는 Fixed Height가 0보다 클 때만 맞춰 업데이트합니다 — Fixed Height가 0(또는 비어 있음)이면 기존 텍스트의 높이를 0으로 축소하지 않고 그대로 둡니다.
Write Back과 동일하게 백업이 강한 게이트로 작동합니다: 파일 자체의 백업이 실패하면 안전 복사본 없이 진행하는 대신 해당 파일의 스타일 쓰기가 완전히 건너뛰어집니다.

Restore Backup

Restore Backup(독립 창)

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

메인 앱의 탭이 아니라 자체 창으로 열리며 — Excel → Text와 Batch Edit Styles 양쪽에서 모두 사용 가능합니다 — TextSync를 재시작해 원래 세션이 사라진 뒤에도 계속 동작합니다.
백업 폴더를 지정하면 그 안의 모든 백업을 최신순으로 표시합니다(실행 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 adding a folder

Settings → AutoCAD

Text → Excel 화면의 Add Folder…에만 적용됩니다 — Excel → Text의 DWG 폴더 매칭(항상 최상위 폴더만)이나 Batch Edit Styles(폴더 선택기가 없음)에는 영향을 주지 않습니다.

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

실행이 특정 파일에서 멈춘 것처럼 보이는 경우

파일마다 10분 제한이 있습니다. AutoCAD가 한 파일에서 그만큼 멈추면 TextSync는 해당 파일을 처리하던 백그라운드 프로세스를 중지하고, 그 파일을 시간 초과로 보고한 뒤 다음 파일로 넘어갑니다. Cancel은 언제든지 클릭할 수 있으며, 멈췄을 때 AutoCAD가 무엇을 하고 있었는지는 로그 폴더에서 확인하세요.

Excel → Text 실행 중 파일이 "Unmatched"에 표시되는 경우

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

스타일 변경이 텍스트 자체에 반영되지 않는 것 같은 경우

그리드만 편집한 것이 아니라 Write Styles Back을 사용했는지 확인하세요 — 이 단계가 해당 스타일을 사용하는 모든 DBText에 Width Factor / Fixed Height를 다시 적용합니다. Fixed Height 값도 확인하세요 — Fixed Height가 0이거나 비어 있으면 기존 텍스트의 높이를 일부러 그대로 두므로, 스타일 레코드는 업데이트되었더라도 텍스트 크기가 눈에 띄게 바뀌지 않습니다.

Batch Edit Styles의 일괄 편집이 적용되지 않는 것 같은 경우

적용되려면 필드의 체크박스가 체크되어 있어야 합니다 — 체크되지 않은 필드는 값이 입력되어 있어도 무시됩니다. Width Factor/Fixed Height의 경우, 숫자로 해석되지 않는 값은 오류로 표시되는 대신 해당 필드에 대해 조용히 건너뛰어지므로 일반 숫자인지 다시 확인하세요.

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

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

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

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

로컬 파일

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

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