Inrichten

Laatst bijgewerkt op
Als PDF opslaan

Technische inrichting

Voor het inschrijven is één module beschikbaar die verschillende soorten inschrijvingen kan afhandelen. Hierbij wordt gebruikgemaakt van hedendaagse best practices. Hieronder volgt in een paar stappen de technische inrichting.

Installatie

RPMs
Het inschrijven is afhankelijk van 3 RPMs:

op machine wiseas (of wisedb): wise-bms-base en wise-nms
op machine wiseweb: frontend-applications

Configuratie

Op de webserver moet de apache module rewrite (of mod_rewrite) enabled zijn.
Onder SLES: edit /etc/sysconfig/apache2 en voeg 'rewrite' achter APACHE_MODULES toe.
Onder RHEL: dit gaat automatisch.
Voeg wise-nms-subscription_wise.include (webserver host config file) als Include toe aan bicat.conf.

Controle
Na installeren moet het commando pm2 logs op de machine waar wise-nms rpm geïnstalleerd is geen fouten leveren.

Algemene voorwaarden bij abonnement

Tijdens het inschrijven wordt bij het vinkje 'Algemene voorwaarden' aangegeven dat deze te vinden zijn bij de omschrijving van de abonnementen. De omschrijving van de abonnementen moet de bibliotheek zelf opstellen en online zetten.

Manager
Als eerste moet in de Wise manager worden aangegeven waar de voorwaarden te vinden zijn. Dit kan via Producten en Diensten > Abonnementen > Abonnementsinstellingen > Abonnementsdefinities > Openen > Detail > veld Info URL. Geef in dit veld de link naar de webpagina of naar een .pdf op waar deze voorwaarden zijn opgenomen.

Doe dit voor alle abonnementen die via internet beschikbaar zijn!

Resultaat
In het online inschrijfformulier verschijnt bij het Product de tekst “Meer informatie over dit abonnement” en deze bevat de link naar de opgegeven info url

Locatie van de Wisecat+: URL

De functionaliteit van de Wisecat+ moet in diverse online interfaces (WaaS, Joomla) ontsloten kunnen worden. De inschrijfmodule is een op zichzelf staand component, waardoor de exacte URL van de Wisecat+ niet automatisch bekend is. Deze URL is echter wel nodig om vanuit het inschrijven naar de juiste plek in de Wisecat+ te kunnen springen.

Manager
Stel de exacte locatie in via de Manager > Beheer organisaties > Instanties > Detail > Portal via website URI. Vul de URL in van de publieke interface naar de Wisecat+:

Indien de Wisecat+rechtstreeks wordt ontsloten (eventueel met een WaaS integratie)	https://bicat.sfb-net.nl/cgi-bin/bx.pl http://bibliotheekoostland.nl/portal/cgi-bin/bx.pl
Indien de Wisecat+ in een Joomla omgeving wordt getoond	http://bibliotheekhoogland.nl/catalogus

Eisen URL

De URL moet compleet zijn (‘absolute’), dus beginnen met http of https.
De URL moet eindigen op /bx.pl.
De URL mag geen ? of & of = bevatten.
De URL mag niet eindigen op /.

URL testen
Of een URL correct is ingevoerd is als volgt te testen:

Start een nieuw browserscherm
Vul daar de complete url in. Vul aan met: ?event=main
Voeg evt. een vestigingsnummer toe: ?event=main;vestnr=xxxx

De browser zal vervolgens een portal main pagina tonen. Indien de browser dit niet doet, dan is URL niet correct.

Let op:
Wanneer in de instantietabel van een testsysteem dit veld is ingevuld, ga je vanuit de testportal naar de produktieportal (!). Wees hierop bedacht bij het testen. Wanneer dit gebeurt, het stukje link van het testgebied weer in de url (terug)zetten.

Inrichten

Systeemopties IDEAL en INSMELD

De volgende systeemopties moeten worden ingesteld:

IDEAL: Ondersteuning Internetbetalingen via iDEAL

Deze optie moet worden ingesteld nadat het iDEAL-betalen is ingericht. Zie Starten met betalen met Ideal.

INSMELD: Meldingen laten staan bij nieuwe pas

Indien INSMELD niet aanstaat, worden – op het moment dat er een pas aangemaakt wordt – de melding 'Internet inschrijving' en de 'Blokkade door internetinschrijving' automatisch weggehaald.
Als deze optie wel aanstaat, dan worden de melding 'Internet inschrijving' en de 'Blokkade door internetinschrijving' NIET automatisch verwijderd.

Wanneer de bibliotheek de passen aan de nieuwe klanten toestuurt, moet gebruik worden gemaakt van deze optie. Dit zorgt ervoor dat deze klanten zich eerst voor legitimatie bij de balie moeten melden voordat ze van de bibliotheekdiensten gebruik kunnen maken.

Systeemtabel (TABSEL) Selectiecodes klanten

Bij het inschrijven via internet wordt deze selectiecode standaard aan de klant toegevoegd. Via klantselecties kan hier vervolgens op worden geselecteerd. Via Klanten > Systeemtabellen > Selectiecodes klanten > Detail kan de code INT worden toegevoegd, voorzien van een omschrijving als 'Internet-inschrijving'.

Abonnementen: inschrijfkosten en drempeltegoed

Inschrijfkosten

De inschrijfkosten die normaal moeten worden betaald bij een inschrijving aan de balie, kunnen ook in rekening worden gebracht bij een inschrijving via internet.

De inschrijfkosten moet worden gedefinieerd via Financiën > Boekingsstructuur > Boekingstabellen > Accounting.
Deze boekingscode wordt toegevoegd aan Producten en diensten > Abonnementen > Abonnementsinstellingen > Abonnementstarieven in het veld 'Boekingscode inschrijfkosten balie'.
Het is ook mogelijk om een inschrijftarief te hanteren voor internetinschrijvingen. In dat geval moet de boekingscode worden toegevoegd in het veld 'Boekingscode inschrijfkosten internet'.

Drempeltegoed

Het is mogelijk dat de bibliotheek geen inschrijfkosten berekent. Om misbruik te voorkomen, is het wel aan te raden een drempel op te werpen bij het inschrijven via internet. Dit zogeheten drempeltegoed wordt door de klant betaald via iDEAL. Het drempeltegoed wordt als deposito op de pas gestort. Dit is in te stellen via Producten en diensten > Abonnementen > Abonnementsinstellingen > Abonnementstarieven, veld 'Drempeltegoed'.

Abonnementen: korting en minimaal contributiebedrag

Wie via iDEAL betaalt, kan korting op de contributie krijgen. Deze korting kan worden vastgelegd in de iDEAL Methode (Financiën > Systeemtabellen). Tevens kan hier worden vastgelegd dat deze korting uitsluitend geldt wanneer de contributie hoger is dan het hier ingevulde minimumbedrag: zo is te regelen dat op een goedkoop abonnement geen korting wordt verleend).

Abonnementsdefinitie

De abonnementsdefinities kunnen worden ingesteld bij Producten en diensten > Abonnementen > Abonnementsdefinities > Detail.

Veld	Uitleg
Uitgifte via internet J/N	Mag een klant dit abonnement kiezen via online inschrijven? Zo ja, kies dan J = vinkje. Zonder vinkje (dus N) kunnen instellings- en personeelsabonnementen e.d. worden uitgesloten van uitgifte via internet.
Info	Tekst die bij het inschrijven aan de klant getoond wordt in het scherm waar een abonnement gekozen wordt. Geef bondige informatie over het desbetreffende abonnement.
Info url	URL naar webpagina of naar .pdf-document waarin de algemene voorwaarden zijn opgenomen. Zie ook Algemene voorwaarden bij abonnement.

Default vestiging

Bij de Instantie moet in het veld 'Inschrijvingen via web' de default vestiging ingevuld worden waar de internetinschrijving geplaatst wordt, vóórdat een filiaal wordt gekozen (Beheer organisaties > Instanties > Detail). Bij internet-inschrijven kan uit één of meerdere filialen worden gekozen, in hetzelfde scherm waar ook de abonnementskeuze gemaakt moet worden.

Bij het online inschrijven door de klant wordt bij klikken op 'verder' gecontroleerd of er een vestiging en een abonnement is gekozen. Zo nee, dan volgt een melding boven dit veld.

Als er één keus is voor filiaal of abonnement dan is dit voor-ingevuld. Zijn er meerdere keuzes mogelijk, dan is er niets voor-ingevuld (ondanks het feit dat bij de instantie een 'default-vestiging voor inschrijven' is ingevuld; deze instelling is alleen van belang voor het systeem zelf als de lener (nog) geen keuze doet).

Abonnement klanttype

Bij het online inschrijven zijn de standaard verplichte velden:

Aanhef (M/V)
Achternaam
Geboortedatum
Postcode
Huisnummer
Type Abonnement
Vestiging

De verplichte velden zijn aan te passen in de manager onder Wise > Klanten > Klanttype definitie. Klanttype ‘Reguliere klant’ wordt gebruikt voor alle reguliere bibliotheekabonnementen. Er wordt onderscheid gemaakt tussen het type klant (donateur, bieblid, etc.) en niet tussen de verschillende abonnementen.

Berichten: publieksmeldingen per mail

Instellen in de Wise Manager > Systeemwise > Berichten > Berichten > SysteemTabel > Publieksmeldingen.

PVC – Verificatiecode bij inschrijven via internet

Tijdens het inschrijfproces krijgt de klant via de mail een verificatiecode waarmee hij/zij het inschrijfproces moet afronden (NB Deze verificatiecode is 7 dagen geldig). Niet alleen een nieuwe klant krijgt deze verificatiemail, maar óók de bestaande klant die zijn e-mailadres heeft gewijzigd (+ naar het oude adres wordt een PVE verzonden, ter informatie). Deze bevat geen verificatiecode.

Omdat de PVC-berichten zowel naar nieuwe als naar bestaande klanten worden verstuurd, is de standaardtekst van de stylesheet meer algemeen gemaakt; de nadruk ligt nu op het controleren en bevestigen (!) van het mailadres zodat het voor beide groepen tegelijk te gebruiken is.

Ga na of er gebruik wordt gemaakt van eventueel eigen overrulingen en test hoe de berichten eruit komen te zien. Pas tevens de onderwerpregel (=tekstregel) aan in bijvoorbeeld ‘Controleer en bevestig uw gegevens’.
Er moet een VC met tekstgroep 01 zijn.
Vul bij tekstregel nummer 1 (=onderwerpsregel) bijvoorbeeld ‘Controleer en bevestig uw gegevens’ in.

PVW – Welkom na inschrijven via internet

De klant ontvangt een PVW nadat een inschrijving succesvol is afgerond. De mail wordt verzonden door de vestiging waarvoor de klant tijdens het inschrijfproces heeft gekozen.

Werkwijze
De mail wordt opgesteld in de Manager. Ga hiervoor naar Systeemwise > Berichten > Berichten > Teksten > Publieksmeldingen. Er moet een VW met tekstgroep 01 zijn. Vul bij tekstregel (= nummer) 1 bijv. ‘Welkom bij de bibliotheek’ in.

De verschillende tekstregels zijn geschikt voor verschillende onderdelen van de mail. Indien binnen de vrije tekstblokjes een 'Enter' wordt gebruikt, dan hoeft alleen tekstregel 4 gebruikt te worden.

Tekstregel 1 – ONDERWERP
Tekstregel 2 – AANHEF
Tekstregel 3 – vrije tekst 1
Tekstregel 4 – vrije tekst 2
Tekstregel 5 – vrije tekst 3

PAE – Publieksmelding actor e-mailadressen ter bevestiging

Tijdens het inschrijven checkt Wise of het opgegeven mailadres al bekend is binnen het systeem. Zo ja, dan wordt naar dat mailadres een PAE verzonden, met opgave van de actoren (+ rollen: ABON, DONA, NBRF, etc.) waaruit de klant moet kiezen ‘wie hij is’. (Indien niet van toepassing, dan kan hij alsnog een nieuwe inschrijving maken).

Er moet een functie AE met tekstgroep 01 zijn.
Vul bij tekstregel 1 bijv. ‘Bevestiging gevraagd' in.

Bcc
In veld 'Bcc' (tabblad SysteemTabel) kan worden gekozen voor geen/ algemeen/ welkom/ beide.

Welkom: Met deze keuze wordt bcc gemaild naar het mailadres dat in de tabel
‘Beheer organisaties > Vestigingen > tabblad NAW > Bcc Welkom’ is ingevuld. Op deze manier is bij te houden hoeveel internetinschrijvingen er zijn geweest.
Algemeen: met deze keuze wordt bcc gemaild naar het mailadres dat in de
Vestigingstabel > tabblad NAW > Bcc Algemeen is ingevuld.
Beide: Met deze keuze gaat naar beide mailadressen een kopie.

Afwijkende tekst in mailbericht

In systeemWise > Berichten > Berichten > Teksten (tab) zijn de standaardteksten opgenomen, die voor de verschillende formulieren en andere berichten worden gebruikt. De vaste teksten kunnen hier worden gewijzigd (zie voor een uitgebreide uitleg systeemwise berichten).

De tekst die in de manager gezet wordt in tekstregel 4, verschijnt in de verificatiecode-mail (PVC) ná de verificatiecode.
De tekst die in de manager gezet wordt in tekstregel 4, verschijnt in de welkomstmail (PVW) ná klantnummer en gebruikersnaam

Teksten wijzigen in XML
In de tekstentabel worden per berichtsoort de teksten vastgelegd. Vaste teksten kunnen natuurlijk ook in de xml worden vastgelegd. Dan is het noodzakelijk dat iemand met kennis van xml deze teksten beheert en muteert. Op de databaseserver kan in de berichtenopmaak een variabele in de xsl gezet worden waardoor er een afwijkende tekst in de mail komt:

In /home/bxmas/berichten/wise/mail_com.xsl opnemen:

Variabele	Tekst
<xsl:variable name="pasafhandeling" select="'thuis'"/> <!-- afhalen / thuis - Afhalen in de bibliotheek of thuisgestuurd krijgen.-->	'U krijgt uw pas zo snel mogelijk thuis gestuurd.'
Of
<xsl:variable name="pasafhandeling" select="'afhalen'"/> <!-- afhalen / thuis - Afhalen in de bibliotheek of thuisgestuurd krijgen.-->	'U kunt uw pas afhalen bij uw bibliotheek.'

De tekst in tekstregel 4 in de manager (berichten) zal deze xsl overrulen.

Links 'Lid worden', Nieuwsbrief, Donateur, Ticketwise

De links zoals 'Lid worden' (of een andere tekst als 'Inschrijven' of 'Schrijf u nu in' etc.) kunnen op verschillende plaatsen op de site worden gezet. De URL’s waar de links naar verwijzen zijn:

Onderwerp	Link
Lid worden	<adres webserver>/wise-apps/opac/<vestigingsnummer>/subscription/regular
Inschrijven nieuwsbrief	<adres webserver>/wise-apps/opac/<vestigingsnummer>/subscription/newsletter
Donateur worden	In versie 7.0.7 niet beschikbaar.
Ticketwise lid	<adres webserver>/wise-apps/opac/<vestigingsnummer>/subscription/ticketwise

Als de klant dit mag, verschijnt de link. De links voor 'Lid worden' en 'Aanmelden nieuwsbrief' kun je aan- en uitzetten via Wisecat+ configuratie.

Internetinschrijfmethode

De internetinschrijfmethode geeft aan welke inschrijfmogelijkheden via de Wisecat+ worden aangeboden. Een internetinschrijfmethode moet worden aangemaakt via Producten en diensten > Abonnementen > Abonnementmethodes > Internetinschrijfmethode.

Veld	Uitleg
Code	Volgnummer, begin met 01. Alfanumeriek, 2 posities
Omschrijving	Omschrijving van de internet inschrijfmethode
Inschrijven regulier abonnement toegestaan	Zet een vinkje als de reguliere bibliotheek-abonnementen worden aangeboden.
Inschrijven nieuwsbrief/ gast-abonnement toegestaan	Zet een vinkje als inschrijven op nieuwsbrief/ gast-abonnement wordt aangeboden.
Inschrijven voor kaartverkoop toegestaan	Zet een vinkje als ook niet-bibliotheekleden via de Wisecat+ online kaarten voor activiteiten mogen kopen. Zie Kaartverkoop Wisecat+.
Blokkeer publiek catalogus	Wanneer dit is aangevinkt, worden in de publiekscatalogus alle inschrijflinks onderdrukt voor alle vestigingen die deze inschrijfmethode hebben ingesteld.
Vraag leeshandicap in web	Mogelijkheid om aan te geven of de klant een leeshandicap heeft.
Melding in balie	Vul de tekst in die in de klantenadministratie moet verschijnen zodra de via internet ingeschreven klant zich daar meldt (bijv. om zijn pas op te halen). Deze tekst wordt opgeslagen in de klantenadministratie, bij Tabblad 5. Meldingen. Adviestekst: 'Controleer legitimatie'

Internetinschrijfmethode koppelen aan vestiging

Per vestiging moet worden aangegeven welke internet-inschrijfmethode geldt; dit kan per vestiging immers verschillen. Ga naar Beheer organisaties > Vestigingen > Vestiging detail > Tabblad Klanten. Kies de Internetinschrijfmethode. Is voor een vestiging geen methode aangegeven, dan is het inschrijven via internet voor die vestiging NIET mogelijk.

Laatste actie!
Het koppelen van de internetinschrijfmethode is de laatste actie die gedaan moet worden. Een aantal zaken wordt namelijk pas zichtbaar als de internetinschrijfmethode gekoppeld is aan een vestiging!

Alle Vestigingen: categorie Z = Dummy-vestiging

Er zijn organisaties die gebruikmaken van een 'Alle vestigingen'-vestiging. Zo'n (verzamel)vestiging moet de categorie Z = Dummy-vestiging hebben. Stel dit in via Beheer organisaties > Vestigingen > Vestiging detail > Tabblad Vestiging.

Ook moet er een internetinschrijfmethode ingevuld zijn (zie Internetinschrijfmethode koppelen aan vestiging). Hierdoor kan deze verzamelvestiging niet als vestiging gekozen worden, maar worden wel de links getoond voor inschrijven en nieuwsbrief.