5. Drukwerk templates in Brocade: parametrisering van leen-, financieel- en aanwinstendrukwerk
Auteur |
|
Aanmaak |
28 sep 2004 11:38 |
Aangepast door |
|
Aangepast op |
23 feb 2015 09:49 |
Oud BVV nr |
2226 |
5.1. Abstract
Dit document beschrijft de wijze waarop in Brocade de diverse templates voor het leen-, financieel-, en aanwinstendrukwerk kunnen worden opgemaakt en beheerd.
5.2. Templates
Er worden twee soorten templates in Brocade gebruikt:
ASCII tekst bestanden voor verzending via e-mail
Open Office documenten (*.odt) files voor productie van pdf bestanden gericht op afdruk en verzending via gewone post. Om Open Office templates te maken moet je beschikken over het Open Office pakket. Dit pakket is beschikbaar als open-source project vanop http://www.openoffice.org
Templates bevatten vaste teksten en placeholders. Placeholders geven aan waar precies in het document variabele tekst moet worden geplaatst. Voorbeelden van variabele tekst zijn:
naam, voornaam van de lezer
adres van een leverancier
streepjescode van een geleend object
titel van een geleverde IBL-aanvraag
...
5.3. Placeholders voor leendrukwerk
Het leendrukwerk vertrekt van een xml-file die alle gegevens (lezers en objecten) bevat. Deze xml-file is het resultaat van het nachtelijke proces loannight. Elk van de data-elementen in deze xml file kan worden gebruikt als placeholder.
- $Euser.Evn
Voornaam van de lezer
- $Euser.Efn
Familienaam van de lezer
- $Euser.Eemail
E-mailadres van de lezer
- $Euser.Emobil
GSM-nummer van de lezer
- $Euser.Eloi
E-loi van de lezer
- $Euser.Ebc
Streepjescode van de lezer
Welke streepjescode wordt gebruikt in placeholder $Euser.Ebc? Deze die is gedefinieerd als af te drukken streepjescode in eindgebruikerssysteem.
- $Euser.Edebt
Totaal van de openstaande schuld
- $Euser.Elib
Basisinstelling van de lezer
- $Euser.Elibti
Basisinstelling (benaming voluit) van de lezer
- $Euser.Enext
Vervaldatum van de lenerskaart
- $Eudebt[].Ektransg
Dit is de verwoording van de kastransactiegroep waartoe de kastransactiecode behoort. Behoort deze niet tot een groep dan toont men de verwoording van de kastransactiecode.
- $Eudebt[].Ecurrency
Munteenheid van de kastransactie(groep)
- $Eudebt[].Edebt
Openstaand bedrag van de kastransactie(groep)
- $Address.Aphone
Telefoon
- $Address.Astreet
Straatnaam
- $Address.Anr
Straatnummer
- $Address.Abus
Busnummer
- $Address.Azip
Postcode
- $Address.Acity
Stad/Gemeente
- $Address.Acountry
Land
- $Date
Datum van aanmaak van de brief
- $Object[].Ois
Catalografische instelling waartoe het object behoort
- $Object[].Oloc
Werkstation waar het object werd uitgeleend
- $Object[].Opk
Plaatskenmerk van het object
- $Object[].Ovo
Volume horend bij het plaatskenmerk van het geleende object
- $Object[].Otitle
(Verkorte) titel van het object
- $Object[].OtitleFull
Volledige titel van het object
- $Object[].Otime
Datum van uitleen
- $Object[].Ountil
Datum van teruggave
- $Object[].Obc
Streepjescode van het object
- $Object[].Oloi
o-loi van het object
- $Object[].Ordue
Vervaldatum van een klaarstaande reservatie
- $Object[].Orpic
Afhaallocatie van de klaarstaande reservatie
- $Object[].Oobjc
Objectklasse (vanaf release 3.30)
- $Object[].Oextra
Extra informatie bij het object
5.4. Placeholders voor financieel drukwerk
Het financieel drukwerk vertrekt van een xml-file die alle gegevens over de lezers en hun financiën bevat. Deze xml-file is het resultaat van de verzegeling van een bepaald type betalingskenmerk. Elk van onderstaande data-elementen in deze xml-file kan worden gebruikt als placeholder.
- $Euser.Evn
Voornaam van de lezer
- $Euser.Efn
Familienaam van de lezer
- $Euser.Eemail
E-mailadres van de lezer
- $Euser.Emobil
GSM-nummer van de lezer
- $Euser.Eloi
E-loi van de lezer
- $Euser.Ebc
Streepjescode van de lezer
Welke streepjescode wordt gebruikt in placeholder $Euser.Ebc? Deze die is gedefinieerd als af te drukken streepjescode in eindgebruikerssysteem.
- $Euser.Edebt
Totaal van de openstaande schuld
- $Euser.Elib
Basisinstelling van de lezer
- $Euser.Elibti
Basisinstelling (benaming voluit) van de lezer
- $Euser.Enext
Vervaldatum van de lenerskaart
- $Eudebt[].Ektransg
Dit is de verwoording van de kastransactiegroep waartoe de kastransactiecode behoort. Behoort deze niet tot een groep dan toont men de verwoording van de kastransactiecode.
- $Eudebt[].Ecurrency
Munteenheid van de kastransactie(groep)
- $Eudebt[].Edebt
Openstaand bedrag van de kastransactie(groep)
- $Address.Aphone
Telefoon
- $Address.Astreet
Straatnaam
- $Address.Anr
Straatnummer
- $Address.Abus
Busnummer
- $Address.Azip
Postcode
- $Address.Acity
Stad/Gemeente
- $Address.Acountry
Land
- $Date
Datum van aanmaak van de brief
- $State.Camount
Het verschuldigde bedrag gekoppeld aan het betalingskenmerk
- $State.Ccur
Valuta van het verschuldigde bedrag
- $State.Cref
Factuurnummer
- $State.Cpaydate
De datum waarop de factuur ten laatste betaald moet worden
- State.Cfploi
De identificatie van het betalingskenmerk
- $State.Ctitle
De boodschap in het veld "Omschrijving" t.h.v. het betalingskenmerk
5.5. Placeholders voor algemeen drukwerk
Het algemeen drukwerk vertrekt van een xml-file die alle gegevens over de lezers bevat en de status waarin deze zich bevindt. Deze xml-file is het resultaat van het proces loannight en/of een gebruikersproces (op aanvraag) (gegeven een lijst met elois (selectie adhv statuscode) en een aan autonome leenstaat). Elk van de data-elementen in deze xml-file kan worden gebruikt als placeholder.
- $Euser.Evn
Voornaam van de lezer
- $Euser.Efn
Familienaam van de lezer
- $Euser.Eemail
e-mailadres van de lezer
- $Euser.Emobil
GSM-nummer van de lezer
- $Euser.Eloi
E-loi van de lezer
- $Euser.Ebc
Streepjescode van de lezer
Welke streepjescode wordt gebruikt in placeholder $Euser.Ebc? Deze die is gedefinieerd als af te drukken streepjescode in eindgebruikerssysteem.
- $Euser.Edebt
Totaal van de openstaande schuld
- $Euser.Elib
Basisinstelling van de lezer
- $Euser.Elibti
Basisinstelling (benaming voluit) van de lezer
- $Euser.Enext
Vervaldatum van de lenerskaart
- $Eudebt[].Ektransg
Dit is de verwoording van de kastransactiegroep waartoe de kastransactiecode behoort. Behoort deze niet tot een groep dan toont men de verwoording van de kastransactiecode.
- $Eudebt[].Ecurrency
Munteenheid van de kastransactie(groep)
- $Eudebt[].Edebt
Openstaand bedrag van de kastransactie(groep)
- $Address.Aphone
Telefoon
- $Address.Astreet
Straatnaam
- $Address.Anr
Straatnummer
- $Address.Abus
Busnummer
- $Address.Azip
Postcode
- $Address.Acity
Stad/Gemeente
- $Address.Acountry
Land
- $Date
Datum van aanmaak van de brief
- $Euser.Estate.Awhy
De opmerking die kan ingeven wanneer u iemand manueel een statuscode geeft
- $Euser.Estate.Adfrom
Datum waarop de statuscode werd toegekend
- $Euser.Estate.Aduntil
Datum waarop de statuscode zal weggenomen worden
- $Euser.Estate.Atype
Het type statuscode
- $Euser.urlemail
De url voor het valideren van het E-mailadres.
5.6. Placeholders voor aanwinstendrukwerk
Het aanwinstendrukwerk vertrekt van een xml-file die alle gegevens bevat. In principe kan elk van de data-elementen in deze xml-file gebruikt worden als placeholder. Hieronder volgt een opsomming van de elementen die in de praktijk in de templates zullen gebruikt worden.
- $Date
Datum van aanmaak drukwerk (DD/MM/YYYY)
- $Dateiso
Datum van aanmaak drukwerk (YYYYMMDD)
- $Dateblank
Datum van aanmaak drukwerk (DDMMYYYY)
- $Destination.Dname{}
Naam bestemmeling (kunnen meerdere lijnen zijn)
- $Destination.Dref
Klantnummer
- $Destination.Did
Loi van de leverancier
- $Destination.Dtotpr
Totale prijs van alle requests, uitgesplitst per muntcode
- $Destination.Dcontact
Contactpersoon
- $Destination.Daddress.Astreet
Straatnaam
- $Destination.Daddress.Alocation
Postcode gevolgd door plaatsnaam of vice versa voor angelsaksische landen
- $Destination.Daddress.Acountry
Land
- $Requests
Verzameling van berichten, bestellingen, rappels, annuleringen voor deze bestemmeling. Aan te spreken in for constructie: #for rq in $Requests
- $rq.Rsay
Verwoording van het type request (zie Types van te bestellen items in Instellingsgebonden beheer)
- $rq.Rid
Identificatie van request rq (loi + eventueel leveranciersidentificatie,...)
- $rq.Rnr
Instellings-eigen nummering van request rq
- $rq.Rsel
Selectiecodes van request rq
- $rq.Rbudget
Opsomming van de gebruikte budgetten (verwoordingen) in request rq (in geval van bestelling)
- $rq.Rbudgetid
Opsomming van de gebruikte budgetten (b-lois) in request rq (in geval van bestelling)
- $rq.Rdescription.Disbd{}
Isbd beschrijving van request rq (kunnen meerdere lijnen zijn)
- $rq.Rdescription.Disbdshort
Korte isbd beschrijving van request (titel / auteur)rq
- $rq.Rdescription.Dis
ISBN/ISSN
- $rq.Rdescription.Disf
Geformateerde ISBN/ISSN (13 karakters, zonder koppeltekens, eventueel voorloopnullen)
- $rq.Rdescription.Din
Extra informatie. Bij bestellingen, rappels en hernieuwingen maken deze gegevens sowieso al deel uit van $rq.Rdescription.Disbd.
- $rq.Rinfo
Extra informatie voor rq, afkomstig uit leveranciersrecord
- $rq.Rholding
Verzameling van holdings van een request rq. Aan te spreken in for constructie: #for holding in $rq.Rholding
- $rq.Rnritems
Totaal aantal exemplaren in deze request
- $rq.Rtotpr
Totale prijs van deze request, uitgesplitst per muntcode
- $rq.Ritempr
Eenheidsprijs = totaalprijs / aantal exemplaren, uitgeplitst per muntcode
- $rq.Rbind
Binding (hardback, paperback, ebook, online (of leeg))
- $rq.Rattr.Aattribuutnaam
Attribuut bij request
- $holding.Hnr
Aantal exemplaren voor holding
- $holding.Hdata
Opgave voor holding
- $holding.Hpr
Totaalprijs voor holding
- $holding.Hcu
Munteenheid voor holding
- $holding.Hdest.Hid
Code bestemming voor holding
- $holding.Hdest.Hnm
Naam bestemming voor holding
- $holding.Hdest.Href
Code bestemming zoals gekend door leverancier voor holding
- $holding.Hitem
Verzameling items binnen holding. Aan te spreken in for constructie: #for item in $holding.Hitem
- $holding.Hitems
Berekende string die zo goed mogelijk de verschillende items in deze holding probeert samen te vatten. Bvb.
een bestelling van n exemplaren -> n ex.
een bestelling van een werk bestaande uit een handboek en een werkmap, in 2 exemplaren -> 2x Handboek, 2x Werkmap
- $holding.Hbudgets
Budgetten van holding.
- $holding.Hattr.Aattribuutnaam
Attribuut bij holding
- $item.Ids
Beschrijving item
- $item.Itx
Supplementaire info item
- $item.Icl
Opsomming vorige rappels van item
- $rq.Nlink
Indien rq een bericht is, bevat Nlink een opsomming van de links van rq naar q-lois, s-lois. Aan te spreken in for constructie: #for link in $rq.Nlink
- $link.Lid
loi van link
- $link.Ldescription.Disbd{}
Isbd beschrijving van link (kunnen meerdere lijnen zijn)
- $rq.Nsubject
Onderwerp van rq indien rq een bericht is
- $rq.Ndata
Inhoud van rq indien rq een bericht is
Naast de placeholders voor de effectieve gegevens zijn er ook nog een aantal taalafhankelijke placeholders beschikbaar. In principe moet er per taal een template gemaakt worden maar er kan ook met dezelfde template gewerkt worden voor alle talen en gebruik gemaakt worden van onderstaande placeholders. Sommige zijn algemeen, andere zijn afhankelijk van het type request (automatisch door de software bepaald).
- $Translation.type
- Bestelling / Order / Commande / BestellungRappel / Claim / Rappel / MahnungAnnulering / Cancellation / Annulation / StornierungHernieuwing / Renewal / Renouvellement / ErneuerungBericht / Note / Note / Nachricht
- $Translation.typeUP
- BESTELLING / ORDER / COMMANDE / BESTELLUNGRAPPEL / CLAIM / RAPPEL / MAHNUNGANNULERING / CANCELLATION / ANNULATION / STORNIERUNGHERNIEUWING / RENEWAL / RENOUVELLEMENT / ERNEUERUNGBERICHT / NOTE / NOTE / NACHRICHT
- $Translation.header
- Bestelnummer / Ordernumber / No. de commande / BestellnummerAbonnement / Subscription / Abonnement / AbonnementBericht / Note / Note / Nachricht
- $Translation.budget
Kredietcode / Credit / No. de credit / Kreditkode
- $Translation.price
Prijs / Price / Prix / Preis
- $Translation.prclaim
Vorige rappels / Previous claims / Rappels / Mahnungen
- $rq.Rtranslation.exchange
De enige vertaal-placeholder die kan verschillen per request, vandaar de andere syntax. $rq is de placeholder die verkregen wordt via #for rq in $Requests (zie boven).
Ruil / Exchange / échange / TauschGift / Gift / Don / SchenkungLidmaatschap / Membership / Membre / Mitgliedschaft
5.7. Stijldefinities in Brocade
Je kan de stijldefinities in Brocade opladen via de toepassing Systeembeheer - Styles - Styledefinities. Dit is vooral interessant als je maar één of een paar styles moet opladen. Er bestaat ook een mogelijkheid om styles in groep op te laden. Doe dit als volgt:
Neem als file naam voor de *.odt en *.txt templates dezelfde identifiers als die van de style in Brocade. Voorbeeld | style = ua-cst_UA-R1-pre_pdf --> filename: ua-cst_UA-R1-pre_pdf.odt | style = ua-cst_UA-R1-pre_text --> filename: ua-cst_UA-R1-pre_text.txt
Plaats de *.odt en *.txt files op de Brocade server bv. in de folder
/library/tmp
Voer uit
stylist -templates leen ua*.odt
. Met dit commando worden alle *.odt files die beginnen met ua opgeladen in de stylegroep voor de leen.Je kan aan dit commando ook een taalswitch als volgt toevoegen:
stylist -templates acquisitie cde_order.odt
: in de definitie cde_order wordt voor alle talen dezelfde file opgeladen.stylist -templates acquisitie cde_order.odt lg=dut
: in de definitie cde_order wordt enkel een file voor de taal Nederlands ingevuld.
Je krijgt een verwerkingsrapport dat aangeeft waar er bv. discrepanties zitten tussen de naam van de file en de identifier van de style.
5.8. Tikfouten corrigeren
Templates bevatten vaak steeds dezelfde informatie. Als je een tikfout hebt gemaakt, dan zal in veel gevallen deze tikfout gecorrigeerd moeten worden in diverse files. Volgende instrumenten kunnen je helpen bij het snel corrigeren
*.txt files Gebruik
qtechng fs replace
*.odt files Gebruik
otool -replace
5.9. Testen
Je kan de stijldefinitie als volgt testen (voorbeelden):
stylist -teststyle acquisitie cde^order
stylist -teststyle leen ha-bls^HA*
Deze commando's maken bij de desbetreffende stijldefinitie zowel een txt als odt/pdf file ter controle. De test files worden weggeschreven in de meta-informatie van de stijldefinitie.
Je kan ook via de interface (meta-inforamtie van de stijldefinitie) voor een bepaalde stijl een testbestand aanmaken.
5.10. Fonts
Zorg ervoor dat de fonts waarmee je op je PC de odt-templates maakt, ook op de server geïnstalleerd zijn.