ZibExtraction: verschil tussen versies

Uit Zorginformatiebouwstenen
Ga naar: navigatie, zoeken
(Voorbereiden publicatie)
 
(52 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 3: Regel 3:
 
{{ZIBS_ManualPages}}
 
{{ZIBS_ManualPages}}
 
==Voorbereiden publicatie==
 
==Voorbereiden publicatie==
*Maak een kopie van de eap files die de zib's van de publicatie bevatten en hernoem deze tot de werkversie van de volgende (pre)release, format <code>(V)ZIBS Werkversie <jaartal>-<prepublicatie volgnummer></code>, dus b.v. VZIBS Werkversie 2019-1 .
+
<ol style="margin-left: 25px">
  [[Bestand:Warning-icon.png]] Vanaf dit punt mogen er geen wijzigingen meer uitgevoerd worden op de eap files van de nieuwe publicatie!
+
<li>Open de eap/qea(x) files die de zib's van de publicatie bevatten en check of er geen zibs meer gelocked zijn. Als deze er zijn, unlock deze dan. Hiervoor moet je als admin de EA file openen.</li>
*Open de nieuwe eap files stuk voor stuk in Enterprise Architect en pas de HCIM tags op DCM Repository niveau aan, t.w. de tags HCIM::ReleaseYear, HCIM::ReleaseType en HCIM::PrereleaseNumber.  
+
<li>Maak een nieuw leeg EA project aan, naam format: <code>(V)ZIBS P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>)</code>, dus b.v. ZIBS Publicatieversie 2017 of ZIBS Prepublicatieversie 2017-1.<li> 
*Hernoem de huidige eap files om aan te geven dat het nu (pre)publicatie bestanden zijn, format: <code>(V)ZIBS P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>)</code>, dus b.v. ZIBS Publicatieversie 2017 of ZIBS Prepublicatieversie 2017-1.
+
<li>Maak een lokale kopie van de server (<code>EA > Settings > Transfer > Full porject transfer via connection</code>)  met optie: DBMS to File (Source database: DBType=1;Connect=Provider=MSOLEDBSQL19.1;Persist Security Info=False;User ID=wouter.zanen@nictiz.nl;Initial Catalog=enterprisearchitect;Data Source=zibs.database.windows.net;Initial File Name="";Use Encryption for Data=Strict;Server SPN="";Authentication=ActiveDirectoryInteractive;Access Token="";Host Name In Certificate="";Server Certificate=""). Target project is het zojuist aangemaakte lege EA project.
  [[Bestand:Warning-icon.png]] Als een prerelease tot release wordt gepromoveerd, moeten de eap bestandsnamen en de bovengenoemde HCIM tags aangepast worden!
+
(We doen dit omdat acties direct op de server uitvoeren nu nog te traag is.)</li>
*Maak in de centrale folder van het zib-centrum met publicaties een nieuwe folder aan met als naam de naam van de publicatie: <code>P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>)</code>.
+
<li>Lock nu alle zibs op de server tot dat de publicatie volledig gereed is </li>
*<i>Verplaats</i> de eap files van de publicatie naar deze folder.
+
<li></b>Vervolg actie op de lokale kopie doen !</b></li>
*<i>Kopieer</i> tevens voor iedere eap file de folder met bijbehorende voorbeeldbestanden van de werkfolder naar de nieuwe publicatie folder.
+
<li>Maak op grond van de behandelde issues een lijst van de gewijzigde zibs. Deze kan automatisch uit Bits gegenereerd worden vanuit ZibExtraction. (<code>ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > Release Document > Uitvoerkeuzes > Losse lijst </code>[[File:page.png|link=GroupRelease]]). Kies wel de gewenste (pre-)publicatie(s).</li>
*Indien de nieuwe <i>werk</i>versie een nieuw publicatiejaar heeft moeten de namen van de folders met voorbeeldbestanden in de werkfolder gewijzigd worden, bv VZIBS_Examples_2020.
+
<li>Start ZibExtraction en check alle SNOMED CT en LOINC codes of er geen foute of verlopen codes in de set zibs aanwezig zijn. (<code>ZibExtraction> Beheer> CodeCheck</code><[[File:page.png|link=ZibCodeCheck]])<br>
 +
Check ook de codes uit de 'eigen' zib codestelsels op foute of verlopen codes. Dit kan ook met ZibCodeCheck met Kies codesystem > Overige code reports.<br>
 +
Dit levert ook rapportages over deprecated codes op die je later nodig hebt.</li>
 +
<li>Test in EA met de de add-in iedere zib op fouten. (<code>EA plugin voor zibs</code>[[File:page.png|link = ZibTools]])<br>
 +
Iedere melding in het opmerkingen veld komt overeen met een fout, waarschuwing of mededeling.<br>
 +
Beoordeel en verbeter eventueel de fouten.<br>
 +
Sommige fouten zijn schijnfouten zoals een id fout bij een bouwsteen verwijzing met een subconcept.<br>
 +
Beoordeel ook de waarschuwingen en de informatie mededelingen.</li>
 +
<li>Check of van de gewijzigde zibs ook een (aangepast) voorbeeld bestand met de juiste versie aanwezig is in de voorbeeldbestand folder van de publicatie.<br>
 +
Dit wordt in de test automatisch gedaan. Indien geen voorbeeldfile met de correcte versie gevonden wordt, zal dit als een warning aangegeven worden.</li>
 +
<li>Zet in Enterprise Architect de publicatietag's van alle zibs (alle eap/qea(x) files, alle subset’s: subzibs, basiszib etc.) (<code>EA plugin voor zibs</code>[[File:page.png|link = ZibTools]])<br>
 +
Check hierbij in het Zib Report scherm of de revision history datum van alle gewijzigde zibs uit de hierboven aangemaakte lijst aangepast wordt, zo niet check dit handmatig.</li>
 +
<li>Maak een kopie van de eap/qea(x) files die de zib's van de publicatie bevatten en hernoem deze tot de werkversie van de volgende (pre)release, format <code>(V)ZIBS Werkversie <jaartal>-<prepublicatie volgnummer></code>, dus b.v. VZIBS Werkversie 2019-1.</li>
 +
  [[Bestand:Warning-icon.png]] Vanaf dit punt mogen er geen wijzigingen meer uitgevoerd worden op de eap/qea(x) files van de nieuwe publicatie!
 +
<li>Open de nieuwe eap/qea(x) (werk)files stuk voor stuk in Enterprise Architect en pas de HCIM tags op DCM Repository niveau aan, t.w. de tags HCIM::ReleaseYear, HCIM::ReleaseType en HCIM::PrereleaseNumber.</li>  
 +
  [[Bestand:Warning-icon.png]] Als een prerelease tot release wordt gepromoveerd, moeten de eap/qea(x)  bestandsnamen en de bovengenoemde HCIM tags aangepast worden!
 +
<li>Maak in de centrale folder van het zib-centrum met publicaties een nieuwe folder aan met als naam de naam van de publicatie: <code>P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>)</code>.</li>
 +
<li><i>Verplaats</i> de eap/qea(x) files van de publicatie naar deze folder.</li>
 +
<li><i>Kopieer</i> tevens voor iedere eap/qea(x)  file de folder met bijbehorende voorbeeldbestanden van de werkfolder naar de nieuwe publicatie folder.</li>
 +
<li>Indien de nieuwe <i>werk</i>versie een nieuw publicatiejaar heeft moeten de namen van de folders met voorbeeldbestanden in de werkfolder gewijzigd worden, bv VZIBS_Examples_2020.</li>
 
  [[Bestand:Warning-icon.png]] Iedere publicatie heeft zijn eigen set voorbeeldbestanden. In de naam van de voorbeeldfolder is het prepublicatienummer niet opgenomen. Overigens is de naam niet kritisch omdat de voorbeeldfolder tijdens het publicatieproces geselecteerd moet worden.
 
  [[Bestand:Warning-icon.png]] Iedere publicatie heeft zijn eigen set voorbeeldbestanden. In de naam van de voorbeeldfolder is het prepublicatienummer niet opgenomen. Overigens is de naam niet kritisch omdat de voorbeeldfolder tijdens het publicatieproces geselecteerd moet worden.
*Reset in Enterprise Architect voor de eap files van de nieuwe werkversie de publicatietag's van alle zibs (alle eap’s, alle subset’s: subzibs, basiszib etc.) (<code>EA plugin voor zibs</code>[[File:page.png|link = ZibTools]])
+
<li>Reset in Enterprise Architect voor de eap/qea(x) files van de nieuwe werkversie de publicatietag's van alle zibs (alle eap/qea(x) ’s, alle subset’s: subzibs, basiszib etc.) (<code>EA plugin voor zibs</code>[[File:page.png|link = ZibTools]])</li></ol>
De volgende acties worden uitgevoerd op de eap files van de nieuwe publicatie, en dus <u>niet</u> op de eap files van de werkversie.
+
De volgende acties worden uitgevoerd op de eap/qea(x) files van de nieuwe publicatie, en dus <u>niet</u> op de eap/qea(x) files van de werkversie.
*Maak op grond van de behandelde issues een lijst van de gewijzigde zibs.
+
<ol style="margin-left: 25px" start=15>
*Start ZibExtraction en check alle SNOMED CT en LOINC codes of er geen foute of verlopen codes in de set zibs aanwezig zijn. (<code>ZibExtraction> Beheer> CodeCheck</code>[[File:page.png|link=ZibCodeCheck]])
+
<li>Zet in de eap/qea(x) files van de nieuwe publicatie het gebruikersbeheer uit (<code> EA Settings > Administer > Enable Security</code>). Hiervoor moet je als admin de EA file openen. Tevens heb je de autorisatie sleutel nodig.</li>
*Zet in Enterprise Architect de publicatietag's van alle zibs (alle eap’s, alle subset’s: subzibs, basiszib etc.) (<code>EA plugin voor zibs</code>[[File:page.png|link = ZibTools]])
+
<li>Start ZibExtraction en maak een nieuwe (pre)release aan of wijzig de prerelease omschrijving bij een tweede of latere prerelease (de juiste inhoud komt later, na de registratie van de bouwstenen: volgende stap)<br>(<code>ZibExtraction> Beheer>Publicaties en groepen | tabblad Releases</code>[[File:page.png|link=GroupRelease]])</li>
:Check hierbij in het Zib Report scherm of de revision history datum van de gewijzigde zibs aangepast wordt, zo niet check dit handmatig.
+
<li>Registeer eerst alle bouwstenen van de publicatie  incl. basis en subbouwstenen (<code>ZibExtraction, actie “Registreer Zib’s”</code>[[File:page.png|link=ZibExtraction_UI]]).<br>
*Test in de add-in iedere zib op fouten.
+
Indien de zibs uit meer dan één bestand komen, dient dit voor al deze bestanden gedaan te worden. De volgorde maak niet uit.</li>
:Iedere melding in het opmerkingen veld komt overeen met een fout, waarschuwing of mededeling.
+
<li>Indien de (pre)publicatie volledig nieuwe bouwstenen bevat, dienen een paar extra stappen gedaan te worden:
:Beoordeel en verbeter eventueel de fouten ( en doe dit ook in de nieuwe werkversie als er al een afsplitsing is gemaakt).
+
<ol style="margin-left: 20px" type = i><li>Open de 'Publicaties en groepen' module en voeg in het 'Groepen' tabblad de nieuwe bouwstenen toe aan een groep naar keuze.(<code>ZibExtraction> Beheer>Publicaties en groepen</code>[[File:page.png|link=GroupRelease]])</li>
:Sommige fouten zijn schijnfouten zoals een id fout bij een bouwsteen verwijzing met een subconcept.
+
<li>Voeg in het 'Releases' tabblad de nieuwe bouwstenen toe aan de nieuwe publicatie.</li>
:Beoordeel ook de waarschuwingen en de informatie mededelingen.
+
<li>Ga hierna verder zoals hieronder in aangegeven.</li></ol></li>
*Check of van de gewijzigde zibs ook een (aangepast) voorbeeld bestand met de juiste versie aanwezig is in de voorbeeldbestand folder van de publicatie.
+
<li>Stel de inhoud van de (pre)release vast of wijzig de bestaande prerelease om de van gewijzigde bouwstenen de juiste versie op te nemen. Check de versies. (<code>ZibExtraction> Beheer>Publicaties en groepen | tabblad Releases</code>[[File:page.png|link=GroupRelease]]).</li>
*Start ZibExtraction en maak een nieuwe (pre)release aan of wijzig de prerelease omschrijving bij een tweede of latere prerelease (de juiste inhoud komt later, na de registratie van de bouwstenen: volgende stap)<br>(<code>ZibExtraction> Beheer>Publicaties en groepen | tabblad Releases</code>[[File:page.png|link=GroupRelease]])
+
<li>Open een van de .eap/qea(x)  bestanden in ZibExtration en maak eventueel de nieuwe configuraties aan (<code>ZibExtraction> Configuraties</code>[[File:page.png|link=ZibExtraction_Config]]).</li>
*Registeer eerst alle bouwstenen van de publicatie  incl. basis en subbouwstenen (<code>ZibExtraction, actie “Registreer Zib’s”</code>[[File:page.png|link=ZibExtraction_UI]]).
+
<li>Registreer voor alle bouwstenen de referenties (<code>ZibExtraction, actie “Registreer referenties”</code>[[File:page.png|link=ZibExtraction_UI]]).<br>
:Indien de zibs uit meer dan één bestand komen, dient dit voor al deze bestanden gedaan te worden. De volgorde maak niet uit.
+
Doe dit voor alle eap/qea(x) . bestanden van de (pre)release.
*Indien de (pre)publicatie volledig nieuwe bouwstenen bevat, dienen een paar extra stappen gedaan te worden:
+
</li></ol>
**Open de 'Publicaties en groepen' module en voeg in het 'Groepen' tabblad de nieuwe bouwstenen toe aan een groep naar keuze.(<code>ZibExtraction> Beheer>Publicaties en groepen</code>[[File:page.png|link=GroupRelease]])
+
  [[Bestand:Warning-icon.png]] Als na dit punt een extra zib aan de publicatie wordt toe gevoegd of een versie van één van de bouwstenen wordt gewijzigd, moeten de laatste vijf stappen opnieuw doorlopen worden. De stap "Registeer referenties" moet dan uitgevoerd worden met optie "Forceer herregistratie" aangevinkt.
**Voeg in het 'Releases' tabblad de nieuwe bouwstenen toe aan de nieuwe publicatie.
 
**Ga hierna verder zoals hieronder in aangegeven.
 
*Stel de inhoud van de (pre)release vast of wijzig de bestaande prerelease om de van gewijzigde bouwstenen de juiste versie op te nemen. Check de versies.<br>Doe dit aan de hand van de release notes. (<code>ZibExtraction> Beheer>Publicaties en groepen | tabblad Releases</code>[[File:page.png|link=GroupRelease]]).
 
*Open een van de .eap bestanden in ZibExtration en maak eventueel de nieuwe configuraties aan (<code>ZibExtraction> Configuraties</code>[[File:page.png|link=ZibExtraction_Config]]).
 
*Registreer voor alle bouwstenen de referenties (<code>ZibExtraction, actie “Registreer referenties”</code>[[File:page.png|link=ZibExtraction_UI]]).  
 
:Doe dit voor alle eap. bestanden van de (pre)release.
 
  [[Bestand:Warning-icon.png]] Als na dit punt een extra zib aan de publicatie wordt toe gevoegd of een versie van één van de bouwstenen wordt gewijzigd, moeten de laatste vijf stappen opnieuw doorlopen worden.<br>
 
De stap "Registeer referenties" moet dan uitgevoerd worden met optie "Forceer herregistratie" aangevinkt.
 
  
 
==Voorbereiden Wiki==
 
==Voorbereiden Wiki==
 
  [[Bestand:Warning-icon.png]] Voor het aanmaken en wijzigen van wiki pagina's moet je ingelogd zijn.
 
  [[Bestand:Warning-icon.png]] Voor het aanmaken en wijzigen van wiki pagina's moet je ingelogd zijn.
*Maak voor een nieuwe release (of eerste prerelease) een nieuwe release startpagina aan of pas deze aan bij een tweede of hogere prerelease.
+
<ol style="margin-left: 25px">
:Doe dit doe de vorige te kopiëren naar een nieuwe pagina met de juiste naam. (''ZIB_Publicatie_<jaartal>(NL)'')
+
<li>Maak voor een nieuwe release (of eerste prerelease) een nieuwe release startpagina aan of pas deze aan bij een tweede of hogere prerelease.<br>
:Wijzig, waar relevant, ‘release’ in ‘prerelease' of omgekeerd (ook in de pagina naam alias) en wijzig eventueel het jaartal in de namen.  
+
Doe dit doe de vorige te kopiëren naar een nieuwe pagina met de juiste naam. (''ZIB_Publicatie_<jaartal>(NL)'') als volgt:
:Wijzig ook de link naar de release notes en de links naar de downloads.
+
<ol style="margin-left: 20px" type=i>
*Check de pagina op correcte informatie en voeg evt publicatie specifiek informatie toe onder het kopje ‘Overige punten’.
+
<li>Ga naar de te kopiëren pagina, selecteer het wiki tabblad 'Bewerken' en kopieer de gehele wiki tekst van de pagina.</li>
: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.  
+
<li>Type in de adresbalk van de browser het adres <wikisite>/wiki/<naam van de nieuwe pagina>, <wikisite> is voor produktie bv. zibs.nl, <naam van de nieuwe pagina> is de naam zoals hierboven beschreven.<\li>
:Indien dit verandert, moet het in de configuratie aangepast worden. <code>ZibExtraction > Configuratie: Groepsbox Wiki, veld ‘TOC Sectie#’</code>[[File:page.png|link=ZibExtraction_Config]]
+
<li>Een nieuwe wiki pagina wordt geopend met de mededeling dat deze niet bestaat. Selecteer het wiki tabblad 'Bewerken' en plak de gekopieerde tekst er in.</li>
*Herhaal bovenstaande stappen voor de Engelse startpagina (''HCIM_Release_<jaartal>(EN)'').
+
<li>Wijzig, waar relevant, ‘release’ in ‘prerelease' of omgekeerd (ook in de pagina naam alias) en wijzig eventueel het jaartal in de namen.</li>
*Pas op de [[ZIB_Hoofdpagina#Publicaties | ZIB hoofdpagina, sectie Publicaties]] de opsomming van publicaties aan, om de nieuwe publicatie op te nemen.
+
<li>Wijzig ook de link naar de release notes en de links naar de downloads.Voorlopig worden dit dode links omdat die bestanden nog niet aanwezig zijn.</li>
*Herhaal dit voor de [[HCIM_Mainpage#Releases | Engelse hoofdpagina]].
+
</ol>
 +
</li>
 +
<li>Check de pagina op correcte informatie en voeg evt publicatie specifiek informatie toe onder het kopje ‘Overige punten’.<br>
 +
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.<br>
 +
Indien dit verandert, moet het in de configuratie aangepast worden. <code>ZibExtraction > Configuratie: Groepsbox Wiki, veld ‘TOC Sectie#’</code>[[File:page.png|link=ZibExtraction_Config]]
 +
</li>
 +
<li>Herhaal bovenstaande stappen voor de Engelse startpagina (''HCIM_Release_<jaartal>(EN)'').</li>
 +
<li>Pas op de [[ZIB_Hoofdpagina#Publicaties | ZIB hoofdpagina, sectie Publicaties]] de opsomming van publicaties aan, om de nieuwe publicatie op te nemen.</li>
 +
<li>Herhaal dit voor de [[HCIM_Mainpage#Releases | Engelse hoofdpagina]].</li>
 +
</ol>
  
 
==Aanmaken wikipagina's en overige zib bestanden==
 
==Aanmaken wikipagina's en overige zib bestanden==
Regel 57: Regel 77:
  
 
Voor het aanmaken van de bestanden moeten de volgende stappen gedaan worden:
 
Voor het aanmaken van de bestanden moeten de volgende stappen gedaan worden:
*Start ZibExtraction en open met het <code>File > Open</code> menu de gewenste .eap file.
+
<ol style="margin-left: 25px">
*Het configuratiekeuze window zal verschijnen waarin de gewenste configuratie gekozen kan worden.
+
<li>Start ZibExtraction en open met het <code>File > Open</code> menu de gewenste .eap/qea(x)  file.</li>
:Indien de gekozen configuratie in strijd is met de .eap publicatie tags, zal een foutmelding volgen en informatie over het vervolg.
+
<li>Het configuratiekeuze window zal verschijnen waarin de gewenste configuratie gekozen kan worden.<br>
*Controleer, als het bestand geopend is, in de <code>ZibExtraction > groupbox Instellingen </code> of de volgende velden de gewenste waarde hebben:
+
Indien de gekozen configuratie in strijd is met de .eap/qea(x)  publicatie tags, zal een foutmelding volgen en informatie over het vervolg.
**RTF template
+
</li>
**Voorbeeldfolder
+
<li>Controleer, als het bestand geopend is, in de <code>ZibExtraction > groupbox Instellingen </code> of de volgende velden de gewenste waarde hebben:
**Publicatie
+
<ol style="margin-left: 20px" type=i><li>RTF template</li>
**Publicatietaal
+
<li>Voorbeeldfolder</li>
**Wiki
+
<li>Publicatie</li>
:Indien de waarden niet juist zijn kunnen deze in het configuratie scherm gewijzigd worden. <code>ZibExtraction > Configuratie.</code>[[File:page.png|link=ZibExtraction_Config]]
+
<li>Publicatietaal</li>
:Blijkt uit de waarden dat de verkeerde standaardconfiguratie gekozen is, dient de .eap file gesloten en opnieuw geopend te worden om de correcte configuratie te kiezen.
+
<li>Wiki</li></ol>
:Een andere standaardconfiguratie kiezen terwijl de .eap fileopen is, is helaas niet mogelijk, omdat een aantal waarden uit de .eap file gehaald worden.
+
Indien de waarden niet juist zijn kunnen deze in het configuratie scherm gewijzigd worden. <code>ZibExtraction > Configuratie.</code>[[File:page.png|link=ZibExtraction_Config]]<br>
*Selecteer batch bewerkingen (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)
+
De gewenste taal zal sowieso in het configuratiescherm gekozen moeten worden.
*Selecteer de volgende bewerkingen (<code>ZibExtraction > groupbox Gewenste actie</code>)
+
Blijkt uit de waarden dat de verkeerde standaardconfiguratie gekozen is, dient de .eap/qea(x)  file gesloten en opnieuw geopend te worden om de correcte configuratie te kiezen.<br>
**XMI en XML waardelijsten
+
Check met name op de locatie van de voorbeeldbestanden staan juist is.<br>
**Eéntalig maken
+
Selecteer tenslotte het sjabloon voor de PDF bestanden. Let op dat het sjabloon voor de gekozen taal geselecteerd is.<br>
**Wiki pagina's aanmaken
+
Een andere standaardconfiguratie kiezen terwijl de .eap/qea(x) file open is, is helaas niet mogelijk, omdat een aantal waarden uit de .eap/qea(x)  file gehaald worden.
**PDF/DOCX bestanden maken
+
</li>
**XLS pagina's aanmaken
+
<li>Selecteer batch bewerkingen (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)</li>
**Inhoudsopgave maken
+
<li>Selecteer de volgende bewerkingen (<code>ZibExtraction > groupbox Gewenste actie</code>)
*Selecteer eventueel gewenste opties (<code>ZibExtraction > groupbox Opties</code>)
+
<ol style="margin-left: 20px" type=i><li>XMI en XML waardelijsten</li>
*Indien de aangemaakte pagina's bewaard gaan worden voor hergebruik, moet dit aangegeven worden (<code>ZibExtraction > groupbox Resultaten > checkbox Bewaren</code>)
+
<li>Eéntalig maken</li>
:Hierna zal automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
+
<li>Wiki pagina's aanmaken</li>
*Druk tenslotte op Uitvoeren om de bewerkingen te starten.
+
<li>PDF/DOCX bestanden maken</li>
 +
<li>XLS pagina's aanmaken</li>
 +
<li>Inhoudsopgave maken</li></ol></li>
 +
<li>Selecteer eventueel gewenste opties (<code>ZibExtraction > groupbox Opties</code>)</li>
 +
<li>Indien de aangemaakte pagina's bewaard gaan worden voor hergebruik, moet dit aangegeven worden (<code>ZibExtraction > groupbox Resultaten > checkbox Bewaren</code>)<br>
 +
Hierna zal automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
 +
</li>
 +
<li>Druk tenslotte op Uitvoeren om de bewerkingen te starten.</li>
 +
</ol>
 
<br>
 
<br>
Indien de .eap file behalve zibs ook sub-zibs en basis elementen zibs bevat, moeten bovenstaande stappen hiervoor herhaald worden<br>
+
Indien de .eap/qea(x)  file behalve zibs ook sub-zibs en basis elementen zibs bevat, moeten bovenstaande stappen hiervoor herhaald worden<br>
 
Hiervoor moet in de configuratie de zib prefix gewijzigd worden van ''nl.zorg'' in ''nl.zorg.part''. Ook kan de file opnieuw geopend worden met een speciaal hiervoor gemaakte standaard configuratie. <br>
 
Hiervoor moet in de configuratie de zib prefix gewijzigd worden van ''nl.zorg'' in ''nl.zorg.part''. Ook kan de file opnieuw geopend worden met een speciaal hiervoor gemaakte standaard configuratie. <br>
 
<br>
 
<br>
Voer bovenstaande stappen uit voor alle .eap files die zibs bevatten van de publicatie.<br>
+
Voer bovenstaande stappen uit voor alle .eap/qea(x) files die zibs bevatten van de publicatie.<br>
 
<br>
 
<br>
 
De stappen moeten zowel voor de NL als voor de EN wiki pagina's uitgevoerd worden. Als de stappen voor één taal uitgevoerd zijn, kan dit niet in dezelfde sessie ook voor de ander taal gedaan worden.<br>
 
De stappen moeten zowel voor de NL als voor de EN wiki pagina's uitgevoerd worden. Als de stappen voor één taal uitgevoerd zijn, kan dit niet in dezelfde sessie ook voor de ander taal gedaan worden.<br>
Hiervoor moet de .eap file eerst gesloten worden en eventueel met een andere configuatie geopend te worden.
+
Hiervoor moet de .eap/qea(x)  file eerst gesloten worden en eventueel met een andere configuatie geopend te worden.
 
{|
 
{|
 
|rowspan = 2 valign="top" | [[Bestand:Warning-icon.png]]
 
|rowspan = 2 valign="top" | [[Bestand:Warning-icon.png]]
 
|De XMI en XML bestanden zijn meertalig en hoeven maar één keer aangemaakt te worden. Wel moet dit gebeuren voordat de zibs ééntalig zijn gemaakt.
 
|De XMI en XML bestanden zijn meertalig en hoeven maar één keer aangemaakt te worden. Wel moet dit gebeuren voordat de zibs ééntalig zijn gemaakt.
 
|-
 
|-
|Als de volgorde van bewerkingen wordt gedaan zoal hierboven aangegeven is, gaat het goed en hoeft voor de Engelse versie de XML/XMI actie neit aan gevinkt te worden.
+
|Als de volgorde van bewerkingen wordt gedaan zoal hierboven aangegeven is, gaat het goed en hoeft voor de Engelse versie de XML/XMI actie niet aan gevinkt te worden.
 
|}
 
|}
  
 
==Laden wikipagina's en overige zib bestanden na generatie==
 
==Laden wikipagina's en overige zib bestanden na generatie==
 
Voor het laden van de bestanden naar de wiki site moeten de volgende stappen uitgevoerd worden:
 
Voor het laden van de bestanden naar de wiki site moeten de volgende stappen uitgevoerd worden:
*Deselecteer 'Batch acties' (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)
+
<ol style="margin-left: 25px">
*Selecteer de bewerking 'Wiki pagina' uploaden' (<code>ZibExtraction > groupbox Gewenste actie</code>)
+
<li>Deselecteer 'Batch acties' (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)</li>
*Deselecteer, indien nodig, 'Bewaren'  
+
<li>Selecteer de bewerking 'Wiki pagina' uploaden' (<code>ZibExtraction > groupbox Gewenste actie</code>)</li>
*Als het de laatste (of enige) upload is van de publicatie in de gekozen taal, vink dan de optie 'Refresh Wiki pagina's' aan.
+
<li>Deselecteer, indien nodig, 'Bewaren'</li>
*Druk op 'Uitvoeren' om de upload te starten.
+
<li>Als het de laatste (of enige) upload is van de publicatie in de gekozen taal, vink dan de optie 'Refresh Wiki pagina's' aan.</li>
 +
<li>Druk op 'Uitvoeren' om de upload te starten.</li>
 +
</ol>
  
 
==Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden==
 
==Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden==
 
Voor het laden van de bestanden naar de wiki site moeten in dit geval de volgende stappen uitgevoerd worden:
 
Voor het laden van de bestanden naar de wiki site moeten in dit geval de volgende stappen uitgevoerd worden:
*Deselecteer 'Batch acties' (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)
+
<ol style="margin-left: 25px">
*Selecteer de bewerking 'Wiki pagina' uploaden' (<code>ZibExtraction > groupbox Gewenste actie</code>)
+
<li>Deselecteer 'Batch acties' (<code>ZibExtration > groupbox Uitvoeren > checkbox Batch acties</code>)</li>
*Selecteer 'Hergebruiken'  
+
<li>Selecteer de bewerking 'Wiki pagina' uploaden' (<code>ZibExtraction > groupbox Gewenste actie</code>)</li>
:Controleer of de locatie, waar de bestanden staan, geselecteerd is en pas deze evtueel aan.  
+
<li>Selecteer 'Hergebruiken'<br>
:Als de locatie leeg is, wordt automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
+
Controleer of de locatie, waar de bestanden staan, geselecteerd is en pas deze evtueel aan.<br>
*Vink de optie 'Refresh Wiki pagina's' aan.
+
Als de locatie leeg is, wordt automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
*Druk op 'Uitvoeren' om de upload te starten.
+
</li>
 +
<li>Vink de optie 'Refresh Wiki pagina's' aan.</li>
 +
<li>Druk op 'Uitvoeren' om de upload te starten.</li>
 +
</ol>
 +
 
 
==Afrondende acties==
 
==Afrondende acties==
 +
<span style="font-variant: small-caps;"><li>Release Notes</li></span>
 +
Maak de release notes aan. (<code>ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > Release Document > Uitvoerkeuzes > Release notes </code>[[File:page.png|link=GroupRelease]]).<br>
 +
Kies wel de gewenste (pre-)publicatie(s). De release notes worden in het Nederlands en Engels aangemaakt.
 +
<span style="font-variant: small-caps;"><li>Code systemen</li></span>
 +
Maak nieuwe publicatie items aan voor de zib 'eigen' codestelsels en upload deze.(<code>ZibExtraction> Beheer > Zib Codestelsel beheer > Akties > Publiceer codestelsels</code>)
 +
<span style="font-variant: small-caps;"><li>Uitgegeven zib Id's</li></span>
 +
Als de publicatie nieuwe zibs bevat, moet ook het overzicht van uitgegeven zib id's vernieuwd worden. (<code>ZibExtraction> Beheer > Zib Id beheer > Akties > Export wiki pagina</code>)<br>
 +
Deze en de vorige bullet resulteren in een upload omgeving die met de ZibExtraction applicatie ge-upload kan worden.([[ZibExtraction#Upload |zie Tips en Tricks]])<br>
 +
Dit kan gecombineerd worden met de upload van de bestanden uit het volgende punt.
 +
<span style="font-variant: small-caps;"><li>Wiki</li></span>
 
Als alle bestanden gecontroleerd zijn, kunnen de zip bestanden, die vanaf de release startpagina te downloaden zijn, aangemaakt worden.
 
Als alle bestanden gecontroleerd zijn, kunnen de zip bestanden, die vanaf de release startpagina te downloaden zijn, aangemaakt worden.
Hiertoe wordt de inhoud van de volgende subfolders van de doelfolder op de bruikelijke wijze gezipt:
+
Hiertoe wordt de inhoud van de volgende subfolders van de doelfolder op de gebruikelijke wijze gezipt:
*xls: naam bestand: ZIBS<release>(XLSX).zip  voor de Nederlandse en HCIM<release>(XLSX).zip voor de Engelse.
+
<ol style="margin-left: 25px">
*zrtf: naam bestand: ZIBS<release>(PDF).zip  voor de Nederlandse en HCIM<release>(PDF).zip voor de Engelse.
+
<li>xls: naam bestand: ZIBS<release>(XLSX).zip  voor de Nederlandse en HCIM<release>(XLSX).zip voor de Engelse.</li>
*xml: naam bestand: ZIBS<release>(XMI).zip  (de xmi.xml bestanden zijn meertalig)
+
<li>zrtf: naam bestand: ZIBS<release>(PDF).zip  voor de Nederlandse en HCIM<release>(PDF).zip voor de Engelse.</li>
<br>
+
<li>xml: naam bestand: ZIBS<release>(XMI).zip  (de xmi.xml bestanden zijn meertalig)</li>
 +
</ol>
 
Tenslotte moeten bovenstaande drie bestanden en de release notes in PDF vorm (naam: Publicatieversie_<release>_-_Zorginformatiebouwstenen.pdf) geupload worden.<br>
 
Tenslotte moeten bovenstaande drie bestanden en de release notes in PDF vorm (naam: Publicatieversie_<release>_-_Zorginformatiebouwstenen.pdf) geupload worden.<br>
 
Dit kan met de standaard wiki functionaliteit gedaan worden of met de ZibExtraction applicatie ([[ZibExtraction#Upload |zie Tips en Tricks]])
 
Dit kan met de standaard wiki functionaliteit gedaan worden of met de ZibExtraction applicatie ([[ZibExtraction#Upload |zie Tips en Tricks]])
Regel 125: Regel 170:
 
Als alles nogmaals gecontroleerd is, kan de publicatie zichtbaar gemaakt worden voor de gebruikers.
 
Als alles nogmaals gecontroleerd is, kan de publicatie zichtbaar gemaakt worden voor de gebruikers.
 
Hiertoe moeten nog drie wijzigingen worden doorgevoerd:  
 
Hiertoe moeten nog drie wijzigingen worden doorgevoerd:  
*Pas op de hoofdpagina de verwijzing naar ''Huidige (pre)publicatie'' en ''Current (pre)release''.
+
<ol style="margin-left: 25px" start=4>
*voeg de nieuwe (pre)publicatie op de ZIB hoofdpagina (''[[ZIB_Hoofdpagina]]'' en ''[[HCIM_Mainpage]]'') aan de sectie 'Publicaties' cq. 'Releases' toe.  
+
<li>Pas op de hoofdpagina de verwijzing naar ''Huidige (pre)publicatie'' en ''Current (pre)release''.</li>
*Pas in het menu (''[[MediaWiki:Sidebar]]'') de verwijzing naar ''Huidige (pre)publicatie'' en ''Current (pre)release'' aan, zodat naar de nieuwe (pre)publicatie verwezen wordt.
+
<li>Voeg de nieuwe (pre)publicatie op de ZIB hoofdpagina (''[[ZIB_Hoofdpagina]]'' en ''[[HCIM_Mainpage]]'') aan de sectie 'Publicaties' cq. 'Releases' toe.</li>
 +
<li>Pas in het menu (''[[MediaWiki:Sidebar]]'') de verwijzing naar ''Huidige (pre)publicatie'' en ''Current (pre)release'' aan, zodat naar de nieuwe (pre)publicatie verwezen wordt.</li>
 +
</ol>
 +
<span style="font-variant: small-caps;"><li>Nieuwe werkbestanden</li></span>
 +
Indien de publicatie geen pre-publicatie betreft maar een publicatie moeten in de nieuwe werkversies alle [Deprecated] codes uit de betreffende waardenlijsten verwijderd worden.<br>
 +
Een overzicht de deze codes is aan te maken vanuit ZibExtraction. (<code>ZibExtraction> Beheer> CodeCheck optie 'Overige code reports'</code><[[File:page.png|link=ZibCodeCheck]])
 +
<span style="font-variant: small-caps;"><li>Publicatie bestanden</li></span>
 +
Zet de eap/qea(x) bestanden (met standaard window functionaliteit) op readonly, om abusievelijk wijzigen te voorkomen
 +
<span style="font-variant: small-caps;"><li>Bestand met Zib namen</li></span>
 +
Maak een nieuw bestand aan met de zib namen van de nieuwe publicatie. (<code>ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > XML Zib Lijst</code>[[File:page.png|link=GroupRelease]]).<br>
 +
Dit bestand wordt gebruikt in de EA Add-in om verwijzen naar andere zibs mogelijk te maken. Verzend dit bestand aan alle gebruikers van de add-in ter vervanging van het huidige bestand. (<code>Standaard locatie: ..\Documents\Nictiz</code>).
  
 
==[https://zibs.test-nictiz.nl/wiki  Test wiki] en [[hoofdpagina | produktie wiki]]==
 
==[https://zibs.test-nictiz.nl/wiki  Test wiki] en [[hoofdpagina | 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.<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.
+
Het op de produktie omgeving zetten van de nieuwe (pre-)publicatie kan op twee manieren:
* genereren wiki pagina's en overige zib bestanden.
+
<ol style="margin-left: 25px" type = A>
* aanmaken release startpagina's
+
<li>Het opnieuw genereren van de pagina's en bestanden, maar nu voor de produktie wiki.<br>
* wijzigen ZIB hoodfpagina's
+
Hiertoe moeten de stappen vanaf [[#Voorbereiden Wiki | Voorbereiden Wiki]] opnieuw doorlopen worden, maar nu in paragraaf [[#Aanmaken wikipagina's en overige zib bestanden | Aanmaken wikipagina's en overige zib bestanden]], stap 3 met de produktie omgeving als wiki.
* wijzigen menu
+
</li>
* laden van de nieuwe pagina's en zib bestanden
+
<li>Door hergebruik van de producten die voor de testomgeving gemaakt zijn en bewaard zijn.<br>
* laden Release Notes
+
Om dit te doen moeten de acties uit de volgende paragrafen uitgevoerd te worden:
* laden zip bestanden
+
<ol style="margin-left: 20px" type = i>
 
+
<li>[[#Voorbereiden Wiki | Voorbereiden Wiki]]<br>
Voor de gegenereerde pagina's biedt ZibExtraction de mogelijkheid deze bij het aanmaken voor de testomgeving te bewaren. <code>ZibExtraction > Groepbox Resultaten > checkbox Bewaren</code><br>
+
Hierbij kan de wikitekst van de overeenkomstige pagina's op de test wiki site als bron gebruikt worden
Deze kunnen op een later tijdstip, na controle, hergebruikt worden om in de produktie omgeving te laden.<code>ZibExtraction > Groepbox Resultaten > checkbox Wiki Pagina's laden en checkbox Hergebruiken</code>
+
</li>
 
+
<li>[[#Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden | Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden]]</li>
Het kopieren van de startpagina's kan eenvoudig als volgt bereikt worden:
+
<li>[[#Afrondende acties | Afrondende acties]]</li>
*kopieer in de 'Bewerken' status van de pagina de wiki tekst  en plak deze in Notepad in een nieuw bestand.
+
</ol>
*sla het bestand op en geef het de naam ''ZIB_Publicatie_<jaartal>(NL).wiki'' resp. ''HCIM_Release_<jaartal>(EN).wiki''.
+
</li>
*ga naar de folder waar de gegenereerde bestanden bewaard zijn, open de subfolder WikiPages en plaats de bestanden daarin.
+
</ol>
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 [[ZibExtraction#Voorbereiden Wiki | Voorbereiden Wiki]] moeten opnieuw gedaan worden voor de produktie wiki.
 
 
==Tips en Tricks==
 
==Tips en Tricks==
 
===Upload===
 
===Upload===
 
Het upload deel van ZibExtraction is vrij generiek en daar kan 'misbruik' van gemaakt worden.<br>
 
Het upload deel van ZibExtraction is vrij generiek en daar kan 'misbruik' van gemaakt worden.<br>
 
Als resultaten van een zib extractie bewaard worden, wordt een subfolderstructuur aangemaakt onder de doelfolder.
 
Als resultaten van een zib extractie bewaard worden, wordt een subfolderstructuur aangemaakt onder de doelfolder.
Deze kent de volgende subfolders:<br>
+
Deze upload omgeving kent de volgende subfolders:<br>
 
[[Bestand:Subfolders.png]]
 
[[Bestand:Subfolders.png]]
  
Regel 170: Regel 223:
 
Als bij een upload de refresh optie vergeten is, kan het voorkomen dat de wikipagina's schijnbaar dode links hebben, bij voorbeeld worden dan plaatjes en transclude pagina's niet getoond.<br>
 
Als bij een upload de refresh optie vergeten is, kan het voorkomen dat de wikipagina's schijnbaar dode links hebben, bij voorbeeld worden dan plaatjes en transclude pagina's niet getoond.<br>
 
Dit is te herstellen zonder alles opnieuw te laden. Doe hiervoor de volgende stappen:
 
Dit is te herstellen zonder alles opnieuw te laden. Doe hiervoor de volgende stappen:
*Sluit een eventueel openstaand .eap bestand en open het opnieuw: er wordt nu een nieuwe sessie gestart.
+
<ol style="margin-left: 25px">
*Controleer of de correcte publicatie gekozen is in de gewenste taal
+
<li>Sluit een eventueel openstaand .eap/qea(x)  bestand en open het opnieuw: er wordt nu een nieuwe sessie gestart.</li>
*Selecteer een willekeurige zib
+
<li>Controleer of de correcte publicatie gekozen is in de gewenste taal</li>
*Deselecteer, indien nodig, de checkbox 'Batch acties'
+
<li>Selecteer een willekeurige zib</li>
*Selecteer de actie 'Wiki pagina's uploaden'
+
<li>Deselecteer, indien nodig, de checkbox 'Batch acties'</li>
*Vink nu wel de optie 'Refresh Wiki pagina's' aan
+
<li>Selecteer de actie 'Wiki pagina's uploaden'</li>
*Controleer dat de checkboxen 'Bewaren' en 'Hergebruiken' niet aangevinkt zijn
+
<li>Vink nu wel de optie 'Refresh Wiki pagina's' aan</li>
*Druk op 'Uitvoeren'
+
<li>Controleer dat de checkboxen 'Bewaren' en 'Hergebruiken' niet aangevinkt zijn</li>
 +
<li>Druk op 'Uitvoeren'</li>
 +
</ol>
 
De applicatie gaat nu proberen alle bestanden te uploaden (aantal is nul) en zal daarna alle pagina's van de publicatie in de gekozen taal refreshen (= purgen).<br>
 
De applicatie gaat nu proberen alle bestanden te uploaden (aantal is nul) en zal daarna alle pagina's van de publicatie in de gekozen taal refreshen (= purgen).<br>
 
Herhaal dit indien nodig ook voor de andere taal.
 
Herhaal dit indien nodig ook voor de andere taal.

Huidige versie van 17 okt 2023 om 15:41


Manual pagina's

Voorbereiden publicatie

  1. Open de eap/qea(x) files die de zib's van de publicatie bevatten en check of er geen zibs meer gelocked zijn. Als deze er zijn, unlock deze dan. Hiervoor moet je als admin de EA file openen.
  2. Maak een nieuw leeg EA project aan, naam format: (V)ZIBS P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>), dus b.v. ZIBS Publicatieversie 2017 of ZIBS Prepublicatieversie 2017-1.
  3. Maak een lokale kopie van de server (EA > Settings > Transfer > Full porject transfer via connection) met optie: DBMS to File (Source database: DBType=1;Connect=Provider=MSOLEDBSQL19.1;Persist Security Info=False;User ID=wouter.zanen@nictiz.nl;Initial Catalog=enterprisearchitect;Data Source=zibs.database.windows.net;Initial File Name="";Use Encryption for Data=Strict;Server SPN="";Authentication=ActiveDirectoryInteractive;Access Token="";Host Name In Certificate="";Server Certificate=""). Target project is het zojuist aangemaakte lege EA project. (We doen dit omdat acties direct op de server uitvoeren nu nog te traag is.)
  4. Lock nu alle zibs op de server tot dat de publicatie volledig gereed is
  5. Vervolg actie op de lokale kopie doen !
  6. Maak op grond van de behandelde issues een lijst van de gewijzigde zibs. Deze kan automatisch uit Bits gegenereerd worden vanuit ZibExtraction. (ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > Release Document > Uitvoerkeuzes > Losse lijst Page.png). Kies wel de gewenste (pre-)publicatie(s).
  7. Start ZibExtraction en check alle SNOMED CT en LOINC codes of er geen foute of verlopen codes in de set zibs aanwezig zijn. (ZibExtraction> Beheer> CodeCheck<Page.png)
    Check ook de codes uit de 'eigen' zib codestelsels op foute of verlopen codes. Dit kan ook met ZibCodeCheck met Kies codesystem > Overige code reports.
    Dit levert ook rapportages over deprecated codes op die je later nodig hebt.
  8. Test in EA met de de add-in iedere zib op fouten. (EA plugin voor zibslink = ZibTools)
    Iedere melding in het opmerkingen veld komt overeen met een fout, waarschuwing of mededeling.
    Beoordeel en verbeter eventueel de fouten.
    Sommige fouten zijn schijnfouten zoals een id fout bij een bouwsteen verwijzing met een subconcept.
    Beoordeel ook de waarschuwingen en de informatie mededelingen.
  9. Check of van de gewijzigde zibs ook een (aangepast) voorbeeld bestand met de juiste versie aanwezig is in de voorbeeldbestand folder van de publicatie.
    Dit wordt in de test automatisch gedaan. Indien geen voorbeeldfile met de correcte versie gevonden wordt, zal dit als een warning aangegeven worden.
  10. Zet in Enterprise Architect de publicatietag's van alle zibs (alle eap/qea(x) files, alle subset’s: subzibs, basiszib etc.) (EA plugin voor zibslink = ZibTools)
    Check hierbij in het Zib Report scherm of de revision history datum van alle gewijzigde zibs uit de hierboven aangemaakte lijst aangepast wordt, zo niet check dit handmatig.
  11. Maak een kopie van de eap/qea(x) files die de zib's van de publicatie bevatten en hernoem deze tot de werkversie van de volgende (pre)release, format (V)ZIBS Werkversie <jaartal>-<prepublicatie volgnummer>, dus b.v. VZIBS Werkversie 2019-1.
  12. Warning-icon.png Vanaf dit punt mogen er geen wijzigingen meer uitgevoerd worden op de eap/qea(x) files van de nieuwe publicatie!
    
  13. Open de nieuwe eap/qea(x) (werk)files stuk voor stuk in Enterprise Architect en pas de HCIM tags op DCM Repository niveau aan, t.w. de tags HCIM::ReleaseYear, HCIM::ReleaseType en HCIM::PrereleaseNumber.
  14. Warning-icon.png Als een prerelease tot release wordt gepromoveerd, moeten de eap/qea(x)  bestandsnamen en de bovengenoemde HCIM tags aangepast worden!
    
  15. Maak in de centrale folder van het zib-centrum met publicaties een nieuwe folder aan met als naam de naam van de publicatie: P(rep)ublicatieversie <jaartal>(-<prepublicatie volgnummer>).
  16. Verplaats de eap/qea(x) files van de publicatie naar deze folder.
  17. Kopieer tevens voor iedere eap/qea(x) file de folder met bijbehorende voorbeeldbestanden van de werkfolder naar de nieuwe publicatie folder.
  18. Indien de nieuwe werkversie een nieuw publicatiejaar heeft moeten de namen van de folders met voorbeeldbestanden in de werkfolder gewijzigd worden, bv VZIBS_Examples_2020.
  19. Warning-icon.png Iedere publicatie heeft zijn eigen set voorbeeldbestanden. In de naam van de voorbeeldfolder is het prepublicatienummer niet opgenomen. Overigens is de naam niet kritisch omdat de voorbeeldfolder tijdens het publicatieproces geselecteerd moet worden.
    
  20. Reset in Enterprise Architect voor de eap/qea(x) files van de nieuwe werkversie de publicatietag's van alle zibs (alle eap/qea(x) ’s, alle subset’s: subzibs, basiszib etc.) (EA plugin voor zibslink = ZibTools)

De volgende acties worden uitgevoerd op de eap/qea(x) files van de nieuwe publicatie, en dus niet op de eap/qea(x) files van de werkversie.

  1. Zet in de eap/qea(x) files van de nieuwe publicatie het gebruikersbeheer uit ( EA Settings > Administer > Enable Security). Hiervoor moet je als admin de EA file openen. Tevens heb je de autorisatie sleutel nodig.
  2. Start ZibExtraction en maak een nieuwe (pre)release aan of wijzig de prerelease omschrijving bij een tweede of latere prerelease (de juiste inhoud komt later, na de registratie van de bouwstenen: volgende stap)
    (ZibExtraction> Beheer>Publicaties en groepen | tabblad ReleasesPage.png)
  3. Registeer eerst alle bouwstenen van de publicatie incl. basis en subbouwstenen (ZibExtraction, actie “Registreer Zib’s”Page.png).
    Indien de zibs uit meer dan één bestand komen, dient dit voor al deze bestanden gedaan te worden. De volgorde maak niet uit.
  4. Indien de (pre)publicatie volledig nieuwe bouwstenen bevat, dienen een paar extra stappen gedaan te worden:
    1. Open de 'Publicaties en groepen' module en voeg in het 'Groepen' tabblad de nieuwe bouwstenen toe aan een groep naar keuze.(ZibExtraction> Beheer>Publicaties en groepenPage.png)
    2. Voeg in het 'Releases' tabblad de nieuwe bouwstenen toe aan de nieuwe publicatie.
    3. Ga hierna verder zoals hieronder in aangegeven.
  5. Stel de inhoud van de (pre)release vast of wijzig de bestaande prerelease om de van gewijzigde bouwstenen de juiste versie op te nemen. Check de versies. (ZibExtraction> Beheer>Publicaties en groepen | tabblad ReleasesPage.png).
  6. Open een van de .eap/qea(x) bestanden in ZibExtration en maak eventueel de nieuwe configuraties aan (ZibExtraction> ConfiguratiesPage.png).
  7. Registreer voor alle bouwstenen de referenties (ZibExtraction, actie “Registreer referenties”Page.png).
    Doe dit voor alle eap/qea(x) . bestanden van de (pre)release.
Warning-icon.png Als na dit punt een extra zib aan de publicatie wordt toe gevoegd of een versie van één van de bouwstenen wordt gewijzigd, moeten de laatste vijf stappen opnieuw doorlopen worden. De stap "Registeer referenties" moet dan uitgevoerd worden met optie "Forceer herregistratie" aangevinkt.

Voorbereiden Wiki

Warning-icon.png Voor het aanmaken en wijzigen van wiki pagina's moet je ingelogd zijn.
  1. 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)) als volgt:
    1. Ga naar de te kopiëren pagina, selecteer het wiki tabblad 'Bewerken' en kopieer de gehele wiki tekst van de pagina.
    2. Type in de adresbalk van de browser het adres <wikisite>/wiki/<naam van de nieuwe pagina>, <wikisite> is voor produktie bv. zibs.nl, <naam van de nieuwe pagina> is de naam zoals hierboven beschreven.<\li>
    3. Een nieuwe wiki pagina wordt geopend met de mededeling dat deze niet bestaat. Selecteer het wiki tabblad 'Bewerken' en plak de gekopieerde tekst er in.
    4. Wijzig, waar relevant, ‘release’ in ‘prerelease' of omgekeerd (ook in de pagina naam alias) en wijzig eventueel het jaartal in de namen.
    5. Wijzig ook de link naar de release notes en de links naar de downloads.Voorlopig worden dit dode links omdat die bestanden nog niet aanwezig zijn.
  2. 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#’Page.png
  3. Herhaal bovenstaande stappen voor de Engelse startpagina (HCIM_Release_<jaartal>(EN)).
  4. Pas op de ZIB hoofdpagina, sectie Publicaties de opsomming van publicaties aan, om de nieuwe publicatie op te nemen.
  5. Herhaal dit voor de Engelse hoofdpagina.

Aanmaken wikipagina's en overige zib bestanden

In deze beschrijving wordt er vanuit gegaan dat alle stappen van een hele publicatie in een keer gedaan worden.
Dit is niet perse noodzakelijk. De stappen kunnen ook in opeenvolgende sessies gedaan worden.

Voor het aanmaken van de bestanden moeten de volgende stappen gedaan worden:

  1. Start ZibExtraction en open met het File > Open menu de gewenste .eap/qea(x) file.
  2. Het configuratiekeuze window zal verschijnen waarin de gewenste configuratie gekozen kan worden.
    Indien de gekozen configuratie in strijd is met de .eap/qea(x) publicatie tags, zal een foutmelding volgen en informatie over het vervolg.
  3. Controleer, als het bestand geopend is, in de ZibExtraction > groupbox Instellingen of de volgende velden de gewenste waarde hebben:
    1. RTF template
    2. Voorbeeldfolder
    3. Publicatie
    4. Publicatietaal
    5. Wiki

    Indien de waarden niet juist zijn kunnen deze in het configuratie scherm gewijzigd worden. ZibExtraction > Configuratie.Page.png
    De gewenste taal zal sowieso in het configuratiescherm gekozen moeten worden. Blijkt uit de waarden dat de verkeerde standaardconfiguratie gekozen is, dient de .eap/qea(x) file gesloten en opnieuw geopend te worden om de correcte configuratie te kiezen.
    Check met name op de locatie van de voorbeeldbestanden staan juist is.
    Selecteer tenslotte het sjabloon voor de PDF bestanden. Let op dat het sjabloon voor de gekozen taal geselecteerd is.
    Een andere standaardconfiguratie kiezen terwijl de .eap/qea(x) file open is, is helaas niet mogelijk, omdat een aantal waarden uit de .eap/qea(x) file gehaald worden.

  4. Selecteer batch bewerkingen (ZibExtration > groupbox Uitvoeren > checkbox Batch acties)
  5. Selecteer de volgende bewerkingen (ZibExtraction > groupbox Gewenste actie)
    1. XMI en XML waardelijsten
    2. Eéntalig maken
    3. Wiki pagina's aanmaken
    4. PDF/DOCX bestanden maken
    5. XLS pagina's aanmaken
    6. Inhoudsopgave maken
  6. Selecteer eventueel gewenste opties (ZibExtraction > groupbox Opties)
  7. Indien de aangemaakte pagina's bewaard gaan worden voor hergebruik, moet dit aangegeven worden (ZibExtraction > groupbox Resultaten > checkbox Bewaren)
    Hierna zal automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
  8. Druk tenslotte op Uitvoeren om de bewerkingen te starten.


Indien de .eap/qea(x) file behalve zibs ook sub-zibs en basis elementen zibs bevat, moeten bovenstaande stappen hiervoor herhaald worden
Hiervoor moet in de configuratie de zib prefix gewijzigd worden van nl.zorg in nl.zorg.part. Ook kan de file opnieuw geopend worden met een speciaal hiervoor gemaakte standaard configuratie.

Voer bovenstaande stappen uit voor alle .eap/qea(x) files die zibs bevatten van de publicatie.

De stappen moeten zowel voor de NL als voor de EN wiki pagina's uitgevoerd worden. Als de stappen voor één taal uitgevoerd zijn, kan dit niet in dezelfde sessie ook voor de ander taal gedaan worden.
Hiervoor moet de .eap/qea(x) file eerst gesloten worden en eventueel met een andere configuatie geopend te worden.

Warning-icon.png De XMI en XML bestanden zijn meertalig en hoeven maar één keer aangemaakt te worden. Wel moet dit gebeuren voordat de zibs ééntalig zijn gemaakt.
Als de volgorde van bewerkingen wordt gedaan zoal hierboven aangegeven is, gaat het goed en hoeft voor de Engelse versie de XML/XMI actie niet aan gevinkt te worden.

Laden wikipagina's en overige zib bestanden na generatie

Voor het laden van de bestanden naar de wiki site moeten de volgende stappen uitgevoerd worden:

  1. Deselecteer 'Batch acties' (ZibExtration > groupbox Uitvoeren > checkbox Batch acties)
  2. Selecteer de bewerking 'Wiki pagina' uploaden' (ZibExtraction > groupbox Gewenste actie)
  3. Deselecteer, indien nodig, 'Bewaren'
  4. Als het de laatste (of enige) upload is van de publicatie in de gekozen taal, vink dan de optie 'Refresh Wiki pagina's' aan.
  5. Druk op 'Uitvoeren' om de upload te starten.

Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden

Voor het laden van de bestanden naar de wiki site moeten in dit geval de volgende stappen uitgevoerd worden:

  1. Deselecteer 'Batch acties' (ZibExtration > groupbox Uitvoeren > checkbox Batch acties)
  2. Selecteer de bewerking 'Wiki pagina' uploaden' (ZibExtraction > groupbox Gewenste actie)
  3. Selecteer 'Hergebruiken'
    Controleer of de locatie, waar de bestanden staan, geselecteerd is en pas deze evtueel aan.
    Als de locatie leeg is, wordt automatisch een folderdialoog venster geopend worden om een doelfolder te selecteren.
  4. Vink de optie 'Refresh Wiki pagina's' aan.
  5. Druk op 'Uitvoeren' om de upload te starten.

Afrondende acties

  • Release Notes
  • Maak de release notes aan. (ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > Release Document > Uitvoerkeuzes > Release notes Page.png).
    Kies wel de gewenste (pre-)publicatie(s). De release notes worden in het Nederlands en Engels aangemaakt.

  • Code systemen
  • Maak nieuwe publicatie items aan voor de zib 'eigen' codestelsels en upload deze.(ZibExtraction> Beheer > Zib Codestelsel beheer > Akties > Publiceer codestelsels)

  • Uitgegeven zib Id's
  • Als de publicatie nieuwe zibs bevat, moet ook het overzicht van uitgegeven zib id's vernieuwd worden. (ZibExtraction> Beheer > Zib Id beheer > Akties > Export wiki pagina)
    Deze en de vorige bullet resulteren in een upload omgeving die met de ZibExtraction applicatie ge-upload kan worden.(zie Tips en Tricks)
    Dit kan gecombineerd worden met de upload van de bestanden uit het volgende punt.

  • Wiki
  • Als alle bestanden gecontroleerd zijn, kunnen de zip bestanden, die vanaf de release startpagina te downloaden zijn, aangemaakt worden. Hiertoe wordt de inhoud van de volgende subfolders van de doelfolder op de gebruikelijke wijze gezipt:

    1. xls: naam bestand: ZIBS<release>(XLSX).zip voor de Nederlandse en HCIM<release>(XLSX).zip voor de Engelse.
    2. zrtf: naam bestand: ZIBS<release>(PDF).zip voor de Nederlandse en HCIM<release>(PDF).zip voor de Engelse.
    3. xml: naam bestand: ZIBS<release>(XMI).zip (de xmi.xml bestanden zijn meertalig)

    Tenslotte moeten bovenstaande drie bestanden en de release notes in PDF vorm (naam: Publicatieversie_<release>_-_Zorginformatiebouwstenen.pdf) geupload worden.
    Dit kan met de standaard wiki functionaliteit gedaan worden of met de ZibExtraction applicatie (zie Tips en Tricks)

    N.B. Het release veld is voor publicaties <jaartal>, bij voorbeeld 2018, en voor prepublicaties <jaartal>-<prepublicatie volgnummer>, bij voorbeeld 2018-2.
    

    Als alles nogmaals gecontroleerd is, kan de publicatie zichtbaar gemaakt worden voor de gebruikers. Hiertoe moeten nog drie wijzigingen worden doorgevoerd:

    1. Pas op de hoofdpagina de verwijzing naar Huidige (pre)publicatie en Current (pre)release.
    2. Voeg de nieuwe (pre)publicatie op de ZIB hoofdpagina (ZIB_Hoofdpagina en HCIM_Mainpage) aan de sectie 'Publicaties' cq. 'Releases' toe.
    3. Pas in het menu (MediaWiki:Sidebar) de verwijzing naar Huidige (pre)publicatie en Current (pre)release aan, zodat naar de nieuwe (pre)publicatie verwezen wordt.
  • Nieuwe werkbestanden
  • Indien de publicatie geen pre-publicatie betreft maar een publicatie moeten in de nieuwe werkversies alle [Deprecated] codes uit de betreffende waardenlijsten verwijderd worden.
    Een overzicht de deze codes is aan te maken vanuit ZibExtraction. (ZibExtraction> Beheer> CodeCheck optie 'Overige code reports'<Page.png)

  • Publicatie bestanden
  • Zet de eap/qea(x) bestanden (met standaard window functionaliteit) op readonly, om abusievelijk wijzigen te voorkomen

  • Bestand met Zib namen
  • Maak een nieuw bestand aan met de zib namen van de nieuwe publicatie. (ZibExtraction> Beheer > Publicaties en groepen | tabblad Releases > Exporteren > XML Zib LijstPage.png).
    Dit bestand wordt gebruikt in de EA Add-in om verwijzen naar andere zibs mogelijk te maken. Verzend dit bestand aan alle gebruikers van de add-in ter vervanging van het huidige bestand. (Standaard locatie: ..\Documents\Nictiz).

    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.
    Het op de produktie omgeving zetten van de nieuwe (pre-)publicatie kan op twee manieren:

    1. Het opnieuw genereren van de pagina's en bestanden, maar nu voor de produktie wiki.
      Hiertoe moeten de stappen vanaf Voorbereiden Wiki opnieuw doorlopen worden, maar nu in paragraaf Aanmaken wikipagina's en overige zib bestanden, stap 3 met de produktie omgeving als wiki.
    2. Door hergebruik van de producten die voor de testomgeving gemaakt zijn en bewaard zijn.
      Om dit te doen moeten de acties uit de volgende paragrafen uitgevoerd te worden:
      1. Voorbereiden Wiki
        Hierbij kan de wikitekst van de overeenkomstige pagina's op de test wiki site als bron gebruikt worden
      2. Laden wikipagina's en overige zib bestanden bij hergebruik van bewaarde bestanden
      3. Afrondende acties

    Tips en Tricks

    Upload

    Het upload deel van ZibExtraction is vrij generiek en daar kan 'misbruik' van gemaakt worden.
    Als resultaten van een zib extractie bewaard worden, wordt een subfolderstructuur aangemaakt onder de doelfolder. Deze upload omgeving kent de volgende subfolders:
    Subfolders.png

    Deze structuur kan natuurlijk ook met de hand aangemaakt worden. Hiermee kunnen ook andere dan de gegenereerde bestanden geupload worden:

    • Wikipagina's
    Maak de pagina in Notepad aan of kopieer de wiki tekst vanuit een bestaande pagina, bv. van een ander server.
    Sla het bestand op in de WikiPages subfolder geef het de naam <WikipaginaNaam>.wiki.
    • PDF bestanden.
    Sla het bestand op de zrtf subfolder
    • Alle andere uploadbare bestanden incl zip bestanden
    Sla het bestand op de xls subfolder

    Bij de volgende upload zullen al deze bestanden worden meegenomen.

    Vergeten refresh

    Als bij een upload de refresh optie vergeten is, kan het voorkomen dat de wikipagina's schijnbaar dode links hebben, bij voorbeeld worden dan plaatjes en transclude pagina's niet getoond.
    Dit is te herstellen zonder alles opnieuw te laden. Doe hiervoor de volgende stappen:

    1. Sluit een eventueel openstaand .eap/qea(x) bestand en open het opnieuw: er wordt nu een nieuwe sessie gestart.
    2. Controleer of de correcte publicatie gekozen is in de gewenste taal
    3. Selecteer een willekeurige zib
    4. Deselecteer, indien nodig, de checkbox 'Batch acties'
    5. Selecteer de actie 'Wiki pagina's uploaden'
    6. Vink nu wel de optie 'Refresh Wiki pagina's' aan
    7. Controleer dat de checkboxen 'Bewaren' en 'Hergebruiken' niet aangevinkt zijn
    8. Druk op 'Uitvoeren'

    De applicatie gaat nu proberen alle bestanden te uploaden (aantal is nul) en zal daarna alle pagina's van de publicatie in de gekozen taal refreshen (= purgen).
    Herhaal dit indien nodig ook voor de andere taal.