Jak używać SmartMapper — automatyczne generowanie wzorców naprawy łączy

Tradycyjna naprawa łączy wymaga podania ciągów wyszukiwania i zamiany. SmartMapper odwraca ten przepływ pracy: definiujesz proste reguły mapowania Źródło → Cel, a SmartMapper automatycznie ustala każdy wzorzec znajdź/zamień — rozwiązując łącza względne, identyfikatory DocID SharePoint oparte na identyfikatorach, ścieżki PowerQuery i ciągi połączeń — i raportuje dokładność i pokrycie, zanim zostanie dotknięty choćby jeden dokument.

Kiedy używać SmartMapper: przy każdej migracji, w której nie można ręcznie wyliczyć wszystkich par znajdź/zamień — migracje SharePoint między dzierżawcami, duże migracje z udziałów plików do chmury, środowiska z łączami opartymi na identyfikatorach lub względnymi oraz każdy projekt wymagający raportu pewności przed uruchomieniem produkcyjnym. W przypadku prostych zmian nazw serwerów, gdy znasz już stare i nowe ścieżki, wystarczy standardowy ReplaceMagic.

Przepływ pracy SmartMapper w skrócie

Potok siedmiu kroków

Skanuj

Wypełnij bazę danych łączy z dokumentów lub SharePoint

→

Wybierz DB

SQL Server, SQLite lub MySQL

→

Reguły mapowania

Pary źródło → Cel

→

Generuj

Automatyczne generowanie i ocena wzorców

→

Przejrzyj

Akceptuj / modyfikuj / odrzucaj każdy wzorzec

→

Zastosuj

Uruchom silnik zastępowania na rzeczywistych dokumentach

→

Zweryfikuj

Ponownie przeskanuj i wyeksportuj raport

Krok 1 Skanowanie dokumentów

Zanim SmartMapper będzie mógł generować wzorce, potrzebuje wypełnionej bazy danych łączy. Użyj standardowej funkcji Skanuj dokumenty, aby przeszukać magazyn źródłowy — lokalny lub sieciowy folder, zamapowany dysk lub natywnie podłączoną bibliotekę SharePoint.

W przypadku źródeł na serwerach plików lub udziałach sieciowych wskaż ReplaceMagic folder główny i uruchom pełne skanowanie. Wszystkie wykryte hiperłącza, łącza OLE, źródła łączy, polecenia PowerQuery i ciągi połączeń są zapisywane w bazie danych.
W przypadku źródeł SharePoint (w tym projektów między dzierżawcami) połącz się przez natywną integrację SharePoint. Kluczowe jest zeskanowanie dzierżawy źródłowej, gdy jest jeszcze aktywna — SmartMapper rozwiązuje łącza oparte na identyfikatorach w oparciu o indeks dokumentów, a te identyfikatory przestają być rozwiązywalne w chwili, gdy źródło przejdzie w tryb offline.
Zaznacz wszystkie odpowiednie obszary dokumentów w ustawieniach skanowania: Hiperłącza, łącza OLE, źródła łączy, zapytania Power Queries, połączenia, VBA. Obszar niezeskanowany będzie niewidoczny dla SmartMapper.

Zapoznaj się z artykułami Jak skanować dokumenty i Przewodnik natywnej obsługi SharePoint, aby uzyskać pełne instrukcje skanowania.

Krok 2 Wybór backendu bazy danych

SmartMapper przechowuje wszystkie zeskanowane łącza, reguły mapowania, wygenerowane wzorce i wyniki walidacji w relacyjnej bazie danych. Obsługiwane są trzy backendy — identyczny schemat, identyczne wyniki:

SQL Server

Najlepszy dla projektów współdzielonych i zarządzanych na poziomie przedsiębiorstwa. SQL Server Express wystarczy do większości migracji. Użyj go, gdy wielu członków zespołu potrzebuje dostępu do tej samej bazy danych wzorców.

SQLite

Najlepszy dla projektów na jednym komputerze lub realizowanych przez partnera. Jeden plik, zero instalacji, brak kosztów licencji. Idealny dla migracji na laptopie.

MySQL

Alternatywa open-source dla SQL Server w środowiskach posiadających już infrastrukturę MySQL. Ten sam schemat co pozostałe dwa backendy.

Skonfiguruj backend w Konfiguracja → Karta SmartMapper → Backend bazy danych. Możesz przełączać backendy między przebiegami; schemat jest identyczny, więc migracja danych jest prosta.

Krok 3 Definiowanie reguł mapowania źródło-cel

Reguły mapowania to jedyne dane wejściowe, których SmartMapper potrzebuje od Ciebie. Każda reguła to pojedyncza para Źródło → Cel:

Przykładowe reguły mapowania dla migracji z udziału plików do SharePoint Online

Źródło (stara ścieżka)	→	Cel (nowa ścieżka)
\\ServerABC\Finance	→	https://company.sharepoint.com/sites/financenew
\\ServerABC\HR	→	https://company.sharepoint.com/sites/hr
\\OldNAS\Shared\Projects	→	https://company.sharepoint.com/sites/projects

Wskazówki dotyczące pisania skutecznych reguł mapowania:

Mapuj na najwyższym użytecznym poziomie — mapuj \\Server\Finance zamiast każdego podfolderu. SmartMapper automatycznie konsoliduje wzorce podfolderów.
Wymieniaj reguły od najbardziej szczegółowych do najmniej szczegółowych.
W przypadku migracji między dzierżawcami dodaj regułę dla starego bazowego adresu URL dzierżawy i jedną dla starego wewnętrznego adresu URL resolvera identyfikatorów dzierżawy. SmartMapper rozwiąże każde łącze oparte na identyfikatorze w oparciu o indeks dokumentów źródłowych zanim dzierżawa źródłowa zostanie wycofana z eksploatacji.
Reguły można wprowadzać ręcznie w siatce SmartMapper lub importować z pliku CSVślnie oddzielone znakiem |).

Krok 4 Uruchamianie generowania wzorców SmartMapper

Kliknij Generuj wzorce na karcie SmartMapper. Dla każdego łącza w bazie danych SmartMapper:

Wykrywa typ łącza — bezwzględne, względne, SharePointDocID, OneDriveID, PowerQuery, ConnectionString, OneNote, SharePoint-special.
Rozwiązuje każde łącze do ścieżki bezwzględnej — niezależnie od jego postaci: względnej, opartej na identyfikatorze lub osadzonej w poleceniach PowerQuery (File.Contents, Folder.Files, Web.Contents) albo parametrach połączenia (Provider=, DSN=, Data Source=, OPENROWSET).
Stosuje regułę mapowania, aby uzyskać nową ścieżkę docelową (NewLink).
Generuje wzorce w najmniejszym wystarczającym zakresie — dzięki temu szeroka reguła \\Server\Finance nie tworzy tysięcy zbędnych wzorców podfolderów.
Deduplikuje i optymalizuje automatycznie — identyczne wzorce z różnych łączy są konsolidowane w jeden wpis.
Oznacza konflikty, gdy ten sam SearchString mapuje się na dwa różne ReplaceString. Są one oznaczane jako Konflikt i muszą zostać rozwiązane przez człowieka, zanim będą mogły być zastosowane.

Dlaczego łączy względnych nie da się naprawić ręcznie

Skoroszyt w lokalizacji \\ServerABC\Finance\Reports\Q2.xlsx zawiera łącze ..\Sub1\file.xlsx. Ten sam tekst występuje w setkach innych dokumentów i w każdym wskazuje co innego, ponieważ łącze względne ma znaczenie wyłącznie w odniesieniu do dokumentu, który je zawiera.

Żadna pojedyncza para wyszukiwania i zamiany tego nie naprawi. SmartMapper ustala, na co faktycznie wskazuje każde wystąpienie, stosuje Twoją regułę i generuje wzorzec. Podajesz jeden wiersz:

\\ServerABC\Finance → https://company.sharepoint.com/sites/financenew

Krok 5 Przeglądanie wygenerowanych wzorców

Siatka wzorców pokazuje każdą automatycznie wygenerowaną kombinację znajdź/zamień z jej statusem i metrykami walidacji. Przejrzyj każdy wzorzec, zanim zostanie dotknięty jakikolwiek dokument:

Statusy wzorców

Wygenerowany	Utworzony przez SmartMapper, jeszcze nie przejrzany
Zaakceptowany	Zatwierdzony — zostanie uruchomiony na dokumentach
Odrzucony	Jawnie wykluczony — nie zostanie uruchomiony
Zmodyfikowany	Edytowałeś SearchString lub ReplaceString — zostanie uruchomiony z Twoją wersją
Konflikt	Ten sam SearchString mapuje się na różne ReplaceString — musi być rozwiązany przed zaakceptowaniem

Dokładność i pokrycie

Każdy wzorzec pokazuje liczbę poprawne (łącza, które wzorzec poprawnie naprawiłby), liczbę niepoprawne (łącza, które wzorzec uszkodziłby) i procent pewności. Dziennik wykonania oznacza to jako Confidence (fix accuracy).

Wzorzec z 100% pewnością i zerową liczbą niepoprawne można bezpiecznie zaakceptować natychmiast. Wzorce z wpisami niepoprawne powinny być sprawdzane — mogą wskazywać na nakładającą się regułę mapowania lub niejednoznaczny segment ścieżki.

Na poziomie przebiegu SmartMapper raportuje dwie niezależne wartości i potrzebujesz obu:

Dokładność — spośród łączy zmienianych przez zaakceptowane wzorce, jaka część jest zmieniana poprawnie.
Pokrycie — spośród wszystkich łączy w zakresie, część która zostanie poprawnie naprawiona.

Mierzą różne rzeczy i zmieniają się niezależnie. Przebieg może być w 100% dokładny, a mimo to obejmować tylko 82% łączy w zakresie — każda wprowadzona zmiana była poprawna, ale prawie jedna piąta pracy nigdy nie została wykonana. Pojedynczy połączony wynik ukrywa dokładnie tę lukę, dlatego obie wartości raportowane są osobno.

Opcjonalne zestawienie zbiorcze jest dostępne na potrzeby raportowania dla interesariuszy. Publikuj je obok wartości dokładności i pokrycia, nigdy zamiast nich.

Konflikty wymagają ręcznego rozwiązania. Konflikt oznacza, że dwa różne łącza rozwiązały się do tego samego SearchString, ale z różnymi ReplaceString — SmartMapper nie może zdecydować, które jest poprawne. Otwórz grupę konfliktów, sprawdź dokumenty źródłowe, wybierz właściwy ReplaceString i kliknij Rozwiąż, lub całkowicie odrzuć wzorzec, jeśli łącza nie powinny być zmieniane.

Krok 6 Stosowanie zaakceptowanych wzorców do dokumentów

Po zatwierdzeniu przejrzanych wzorców uruchom silnik zastępowania. Stosowane są tylko wzorce w statusie Zaakceptowany lub Zmodyfikowany — wzorce Wygenerowane, Odrzucone i nierozwiązane Konflikty są pomijane.

Dokumenty są przetwarzane równolegle (konfigurowalny liczba wątków) bez otwierania przez Word, Excel ani żadną inną aplikację.
Jeśli włączony jest tryb podglądu, ReplaceMagic raportuje każdą zmianę, którą by wprowadził, ale nic nie zapisuje na dysk — użyj tego do weryfikacji wyników przed zatwierdzeniem.
Włącz automatyczną kopię zapasową, aby zapisać kopię każdego dokumentu przed jego modyfikacją.
W przypadku celów SharePoint włącz Zachowaj datę ostatniej modyfikacji i wartości Zmodyfikowany przez (wymaga uprawnień administratora witryny), aby zachować metadane po zmianach.

Zapoznaj się z artykułem Jak naprawić uszkodzone łącza, aby uzyskać szczegółowe ustawienia silnika zastępowania.

Krok 7 Weryfikacja i eksport wyników

Po zakończeniu przebiegu zastępowania:

Ponownie przeskanuj ten sam magazyn, aby potwierdzić, że wszystkie poprzednio uszkodzone łącza są teraz rozwiązane. Nowy wynik skanowania można porównać z punktem odniesienia, aby dokładnie pokazać, które łącza zmieniły status.
Sprawdź kartę Dodatkowe informacje pod kątem dokumentów, które zostały pominięte (limit rozmiaru, limit czasu, ograniczanie przepustowości SharePoint). Ponownie przetwórz pominięte pliki, klikając Importuj pominięte pliki.
Wyeksportuj wyniki do CSV, Excel lub bazy danych SmartMapper. Eksport zawiera oryginalne łącze, nowe łącze, zastosowany wzorzec, ścieżkę dokumentu i znacznik czasu zmiany — pełny ślad audytu dla celów zgodności lub raportowania dla interesariuszy.
Wyeksportuj raport na poziomie przebiegu z karty SmartMapper, aby dostarczyć dokument odbioru pokazujący łączną liczbę zeskanowanych łączy, zastosowane wzorce, liczby poprawne / niepoprawne i ogólny procent pewności.

Zapoznaj się z artykułem Jak eksportować wyniki, aby zapoznać się z opcjami formatu eksportu.

Przypadek szczególny: łącza DocID SharePoint i migracje między dzierżawcami

Łącza oparte na identyfikatorach SharePoint (DocID, OrganizationalViewLink, DirectLink) są najtrudniejszym typem łączy do naprawienia za pomocą konwencjonalnych narzędzi, ponieważ identyfikator ma znaczenie tylko w oryginalnej dzierżawie. Po wycofaniu dzierżawy źródłowej z eksploatacji te identyfikatory są trwale utracone.

SmartMapper rozwiązuje ten problem, skanując podczas gdy źródło jest jeszcze aktywne:

Połącz się z dzierżawą źródłową SharePoint i uruchom pełne skanowanie, dopóki jest jeszcze aktywna.
Zdefiniuj regułę mapowania między dzierżawcami (stary bazowy adres URL dzierżawy → nowy bazowy adres URL dzierżawy).
Uruchom generowanie wzorców.
Wygenerowany wzorzec zastępuje stary adres URL oparty na identyfikatorze nowym bezwzględnym adresem URL — naprawa, która działa nawet po przejściu dzierżawy źródłowej w tryb offline.

Kluczowa kwestia: Uruchom skanowanie SmartMapper na dzierżawie źródłowej przed przełączeniem migracji. Po przejściu źródła w tryb offline rozwiązywanie DocID nie jest już możliwe.

Pełny przewodnik dotyczący migracji między dzierżawcami znajdziesz pod adresem Migracja SharePoint Online między dzierżawcami: naprawianie uszkodzonych łączy.

Praca z PowerQuery, ConnectionStrings i łączami OLE

Wiele dużych środowisk Excela zawiera łącza, które nie są widoczne jako standardowe hiperłącza — są ukryte w kodzie M PowerQuery, ciągach połączeń OLEDB lub definicjach pamięci podręcznej przestawnej. SmartMapper wyodrębnia je automatycznie:

PowerQuery: SmartMapper obsługuje ścieżki w poleceniach PowerQuery M, w tym File.Contents, Folder.Files, Web.Contents i SharePoint.Files. Gdy migracja przenosi pliki lokalne do SharePoint, sama zmiana ścieżki nie wystarczy — zapytanie musi działać na magazynie w chmurze, czym SmartMapper również się zajmuje.
ConnectionStrings: Ścieżki wewnątrz instrukcji Provider=, DSN=, Data Source=, OPENROWSET, OPENDATASOURCE i BULK INSERT są wyodrębniane, rozwiązywane i mapowane przy użyciu tego samego potoku co zwykłe łącza.
Łącza OLE i źródła łączy: Zewnętrzne ścieżki odniesień w skoroszytach Excela łączących się z zewnętrznymi źródłami danych (inny skoroszyt, plik bazy danych) są aktualizowane za pośrednictwem obszaru Źródła łączy.

Upewnij się, że obszary Power Queries, Połączenia i Źródła łączy są zaznaczone w ustawieniach skanowania, aby uwzględnić je w bazie danych SmartMapper.

Wskazówki i najlepsze praktyki

Używaj SQLite do prototypowania. Uruchom pierwszy przebieg SmartMapper z backendem SQLite — bez konfiguracji serwera, natychmiastowy start. Zweryfikuj jakość wzorców przed zaangażowaniem się w pełne wdrożenie SQL Server dla dużego projektu zespołowego.
Używaj RunIDs dla migracji wielofalowych. Każdy przebieg SmartMapper jest ograniczony przez RunID. Przypisz inny RunID na każdą falę migracji, aby wyniki z różnych fal współistniały w tej samej bazie danych bez wzajemnego zanieczyszczania.
Rozwiąż konflikty przed uruchomieniem produkcyjnym. Nierozwiązane wzorce Konflikt są wykluczane z przebiegu zastępowania. Przejrzyj listę grup konfliktów po każdym przebiegu generowania i jawnie rozwiąż lub odrzuć każdy z nich.
Skieruj najbardziej szczegółową regułę mapowania na pierwszą pozycję. Jeśli \\Server\Finance\Archive powinno być mapowane inaczej niż \\Server\Finance, dodaj regułę Archive powyżej reguły Finance w siatce mapowania.
Uruchom podgląd przed zastosowaniem. Zawsze uruchamiaj w trybie podglądu na reprezentatywnym podzbiorze dokumentów, aby zwalidować wyniki wzorców przed uruchomieniem na całej bibliotece dokumentów.
W przypadku usługi przygotowania zastąpień: jeśli Twój projekt jest zbyt duży lub złożony, aby uruchomić SmartMapper we własnym zakresie, zespół ReplaceMagic może przygotować wszystkie reguły mapowania i wzorce w Twoim imieniu. Zapoznaj się z Pakietem przygotowania zastąpień.