ZibExtraction: verschil tussen versies
Regel 32: | Regel 32: | ||
Het verdient aanbeveling om een nieuwe publicatie eerst op de test omgeving uit te proberen en pas na gebleken correctheid op de produktie omgeving te zetten.<br> | Het verdient aanbeveling om een nieuwe publicatie eerst op de test omgeving uit te proberen en pas na gebleken correctheid op de produktie omgeving te zetten.<br> | ||
Hiertoe moeten een aantal stappen tweemaal uitgevoerd te worden. | Hiertoe moeten een aantal stappen tweemaal uitgevoerd te worden. | ||
* | * genereren wiki pagina's en overige zib bestanden. | ||
* aanmaken startpagina's | * aanmaken startpagina's | ||
* wijzigen hoodfpagina's | * wijzigen hoodfpagina's |
Versie van 14 nov 2018 15:11
Voorbereiden publicatie
- Maak een lijst van de gewijzigde zibs
- Zet in Enterprise Architect de publicatietag's van alle zibs (alle eap’s, alle subset’s: subzibs, basiszib etc.) ( zie EA add-in)
- Check hierbij in het Zib Report scherm of de revision history datum van de gewijzigde zibs aangepast wordt, zo niet check dit handmatig.
- Test in de add-in iedere zib op fouten.
- Iedere melding in het opmerkingen veld komt overeen met een fout, waarschuwing of mededeling.
- Beoordeel en verbeter eventueel de fouten ( en doe dit ook in de nieuwe werkversie als er al een afsplitsing is gemaakt).
- Sommige fouten zijn schijnfouten zoals een id fout bij een bouwsteen verwijzing met een subconcept.
- Beoordeel ook de waarschuwingen en de informatie mededelingen.
- Check of van de gewijzigde zibs ook een (aangepast) voorbeeld bestand met de juiste versie aanwezig is in de voorbeeldbestand folder van de publicatie.
- Start ZibExtraction en maak een release aan of wijzig de prerelease (de juiste inhoud komt later, na de registratie van de bouwstenen: volgende stap) (
ZibExtraction> Beheer>Publicaties en groepen
) - Registeer eerst alle bouwstenen van de publicatie incl basis en subbouwstenen (
ZibExtraction, actie “Registreer Zib’s”
).
- Indien de zibs uit meer dan één bestand komen, dient dit tweemaal gedaan te worden (bestand 1, bestand 2, …., bestand 1, bestand 2, ….) om alle kruisverwijzingen vast te leggen.
- Open een van de .eap bestanden in ZibExtration en maak eventueel de nieuwe configuraties aan (
ZibExtraction> Configuraties
). - Stel de inhoud van de publicatie vast of wijzig de prerelease om de gewijzigde bouwstenen op te nemen. Check de versies. Doe dit aan de hand van de release notes. (
ZibExtraction> Beheer>Publicaties en groepen
).
Voorbereiden Wiki
- Maak voor een nieuwe release (of eerste prerelease) een nieuwe release startpagina aan of pas deze aan bij een tweede of hogere prerelease.
- Doe dit doe de vorige te kopiëren naar een nieuwe pagina met de juiste naam. (ZIB_Publicatie_<jaartal>(NL))
- Wijzig, waar relevant, ‘release’ in ‘prerelease' of omgekeerd (ook in de pagina naam alias).
- Wijzig ook de link naar de release notes en de links naar de downloads.
- Check de pagina op correcte informatie en voeg evt publicatie specifiek informatie toe onder het kopje ‘Overige punten’.
- De opsomming met zibs waaruit de pubicatie bestaat hoeft niet gewijzigd te worden. Dit gebeurt automatisch bij de publicatie van de zibs. Daarvoor moet de opsomming wel in de tweede sectie staan.
- Indien dit verandert, moet het in de configuratie aangepast worden.
ZibExtraction > Configuratie: Groepsbox Wiki, veld ‘TOC Sectie#’
- Herhaal bovenstaande stappen voor de engelse startpagina (HCIM_Release_<jaartal>(EN)).
- Pas op de ZIB hoofdpagina (ZIB_Hoofdpagina en HCIM_Mainpage) de sectie 'Publicaties' cq. 'Releases' aan
- Pas in het menu (MediaWiki:Sidebar) de verwijzing naar Huidige (pre)publicatie en Current (pre)release aan.
Maak de
Test wiki en produktie wiki
Het verdient aanbeveling om een nieuwe publicatie eerst op de test omgeving uit te proberen en pas na gebleken correctheid op de produktie omgeving te zetten.
Hiertoe moeten een aantal stappen tweemaal uitgevoerd te worden.
- genereren wiki pagina's en overige zib bestanden.
- aanmaken startpagina's
- wijzigen hoodfpagina's
- wijzigen menu
- laden van de nieuwe pagina's en zib bestanden
- laden Release Notes
- laden zip bestanden
Voor de gegenereerde pagina's biedt ZibExtraction de mogelijkheid deze bij het aanmaken voor de testomgeving te bewaren. ZibExtraction > Groepbox Resultaten > checkbox Bewaren
Deze kunnen op een later tijdstip, na controle, hergebruikt worden om in de produktie omgeving te laden.
Het kopieren van de startpagina's kan eenvoudig alsvolgt bereikt worden:
- kopieer in de 'Bewerken' status van de pagina de wiki tekst en plak deze in Notepad in een nieuw bestand.
- sla het bestand op en geef het de naam ZIB_Publicatie_<jaartal>(NL).wiki resp. HCIM_Release_<jaartal>(EN).wiki.
- ga naar de folder waar de gegenereerde bestanden bewaard zijn, open de subfolder WikiPages en plaats de bestanden daarin.
De pagina's worden nu automatisch met de rest van de pagina's geladen, als deze naar de produktieomgeving geladen worden.
De overige stappen onder het kopje Voorbereiden Wiki moeten opnieuw gedaan worden.