Bestanden: kopieren, bewerken en testen
XSL
Voor het aanpassen van de bonnen is enige xsl-ervaring vereist, maar daarmee is dan ook (bijna) alles wat betreft de bonnen naar je hand te zetten.
Niet elke xsl file mag bewerkt worden
Enkele basis-bestanden kunnen door OCLC worden aangepast. Wanneer hierin gewijzigd wordt, zullen de wijzigingen bij een update door OCLC worden overschreven. Alleen deze bestanden mogen worden bewerkt:
bon_1.xsl / bon_2.xsl / bon_3.xsl / bon_4.xsl / bon_5.xsl / bon_10.xsl / bon_11.xsl / bon_12.xsl / bon_a.xsl / bon_i.xsl / bon_k.xsl / bon_m.xsl / custom_templates.xsl
De bonnen met default.xsl mogen nooit gewijzigd worden.
Bij het opstarten van de client zal Wise op de server checken of er ook bestanden zijn van een meer recente datum. Zoja, dan worden deze nieuwere bestanden gezipt en naar de client gestuurd. Dit gaat geheel automatisch. Bonnen die door een organisatie zijn gewijzigd, zullen niet door bestanden van OCLC Wise worden overschreven.
Om te zorgen dat een bon anders opgemaakt wordt, moet het volgende onder handen worden genomen:
- of de hoofdstylesheet 'bon_1.xsl' – wanneer de wijziging enkel voor deze bon geldt
- of 'custom_templates.xsl' – wanneer de wijziging voor alle bonnen moet gelden
Aanpassingen doe je door templates uit de OCLC Wise files basexslt.xsl, default_templates.xsl, default_texts.xsl te 'overrulen'. Neem je in deze files een template op met dezelfde naam als in basexslt, default_templates of default_texts, dan zal de aangepaste versie gebruikt worden bij het maken van de bon.
Meestal zal een bestaande template gekopieerd worden naar 'custom_templates.xsl', en vervolgens van een andere template-inhoud voorzien. Tevens kun je in de 'custom_templates.xsl' extra templates aanmaken en aanroepen.
Zowel op de server als in de cachemap kunnen bonnen worden gewijzigd (zie Gewijzigde bon testen).
Bestand downloaden
Het bestand waarvan de inhoud gewijzigd moet worden, moet eerst worden gedownload vanuit Bestandsbeheer. Dit doe je als volgt:
- Ga in de Client naar Vestigingsbeheer > Bestandsbeheer
- Open de map resources/rsrc/STYLESHEET_RECEIPT
- Kies in het rechterscherm de stylesheet van de bon die je wil bewerken > rechtermuisklik > Download geselecteerde bestand(en)
Verwerk in het gedownloade bestand de aanpassingen, zodat – als het mis gaat – er altijd nog een origineel is.
Bestand bewerken met een editor
De bestanden zijn te bewerken met een editor, bijv. Wordpad, Kladblok of Notepad++ (rechtermuisklik, kies 'openen met' of kies 'Edit met Notepad++'). Notepad++ werkt met kleuren zodat je goed kunt zien wat je doet. Sla het bestand op met Ctrl+S of klik op de afbeelding van de floppy.
Gewijzigde bon testen
Wanneer op de server een bestand is gewijzigd, zal na elke wijziging de client opdracht gegeven moeten om de cache te wissen (zie Cache wissen). Wanneer je een template aanpast in de cachemap wordt deze direct door de client opgepikt bij de eerstvolgende bon die wordt afgedrukt. Je kunt dus steeds kleine wijzigingen in de stylesheets aanbrengen en vervolgens in de client via Test XML-bonnen (Vestigingbeheer > Test XML-bonnen > toon bon) het resultaat bekijken. De XML-data die daarbij gebruikt wordt is eventueel op te vragen bij OCLC.
Dummy
Een bon kan ook worden getest via de klantenadministratie. Zoek een klant op en laat via Printen klantbon een dummy over het scherm lopen. De dummy moet worden ingesteld via Vestigingsbeheer > Werkplekbeheer > Configuratie > Randapparaten > Bonnenprinter: dummy/debug.
Aangepaste bestand uploaden
Zijn de aanpassingen naar wens? Dan kan de aangepaste stylesheet op de server geplaatst worden.
Dit doe je niet in de rsrc-map, maar in je eigen STYLESHEET_RECEIPT-map in resources. Voeg deze toe door in Bestandsbeheer de map resources te selecteren > rechtermuisklik > Map [STYLESHEET_RECEIPT] aanmaken. Op dezelfde manier kan je vervolgens eventueel een submap maken voor de instantie of vestiging waarmee je ingelogd bent, bijvoorbeeld als de aangepaste bon alleen voor deze vestiging of instantie moet gelden.
Selecteer ten slotte de map waar je het bestand wil plaatsen > rechtermuisklik > Upload bestand.
Let op: bij bonnen moet de gebruikte naam van het aangepaste bestand exact hetzelfde zijn als het origineel. Heb je bijvoorbeeld een aanpassing gedaan aan bon_a? Dan moet het aangepaste bestand ook bon_a.xsl heten.