Resources (via de ResourceServlet)
Resources (via de ResourceServlet)
Resources zijn allerlei bestandjes die de client nodig heeft en die eventueel op het server-systeem overruled kunnen worden op vestigings/instantie/systeem nivo.
Deze resources worden uitgeleverd in /home/hka/bxmbng-webstart/resources. Ze komen mee
met package wise-bxmbng. De resources die OCLC meelevert worden gekopieerd naar /home/bxmas/resources/rsrc (post-install). Hieronder ontstaat een map Templates met stylesheets die door de klant kunnen worden aangepast (moeten eenmalig naar /home/bxmas/resources gekopieerd worden).
Als voorbeeld geven we bon_k.xsl (kassabon):
Wordt uitgeleverd in:
/home/bxmas/resources/rsrc/STYLESHEET_RECEIPT/bon_k.xsl
Moet door de klant gekopieerd worden naar:
/home/bxmas/resources/STYLESHEET_RECEIPT/bon_k.xsl
Deze importeert bon_k_default.xsl en custom_templates.xsl. Deze te importeren bestanden mogen in /home/bxmas/resources/rsrc/STYLESHEET_RECEIPT blijven staan.
Het is mogelijk om te differentiëren per instantie of vestiging, bij het zoeken naar (bijvoorbeeld) een bon-stylesheet ‘bon_k.xsl’ wordt in de volgende volgorde gezocht:
- resources/STYLESHEET_RECEIPT/<vestiging>/bon_k.xsl (klant)
- resources/STYLESHEET_RECEIPT/<instantie>/bon_k.xsl (klant)
- resources/STYLESHEET_RECEIPT/bon_k.xsl (klant)
- resources/rsrc/STYLESHEET_RECEIPT/bon_k.xsl (HKA)
De bestanden in de rsrc map mogen niet door klanten gewijzigd worden aangezien deze bij elke update overschreven kunnen worden.
Klantaanpassingen kunnen uitsluitend door het te wijzigen bestand te kopiëren naar een resourcemap een niveau hoger en daar de wijzigingen aanbrengen.
Resource-type (hoofdgroep) STYLESHEET_RECEIPT (baliebonnetjes) werkt anders dan de andere resource-types. Bij STYLESHEET_RECEIPT zijn er WEL imports mogelijk. de naam van de XSL die gezocht wordt ligt per functie (bontype) vast, bv bon_k.xsl.
Bij de andere resource-types wordt door de servlet een zipje gemaakt waarin elke naam (x.xsl) maar 1 keer voorkomt. Bijvoorbeeld rsrc/STYLESHEET_X/x.xsl wordt overruled door alle andere nivo's. Er zijn GEEN imports mogelijk voor deze resource-types (ze zijn relatief simpel). De client biedt keuze uit de beschikbare XSL's (als er meerdere zijn) of gaat direct over tot renderen/afdrukken indien slecht 1 stylesheet van een bepaald resourcetype beschikbaar is.
We kennen de volgende resource-types:
Later volgt hiervoor nog een configuratie-instelling. De voorbeeld-xml of XSD's komen nog beschikbaar.