ReplaceMagic i SharePoint Online — Natywna masowa naprawa łączy

SharePoint Online to oparta na chmurze platforma zarządzania dokumentami i współpracy firmy Microsoft, będąca częścią Microsoft 365. Organizacje na całym świecie używają jej do przechowywania plików Word, Excel, PowerPoint, Visio i Project w ustrukturyzowanych bibliotekach dokumentów. Gdy te organizacje migrują z serwerów plików, lokalnych farm SharePoint lub innego dzierżawcy Microsoft 365, każde hiperłącze, odwołanie do obiektu OLE i osadzona ścieżka wskazująca stare miejsce staje się uszkodzona. ReplaceMagic został stworzony specjalnie w celu rozwiązania tego problemu — na dużą skalę, bez konieczności ręcznego otwierania pojedynczego dokumentu.

Połączenie natywne — mapowanie dysków nie jest wymagane

ReplaceMagic łączy się z SharePoint Online bezpośrednio przez interfejs API REST SharePoint firmy Microsoft i CSOM (Client-Side Object Model). Oznacza to, że nie trzeba mapować SharePoint jako dysku sieciowego ani konfigurować WebDAV. Natywne połączenie przez API jest szybsze, bardziej niezawodne i daje ReplaceMagic dostęp do metadanych SharePoint, których mapowany dysk po prostu nie może udostępnić. Po połączeniu ReplaceMagic może wyliczać biblioteki dokumentów, pobierać pliki do przetworzenia, stosować zamienniki i przesyłać poprawione pliki — wszystko bez opuszczania interfejsu ReplaceMagic.

Obsługiwane metody uwierzytelniania

ReplaceMagic obsługuje wiele metod uwierzytelniania dla SharePoint Online, aby dostosować się do różnych konfiguracji zabezpieczeń dzierżawcy:

• SharePoint Online (nazwa użytkownika/hasło) — Standardowe poświadczenia Microsoft 365. Odpowiednie dla dzierżawców, w których starsze uwierzytelnianie jest nadal dozwolone.
• MFA z hasłem aplikacji — Dla kont chronionych uwierzytelnianiem wieloskładnikowym. Wygeneruj hasło aplikacji w ustawieniach zabezpieczeń konta Microsoft 365 i użyj go zamiast zwykłego hasła.
• Uwierzytelnianie tylko aplikacji — Zarejestruj aplikację Azure AD, przyznaj jej wymagane uprawnienia SharePoint i użyj identyfikatora klienta oraz klucza tajnego klienta. Ta metoda jest idealna dla zautomatyzowanych, nienadzorowanych lub zaplanowanych przepływów pracy, gdzie interaktywne logowanie nie jest możliwe.

Co ReplaceMagic zachowuje w SharePoint Online

Jedną z najważniejszych kwestii podczas masowego przetwarzania dokumentów jest integralność metadanych. ReplaceMagic jest zaprojektowany tak, aby po zmodyfikowaniu pliku zachować następujące właściwości SharePoint Online:

• Datę ostatniej modyfikacji i autora zmiany
• Stan zatwierdzenia treści (Zatwierdzone, Odrzucone, Oczekujące)
• Historię wersji — zmiany są oddawane jako nowa wersja, a nie nadpisanie łańcucha wersji
• Stan pobierania i oddawania — dokumenty pobrane przed przetworzeniem są zwracane do tego samego stanu

Zachowanie daty ostatniej modyfikacji i autora wymaga uprawnień Administratora witryny w docelowej kolekcji witryn. Same uprawnienia Współautora są niewystarczające dla tej operacji.

Ograniczanie przepustowości SharePoint Online (HTTP 429)

SharePoint Online narzuca limity przepustowości na żądania API. Gdy zbyt wiele żądań dociera w krótkim oknie czasowym, usługa zwraca odpowiedź HTTP 429 (Zbyt wiele żądań) lub HTTP 503. ReplaceMagic obsługuje ograniczanie przepustowości automatycznie: wykrywa odpowiedź 429, odczytuje nagłówek Retry-After, wstrzymuje wątek na określony czas, a następnie ponawia żądanie. Żadna ręczna interwencja nie jest wymagana.

Aby zminimalizować presję ograniczania przepustowości, zalecane ustawienie przetwarzania równoległego dla SharePoint Online to 3 do 5 wątków. Większa równoległość spowoduje częstsze ograniczanie przepustowości i może faktycznie zmniejszyć ogólną przepustowość. Liczbę wątków można dostosować w panelu ustawień przetwarzania ReplaceMagic.

Obsługiwane typy bibliotek i stron

Poprzez natywną integrację ReplaceMagic może przetwarzać następujące typy treści w SharePoint Online:

• Standardowe biblioteki dokumentów (Word, Excel, PowerPoint, Visio, PDF i inne typy plików)
• Strony Wiki (treść Enterprise Wiki przechowywana jako ASPX)
• Strony Canvas (nowoczesne strony SharePoint)

Ograniczenie dotyczące znaków specjalnych

Pliki, których nazwy zawierają którykolwiek z następujących znaków, nie mogą mieć pobranych przez interfejs API SharePoint tokenów łączy udostępnionych ani informacji o łączach organizacyjnych: ~ # % & * { } \ : <> ? / + | ". Pliki te są nadal pobierane, przetwarzane pod kątem uszkodzonych łączy i ponownie przesyłane — jednak wszelkie adresy URL w stylu łączy udostępnionych wskazujące na nie nie mogą zostać naprawione za pomocą mechanizmu tokenów.

Typowe scenariusze migracji

• Serwer plików → SharePoint Online: Ścieżki UNC (\\Serwer\Udział\Plik.xlsx) stają się adresami URL biblioteki dokumentów HTTPS.
• SharePoint lokalny → SharePoint Online: Adresy URL intranetu (http://intranet/sites/...) zmieniają się na adresy URL w chmurze (https://firma.sharepoint.com/sites/...).
• Migracja między dzierżawcami: Zarówno bazowy adres URL, jak i wewnętrzne identyfikatory elementów SharePoint ulegają zmianie; łącza oparte na ID wymagają konwersji do formatu bezwzględnego adresu URL.

Przegląd procesu krok po kroku

Korzystanie z ReplaceMagic z SharePoint Online przebiega według prostego przepływu pracy: wybierz SharePoint Online jako cel → uwierzytelnij się przy użyciu preferowanej metody → wybierz witrynę i bibliotekę dokumentów → uruchom skanowanie, aby zidentyfikować wszystkie łącza → skonfiguruj reguły znajdź i zamień → wyświetl podgląd zmian w siatce wyników → wykonaj zamienniki. Cały proces jest rejestrowany i odwracalny za pośrednictwem wbudowanej historii wersji SharePoint.