SharePoint 테넌트 간 마이그레이션 후 끊어진 링크 수정

테넌트 간 마이그레이션은 가장 복잡한 SharePoint 시나리오 중 하나입니다 — 기본 URL과 SharePoint’s 내부 항목 ID를 모두 변경하여 모든 Office 문서의 모든 내장 링크가 끊어집니다. 이 가이드는 무엇이 끊어지는지, 이유는 무엇인지, 그리고 ReplaceMagic이 세 가지 링크 유형 모두를 일괄 복구하는 방법을 설명합니다.

테넌트 마이그레이션은 세 가지 링크 유형 모두를 끊습니다: 절대 URL 링크, 상대 경로 링크 및 SharePoint ID 기반 링크
엔터프라이즈 규모에서 수동 복구는 불가능합니다 — 링크가 10개인 문서가 1,000개만 있어도 10,000번의 수동 편집이 필요합니다
ReplaceMagic은 세 가지 링크 유형을 모두 자동으로 처리합니다, ID 기반 링크 변환 포함(사용자 제공 찾기/바꾸기 조합 기반)

테넌트 간 마이그레이션이 문서 링크를 끊는 이유

기업이 인수, 합병 또는 분리로 인해 하나의 Microsoft 365 테넌트에서 다른 테넌트로 이동할 때, 테넌트 도메인이 변경되기 때문에(company.sharepoint.com이 newcompany.sharepoint.com이 됨) 모든 SharePoint URL이 변경됩니다. 또한 모든 SharePoint 항목에는 해당 테넌트에 고유한 내부 ID가 있으며 — 이 ID는 새 테넌트로 이전되지 않습니다. 결과적으로 모든 문서의 모든 내장 링크가 전환 시점에 끊어집니다.

1. 절대 URL 링크

이 링크는 이전 테넌트 도메인을 직접 참조합니다(예: https://oldcompany.sharepoint.com/sites/Finance/...). 마이그레이션 후 도메인이 유효하지 않습니다. 수정 방법: 모든 문서에서 이전 도메인을 새 도메인으로 교체합니다.

2. 상대 경로 링크

이 링크는 SharePoint 사이트 계층 구조 내에서 상대 경로를 사용하여 문서를 참조합니다. 마이그레이션 중 사이트 구조가 변경되면 끊어질 수 있습니다. 수정 방법: 변경된 경로 구성 요소를 업데이트합니다.

3. ID 기반 링크(가장 중요)

SharePoint는 일부 링크를 항목의 내부 데이터베이스 ID에 대한 참조로 저장합니다(예: /sites/Finance/_layouts/15/Doc.aspx?sourcedoc={GUID}). 이 GUID는 테넌트 특정적이며 대상 테넌트에는 존재하지 않습니다. 마이그레이션 후 이 링크는 아무것도 가리키지 않습니다. 수정 방법: ReplaceMagic은 마이그레이션 전 또는 후에 사용자 제공 찾기/바꾸기 조합을 기반으로 ID 기반 링크를 올바른 URL 기반 링크로 변환하여 새 테넌트에서 작동하도록 합니다.

모든 변경 사항 - 사용자 제공 찾기/바꾸기 규칙 기반

ReplaceMagic은 사용자가 제공한 찾기/바꾸기 규칙을 기반으로 모든 변경을 수행합니다. ReplaceMagic.SmartMapper는 해당 규칙 생성을 자동화합니다 — SharePoint DocID를 해석하고 테넌트 전환 전에 소스 → 대상 매핑에서 직접 필요한 패턴을 생성합니다. 자세한 내용은 SmartMapper 가이드를 참조하세요.

ReplaceMagic이 세 가지 링크 유형을 모두 수정하는 방법

1단계 — 마이그레이션 전 스캔

소스 테넌트에 대해 ReplaceMagic을 실행하여 모든 문서와 모든 링크 유형의 완전한 인벤토리를 구축합니다. 절대 링크, 상대 링크 및 ID 기반 링크가 얼마나 존재하는지 파악합니다. 이 인벤토리는 대체 규칙에 직접 입력되고 마이그레이션 후 검증의 기준선을 제공합니다.

2단계 — 대체 규칙 구성

도메인 대체를 설정합니다(이전 URL → 새 URL). ID 기반 링크의 경우 ReplaceMagic은 사용자 제공 찾기/바꾸기 규칙을 기반으로 변환할 수 있습니다. 모든 규칙 유형은 단일 가져오기 파일에 구성되고 하나의 처리 단계에서 실행됩니다.

3단계 — 미리 보기 및 검증

미리 보기 모드로 실행하여 적용하기 전에 모든 제안 변경 사항을 확인합니다. 대체 규칙이 스캔에서 발견된 모든 링크 변형을 포함하는지 검증합니다. 엣지 케이스가 발견되면 규칙을 조정합니다.

4단계 — 실행

대체를 실행합니다. ReplaceMagic은 모든 문서를 병렬로 처리하여 파일을 열지 않고 한 번의 처리로 세 가지 링크 유형을 모두 업데이트합니다. 사이트 관리자 권한으로 실행 시 SharePoint 메타데이터(최종 수정 날짜, 작성자)가 보존됩니다.

5단계 — 마이그레이션 후 검증

대상 테넌트에서 재스캔하여 모든 링크가 올바르게 해석되는지 확인합니다. 프로젝트 최종 승인 및 감사 문서화를 위한 검증 보고서를 내보냅니다.

대체 준비 패키지가 하는 일

수백 가지 경로 변형이나 대용량 ID 기반 링크를 포함하는 복잡한 테넌트 간 마이그레이션의 경우, ReplaceMagic 팀이 모든 대체 문자열 조합을 대신 준비할 수 있습니다. 이 서비스는 소스 테넌트를 분석하고 모든 고유 링크 패턴을 식별하여 바로 가져올 수 있는 대체 규칙 파일을 제공합니다. 자세한 내용은 대체 준비 패키지를 참조하세요.