Stylesheets overrulen
Overrulen van standaard teksten
In OCLC Wise kunnen standaard teksten overruled worden. Voor de duidelijkheid: het gaat hier over alle teksten die NIET met behulp van tekstregels in de manager zijn toegevoegd.
We gaan er in dit document gemakshalve van uit dat we te maken hebben met een schone installatie, standaard werkend met de klant-eigen 'wise' directory (zonder vestnr of instantie niveau), om vervolgens uitleg te geven over de werkwijze van overrulen van standaard teksten.
Uitlevering en benodigdheden
De Wise uitlevering bestaat uit xslt stylesheets en enkele xml bestanden. Voor algemene werking van xml, xsl en xpath zie: https://www.w3schools.com/xml/
Deze berichten stylesheets en xml bestanden zijn over het algemeen te vinden in:
/home/bxmas/berichten/rsrc/wise/* NB ⛔ Deze files nooit aanpassen!
Aanpassen heeft ook geen zin want alles in de 'rsrc' map wordt toch overschreven bij iedere update van OCLC Wise. Daarvoor bestaat dan ook het klant-eigen niveau:
/home/bxmas/berichten/wise/* ✅ Deze map is onze 'working directory' waar we met overrulingen werken!
Alle standaard teksten die in de Wise uitlevering meekomen, zijn gecentraliseerd naar één xml bestand:
/home/bxmas/berichten/rsrc/wise/txt_default.xml
Dan bestaat er nog een template bestand voor de klant-eigen tekst xsl-file. Let op! Dit is inhoudelijk een xml file maar heeft de extensie .xsl omdat op de server in /home/bxmas/berichten/ alle .xml bestanden worden opgeruimd behalve in de 'rsrc' map.
Het klant-eigen tekst xsl-bestand is te vinden in:
/home/bxmas/berichten/Templates/template_txt_overruling.xsl
Overrulen indien nodig
Indien het nodig is om een standaard tekst te overrulen, dan gaat dit als volgt.
Configuratie
Allereerst is er een stukje configuratie nodig om het overrulen te activeren. Allereerst het kopiëren en gebruiken van de klant-eigen tekst xsl-file. Onder Uitlevering en benodigdheden staat de locatie van template_txt_overruling.xsl (template-bestand) benoemd. Kopieer (en hernoem) het bestand naar een logische plek(/naam). Het is aan te raden om deze file naar het klant-eigen niveau te kopiëren. In dit geval is dat dus:
/home/bxmas/berichten/wise/txt_overruling.xsl
Het bestand is klaar voor gebruik. Nu moeten alleen de stylesheets nog 'weten' dat ze in dit bestand moeten gaan zoeken naar overrulende teksten. Dat werkt als volgt:
1) Plaats deze xsl variabele (met een absoluut pad naar de xml file):
<xsl:variable name="overruling_file"
select="'/home/bxmas/berichten/wise/txt_overruling.xsl'"/>
2) In deze bestanden:
/home/bxmas/berichten/wise/mail_com.xsl
/home/bxmas/berichten/wise/frm_com.xsl
/home/bxmas/berichten/wise/krt_com.xsl
Klaar voor gebruik! Lees verder voor een voorbeeld hoe deze klant-eigen xml-file voor teksten te gebruiken.
Voorbeeld
Stel, er is een e-mailbericht met daarin een tekst die niet via tekstregels in de manager is aan te passen, bijvoorbeeld:
Werkwijze voor wijzigen
Ga in txt_default.xml (uit de OCLC Wise-uitlevering) nu letterlijk op zoek naar deze tekst. Maak bijvoorbeeld in een texteditor gebruik van de zoekfunctie. Waarschijnlijk verschijnt nu de volgende coderegel:
<t.pub-vw-uw-geg><text>Uw gegevens:</text></t.pub-vw-uw-geg>
Kopieer en plak deze regel nu zoals aangegeven in txt_overruling.xsl. De tekst tussen de <text> … </text> kan worden aangepast. Alleen deze regel wordt nu opgepikt door de stylesheets en dus 'overruled'.
Let op: Als deze tekst in de uitlevering wordt aangepast, dan zal dat nooit naar voren komen zolang deze overruling op zijn plek is. Dat kan een gewenst effect zijn, of juist niet. Het is belangrijk om hier alert op te zijn en bewust mee om te gaan.
Geavanceerd overrulen
Stel er zijn veel verschillende instanties en teksten per vestigingen. Er zijn dan twee verschillende manieren om te werk te gaan.
1: Instantie- en vestigingsmappen
Het is mogelijk om te kiezen om met de bekende instantie- en vestigingsmappen te gaan werken. Hanteer dan bovenstaande werkwijze voor de betreffende instantie of vestigingsmap.
2: Variatie binnen de overruling_file variabele
De tweede optie is om binnen de overruling_file variabele een 'choose' constructie te maken per instantie of op vestiging:
<xsl:variable name="overruling_file">
<xsl:choose>
<xsl:when test="/berichten/afzender/vestiging='1000'">/home/bxmas/berichten/wise/txt_1000.xml</xsl:when> <xsl:when test="/berichten/afzender/instantie='I010'">/home/bxmas/berichten/wise/txt_I010.xml</xsl:when>
<xsl:otherwise/>
</xsl:choose>
</xsl:variable>
Deze lijst kan dan zo lang als mogelijk worden gemaakt en in de noodzakelijke combinatie. Bedenk wel dat de eerste match op een test gebruikt wordt. Dus vaak is vestiging specifieker en moet dus als eerste matchen. Vandaar dat die bovenaan staat.