ZibTools

Manual pagina's

• Enterprise Architect plug-in voor zib's
• Publicatie van zibs
• ZibExtraction user interface
• Configuratie user interface
• Controleren SNOMED CT en LOINC codes
• Beheer wikipage labels
• Beheer publicaties en groepen

Korte beschrijving

Enterprise Architect biedt de mogelijkheid om functionaliteit aan de applicatie toe te voegen door middel van add-in's.

Voor de zib's is een add-in gemaakt die de uitvoering een aantal handelingen en testen die gedaan moeten worden om tot een succesvolle publicatie te komen, vereenvoudigen.
Allereerst kunnen de zib's op een groot aantal punten getest worden of zij voldoen aan de afspraken die over de zib's gemaakt zijn.
Deze eisen varieren van modelleringsafspraken tot afspraken ten behoeve van de import in ART-DECOR. De eisen zijn in detail beschreven in de documentatie.
Daarnaast kunnen van één zib of een set zib's de publicatie tags geset en gereset worden en kunnen de datumvelden gewist worden (wat handmatig niet mogelijk is).
Tenslotte biedt de add-in de mogelijkheid om eenvoudig een nieuwe versie aan te maken ten behoeve van het verwerken van issues.

Om ook het maken en wijzigen van zib's te vereenvoudigen, biedt de add-in ondersteuning voor het maken en aanpassen van elementen, waardelijsten, connectors en boundaries, door middel van custom invoerdialogen

Enterprise Architect Zib Add-in gebruikersinterface

De Enterprise Architect Zib Add-in bestaat functioneel uit twee delen, tw. een uitbreiding van het menu en de eigenlijke testmodule.

Menu

Bij de installatie van de EA zib add-in worden de volgende menu items toegevoegd:

	Figuur 1: Enterprise Architect hoofdmenu (versie 12)

	Figuur 2: Enterprise Architect hoofdmenu (versie 14)

1. Menu item Zib
   Na installatie van de add-in wordt het Extensions (v.12)/Specialize(v.14) menu uitgebreid met het menu item 'Zib'
2. Submenu
   Het submenu kent vijf items:

   Tools: Hiermee wordt het zibtest scherm geopend in de EA add-in window.

   Als dit item uitgegrijsd is, wordt het eap bestand niet als Zib container beschouwd.

   Meestal betekent dit dat de tag HCIM::ZIBRepository ontbreekt of is false.

   Bilingual notes: Open een tweetalig editorscherm.

   Als dit item uitgegrijsd is, is geen item met tweetalige notes.

   Configure tools: Opent het configuratiescherm van de add-in.

   Help: Gebruiksaanwijzing van de add-in(deze pagina)

   About: Informatie over de add-in

3. Add-in Windows
   Mocht het add-in window niet verschijnen kan het met dit menu item getoond worden.

Add-in window

De EA Zib Add-in kent de volgende besturingselementen:

	Figuur 3: Enterprise Architect add-in window

1. Test Zib
   Start de test cyclus voor de zib.
   De eisen waar de zib op getest wordt, staan beschreven in de documentiepagina's.
   De resultaten worden in het add-in window weergeven.
2. Publish
   Wijzigt de publicatie tags van de zib. Voordat dat kan gebeuren, moeten eerst de twee volgende items op de juiste waarde gezet worden.
   De volgende tags worden aangepast:
   • DCM::PublicationDate : Publicatiedatum
   • DCM::PublicatieStatus: Published/Prepublished
   • DCM::LifecycleStatus : Final
3. Publicatie datum
   Datumdialoog om de gewenste publicatiedatum in te stellen.
4. Pre(publicatie)
   Dropdown list met de opties publicatie en prepublicatie.
5. Reset Tags
   Reset de publicatie tags van de zib.
   De volgende tags worden aangepast:
   • DCM::PublicationDate : leeg
   • DCM::PublicatieStatus: Unpublished
   • DCM::LifecycleStatus : Draft
6. Clear Tags
   Reset de publicatie tags zoal beschreven bij 'Reset tags' en wist bovendien de DCM::CreationDate en DCM::RevisionDate tags..
7. Voorbeeld waarschuwing
   Tijdens de test kunnen fouten (rood), waarschuwingen (oranje) en informatieve mededelingen (groen) verschijnen.
   Allen gaan vergezeld met mededeling in het opmerkingen veld.
   Hier wordt een voorbeeld van een waarschuwing getoond.
8. Samenvatting testresultaat
   De test besluit met een overzicht van het aantal geconstateerde afwijkingen.
9. New Version
   Faciliteert het maken van een nieuwe versie van een zib. Het gebruik van de knop roept een keuze scherm op met de mogelijke nieuwe versienummers.
   Na het kiezen van de nieuwe versie, worden alle vermeldingen van het versienummer aangepast.
   Indien het vinkvak 'Modify Example Filename' wordt geselecteerd, zal op de aangegeven locatie gezocht worden naar de example file en wordt de naam aangepast, de inhoud natuurlijk niet.
   Als geen locatie ingegeven is, wordt een folder selectiedialoog gestart.
   Als de examplefile locatie gevuld is, zal bij het testen van een zib ook gecontroleerd worden of de voorbeeld file de juiste versie heeft.
10. Notes Editor
    Opent een tweetalig editorscherm.

Gebruik

Om de add-inn te kunnen gebruiken moet eerst via het Extensions cq. Specialize menu Zib > Tools gekozen worden.

Test zib

De knop wordt pas actief als er een enkele zib geselecteerd wordt.
Na het indrukken van de knop zal de test gestart worden. De geteste punten worden per testsectie in tabelvorm weergegeven.
Bij geconstateerde afwijkingen zal de afwijkende waarde in kleur weergegeven worden en zal in de kolom 'Opmerkingen' additionale informatie getoond worden. De kleurcodering voor de afwijkingen is:

• rood: een foutconditie die opgelost moet worden voordat de zib gepubliceerd kan worden.
• oranje: een waarschuwing. De test constateert een afwijking maar kan niet vaststellen of het om een fout gaat of niet.

Voorbeeld is het ontbreken van een publicatiedatum: voor een test tijdens de ontwikkeling van de zib is dat een juiste conditie, maar bij een finale test voor de publicatie een fout.
Waarschuwingen moeten altijd beoordeeld worden op impact en noodzaak tot verbetering.

• groen: informatieve mededeling: een afwijking die geen actie vereist.

Als de test een afwijking constateert die de test zelf kan oplossen zal dit als informatie getoond worden.

Iedere mededeling in de kolom 'Opmerkingen' wijst op een geconstateerde afwijking. Idealiter verloopt de test zonder opmerkingen.
Aan het einde van de test wordt een overzicht getoond van het totaal aantal fouten, waarschuwingen en informatieve mededeingen.

Publish

De actie is beschikbaar voor enkele zib's en voor een folder met zib's.
Selecteer met behulp van de datumdialoog de publicatiedatum en geef met de dropdown list aan of om een publicatie gaat of om een prepublicatie
Als in de eap file de tag HCIM::ReleaseType bestaat, zal deze waarde als preset worden gebruikt. Druk vervolgens op de knop 'Publish'. De plugin voor iedere geselecteerde zib de publicatie tags op de gekozen waarden zetten.<br. Bovendien wordt in iedere zib in de sectie 'Revison History' gezocht naar de sjabloon tekst nn-nn-nnnn en wordt dit sjabloon vervangen door de publicatiedatum

Reset

De actie is beschikbaar voor enkele zib's en voor een folder met zib's.
Een druk op de knop zal voor de geselecteerde zib's de publicatie datum wissen en de publicatiestatus velden resetten.
Deze actie is nodig als de eap met een gepubliceerde set zib's gekopieerd wordt om als werkversie voor de volgende (pre)publicaite te dienen.

Clear

De actie is beschikbaar voor enkele zib's en voor een folder met zib's.
Een druk op deze knop doet hetzelfde als Reset maar wist bovendien de DCM::RevisionDate en de DCM::CreationDate tag.
Dit is handig als een bestaande zib gebruikt wordt als basis voor een nieuwe zib.

 De gewiste datumvelden kunnen niet meer hersteld worden. Wees dus voorzichtig met deze functie.

Tweetalige teksteditor

Voor het aanmaken en wijzigen van tweetalige notes velden is een tweetalige editor beschikbaar.

		Figuur 4: Tweetalige teksteditor

1. Nederlands tekstveld
   
2. Engels tekstveld
   Datumdialoog om de gewenste publicatiedatum in te stellen.
3. Vertaalrichting
   Datumdialoog om de gewenste publicatiedatum in te stellen.
4. Google vertaalservice
   Datumdialoog om de gewenste publicatiedatum in te stellen.
5. Google vertaalwebpagina
   Datumdialoog om de gewenste publicatiedatum in te stellen.
6. Afsluiten of opslaan
   Datumdialoog om de gewenste publicatiedatum in te stellen.

Configuratie van de add-in

Een aantal aspecten van de werking van de add-in zijn configureerbaar.

		Figuur 5: Configuratiescherm van de add-in

1. Publicatie Informatie
   Zib categorie: wordt niet meer gebruikt.
   Publicatienaam: dropdownlist met alle publicaties die met Groep en publicatiebeheer zijn aangemaakt.
   Release info: publicatie omschrijving. Wordt automatisch gevuld met de Nederlandstalige informatie uit Groep en publicatiebeheer. Readonly.
   Zib prefix: volledige prefix van de bouwstenen die in ZibExtraction geselecteerd worden, bijvoorbeeld nl.zorg of nl.zorg.part
   Publicatietaal: Taal waarin de publicatie produkten aangemaakt worden.
2. Bestandslocaties
   Voorbeeldbestanden: Locatie van de bronbestanden van de voorbeelden uit sectie Example Instances van bouwsteen.
   Afbeeldingen: Locatie van een aantal afbeeldingen die in de spreadsheet uitvoer worden gebruikt.
   Configuratie: Locatie van het groep en publicatie definitie bestand en de label definitiebestand.
   De overige velden geven de locaties van de uitvoer van ZibExtraction aan voor de verschillende types uitvoer. Getoonde loccaties zijn de default locaties, die automatisch aangemaakt worden als de velden leeg zijn.
3. Bits gegevens
   Velden met informatie die nodig is om de issue beschrijvingen uit Bits op te halen.
   URL Jira API: URL voor het aanspreken dan de API van de Bits applicatie
   Gebruiker: Bits gebruikersnaam ten behoeve van de inloggen via de API van Bits Wachtwoord: Bijbehorend wachtwoord. Het wachtwoord wordt nooit getoond. Het kan wel ingevoerd worden.
   Issue prefix:Prefix bvan de issues in bits die betrekking hebben op de bouwstenen.
   Statussen: Bits statussen waarvan de issue informatie opgehaald wordt. De statussen moeten exact overeenkomen met de benamingen in Bits.
   
4. Wikisite gegevens
   Velden met informatie die nodig is om de wikipagina's te kunnen maken en om de bestanden te kunnen uploaden naar de wikiserver.
   URL Wiki API: URL voor het aanspreken dan de API van de Wiki server. Hiermee kan gekozen worden voor de test of de produktie server
   Gebruiker: Bits gebruikersnaam ten behoeve van de inloggen via de API van de wiki server.
   Wachtwoord: Bijbehorend wachtwoord. Het wachtwoord wordt nooit getoond. Het kan wel ingevoerd worden.
   AD repository: ART DECOR repository waar de wiki pagina's naar verwijzen. ReadOnly. Wordt gevuld met informatie uit het publicatiebeheer.
   
5. Enterprise Architect RTF template gegevens
   Sjabloon: Dropdownlist met alle RTF templates die de geopende .eap file bevat. Hieruit moet een template gekozen worden die overeenkomt met de gekozen publicatietaal. De template wordt gebruikt bij het generereren van de PDF output.
   
6. Additionele wikipagina gegevens
   Hoofdpagina: Naam van het (meertalige) label dat de link bevat naar publicatie startpagina.
   TOC sectie#: Nummer van de sectie van de publicatie startpagina waarin de opsomming van de in de publicatie opgenomen bouwstenen zich bevindt. Indien de indeling van de startpagina gewijzigd wordt, kan dit evt. aangepast worden.
   Legenda: Naam van het (meertalige) label dat de link bevat naar de legenda pagina.
7. Nieuwe configuratie
   Bewaar als nieuwe configuratie: Als het vinkvak aangevinkt wordt, kan in het 'Configuratienaam' veld een naam voor de nieuwe configuratie ingevuld worden.
   Als daarna op 'OK' wordt gedrukt zal de huidige setting opgeslagen worden onder de nieuwe naam. Indien de naam al in gebruik is, volgt een foutmelding en de gelegenheid om een andere naam te kiezen.
   Bij het opslaan zal de oorspronkelijke configuratie niet gewijzigd worden. De nieuwe configuratie kan daarna gekozen worden bij het openen van een eap bestand.
8. Actie knoppen
   OK: Ingevoerde wijzigingen opslaan en scherm sluiten
   Annuleren: Scherm sluiten en eventuele wijzigingen negeren.
   
9. Statusbalk
   Geeft de locatie aan waar de configuratie file is opgeslagen.

Known issues

- Doordat in het verleden in een aantal zib's de legenda op foutieve wijze gekopieerd is hebben deze zib's feitelijk geen eigen legenda maar een verwijzing naar de legenda van een andere zib.
In de presentatie van het informatie model in EA is dit niet te zien, dit is uitsluitend te constateren in de onderliggende database. Het levert dus ook geen problemen op.
Niettemin geeft dit aanleiding tot de informatieve mededeling: 'Gedeelde legenda' en een aantal legenda's van nul in plaats van één.

- In de laatste testsectie wordt getracht vast te stellen of het aantal elementen van de zib in de projectbrowser overeen komt met het aantal in het informatie model diagram.
Om een aantal redenen is deze test nog niet helemaal betrouwbaar en geeft soms aanleiding tot onterechte meldingen.
Niettemin verdient het aanbeveling om bij deze meldingen projectbrowser en het informatie model te checken op losse elementen.
Een bekend probleem ontstaat wanneer een element in het informatie model weggegooid wordt in plaats van in de project browser: het element blijft dan wel onderdeel van de zib maar wordt niet getoond.

- Bij een aantal verwijzigen binnen een zib naar andere zibs wordt binnen de boundary één specifiek element van de andere bouwsteen opgenomen om daar bv. een andere waarde lijst aan te hangen (zie bv nl.zorg.Ademhaling)
Dit element heeft een DCM::ConceptID dat niet bij verwijzende zib past: dit is aanleiding voor een (onterechte) foutmelding.

Configureerbare gegevens

Naam	Beschrijving	Gebruik	Locatie	Huidige waarde	Wijzigbaar via UI
WikiBase	De basis url van deze wiki	Hiermee wordt de url van deze pagina aangemaakt.	Properties.Settings.Default.WikiBase *	https://zibs.nl/wiki	Nee

* De C# applicatie settings worden opgeslagen in het standaard app.config bestand van de applicatie