Spakuj dane swojej grupy, zanim będą musiały się przenieść.

1. Zdecyduj, co pakiet musi ci umożliwić.

Zapisz zamierzony wynik przed wybraniem przycisku eksportu. Czytelna kopia dla odchodzącego członka, przeniesienie do innej aplikacji i pełne odzyskanie istniejącej usługi wymagają różnych materiałów. Jeden eksport może dobrze służyć pierwszemu celowi i zawieść w dwóch pozostałych.

BookStack wyraźnie to rozróżnia: jego narzędzia eksportu i importu treści nie są przeznaczone do tworzenia kopii zapasowych i przywracania. Czytelna kopia HTML lub PDF jest przydatna, ale nie powinna po cichu zastępować zestawu do odzyskiwania aplikacji. Eksportowanie i importowanie treści w BookStack.

W hipotetycznej grupie warsztatowej początkowy cel jest skromny: inny upoważniony opiekun może przeczytać podręcznik operacyjny i zaimportować reprezentatywną sekcję, wraz z jej diagramami, do osobnej instancji testowej.

2. Zapisz format i luki.

Utwórz macierz opisującą, co musisz zachować i jak to udowodnisz. Nie wpisuj „kompletne” w komórce, dopóki nie sprawdzisz miejsca docelowego.

BookStack opisuje przenośny format ZIP zawierający dane treści, załączniki i obrazy, które można ponownie zaimportować do BookStack. Nie dowodzi to zgodności z inną wiki ani zachowania wszystkich ustawień na poziomie usługi. Formaty eksportu BookStack.

3. Daj pakietowi ludzki punkt startowy.

Dodaj krótki plik readme ze źródłową aplikacją i wersją, datą i strefą czasową eksportu, wybranym zakresem, rolą eksportującego, listą plików i oczekiwanym miejscem docelowym. Użyj opisowych nazw folderów, takich jak readable-content, attachments oraz import-package. Poświadczenia przechowuj gdzie indziej; zapisz tylko zatwierdzoną procedurę pobierania dla upoważnionych opiekunów.

Hipotetyczny podręcznik zawiera listę kontrolną na otwarcie, stronę pielęgnacji maszyny, diagram i jeden powiązany arkusz kalkulacyjny. Jego manifest rejestruje te cztery pozycje, ich ścieżki względne oraz relację między stroną a jej załącznikiem. Zapisz także stronę ograniczoną jako celowo wykluczoną, aby później nie pomylono braku z przypadkową utratą.

Suma kontrolna może pomóc zidentyfikować niezmieniony plik podczas transferu. Nie dowodzi, że eksport był kompletny, miał poprawne uprawnienia lub był czytelny.

4. Sprawdź reprezentatywną próbkę.

Otwórz czytelną kopię bez polegania na aktywnej sesji w oryginalnej aplikacji. Otwórz link, sprawdź osadzony obraz i otwórz powiązany załącznik. Szukaj odwołań, które nadal prowadzą z powrotem do usługi źródłowej. Zapisz, które linki są celowo zewnętrzne, a które przestałyby działać po przeniesieniu.

W przypadku kalendarzy wybierz próbkę obejmującą zdarzenie powtarzające się, wyjątek oraz zdarzenie z istotną strefą czasową. Nextcloud opisuje eksport kalendarza i zgodny z iCalendar .ics import. To ustanawia obsługiwaną ścieżkę wymiany, ale nie dowodzi, że twój cel zachowuje każdą wybraną funkcję. Import i eksport kalendarza Nextcloud.

Sprawdź dokumentację dla zainstalowanej wersji przed kierowaniem się etykietami interfejsu; powiązany podręcznik online może opisywać inną wersję.

5. Zaimportuj do oddzielnego, kontrolowanego celu.

Użyj pustego miejsca docelowego testu lub wyraźnie zatwierdzonej kolekcji testowej. Nie zmieniaj działającej usługi ani jej oryginalnych danych. Wyłącz powiadomienia wychodzące i ogranicz połączenia zewnętrzne przed uruchomieniem importowanej aplikacji; celem jest ocena danych, a nie ponowne wysyłanie historycznych zdarzeń do członków.

Niech drugi opiekun postępuje zgodnie z readme, nie polegając na nieudokumentowanych instrukcjach od eksportującego. Porównaj oczekiwane pozycje z zaimportowanym wynikiem. Sprawdź diagram, link do arkusza kalkulacyjnego, strukturę stron i zamierzone uprawnienia członków. Zapisz każde mapowanie ról, które wymaga ręcznej pracy. Jeśli w formacie brakuje potrzebnej funkcji, zdecyduj, czy ją odtworzyć, wybrać inną metodę eksportu czy zachować czytelne archiwum obok nowej usługi.

6. Uczyń awarię informacyjną.

Jeśli brakuje plików, porównaj zakres eksportu i uprawnienia eksportującego, zanim wielokrotnie zaczniesz tworzyć większe archiwa. Jeśli linki przestają działać, ustal, czy odwołują się do starej usługi, czy do pliku nieobecnego w pakiecie. Jeśli import tworzy nieoczekiwane duplikaty, zatrzymaj się i sprawdź jego reguły dopasowania, zanim ponownie zaimportujesz ten sam pakiet.

W przykładzie warsztatowym akceptacja oznacza, że drugi opiekun może przeczytać i edytować wybrane strony, pobrać każdy dołączony plik i wykazać, że zwykły członek nie ma dostępu do wykluczonego materiału. Zapisz każdy wynik i jego recenzenta. „Import się zakończył” to tylko jedna obserwacja. Nierozwiązane różnice wymień obok pakietu, aby grupa mogła podjąć świadomą decyzję.

7. Trzymaj eksporty i odzyskiwanie w osobnych torach.

Przechowuj zaakceptowany pakiet w kontrolowanej lokalizacji niezależnej od usługi źródłowej i ustal, kiedy go odświeżać. Przejrzyj go ponownie po zmianach ważnych formatów, uprawnień lub wersji aplikacji. Pliki eksportu mogą zawierać prywatne treści, nawet gdy miejsce docelowe jest tylko tymczasowe, więc przypisz im również dostęp i decyzję o okresie przechowywania.

Zestaw do odzyskiwania aplikacji przechowuj osobno: dokumentacja odzyskiwania BookStack wymaga na przykład materiału bazy danych i plików wykraczającego poza czytelny eksport dokumentów. Wymagania dotyczące kopii zapasowej i przywracania BookStack.

Kontynuuj z próbę przywracania dla odzyskiwania usługi, arkusz roboczy przechowywania dla przestrzeni roboczej eksportu i inwentarzem usług dla zależności. Przenośność należy wykazać swoim pakietem, a nie zakładać na podstawie rozszerzenia pliku.