VELDNAMEN

AANPASSEN IN
TOPDESK (DEEL 2)
is cordinator informatievoorziening. Hij is gespecialiseerd in
technische vraagstukken en het optimaliseren van processen.
PATRICK MACKAAIJ
In de vorige editie van TOPdesk Magazine ( juni 2014) heb ik laten zien
hoe TOPdesk omgaat met verschillende talen en welke terminologie
standaard aanpasbaar is. In dit artikel laat ik zien hoe u vrijwel alle
terminologie naar uw hand kunt zetten door uw aanpassingen op te
sommen in een door u aan te passen bestand. Indien nodig spitst u
TOPdesk zo verder toe op de terminologie die uw organisatie gebruikt.
20 SLIMMER WERKEN
Fotograe: Robin Kuijs
Technische opbouw van vertalingen:
resourcebestanden
TOPdesk levert voor iedere ondersteunde taal een taalbestand uit.
Ieder taalbestand bevat duizenden regels met daarin een sleutel
(resourcekey) gevolgd door de vertaling (zie afbeelding 1). De
taalbestanden van TOPdesk zijn terug te vinden in de map boot. De
bestanden hebben als naam tasresources_xx.properties waarbij xx
de land- en eventuele taalcode is. Het bestand tasresources.properties
is Engelstalig en tevens de standaard waarop TOPdesk terugvalt als
een webbrowser vraagt om een niet-ondersteunde taal.

De naamgeving van bestanden in dit artikel volgt TOPdesk 5.4. De aanpassingen zijn mogelijk vanaf TOPdesk 4.4.
Maakt u gebruik van TOPdesk SaaS, dan is deze functionaliteit vanaf medio 2015 te gebruiken.
Afb. 1 Deel van een taalbestand
Gebruikt u TOPdesk SaaS?
Dan kunt u de resourcebestanden op de volgende manier downloaden:
1. Open Instellingen > SaaS > Upload/Download bestanden en kies
voor Aangepaste labels.
2. Klik op de knop Download standaard labelbestanden om het
zipbestand Default tasrecources.zip te downloaden.
3. Pak het zipbestand uit.
Veldnamen die u aanpast in TOPdesk via de instellingen zoals
beschreven in het voorgaande artikel komen in de resources terug
tussen dollartekens. Er zijn waarden voor enkel- en meervoud. Zo ziet
u in afbeelding 1 een verwijzing naar het enkelvoud van budgethouder
als $<budgetholder_singular>$.
Een resourcekey kan verwijzen naar een andere resourcekey door
de naam tussen procenttekens aan te roepen. Een voorbeeld in
afbeelding 1 is %tas.reference.caller%. U kunt de oorspronkelijke
resourcekey snel vinden door te zoeken op de naam zonder
procenttekens gevolgd door een =-teken.
In verwijzingen naar aangepaste namen of andere resourcekeys
kunt u het gebruik van grote en kleine letters benvloeden. Plaats een
plus- of minteken direct achter het dollar- of procentteken. Eventueel
in combinatie met een sterretje om het hele woord om te zetten. Voor
het aanpassen van kapitalen gebruikt u de volgende tekens:
+ = eerste letter hoofdletter
+* = hele woord hoofdletters
- = eerste kleine letter
-* = hele woord kleine letters
Speciale tekens zoals letters met accenten, de ringel-s, of c-cedille
moet u vervangen door unicode. In plaats van kopiren noteert u
kopi\u00EBren. Via www.unicode-table.com zoekt u eenvoudig naar
de unicode voor in dit geval de . Deze noteert u vervolgens als
\u00EB. Controleer de uiteindelijke weergave van deze woorden goed;
bij fouten laat TOPdesk een vraagteken of vierkantje zien.
Het is van belang dat u de resourcebestanden in de map boot van
TOPdesk zelf intact laat. Dit garandeert een goede werking van TOPdesk.
Bovendien overschrijft TOPdesk deze bestanden met iedere update.
Terminologie-aanpassingen inventariseren en
bestanden klaarzetten
Als u zelf aan de slag wilt gaan met het aanpassen van veldnamen,
inventariseer dan eerst aan de hand van de TOPdesk-interface de door u
gewenste aanpassingen in een tekstbestand met de naam readme.txt
voor zowel de SelfServiceDesk als het behandelaarsgedeelte. U
gebruikt deze lijst om straks de aanpassingen stuk voor stuk door te
voeren in uw eigen bestand(en). En uzelf of een collega heeft deze
uitleg in de toekomst nodig bij het updaten naar een nieuwe versie
van TOPdesk. Dit doet u als volgt:
1. Maak een tekstbestand aan en noteer de datum, naam en TOPdesk-
versie en geef onder dit kopje alle aanpassingen aan die u door wilt
voeren. Bijvoorbeeld:
15-04-2014 Patrick Mackaaij voor TOPdesk 5.5
Personeelsnummer > BSN
2. Voer vervolgens deze wijzigingen door op een eigen kopie van de
benodigde resourcebestanden op een andere locatie.
3. Verzamel de resourcebestanden in een map met de naam boot.
Terminologie aanpassen op eigen risico
Het aanpassen van resourcebestanden valt buiten de
standaardinstellingen van TOPdesk en valt daarom
niet onder uw onderhoudscontract. De aangepaste
velden vereisen bij iedere TOPdesk-update een
controle en mogelijk een aanpassing. In plaats
van zelf de terminologie aan te passen, kunt u een
opdrachtbevestiging aanvragen voor uitbesteding aan
TOPdesk Consultancy of TOPdesk Support.
SLIMMER WERKEN 21
Colofon
TOPdesk Magazine downloaden?
Ga naar www.scribd.com/topdesk
TOPdesk Magazine, ht
servicemanagement-platform van
Nederland, behandelt onderwerpen die
spelen in de wereld van professionele
servicedesken bij IT-, facilitaire, HR- en
overige dienstverlenende organisaties.
TOPdesk Magazine is bedoeld voor
managers, servicedeskmedewerkers,
facilitaire medewerkers, gemeenteloket-
medewerkers en iedereen die in de
dagelijkse praktijk te maken heeft met het
ondersteunen van klanten. Daarbij gaat
het zowel om de processen als de techniek
achter de dienstverlening.
TOPdesk Magazine is een uitgave van
TOPdesk Nederland BV
Postbus 559, 2600 AN Delft,
+31 (0)15 270 09 00, info@topdesk.nl
Hoofdredactie: Milou Snaterse
Redactionele medewerkers: Stefanie
Klaassen, Milou Snaterse
Aan dit nummer werkten mee: Leah
Clarke, Ron van Haasteren, Lukke Joustra,
Kasper van der Leeden, Patrick Mackaaij,
Anne van der Veen
Vormgeving: Louise van der Laak
Fotograe: Menno van der Bijl, Aad
Hoogendoorn, Robin Kuijs
Illustratie: Deborah van der Schaaf
Eindredactie: Brenda Heeringa
Adverteren? In TOPdesk Magazine is
ruimte voor advertenties en advertorials.
Meer informatie: redactie@topdesk.nl
Oplage: 7.500 exemplaren
Verschijningsfrequentie: 4 x per jaar
Talen: Nederlands, Engels
Resourcekeys opzoeken in de TOPdesk-interface via Volapk
De namen van de sleutels (resourcekeys) kunt u via de interface van TOPdesk opzoeken. TOPdesk
laat in plaats van veldnamen de resourcekeys zien als u de taalinstelling van de webbrowser
verandert naar vo (Volapk). Als u deze taal niet ziet staan, dan kunt u deze landcode
eenvoudig aan Internet Explorer en Firefox toevoegen via de taalinstelling van de webbrowser:
Internet Explorer: Extra > Internetopties > Talen.
Firefox: Options > Options > Content en kies voor Choose... in het vak Languages.
Helaas ontbreekt Volapk in Google Chrome en is het lastig om deze taal toe te voegen. Daarbij
vervalt de instelling als u de instellingen van Google Chrome synchroniseert. Daarom leg ik het
toevoegen van Volapk aan Google Chrome niet uit.
Loop de aanpassingen die u eerder inventariseerde stuk voor stuk door en voeg ze toe aan uw
eigen resourcebestand(en).
Zipbestand maken en inlezen
Het bestand dat u heeft aangepast dient u te zippen, de naam mag u zelf bepalen. Voeg het
zipbestand via de Administrator Web Console toe aan uw TOPdesk-acceptatieomgeving.
Klik op de knop Forceer en vervolgens op TOPdesk herstarten om de wijzigingen in uw
acceptatieomgeving door te voeren. Als de aanpassingen naar wens zijn, herhaalt u deze stap
voor uw productieomgeving.
Gebruikt u TOPdesk SaaS?
Dan kunt u de resourcebestanden naar TOPdesk uploaden via Instellingen > SaaS > Upload/
Download bestanden en daarna kiezen voor Aangepaste labels. TOPdesk controleert bij het
uploaden of het zipbestand uit alleen resourcebestanden bestaat. TOPdesk herstart uw SaaS-
omgeving op vrijdag, buiten kantoortijden. Wilt u direct herstarten? Neem dan contact op met
TOPdesk Support.
Herstellen testomgeving wanneer fouten optreden
Het kan voorkomen dat TOPdesk bij het starten een foutmelding geeft nadat de nieuwe
veldnamen ingeladen zijn. Waarschijnlijk is er dan een typefout gemaakt in het bestand
resources.properties, of heeft een bestand of map niet de juiste naam.
In dit geval moet TOPdesk worden gestopt en moeten de door u aangepaste bestanden
worden verwijderd. Dit kunt u doen door een back-up van de installatiemap terug te plaatsen,
of door de door u aangepaste bestanden te verwijderen, inclusief het bestand installed.yaml
uit de map bespoke-work.
Onderhoud bij servicepacks en updates
Het aanpassen van resourcebestanden heeft onderhoud nodig. Controleer bij iedere TOPdesk-
update of servicepack of de resources die u heeft aangepast nog onder die naam bestaan.
U kunt hiervoor de door u aangepaste resourcekeys opzoeken in het corresponderende
tasresources_xx.properties-bestand. Of u kunt de resourcebestanden van de door u gebruikte
versie van TOPdesk in uw productieomgeving vergelijken met die van de update van TOPdesk in
uw acceptatieomgeving met een tool als ExamDiff. Zo vindt u ook eventuele nieuwe resources
die gebruikmaken van de eerder door u aangepaste terminologie. Controleer, ook als er niets
gewijzigd lijkt, het zipbestand altijd eerst even in de acceptatieomgeving.
22 SLIMMER WERKEN