Zorginformatiebouwstenen: Label editor

---

Korte beschrijving

Om de vaste delen van de zib wikipagina's en spreadsheets in meerdere talen te kunnen genereren, staan deze delen niet als tekst in de ZibExtractie applicatie maar als labels.
Afhankelijk van de gekozen publicatietaal wordt het label vervangen door een stuk tekst in de betreffende taal.
De applicatie LabelEditor maakt het mogelijk deze labels te beheren, wijzigen en om nieuwe labels aan te maken.
De naam van de labels hebben een prefix die een hint geeft waar het label gebruikt wordt. Zo worden de labels de beginnen met xls gebruikt bij de generatie van de spreadsheets.
Om bij gewenste wijzigingen eenvoudig terug te kunnen vinden wat de naam van het betreffende label is, wordt deze, in de wikipagina's, als commentaar achter de labeltekst gezet.
Dit kan zichtbaar gemaakt worden door de brontekst van de wikipagina te bekijken (of de pagina te bewerken).
Voorbeeld:

Algemeen<!--hdGeneralInformation-->

Dit betekent dus dat het label met de naam hdGeneralInformation als (Nederlandse) vulling 'Algemeen' heeft. De labelnaam is in LabelEditor te vinden waarna de Nedelandse of Engelse tekst eventueel aangepast kan worden.
De applicatie kan gestart worden vanuit ZibExtraction of als op zichzelf staande toepassing gestart worden.
N.B. Labels zijn in de applicatie van het datatype 'string'. Dit houdt in dat overal waar een string gebruikt wordt ook een label gebruikt kan worden.
Een voorbeeld hiervan in de c# methode 'String.Format' waarmee variabelen als geformateerde string kunnen worden uitgedrukt.
In de bestaande labels komen deze dan ook voor: van het label ftDownloads is de Nederland tekst

'De bouwsteen is ook beschikbaar als [[Media:{0}|pdf bestand]] [[File:PDF.png|link=]] of als [[Media:{1}|'

Label Editor gebruikersinterface

Het programma LabelEditor kent de volgende besturingselementen:

Figuur 1: LabelEditor gebruikersinterface

1. Menubalk
   Opslaan: Opslaan van de wijzigingen en afsluiten van de applicatie
   Sluiten: Afsluiten van de applicatie. Als er wijzigingen zijn gedaan, wordt gevraagd of deze opgeslagen moeten worden.
   Backup: Heeft één submenu item:
   • Maak backup voor afsluiten: Vinkvak: Indien aangevinkt wordt voor het opslaan van de wijzigingen eerst een backup gemaakt.¹
     
   Help: Heeft twee submenu items:
   • Over: Informatie over de applicatie
     
   • Help pagina: Gebruiksaanwijzing van de applicatie (deze pagina)
2. Alle labels
   De tekstbox toont de namen van alle beschikbare labels.
3. Label informatie
   Behalve de naam van het geselecteerde label worden ook de Nederlandse en Engelse tekst getoond.
   De teksten zijn wijzigbaar, de naam niet.
4. Actieknoppen
   Nieuw: Aanmaken nieuw label
   Wijzigen: Doorvoeren wijzigingen in de tekst van het geselecteerde label.
   Verwijderen: Verwijderen geselecteerde label.
   Annuleren: Wijzigingen niet doorvoeren en huidige tekst herstellen
5. Statusbalk
   Geeft de locatie aan waar de label configuratie file is opgeslagen.

¹ De naam van de backupfile is ZibExtractionLabels_Backup_[yyyyMMddHHmmss].cfg. Het terugzetten van een backup dient handmatig gedaan te worden door de gewenste backup te hernoemen naar ZibExtractionLabels.cfg

Gebruik

Aanmaken nieuw label

Zoek in de ZibExtraction applicatie de naam op van het nieuw aan te maken label of maak een nieuwe naam aan met een betekenisvol prefix.
Druk op de knop 'Nieuw'. Alle invoervelden worden nu leeg gemaakt en de knop 'Wijzigen' krijgt het opschrift 'Toevoegen'.
Voer de naam van het nieuwe label in het veld 'Label'
Voer de Nederlandse en Engelse tekst voor dit label in in het 'NL' resp. 'EN veld.
Beide velden moeten gevuld zijn anders zal dit tot problemen leiden bij het genereren van de wiki en xlsx bestanden
Druk, als de teksten naar tevredenheid ingevoerd zijn, op de knop 'Toevoegen'
Zie ook de opmerking bij afsluiten van de applicatie.

Wijzigen van een label

Zoek in de 'Alle labels' tekstbox het betreffende label en selecteer het.
In de 'Label informtie' velden verschijnt de labelnaam en de Nederlandse en Engelse labeltekst.
Pas de teksten naar behoeve aan.De labelnaam kan niet gewijigd worden.
Mocht dit toch noodzakelijk zijn, dan moet het oude label weggegooid worden en een nieuwe label aangemaakt worden.
Druk, als de teksten naar tevredenheid gewijzigd zijn, op de knop 'Wijzigen'
Zie ook de opmerking bij afsluiten van de applicatie.

Verwijderen van een label

Zoek in de 'Alle labels' tekstbox het betreffende label en selecteer het.
Druk op de knop 'Verwijderen'
Zie ook de opmerking bij afsluiten van de applicatie.

Afsluiten van de applicatie

De applicatie kan gesloten worden met de menu knoppen en op de gebruikelijke Windows manieren (rode kruis, alt F4 etc.)

 De knoppen 'Wijzigen', 'Toevoegen' en 'Verwijderen' wijzigen alleen de labelteksten in het geheugen, niet in het labelconfiguratie bestand.
Daarom moeten na wijzigingen altijd ook nog het menu item 'Opslaan' geselecteerd worden. Hiermee worden de wijzigingen ook in het bestand opgeslagen.

Als er wijzigingen aangebracht zijn en de applicatie op een of andere wijze afgesloten wordt zonder dat de wijzigingen opgeslagen zijn,
wordt een dialoog getoond worden met de vraag of de wijzigingen alsnog opgeslagen moeten worden.

Ontbrekende labels

Mocht in de ZibExtraxtion een label aangeroepen worden dat niet gedefinieerd is, zal dat niet tot een crash leiden. In de wiki pagina of spreadsheet zal op de plek waar het label gebruikt wordt de tekst van het label 'noKey' getoond worden met de naam van het label erachter. Het label kan dan in LabelEditor alsnog aangemaakt worden.

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.	ZibAppsStart.cfg	https://zibs.nl/wiki	Nee
UserConfigLocation	Locatie locaal bestand met configuraties	Voorgeconfigureerde publicatie settings	ZibAppsStart.cfg	C:\Users\[gebruikersnaam]\AppData\Local\Nictiz\ZibExtraction	Nee
CommonConfigLocation	Locatie gedeelde configuratiedata	Acties op het Zib Label bestand	ZibExtraction.cfg	C:\ProgramData\Nictiz\ZibExtraction\Config	Ja

Vaste gegevens

Naam	Beschrijving	Gebruik	Vaste locatie
ZibAppsStart.cfg	Basis configuratie bestand	Bevat opstartconfiguratiedata voor Zib app's	C:\Users\[gebruikersnaam]\AppData\Local\Nictiz\ZibExtraction