Znane ograniczenia SharePoint podczas używania ReplaceMagic

ReplaceMagic jest zaprojektowany tak, aby obsługiwać pełną złożoność przetwarzania dokumentów SharePoint, jednak jak każde narzędzie działające w ramach platformy stworzonej przez innego dostawcę, podlega pewnym ograniczeniom. Ograniczenia udokumentowane na tej stronie są narzucone przez sam SharePoint, przez system operacyjny Windows lub przez specyfikacje formatów plików Office. Zrozumienie tych granic przed rozpoczęciem dużego projektu migracji pomoże skutecznie zaplanować prace i uniknąć niespodzianek.

Grupa 1: Ograniczenia plików i ścieżek

• Znaki specjalne w nazwach plików — Pliki, których nazwy zawierają którykolwiek z następujących znaków, nie mogą mieć pobranych tokenów łączy udostępnionych ani łączy organizacyjnych za pośrednictwem interfejsu API SharePoint: ~ # % & * { } \ : <> ? / + | ". Pliki te są nadal pobierane, przetwarzane pod kątem uszkodzonych łączy w ich treści i ponownie przesyłane — jednak adresy URL w stylu łączy udostępnionych odwołujące się do pliku przez token nie mogą zostać naprawione. Jest to ograniczenie interfejsu API REST SharePoint, a nie ReplaceMagic.
• Limit długości ścieżki Windows (260 znaków) — Gdy ReplaceMagic pobiera pliki z SharePoint do tymczasowej ścieżki lokalnej w celu przetworzenia, łączna długość ścieżki folderu tymczasowego i nazwy pliku nie może przekraczać 260 znaków. Obejście jest dostępne w ustawieniach przetwarzania ReplaceMagic: włącz obsługę długich ścieżek lub skróć ścieżkę folderu tymczasowego do katalogu na poziomie głównym, np. C:\Temp.
• Długość ścieżki źródła łącza w programie Excel — Program Excel narzuca maksymalne długości ścieżek na zewnętrznych źródłach łączy. W starszych formatach Excel (.xls) maksymalna długość ścieżki źródła łącza wynosi 253 znaki. W nowszych formatach (.xlsx, .xlsm) limit wynosi 2000 znaków. Jeśli zastąpienie spowodowałoby powstanie adresu URL lub ścieżki pliku przekraczającej te limity, ReplaceMagic pomija konkretne łącze i rejestruje je w raporcie wyników. Sam dokument jest nadal przetwarzany; pomijane jest tylko zbyt długie łącze.

Grupa 2: Ograniczenia platformy SharePoint

• Próg widoku listy SharePoint (5000 elementów) — SharePoint Online i lokalna wersja SharePoint narzucają maksymalnie 5000 elementów na zapytanie do listy. ReplaceMagic używa domyślnego limitu wierszy zapytania wynoszącego 4900, aby bezpiecznie utrzymać się poniżej tego progu. Zmniejszenie tej wartości na karcie Konfiguracja SharePoint spowoduje, że zapytania będą mniejsze i bezpieczniejsze, ale wyliczanie dużych bibliotek zajmie więcej czasu.
• Maksymalne ID dokumentu (30 000 000) — Podczas rozwiązywania łączy SharePoint opartych na ID ReplaceMagic iteruje przez ID dokumentów aż do skonfigurowanego maksimum. Domyślna wartość 30 000 000 odpowiada praktycznemu górnemu limitowi SharePoint. Jeśli dzierżawca ma dokumenty z ID powyżej tej wartości (rzadkie, ale możliwe w bardzo dużych, długo działających dzierżawcach), zwiększ ustawienie Maksymalne ID dokumentu w konfiguracji.
• Ograniczanie przepustowości SharePoint (HTTP 429 / 503) — SharePoint Online narzuca ograniczenia przepustowości na żądania API. ReplaceMagic wykrywa odpowiedzi ograniczające przepustowość i automatycznie ponawia próby, jednak ciągłe przetwarzanie z dużą równoległością nadal będzie napotykać opóźnienia wynikające z ograniczania. Zalecana liczba wątków dla SharePoint Online to 3–5. Używanie większej liczby wątków nie zwiększa proporcjonalnie przepustowości w SharePoint Online, ponieważ ograniczanie przepustowości coraz bardziej niweluje korzyści.
• Wymóg nowoczesnego uwierzytelniania — Administratorzy dzierżawcy mogą wyłączyć starsze protokoły uwierzytelniania w Microsoft 365, co oznacza, że metody logowania za pomocą nazwy użytkownika/hasła i hasła aplikacji mogą przestać działać. W takim przypadku należy użyć uwierzytelniania tylko aplikacji z rejestracją aplikacji Azure AD. Uwierzytelnianie tylko aplikacji nie podlega ograniczeniom starszego uwierzytelniania.

Grupa 3: Metadane i wersjonowanie

• Zachowanie daty ostatniej modyfikacji i autora wymaga uprawnień Administratora witryny — ReplaceMagic używa uprzywilejowanego wywołania API SharePoint, aby przywrócić oryginalnego redaktora i znacznik czasu modyfikacji. To wywołanie jest dostępne tylko dla kont z uprawnieniami Administratora witryny (Administratora kolekcji witryn). Uprawnienia Współautora lub Członka są niewystarczające. Jeśli konto przetwarzające ma tylko uprawnienia współautora, pole zmodyfikowane przez będzie wskazywało konto przetwarzające, a data modyfikacji zostanie ustawiona na czas przetwarzania.
• Kopia zapasowa dokumentów jest niedostępna w natywnym trybie SharePoint — Wbudowana funkcja kopii zapasowej plików ReplaceMagic (kopiująca oryginały do folderu kopii zapasowej przed modyfikacją) nie działa podczas natywnego przetwarzania dokumentów przez interfejs API SharePoint. Jako zabezpieczenie należy używać wbudowanej historii wersji SharePoint. Upewnij się, że wersjonowanie jest włączone w docelowej bibliotece przed uruchomieniem zadania przetwarzania.
• Zachowanie stanu zatwierdzenia treści wymaga odpowiednich uprawnień — Przywrócenie stanu zatwierdzenia treści dokumentu po przetworzeniu wymaga, aby konto przetwarzające miało uprawnienia do zatwierdzania i odrzucania elementów w bibliotece. Bez uprawnień do zatwierdzania ReplaceMagic ukończy modyfikację treści, ale nie będzie w stanie przywrócić stanu zatwierdzenia.

Grupa 4: Łączność

• Wymagany dostęp do sieci lokalnej — W przypadku SharePoint lokalnego ReplaceMagic musi być zainstalowany na maszynie, która może dotrzeć do serwera SharePoint przez sieć. Maszyna musi być w stanie rozwiązać nazwę hosta serwera SharePoint za pomocą DNS i połączyć się z nim na odpowiednim porcie HTTP lub HTTPS. Żadne komponenty nie są instalowane na samym serwerze SharePoint, jednak widoczność sieciowa jest obowiązkowa.
• Firmowe serwery proxy i zapory sieciowe — Jeśli organizacja kieruje wychodzący ruch HTTPS przez firmowy serwer proxy lub zaporę sieciową, połączenia z ReplaceMagic do SharePoint Online mogą być blokowane lub wymagać uwierzytelnienia przez proxy. Skonfiguruj ustawienia proxy w panelu ustawień przetwarzania ReplaceMagic. Jeśli na serwerze proxy jest włączona inspekcja SSL, certyfikaty SharePoint Online mogą wydawać się nieprawidłowe — skonsultuj się z zespołem sieciowym, aby dodać niezbędne wyjątki.

Te ograniczenia są udokumentowane, aby pomóc w dokładnym zaplanowaniu projektu migracji. Jeśli napotkasz konkretny scenariusz nieopisany tutaj, skontaktuj się z nami pod adresem support@replacemagic.com, a chętnie doradzimy.