SmartMapper 사용 방법 — 링크 복구 패턴 자동 생성

기존의 링크 복구는 찾기 및 바꾸기 문자열을 직접 입력해야 합니다. SmartMapper는 이 워크플로우를 역전시킵니다: 간단한 소스 → 대상 매핑 규칙을 정의하면 SmartMapper가 모든 찾기/바꾸기 패턴을 자동으로 파악합니다 — 상대 링크, ID 기반 SharePoint DocID, PowerQuery 경로 및 연결 문자열을 해석하고 — 단 하나의 문서도 건드리기 전에 정확도와 커버리지를 보고합니다.

SmartMapper를 사용해야 할 때: 모든 찾기/바꾸기 쌍을 수동으로 열거할 수 없는 마이그레이션 — SharePoint 테넌트 간 이동, 대규모 파일 공유-클라우드 마이그레이션, ID 기반 또는 상대 링크가 있는 환경, 그리고 운영 전에 최종 승인 보고서가 필요한 모든 프로젝트. 이전 및 새 경로를 이미 알고 있는 단순 서버 이름 변경의 경우 표준 ReplaceMagic으로 충분합니다.

SmartMapper 워크플로우 한눈에 보기

7단계 파이프라인

스캔

문서 또는 SharePoint에서 링크 데이터베이스 채우기

→

DB 선택

SQL Server, SQLite 또는 MySQL

→

규칙 매핑

소스 → 대상 쌍

→

생성

패턴 자동 생성 & 점수 산출

→

검토

각 패턴 수락 / 수정 / 거부

→

적용

실제 문서에 대체 엔진 실행

→

검증

재스캔 및 보고서 내보내기

1단계 문서 스캔

SmartMapper가 패턴을 생성하려면 링크 데이터베이스가 채워져 있어야 합니다. 표준 문서 스캔 기능을 사용하여 소스 저장소를 크롤링합니다 — 로컬 또는 네트워크 폴더, 매핑된 드라이브, 또는 기본적으로 연결된 SharePoint 라이브러리.

파일 서버 또는 네트워크 공유 소스의 경우, ReplaceMagic을 루트 폴더로 지정하고 전체 스캔을 실행합니다. 발견된 모든 하이퍼링크, OLE 링크, 링크 소스, PowerQuery 명령 및 연결 문자열이 데이터베이스에 기록됩니다.
SharePoint 소스(테넌트 간 프로젝트 포함)의 경우, 기본 SharePoint 통합을 통해 연결합니다. 소스 테넌트가 아직 라이브 상태일 때 스캔하는 것이 중요합니다 — SmartMapper는 문서 인덱스에 대해 ID 기반 링크를 해석하며, 소스가 오프라인되는 순간 해당 ID는 더 이상 해석할 수 없습니다.
스캔 설정에서 모든 관련 문서 영역을 선택합니다: 하이퍼링크, OLE 링크, 링크 소스, Power Queries, 연결, VBA. 스캔되지 않은 영역은 SmartMapper에 보이지 않습니다.

전체 스캔 지침은 문서 스캔 방법 및 SharePoint 기본 지원 가이드를 참조하세요.

2단계 데이터베이스 백엔드 선택

SmartMapper는 스캔된 모든 링크, 매핑 규칙, 생성된 패턴 및 검증 결과를 관계형 데이터베이스에 저장합니다. 세 가지 백엔드가 지원되며 — 동일한 스키마, 동일한 결과:

SQL Server

공유, 엔터프라이즈 관리 프로젝트에 최적입니다. SQL Server Express는 대부분의 마이그레이션에 충분합니다. 여러 팀원이 동일한 패턴 데이터베이스에 액세스해야 할 때 사용합니다.

SQLite

단일 머신 또는 파트너 주도 프로젝트에 최적입니다. 파일 하나, 설치 불필요, 라이선스 비용 없음. 노트북 기반 마이그레이션에 이상적입니다.

MySQL

MySQL 인프라가 이미 있는 환경에서 SQL Server에 대한 오픈 소스 대안입니다. 다른 두 백엔드와 동일한 스키마.

구성 → SmartMapper 탭 → 데이터베이스 백엔드에서 백엔드를 구성합니다. 실행 사이에 백엔드를 전환할 수 있으며 스키마가 동일하므로 데이터 마이그레이션이 간단합니다.

3단계 소스-대상 매핑 규칙 정의

매핑 규칙은 SmartMapper가 사용자에게 필요로 하는 유일한 입력입니다. 각 규칙은 단일 소스 → 대상 쌍입니다:

파일 공유에서 SharePoint Online 마이그레이션을 위한 예시 매핑 규칙

소스(이전 경로)	→	대상(새 경로)
\\ServerABC\Finance	→	https://company.sharepoint.com/sites/financenew
\\ServerABC\HR	→	https://company.sharepoint.com/sites/hr
\\OldNAS\Shared\Projects	→	https://company.sharepoint.com/sites/projects

효과적인 매핑 규칙 작성 팁:

가장 유용한 수준에서 매핑합니다 — 모든 개별 하위 폴더 대신 \\Server\Finance를 매핑합니다. SmartMapper의 패턴 최적화기가 하위 폴더 패턴을 자동으로 통합합니다.
규칙을 가장 구체적인 것에서 덜 구체적인 순서로 나열합니다.
테넌트 간 마이그레이션의 경우, 이전 테넌트 기본 URL에 대한 규칙과 이전 테넌트 내부 ID 해석기 URL에 대한 규칙을 추가합니다. SmartMapper는 소스 테넌트가 해제되기 전에 소스 문서 인덱스를 사용하여 모든 ID 기반 링크를 절대 경로로 해석합니다.
규칙은 SmartMapper 그리드에서 수동으로 입력하거나 CSV 파일에서 가져올 수 있습니다(기본적으로 파이프 |로 구분).

4단계 SmartMapper 패턴 생성 실행

SmartMapper 탭에서 패턴 생성을 클릭합니다. 데이터베이스의 각 링크에 대해 SmartMapper는:

링크 유형 감지 — 절대, 상대, SharePointDocID, OneDriveID, PowerQuery, ConnectionString, OneNote, SharePoint-특수.
모든 링크를 절대 경로로 확인합니다 — 상대 링크, ID 기반 링크, PowerQuery 명령 (File.Contents, Folder.Files, Web.Contents) 또는 연결 문자열 (Provider=, DSN=, Data Source=, OPENROWSET) 에 포함된 링크 등 형식을 가리지 않습니다.
매핑 규칙 적용하여 새 대상 경로(NewLink)를 생성합니다.
목적을 달성하는 최소 범위로 패턴을 생성합니다 — 따라서 \\Server\Finance 같은 광범위한 규칙이 수천 개의 중복된 하위 폴더 패턴을 만들지 않습니다.
중복 제거 및 최적화: 패턴 최적화기를 통해 다른 링크의 동일한 패턴이 단일 항목으로 통합됩니다.
충돌 표시: 동일한 SearchString이 두 개의 다른 ReplaceString에 매핑되는 경우. 이는 충돌로 표시되며 수락되기 전에 사람이 해결해야 합니다.

상대 링크를 수동으로 복구할 수 없는 이유

\\ServerABC\Finance\Reports\Q2.xlsx 에 있는 통합 문서에 ..\Sub1\file.xlsx 링크가 있습니다. 동일한 텍스트가 수백 개의 다른 문서에도 나타나지만 가리키는 위치는 문서마다 다릅니다. 상대 링크는 그것을 포함한 문서와의 관계에서만 의미를 갖기 때문입니다.

하나의 찾기 및 바꾸기 쌍으로는 이를 해결할 수 없습니다. SmartMapper는 각 항목이 실제로 무엇을 가리키는지 판별하고 사용자의 규칙을 적용하여 패턴을 생성합니다. 사용자가 제공하는 것은 다음 한 줄입니다.

\\ServerABC\Finance → https://company.sharepoint.com/sites/financenew

5단계 생성된 패턴 검토

패턴 그리드는 상태 및 검증 지표와 함께 자동 생성된 모든 찾기/바꾸기 조합을 표시합니다. 어떤 문서도 건드리기 전에 각 패턴을 검토합니다:

패턴 상태

생성됨	SmartMapper가 생성했으나 아직 검토되지 않음
수락됨	승인됨 — 문서에 대해 실행됩니다
거부됨	명시적으로 제외됨 — 실행되지 않습니다
수정됨	SearchString 또는 ReplaceString을 편집함 — 수정된 버전으로 실행됩니다
충돌	동일한 SearchString이 다른 ReplaceString에 매핑됨 — 수락되기 전에 해결해야 합니다

정확도와 커버리지

각 패턴은 정상 수(이 패턴이 올바르게 복구할 링크 수), 오류 수(이 패턴이 손상시킬 링크 수), 그리고 정확도 비율를 표시합니다. 실행 로그에서는 이를 Confidence (fix accuracy)(으)로 표시합니다.

신뢰도 100%이고 오류 링크가 없는 패턴은 즉시 수락해도 안전합니다. 오류 항목이 있는 패턴은 검사해야 합니다 — 겹치는 매핑 규칙이나 모호한 경로 세그먼트를 나타낼 수 있습니다.

실행 수준에서 SmartMapper는 두 개의 독립적인 수치를 보고하며, 두 가지 모두 필요합니다:

정확도 — 수락된 패턴이 변경하는 링크 중 올바르게 변경되는 비율.
커버리지 — 전체 대상 링크 중 올바르게 복구되는 비율.

두 지표는 서로 다른 것을 측정하며 독립적으로 움직입니다. 어떤 실행은 정확도 100%이면서도 대상 링크의 82%만 커버할 수 있습니다 — 변경한 내용은 모두 옳았지만 작업의 5분의 1 가까이는 손도 대지 않은 것입니다. 하나로 합친 점수는 바로 그 격차를 감추기 때문에, 두 수치는 별도로 보고됩니다.

이해관계자 보고용으로 선택적인 종합 요약도 제공됩니다. 정확도와 커버리지 수치를 대체하지 말고 반드시 함께 게시하십시오.

충돌은 수동으로 해결해야 합니다. 충돌은 두 개의 다른 링크가 동일한 SearchString으로 해석되었지만 서로 다른 ReplaceString을 가짐을 의미합니다 — SmartMapper는 어떤 것이 올바른지 결정할 수 없습니다. 충돌 그룹을 열고 소스 문서를 검사하여 올바른 ReplaceString을 선택하고 해결을 클릭하거나, 링크를 변경하지 않으려면 패턴을 완전히 거부합니다.

6단계 수락된 패턴을 문서에 적용

검토된 패턴에 만족하면 대체 엔진을 실행합니다. 수락됨 또는 수정됨 상태의 패턴만 적용됩니다 — 생성됨, 거부됨 및 미해결 충돌 패턴은 건너뜁니다.

문서는 Word, Excel 또는 다른 애플리케이션으로 열지 않고 병렬로(구성 가능한 스레드 수) 처리됩니다.
미리 보기 모드가 활성화된 경우 ReplaceMagic은 적용할 모든 변경 사항을 보고하지만 디스크에 아무것도 쓰지 않습니다 — 적용하기 전에 출력을 검증하는 데 사용합니다.
자동 백업을 활성화하여 수정 전 모든 문서의 복사본을 저장합니다.
SharePoint 대상의 경우, 변경 후 메타데이터를 보존하기 위해 마지막 수정 날짜 및 수정자 값 유지를 활성화합니다(사이트 관리자 권한 필요).

자세한 대체 엔진 설정은 끊어진 링크 수정 방법을 참조하세요.

7단계 결과 검증 및 내보내기

대체 실행이 완료된 후:

동일한 저장소를 재스캔하여 이전에 끊어진 모든 링크가 이제 해석되는지 확인합니다. 새 스캔 결과를 기준선과 비교하여 어떤 링크가 상태를 변경했는지 정확히 확인할 수 있습니다.
추가 정보 탭에서 건너뛴 문서(크기 제한, 타임아웃, SharePoint 제한)를 확인합니다. 건너뛴 파일 가져오기를 클릭하여 건너뛴 파일을 재처리합니다.
결과 내보내기: CSV, Excel 또는 SmartMapper 데이터베이스로 내보냅니다. 내보내기에는 원래 링크, 새 링크, 적용된 패턴, 문서 경로 및 변경 타임스탬프가 포함됩니다 — 규정 준수 또는 이해관계자 보고를 위한 완전한 감사 추적.
스캔된 총 링크, 적용된 패턴, 정상 / 오류 수 및 정확도와 커버리지 두 수치을 보여주는 최종 승인 문서를 제공하기 위해 SmartMapper 탭에서 실행 수준 보고서를 내보냅니다.

내보내기 형식 옵션은 결과 내보내기 방법을 참조하세요.

특수 사례: SharePoint DocID 링크 및 테넌트 간 마이그레이션

SharePoint ID 기반 링크(DocID, OrganizationalViewLink, DirectLink)는 ID가 원래 테넌트 내에서만 의미가 있기 때문에 기존 도구로 복구하기 가장 어려운 링크 유형입니다. 소스 테넌트가 해제되면 해당 ID는 영구적으로 사라집니다.

SmartMapper는 소스가 아직 라이브 상태일 때 스캔하여 이 문제를 해결합니다:

소스 SharePoint 테넌트에 연결하고 아직 운영 중일 때 전체 스캔을 실행합니다.
테넌트 간 매핑 규칙을 정의합니다(이전 테넌트 기본 URL → 새 테넌트 기본 URL).
패턴 생성을 실행합니다.
생성된 패턴은 이전 ID 기반 URL을 새 절대 URL로 교체합니다 — 소스 테넌트가 오프라인이 된 후에도 작동하는 복구입니다.

핵심 사항: 마이그레이션 전환 전에 소스 테넌트에서 SmartMapper 스캔을 실행합니다. 소스가 오프라인되면 DocID 해석이 더 이상 불가능합니다.

전체 테넌트 간 마이그레이션 가이드는 SharePoint Online 테넌트 간 마이그레이션: 끊어진 링크 수정을 참조하세요.

PowerQuery, ConnectionString 및 OLE 링크 작업

많은 대형 Excel 환경에는 표준 하이퍼링크로 노출되지 않는 링크가 포함되어 있습니다 — PowerQuery M 코드, OLEDB 연결 문자열 또는 피벗 캐시 정의 내부에 묻혀 있습니다. SmartMapper는 이를 자동으로 추출합니다:

PowerQuery: SmartMapper는 File.Contents, Folder.Files, Web.Contents, SharePoint.Files를 포함한 PowerQuery M 명령 내부의 경로를 처리합니다. 로컬 파일을 SharePoint로 이전하는 경우 경로만 바꾸는 것으로는 충분하지 않습니다. 쿼리 자체가 클라우드 저장소에서 동작해야 하며, SmartMapper가 이 부분도 처리합니다.
ConnectionString: Provider=, DSN=, Data Source=, OPENROWSET, OPENDATASOURCE 및 BULK INSERT 문 내부의 경로는 일반 링크와 동일한 파이프라인을 사용하여 추출, 해석 및 매핑됩니다.
OLE 링크 및 링크 소스: 외부 데이터 소스(다른 통합 문서, 데이터베이스 파일)에 연결되는 Excel 통합 문서는 링크 소스 영역을 통해 외부 참조 경로가 업데이트됩니다.

SmartMapper 데이터베이스에 포함시키려면 스캔 설정에서 Power Queries, 연결 및 링크 소스 영역이 선택되어 있는지 확인합니다.

팁 및 모범 사례

프로토타이핑에 SQLite를 사용합니다. SQLite 백엔드로 첫 번째 SmartMapper 패스를 실행합니다 — 서버 설치 불필요, 즉시 시작. 대형 팀 프로젝트를 위한 전체 SQL Server 배포에 커밋하기 전에 패턴 품질을 검증합니다.
다중 파동 마이그레이션에 RunID를 사용합니다. 각 SmartMapper 실행은 RunID로 범위가 지정됩니다. 마이그레이션 파동별로 다른 RunID를 할당하면 서로 다른 파동의 결과가 서로를 오염시키지 않고 동일한 데이터베이스에 공존할 수 있습니다.
운영 전에 충돌을 해결합니다. 미해결 충돌 패턴은 대체 실행에서 제외됩니다. 각 생성 패스 후 충돌 그룹 목록을 검토하고 각각을 명시적으로 해결하거나 거부합니다.
가장 구체적인 매핑 규칙을 먼저 지정합니다. \\Server\Finance\Archive가 \\Server\Finance와 다르게 매핑되어야 하는 경우, 매핑 그리드에서 Finance 규칙 위에 Archive 규칙을 추가합니다.
적용 전에 미리 보기를 실행합니다. 전체 문서 라이브러리에 실행하기 전에 항상 대표적인 문서 하위 집합에서 미리 보기 모드로 실행하여 패턴 출력을 검증합니다.
대체 준비 서비스의 경우: 프로젝트가 너무 크거나 복잡하여 SmartMapper를 직접 실행하기 어려운 경우, ReplaceMagic 팀이 모든 매핑 규칙과 패턴을 대신 준비할 수 있습니다. 대체 준비 패키지를 참조하세요.