Konfiguracja SharePoint w ReplaceMagic — Kompletny przewodnik po ustawieniach

Wszystkie ustawienia specyficzne dla SharePoint w ReplaceMagic znajdują się w panelu Konfiguracja na karcie SharePoint. Dostęp do niego uzyskasz, klikając przycisk Konfiguracja na głównym pasku narzędzi. Ta karta steruje zachowaniem metadanych, blokowaniem dokumentów, limitami platformy, trybami przetwarzania stron i opcjami kodowania. Zrozumienie każdego ustawienia przed rozpoczęciem dużego zadania przetwarzania pomoże uniknąć nieoczekiwanych wyników i chronić integralność środowiska SharePoint.

Ustawienia metadanych i stanu dokumentu

• Zachowaj datę ostatniej modyfikacji i autora zmiany — Po przesłaniu zmodyfikowanego pliku ReplaceMagic przywraca oryginalny znacznik czasu ostatniej modyfikacji oraz nazwę pierwotnego redaktora. To ustawienie wymaga uprawnień Administratora witryny w docelowej kolekcji witryn. Bez tych uprawnień SharePoint zarejestruje konto usługi ReplaceMagic jako ostatniego redaktora i ustawi czas modyfikacji na bieżący.
• Pobieranie/oddawanie dokumentów — ReplaceMagic automatycznie pobiera dokument do edycji przed pobraniem go i oddaje po przesłaniu zmodyfikowanej wersji. Dzięki temu inni użytkownicy nie mogą modyfikować pliku podczas przetwarzania, a SharePoint rejestruje zmianę jako właściwą nową wersję.
• Wymuś oddanie dokumentu — Po włączeniu ReplaceMagic wymusi oddanie dokumentów aktualnie pobranych przez innego użytkownika. Tej opcji należy używać ostrożnie: powoduje odrzucenie wszelkich oczekujących zmian, których inny użytkownik nie zdążył jeszcze oddać. Najlepiej sprawdza się w zautomatyzowanych scenariuszach migracji, gdy wiadomo, że biblioteka jest nieaktywna.
• Zachowaj stan zatwierdzenia treści — Jeśli biblioteka korzysta z zatwierdzania treści, to ustawienie przywraca oryginalny stan Zatwierdzone, Odrzucone lub Oczekujące po przetworzeniu. Bez tej opcji zatwierdzony dokument może wrócić do stanu Oczekujące po modyfikacji.
• Zachowaj stan publikacji — Utrzymuje widoczność wersji głównej/pomocniczej każdego dokumentu. Dokument opublikowany jako wersja główna przed przetworzeniem pozostanie opublikowany po zakończeniu pracy przez ReplaceMagic.
• Ustaw wersjonowanie — Steruje sposobem interakcji ReplaceMagic z systemem wersjonowania SharePoint podczas oddawania dokumentów. Włącz tę opcję, aby każdy przetworzony dokument był właściwie śledzony w historii wersji.

Ustawienia zapytań i limitów

• Limit wierszy zapytania — Ustawia maksymalną liczbę elementów pobieranych w jednym zapytaniu do listy SharePoint. Domyślna wartość to 4900, a maksymalna to 5000, co odpowiada progowi widoku listy SharePoint. Przekroczenie 5000 elementów w jednym zapytaniu powoduje zwrócenie przez SharePoint błędu progu. Domyślna wartość 4900 zapewnia bezpieczny margines poniżej tego limitu. Zmieniaj ją tylko wtedy, gdy masz ku temu konkretne powody.
• Maksymalna wartość ID dokumentu — Maksymalne ID dokumentu SharePoint, które ReplaceMagic będzie próbować pobrać podczas rozwiązywania łączy opartych na ID. Domyślna wartość to 30 000 000, co odpowiada wewnętrznemu maksimum SharePoint. Zwiększaj tę wartość tylko wtedy, gdy dzierżawca ma wyjątkowo wysokie zakresy ID dokumentów.

Ustawienia zakresu bibliotek i stron

• Wszystkie biblioteki SharePoint — Po włączeniu ReplaceMagic uzyskuje dostęp do ukrytych bibliotek systemowych i zawartości stron ASPX oprócz standardowych bibliotek dokumentów. Ten tryb jest zaawansowany, lecz należy go używać ostrożnie, ponieważ ujawnia pliki systemowe SharePoint normalnie niewidoczne dla użytkowników końcowych.
• Przetwarzaj elementy list — Włącza zastępowanie adresów URL w polach elementów list SharePoint (nie tylko w plikach dokumentów). Przydatne, gdy kolumny list przechowują hiperłącza lub ścieżki plików wymagające aktualizacji.
• Szybkie uruchamianie i górny pasek nawigacji — Po włączeniu ReplaceMagic aktualizuje również adresy URL osadzone w panelu Szybkie uruchamianie i górnym pasku nawigacyjnym witryny SharePoint. Jest to szczególnie przydatne po migracji między dzierżawcami, gdy łącza nawigacyjne wskazują na stary adres URL dzierżawcy.

Ustawienia kodowania i starszych formatów

• Dekodowanie/kodowanie HTML stron SharePoint — W przypadku stron Enterprise Wiki przechowujących treść zakodowaną w HTML ta opcja dekoduje treść przed przetworzeniem i ponownie ją koduje po zakończeniu. Wymagana w przypadku niektórych starszych formatów stron Wiki, gdzie znaki specjalne są przechowywane jako encje HTML.
• Dekodowanie/kodowanie Unicode stron SharePoint — Stosuje normalizację Unicode podczas odczytywania i zapisywania treści stron SharePoint. Włącz tę opcję, gdy treść strony zawiera sekwencje unikodowe, które muszą być poprawnie zachowane.
• Starszy tryb uwierzytelniania SharePoint — Przełącza procedurę uzgadniania uwierzytelniania na starszy tryb zgodny z uwierzytelnianiem opartym na formularzach lub podstawowym w starszych farmach SharePoint lokalnych. Nie ma wpływu na SharePoint Online.
• Natywne sprawdzanie uszkodzonych łączy SharePoint — Wykonuje wbudowane sprawdzanie uszkodzonych łączy przy użyciu interfejsu API SharePoint zamiast pobierania plików. Ta metoda jest znacznie wolniejsza od standardowego sprawdzania opartego na plikach w ReplaceMagic i nie jest zalecana w przypadku dużych bibliotek. Używaj jej tylko wtedy, gdy sprawdzanie oparte na plikach nie jest odpowiednie dla konkretnego scenariusza.
• Przetwarzaj wszystkie pominięte dokumenty — Wymusza ponowne przetworzenie przez ReplaceMagic dokumentów pominiętych w poprzednim przebiegu z powodu określonych kodów błędów. Używaj tej opcji po rozwiązaniu podstawowego problemu (na przykład po przyznaniu dodatkowych uprawnień), aby przetworzyć dokumenty nieobsłużone w pierwszym przebiegu.

Zalecane ustawienia według scenariusza

• Migracja do SharePoint Online: Włącz opcje Zachowaj datę ostatniej modyfikacji i autora, Pobieranie/oddawanie dokumentów, Zachowaj stan zatwierdzenia treści, Zachowaj stan publikacji. Ustaw równoległe wątki na 3–5.
• Migracja lokalna do SharePoint Online: Jak powyżej; dodatkowo włącz Szybkie uruchamianie i górny pasek nawigacji, jeśli łącza nawigacyjne wymagają aktualizacji.
• Migracja między dzierżawcami: Włącz wszystkie opcje zachowania metadanych; włącz Przetwarzaj elementy list oraz Szybkie uruchamianie/górny pasek nawigacji; upewnij się, że wartość Maksymalne ID dokumentu jest wystarczająco wysoka, aby obejmować wszystkie łącza oparte na ID w dzierżawcy źródłowym.