Verpak de gegevens van uw groep voordat ze moeten verhuizen.

1. Bepaal wat het pakket je moet laten doen.

Schrijf de beoogde uitkomst op voordat je een exportknop selecteert. Een leesbare kopie voor een vertrekkend lid, een verhuizing naar een andere applicatie en een volledig herstel van de bestaande dienst vragen verschillend materiaal. Eén export kan het eerste doel goed dienen en de andere twee niet halen.

BookStack maakt dit onderscheid expliciet: de hulpmiddelen voor het exporteren en importeren van inhoud zijn niet bedoeld als back-up en herstel. Een leesbare HTML- of PDF-kopie is nuttig, maar mag de herstelset voor de applicatie niet stilzwijgend vervangen. BookStack inhoud exporteren en importeren.

Voor een hypothetische workshopgroep is het eerste doel bescheiden: een andere bevoegde beheerder kan de handleiding lezen en een representatief gedeelte, inclusief de diagrammen, in een aparte testinstantie importeren.

2. Leg het formaat en de hiaten vast.

Maak een matrix die beschrijft wat je wilt behouden en hoe je dat gaat aantonen. Zet pas “compleet” in een cel als je de bestemming hebt gecontroleerd.

BookStack documenteert een draagbaar ZIP-formaat met inhoudsgegevens, bijlagen en afbeeldingen dat opnieuw in BookStack kan worden geïmporteerd. Dat bewijst geen compatibiliteit met een andere wiki of behoud van elke instelling op serviceniveau. BookStack exportformaten.

3. Geef het pakket een menselijk startpunt.

Voeg een korte readme toe met de bronapplicatie en versie, exportdatum en tijdzone, gekozen bereik, rol van de exporteur, bestandslijst en verwachte bestemming. Gebruik beschrijvende mapnamen zoals readable-content, attachments en import-package. Bewaar inloggegevens elders; schrijf alleen de goedgekeurde ophaalprocedure voor bevoegde beheerders op.

De hypothetische handleiding bevat een openingschecklist, een pagina over machineonderhoud, een diagram en een gekoppelde spreadsheet. Het manifest noteert die vier items, hun relatieve paden en de relatie tussen de pagina en de bijlage. Noteer ook een beperkte pagina als bewust uitgesloten, zodat een afwezigheid later niet wordt aangezien voor onbedoeld verlies.

Een checksum kan helpen om tijdens overdracht een ongewijzigd bestand te herkennen. Het bewijst niet dat de export compleet, correct gemachtigd of leesbaar was.

4. Inspecteer een representatieve steekproef.

Open de leesbare kopie zonder afhankelijk te zijn van een actieve sessie in de oorspronkelijke applicatie. Volg een link, bekijk een ingesloten afbeelding en open de gekoppelde bijlage. Let op verwijzingen die nog steeds naar de brondienst leiden. Noteer welke links bewust extern zijn en welke na een verhuizing zouden breken.

Kies voor agenda's een voorbeeld met een terugkerende afspraak, een uitzondering en een afspraak met een relevante tijdzone. Nextcloud documenteert agenda-export en iCalendar-compatibele .ics import. Dat legt een ondersteund uitwisselingspad vast, niet het bewijs dat jouw doel elke gekozen functie behoudt. Nextcloud Agenda importeren en exporteren.

Controleer de documentatie voor je geïnstalleerde release voordat je interfacelabels volgt; de gelinkte rolling manual kan een andere versie beschrijven.

5. Importeer naar een aparte, gecontroleerde bestemming.

Gebruik een lege testbestemming of een expliciet goedgekeurde testcollectie. Laat de werkende dienst en de oorspronkelijke gegevens ongemoeid. Schakel uitgaande meldingen uit en beperk externe verbindingen voordat je de geïmporteerde applicatie start; het doel is de gegevens beoordelen, niet historische gebeurtenissen opnieuw naar leden sturen.

Laat de tweede beheerder de readme volgen zonder te vertrouwen op ongedocumenteerde instructies van de exporteur. Vergelijk de verwachte items met het geïmporteerde resultaat. Controleer het diagram, de spreadsheetlink, de paginastructuur en de beoogde ledenmachtigingen. Noteer elke roltoewijzing die handmatig werk vereist. Als een formaat een benodigde functie mist, beslis dan of je die opnieuw opbouwt, een andere exportmethode kiest of een leesbaar archief naast de nieuwe dienst bewaart.

6. Maak falen informatief.

Als bestanden ontbreken, vergelijk dan eerst het exportbereik en de machtigingen van de exporteur voordat je herhaaldelijk grotere archieven maakt. Als links breken, stel dan vast of ze naar de oude dienst verwijzen of naar een bestand dat niet in het pakket zit. Als de import onverwachte duplicaten maakt, stop en inspecteer de matchingregels voordat je hetzelfde pakket opnieuw importeert.

Voor het workshopvoorbeeld betekent acceptatie dat de tweede beheerder de geselecteerde pagina's kan lezen en bewerken, elk opgenomen bestand kan ophalen en kan aantonen dat een gewoon lid geen toegang heeft tot het uitgesloten materiaal. Noteer elk resultaat en de beoordelaar ervan. “De import is voltooid” is slechts één observatie. Houd onopgeloste verschillen naast het pakket vermeld, zodat de groep daar bewust over kan beslissen.

7. Houd exports en herstel in hun eigen sporen.

Bewaar een geaccepteerd pakket op een gecontroleerde locatie los van de brondienst en spreek af wanneer je het vernieuwt. Beoordeel opnieuw na wijzigingen in belangrijke formaten, machtigingen of applicatieversies. Exportbestanden kunnen privé-inhoud bevatten, zelfs als de bestemming slechts tijdelijk is, dus wijs er ook toegang en een bewaarbeslissing aan toe.

Houd de applicatieherstelset apart: de hersteldocumentatie van BookStack vereist bijvoorbeeld database- en bestandsmateriaal naast een leesbare documentexport. BookStack back-up- en herstelvereisten.

Ga verder met de hersteloefening voor dienstherstel, de opslagwerkblad voor exportwerkruimte en de service-inventaris voor afhankelijkheden. Portabiliteit is iets om met je pakket aan te tonen, niet om aan te nemen op basis van een bestandsextensie.