ReplaceMagic과 SharePoint Online — 네이티브 대량 링크 복구

SharePoint Online은 Microsoft 365의 일부인 Microsoft의 클라우드 기반 문서 관리 및 협업 플랫폼입니다. 전 세계 조직들이 이를 사용하여 Word, Excel, PowerPoint, Visio 및 Project 파일을 구조화된 문서 라이브러리에 저장합니다. 이러한 조직이 파일 서버, 온-프레미스 SharePoint 팜 또는 다른 Microsoft 365 테넌트에서 마이그레이션할 때, 이전 위치를 가리키던 모든 하이퍼링크, OLE 개체 참조 및 포함된 경로가 끊어집니다. ReplaceMagic은 이 문제를 특별히 해결하기 위해 만들어졌습니다 — 대규모로, 단일 문서를 수동으로 열 필요 없이.

네이티브 연결 — 드라이브 매핑 불필요

ReplaceMagic은 Microsoft SharePoint REST API 및 CSOM(클라이언트 사이드 개체 모델)을 통해 SharePoint Online에 직접 연결합니다. 즉, SharePoint를 네트워크 드라이브로 매핑하거나 WebDAV를 구성할 필요가 없습니다. 네이티브 API 연결은 더 빠르고 안정적이며, 매핑된 드라이브로는 노출할 수 없는 SharePoint 메타데이터에 ReplaceMagic이 접근할 수 있게 합니다. 연결되면 ReplaceMagic이 문서 라이브러리를 열거하고, 처리를 위해 파일을 다운로드하고, 교체를 적용하고, 수정된 파일을 업로드할 수 있습니다 — 모두 ReplaceMagic 인터페이스를 벗어나지 않고.

지원되는 인증 방법

ReplaceMagic은 다양한 테넌트 보안 구성을 수용하기 위해 SharePoint Online의 여러 인증 방법을 지원합니다:

SharePoint Online (사용자 이름/암호) — 표준 Microsoft 365 자격 증명. 레거시 인증이 여전히 허용되는 테넌트에 적합합니다.
앱 암호를 사용한 MFA — 다단계 인증으로 보호된 계정용. Microsoft 365 계정 보안 설정에서 앱 암호를 생성하고 일반 암호 대신 사용하십시오.
앱 전용 인증 — Azure AD 애플리케이션을 등록하고 필요한 SharePoint 권한을 부여한 후 클라이언트 ID 및 클라이언트 비밀을 사용합니다. 이 방법은 대화형 로그인이 불가능한 자동화, 무인 또는 예약된 워크플로에 이상적입니다.

ReplaceMagic이 SharePoint Online에서 보존하는 항목

대량 문서 처리 중 가장 중요한 관심사 중 하나는 메타데이터 무결성입니다. ReplaceMagic은 파일을 수정한 후 다음 SharePoint Online 속성을 보존하도록 설계되었습니다:

마지막 수정 날짜 및 수정자 작성자
콘텐츠 승인 상태 (승인됨, 거부됨, 보류 중)
버전 기록 — 변경 사항이 버전 체인을 덮어쓰는 것이 아닌 새 버전으로 체크인됩니다
체크인 및 체크아웃 상태 — 처리 전에 체크아웃된 문서는 동일한 상태로 반환됩니다

마지막 수정 날짜 및 작성자를 보존하려면 대상 사이트 모음에 대한 사이트 관리자 권한이 필요합니다. 이 작업에는 참가자 권한만으로는 충분하지 않습니다.

SharePoint Online 제한 (HTTP 429)

SharePoint Online은 API 요청에 대한 속도 제한을 적용합니다. 짧은 시간 내에 너무 많은 요청이 도착하면 서비스는 HTTP 429(너무 많은 요청) 또는 HTTP 503 응답을 반환합니다. ReplaceMagic은 제한을 자동으로 처리합니다. 429 응답을 감지하고, Retry-After 헤더를 읽고, 지정된 기간 동안 영향받는 스레드를 일시 중지한 다음 요청을 재시도합니다. 수동 개입이 필요하지 않습니다.

제한 압력을 최소화하려면 SharePoint Online의 권장 병렬 처리 설정은 3~5개 스레드입니다. 병렬 수준이 높으면 제한이 더 자주 발생하여 전체 처리량이 실제로 줄어들 수 있습니다. ReplaceMagic 처리 설정 패널에서 스레드 수를 조정할 수 있습니다.

지원되는 라이브러리 및 페이지 유형

네이티브 통합을 통해 ReplaceMagic이 SharePoint Online에서 처리할 수 있는 콘텐츠 유형:

표준 문서 라이브러리 (Word, Excel, PowerPoint, Visio, PDF 및 기타 파일 유형)
위키 페이지 (ASPX로 저장된 엔터프라이즈 위키 콘텐츠)
캔버스 페이지 (최신 SharePoint 페이지)

특수 문자 제한 사항

이름에 다음 문자 중 하나가 포함된 파일은 SharePoint API에서 공유 링크 토큰 또는 조직 링크 정보를 검색할 수 없습니다: ~ # % & * { } \ : <> ? / + | ". 이러한 파일은 여전히 다운로드되고, 끊어진 링크가 처리되며, 다시 업로드됩니다 — 단, 해당 파일을 가리키는 공유 링크 방식의 URL은 토큰 메커니즘을 통해 복구할 수 없습니다.

일반적인 마이그레이션 시나리오

파일 서버 → SharePoint Online: UNC 경로 (\\Server\Share\File.xlsx)가 HTTPS 문서 라이브러리 URL로 변환됩니다.
SharePoint 온-프레미스 → SharePoint Online: 인트라넷 URL (http://intranet/sites/...)이 클라우드 URL (https://company.sharepoint.com/sites/...)로 변경됩니다.
테넌트 간 마이그레이션: 기본 URL과 내부 SharePoint 항목 ID가 모두 변경됩니다. ID 기반 링크는 절대 URL 형식으로 변환이 필요합니다.

단계별 처리 개요

ReplaceMagic을 SharePoint Online과 함께 사용하는 것은 간단한 워크플로를 따릅니다: 대상으로 SharePoint Online을 선택 → 원하는 방법으로 인증 → 사이트 및 문서 라이브러리 선택 → 스캔을 실행하여 모든 링크 식별 → 찾기 및 바꾸기 규칙 구성 → 결과 그리드에서 변경 사항 미리 보기 → 교체 실행. 전체 프로세스는 기록되며 SharePoint의 내장 버전 기록을 통해 되돌릴 수 있습니다.

관련 가이드: