ReplaceMagic 사용 시 알려진 SharePoint 제한 사항

ReplaceMagic은 SharePoint 문서 처리의 복잡성을 완벽하게 처리하도록 설계되었지만, 다른 벤더가 구축한 플랫폼 내에서 작동하는 모든 도구와 마찬가지로 특정 제약의 영향을 받습니다. 이 페이지에 문서화된 제한 사항은 SharePoint 자체, Windows 운영 체제 또는 Office 파일 형식 사양에 의해 부과됩니다. 대규모 마이그레이션 프로젝트를 시작하기 전에 이러한 한계를 이해하면 효과적으로 계획하고 예상치 못한 문제를 방지하는 데 도움이 됩니다.

그룹 1: 파일 및 경로 제한 사항

파일 이름의 특수 문자 — 이름에 다음 문자 중 하나가 포함된 파일은 SharePoint API를 통해 공유 링크 토큰이나 조직 링크를 검색할 수 없습니다: ~ # % & * { } \ : <> ? / + | ". 이러한 파일은 여전히 다운로드되고, 콘텐츠의 끊어진 링크가 처리되며, 다시 업로드됩니다 — 단, 토큰으로 파일을 참조하는 공유 링크 방식의 URL은 복구할 수 없습니다. 이것은 ReplaceMagic이 아닌 SharePoint REST API의 제한 사항입니다.
Windows 경로 길이 제한 (260자) — ReplaceMagic이 처리를 위해 SharePoint에서 파일을 임시 로컬 경로로 다운로드할 때, 임시 폴더 경로와 파일 이름의 합산 길이가 260자를 초과하지 않아야 합니다. ReplaceMagic 처리 설정에서 해결 방법을 사용할 수 있습니다. 긴 경로 지원을 활성화하거나 임시 폴더 경로를 C:\Temp와 같은 루트 수준 디렉토리로 단축하십시오.
Excel 링크 소스 경로 길이 — Excel은 외부 링크 소스에 대한 최대 경로 길이를 적용합니다. 이전 Excel 형식(.xls)에서 링크 소스의 최대 경로 길이는 253자입니다. 최신 형식(.xlsx, .xlsm)에서 제한은 2,000자입니다. 교체로 이 제한을 초과하는 URL이나 파일 경로가 생성되는 경우, ReplaceMagic은 해당 링크를 건너뛰고 결과 보고서에 기록합니다. 문서 자체는 계속 처리됩니다. 크기 초과 링크만 건너뜁니다.

그룹 2: SharePoint 플랫폼 제한 사항

SharePoint 목록 보기 임계값 (5,000개 항목) — SharePoint Online 및 온-프레미스 모두 목록 쿼리당 최대 5,000개 항목을 적용합니다. ReplaceMagic은 이 임계값 아래에 안전하게 유지하기 위해 기본 쿼리 행 제한 4,900을 사용합니다. SharePoint 구성 탭에서 이 값을 줄이면 쿼리가 더 작고 안전해지지만 대형 라이브러리 열거에 더 오랜 시간이 걸립니다.
최대 문서 ID (30,000,000) — ID 기반 SharePoint 링크를 해석할 때 ReplaceMagic은 구성된 최대값까지 문서 ID를 반복합니다. 기본값 30,000,000은 SharePoint의 실제 상한값과 일치합니다. 테넌트에 이 값보다 높은 ID를 가진 문서가 있는 경우 (매우 크고 오래된 테넌트에서는 드물지만 가능), 구성에서 최대 문서 ID 설정을 늘리십시오.
SharePoint 제한 (HTTP 429 / 503) — SharePoint Online은 API 요청에 대한 속도 제한을 적용합니다. ReplaceMagic은 제한 응답을 감지하고 자동으로 재시도하지만, 지속적인 고병렬 처리는 여전히 제한 지연을 겪습니다. SharePoint Online에 권장되는 스레드 수는 3–5개입니다. SharePoint Online에서는 제한이 점차 이익을 상쇄하므로 더 많은 스레드를 사용한다고 해서 처리량이 비례하여 증가하지는 않습니다.
최신 인증 요구 사항 — 테넌트 관리자는 Microsoft 365에서 레거시 인증 프로토콜을 비활성화할 수 있으며, 이는 사용자 이름/암호 및 앱 암호 로그인 방법이 작동하지 않을 수 있음을 의미합니다. 이 경우 Azure AD 애플리케이션 등록을 사용한 앱 전용 인증을 사용하십시오. 앱 전용 인증은 레거시 인증 제한을 받지 않습니다.

그룹 3: 메타데이터 및 버전 관리

마지막 수정 날짜 및 작성자 보존에는 사이트 관리자 권한 필요 — ReplaceMagic은 원래 편집자 및 수정 타임스탬프를 복원하기 위해 특권 SharePoint API 호출을 사용합니다. 이 호출은 사이트 관리자 (사이트 모음 관리자) 권한이 있는 계정에서만 사용할 수 있습니다. 참가자 또는 구성원 권한으로는 충분하지 않습니다. 처리 계정에 참가자 권한만 있는 경우, 수정자 필드에 처리 계정이 표시되고 수정 날짜가 처리 시간으로 설정됩니다.
문서 백업은 네이티브 SharePoint 모드에서 사용할 수 없음 — ReplaceMagic의 내장 파일 백업 기능 (수정 전에 원본을 백업 폴더에 복사)은 SharePoint API를 통해 네이티브로 문서를 처리할 때 작동하지 않습니다. SharePoint의 내장 버전 기록을 안전망으로 사용하십시오. 처리 작업을 실행하기 전에 대상 라이브러리에 버전 관리가 활성화되어 있는지 확인하십시오.
콘텐츠 승인 보존에는 적절한 권한 필요 — 처리 후 문서의 콘텐츠 승인 상태를 복원하려면 처리 계정에 라이브러리에서 항목을 승인하고 거부할 수 있는 권한이 있어야 합니다. 승인 권한이 없는 경우 ReplaceMagic은 콘텐츠 수정을 완료하지만 승인 상태를 복원할 수 없습니다.

그룹 4: 연결성

온-프레미스 네트워크 접근 필요 — SharePoint 온-프레미스의 경우, ReplaceMagic이 네트워크를 통해 SharePoint 서버에 도달할 수 있는 컴퓨터에 설치되어 있어야 합니다. 컴퓨터는 DNS를 통해 SharePoint 서버의 호스트 이름을 확인하고 적절한 HTTP 또는 HTTPS 포트로 연결할 수 있어야 합니다. 구성 요소는 SharePoint 서버 자체에 설치되지 않지만 네트워크 가시선은 필수입니다.
회사 프록시 및 방화벽 — 조직이 회사 프록시 또는 방화벽을 통해 아웃바운드 HTTPS 트래픽을 라우팅하는 경우, ReplaceMagic에서 SharePoint Online으로의 연결이 차단되거나 프록시 인증이 필요할 수 있습니다. ReplaceMagic 처리 설정 패널에서 프록시 설정을 구성하십시오. 프록시에서 SSL 검사가 활성화된 경우 SharePoint Online 인증서가 유효하지 않게 표시될 수 있습니다 — 네트워크 팀과 협력하여 필요한 예외를 추가하십시오.

이러한 제한 사항은 마이그레이션 프로젝트를 정확하게 계획하는 데 도움을 드리기 위해 문서화되었습니다. 여기에 설명되지 않은 특정 시나리오가 발생하면 support@replacemagic.com으로 문의해 주세요. 기꺼이 도움을 드리겠습니다.

관련 가이드: