ReplaceMagic의 SharePoint 구성 — 전체 설정 가이드

ReplaceMagic의 모든 SharePoint 관련 설정은 구성 패널의 SharePoint 탭에 있습니다. 기본 도구 모음에서 구성 버튼을 클릭하여 접근할 수 있습니다. 이 탭은 메타데이터 보존, 문서 잠금 동작, 플랫폼 제한, 페이지 처리 모드 및 인코딩 옵션을 제어합니다. 대규모 처리 작업을 시작하기 전에 각 설정을 이해하면 예상치 못한 결과를 방지하고 SharePoint 환경의 무결성을 보호하는 데 도움이 됩니다.

메타데이터 및 문서 상태 설정

• 마지막 수정 날짜 및 수정자 유지 — ReplaceMagic이 수정된 파일을 업로드한 후 원래의 마지막 수정 타임스탬프와 원래 편집자 이름을 복원합니다. 이 설정을 사용하려면 대상 사이트 모음에 대한 사이트 관리자 권한이 필요합니다. 해당 권한이 없으면 SharePoint는 ReplaceMagic의 서비스 계정을 마지막 편집자로 기록하고 수정 시간을 현재 시각으로 설정합니다.
• 문서 체크아웃 / 체크인 — ReplaceMagic은 문서를 다운로드하기 전에 자동으로 체크아웃하고, 수정된 버전을 업로드한 후 체크인합니다. 이렇게 하면 처리 중에 다른 사용자가 파일을 수정할 수 없으며 SharePoint가 해당 변경 사항을 올바른 새 버전으로 등록합니다.
• 강제 체크인 — 활성화하면 ReplaceMagic이 다른 사용자에 의해 체크아웃된 문서를 강제로 체크인합니다. 이 옵션은 주의해서 사용하십시오. 다른 사용자가 아직 체크인하지 않은 보류 중인 변경 사항이 삭제됩니다. 라이브러리가 유휴 상태임이 확인된 자동화된 마이그레이션 시나리오에서 가장 적합합니다.
• 콘텐츠 승인 상태 유지 — 라이브러리가 콘텐츠 승인을 사용하는 경우, 이 설정은 처리 후 문서의 원래 승인됨, 거부됨 또는 보류 중 상태를 복원합니다. 이 옵션이 없으면 승인된 문서가 수정 후 보류 중 상태로 되돌아갈 수 있습니다.
• 게시 상태 유지 — 각 문서의 주/부 버전 가시성을 유지합니다. 처리 전에 주 버전으로 게시된 문서는 ReplaceMagic이 작업을 완료한 후에도 게시 상태를 유지합니다.
• 버전 관리 설정 — 문서를 체크인할 때 ReplaceMagic이 SharePoint 버전 관리 시스템과 상호 작용하는 방식을 제어합니다. 활성화하면 처리된 각 문서가 버전 기록에 올바르게 추적됩니다.

쿼리 및 제한 설정

• 쿼리 행 확인 — SharePoint 목록 쿼리당 검색되는 최대 항목 수를 설정합니다. 기본값은 4,900이고 최대값은 SharePoint의 목록 보기 임계값과 일치하는 5,000입니다. 단일 쿼리에서 5,000개 항목을 초과하면 SharePoint가 임계값 오류를 반환합니다. 4,900의 기본값은 해당 제한 아래에서 안전한 여유를 제공합니다. 특별한 이유가 없는 한 조정하지 마십시오.
• 최대 문서 ID 값 — ReplaceMagic이 ID 기반 링크를 해석할 때 검색을 시도하는 최대 SharePoint 문서 ID입니다. 기본값은 SharePoint의 내부 최대값과 일치하는 30,000,000입니다. 테넌트에 비정상적으로 높은 문서 ID 범위가 있는 경우에만 이 값을 늘리십시오.

라이브러리 및 페이지 범위 설정

• 모든 SharePoint 라이브러리 — 활성화하면 ReplaceMagic이 표준 문서 라이브러리 외에도 숨겨진 시스템 라이브러리 및 ASPX 페이지 콘텐츠에 접근합니다. 이 모드는 강력하지만 일반 사용자에게 보이지 않는 SharePoint 시스템 파일을 노출하므로 주의해서 사용해야 합니다.
• 목록 항목 처리 — SharePoint 목록 항목 필드(문서 파일뿐만 아니라)에서 URL 교체를 활성화합니다. 목록 열에 업데이트가 필요한 하이퍼링크나 파일 경로가 저장된 경우 유용합니다.
• 빠른 실행 및 상단 탐색 모음 — 활성화하면 ReplaceMagic이 SharePoint 사이트의 빠른 실행 탐색 패널과 상단 탐색 모음에 포함된 URL도 업데이트합니다. 탐색 링크가 이전 테넌트 URL을 가리키는 테넌트 간 마이그레이션 후 특히 유용합니다.

인코딩 및 레거시 설정

• SharePoint 페이지 HTML 디코드/인코드 — HTML 인코딩된 콘텐츠를 저장하는 엔터프라이즈 위키 페이지의 경우, 이 옵션은 처리 전에 콘텐츠를 디코딩하고 처리 후 다시 인코딩합니다. 특수 문자가 HTML 엔티티로 저장된 특정 레거시 위키 페이지 형식에 필요합니다.
• SharePoint 페이지 유니코드 디코드/인코드 — SharePoint 페이지 콘텐츠를 읽고 쓸 때 유니코드 정규화를 적용합니다. 페이지 콘텐츠에 올바르게 보존되어야 하는 유니코드 이스케이프 시퀀스가 포함된 경우 활성화하십시오.
• SharePoint 레거시 인증 모드 — 이전 온-프레미스 SharePoint 팜에서 폼 기반 또는 기본 인증과 호환되는 레거시 모드로 인증 핸드셰이크를 전환합니다. SharePoint Online에는 영향을 미치지 않습니다.
• 끊어진 링크의 네이티브 SharePoint 확인 — 파일을 다운로드하는 대신 SharePoint API를 사용하여 현장에서 끊어진 링크 확인을 수행합니다. 이 방법은 ReplaceMagic의 표준 파일 기반 확인보다 훨씬 느리며 대형 라이브러리에는 권장되지 않습니다. 파일 기반 확인이 특정 시나리오에 적합하지 않을 때만 사용하십시오.
• 건너뛴 모든 문서 처리 — 특정 오류 코드로 인해 이전 실행에서 건너뛴 문서를 ReplaceMagic이 다시 처리하도록 강제합니다. 근본적인 문제를 해결한 후(예: 추가 권한 부여 후) 초기 실행에서 처리되지 않은 문서를 처리하는 데 사용하십시오.

시나리오별 권장 설정

• SharePoint Online 마이그레이션: 마지막 수정 날짜 및 수정자 유지, 체크아웃/체크인, 콘텐츠 승인 상태 유지, 게시 상태 유지를 활성화합니다. 병렬 스레드를 3–5개로 설정합니다.
• 온-프레미스에서 SharePoint Online으로: 위와 동일. 탐색 링크 업데이트가 필요한 경우 추가로 빠른 실행 및 상단 탐색 모음을 활성화합니다.
• 테넌트 간 마이그레이션: 모든 메타데이터 보존 옵션을 활성화합니다. 목록 항목 처리 및 빠른 실행/상단 탐색 모음을 활성화합니다. 최대 문서 ID가 원본 테넌트의 모든 ID 기반 링크를 포함할 만큼 충분히 높게 설정되어 있는지 확인합니다.