Dashboard en jobs

Laatst bijgewerkt op
Als PDF opslaan

systeemWise > Dashboard

Via systeemWise > Dashboard kunnen alle gestarte berichtverwerkingen (automatisch of handmatig) worden ingezien. Het dashboard geeft belangrijke informatie over status en verloop van de gestarte job. Deze informatie is te zien in het tabblad 'Jobregels'.

Als een gestarte job is afgerond, kan er een verslag van worden aangemaakt. In dit verslag is te lezen wat, voor wie en hoe er is verzameld en wat er is onderzocht. In het geval van Berichten is dit verslag belangrijk omdat er wordt vermeld waarom een bericht niet kon worden aangemaakt. Daarvoor kunnen diverse redenen zijn: het e-mailadres is onvolledig, de berichtmethode ontbreekt of de adresgegevens zijn onvolledig etc. Ook is het mogelijk dat de berichtvoorkeur niet goed staat ingesteld.

Bijvoorbeeld: de melding in het Dashboard "geen vestigingsgegevens (vestiging/instantie onbekend in tabel actor of adres)" betekent dat de adresgegevens ontbreken van vestiging 0000 in manager > Systeemwise > Systeeminstellingen.

Onder andere berichten met betrekking tot authenticatie, passwords, IBL-V worden aangemaakt met vestiging 0000.

Het is dus belangrijk om na iedere verzamel- en verwerk-actie het verslag te controleren. Het is mogelijk (wordt aanbevolen!) om de verslagen na afloop van de actie naar een beheerder te laten mailen. Een uitgebreide beschrijving van de dashboard-functie is te vinden in handleiding Systeemwise Dashboard.

Jobs Berichten

Voordat een bericht wordt verzonden naar een klant vinden er drie processen plaats: het selecteren, verzamelen en verwerken van exemplaren/reserveringen/meldingen die in aanmerking komen voor een bericht. Deze processen worden uitgevoerd door 'jobs'. Iedere berichtsoort heeft zijn eigen job. Wanneer deze jobs worden geactiveerd is per berichtsoort afwijkend. De ene job start eens per 24 uur, een andere start ieder uur of zelfs om de vijf minuten.

Een job start niet vanzelf: per organisatie moet worden aangegeven welke jobs er moeten worden gestart. Dit wordt ingesteld in etc/bwise/bxmas/bwise.properties. In de properties worden de jobs op 'true' of 'false' gezet, na een herstart van tomcat wordt de job actief of inactief. De actieve jobs zijn na de herstart direct zichtbaar in de tabel 'jobstat'. De inhoud van jobstat wordt getoond in het dashboard onder tabje 'Jobs'. Per job wordt getoond wanneer de job voor het laatst is gestart en wanneer de job opnieuw gaat lopen.

Let op: In de bwise.properties ontbreken de jobs BALRSV en PUBVZM. Deze beide jobs worden automatisch gestart na een herstart van tomcat.

Indien het gewenst is het tijdstip waarop een job gaat lopen aan te passen, kan dit met behulp van de querybrowser worden aangepast in de tabel 'jobstat'.

Naast de jobs die automatisch starten zijn er de jobs die gestart worden zodra een bepaalde functie wordt uitgevoerd; denk hierbij aan het 'printklaar maken' van de diverse berichten, het verzamelen van de aanwinstenmail of het aanmaken van incassobestand. Welke job er ook wordt gestart, in het dashboard wordt altijd een verslag geschreven.

Het kan voorkomen dat om wat voor reden ook de job in de fout loopt. In het dashboard verslag wordt alle beschikbare info getoond, maar in sommige gevallen zit de fout al aan het begin van het proces waardoor het niet mogelijk is om een verslag te produceren in het dashboard. Dan is de fout dus in een eerder stadium opgetreden. Is het niet duidelijk waarom een job in de fout is gelopen dan kan het serverlog uitkomst bieden. Het serverlog is op te vragen via /var/log/tomcat6/bxmas.log. Let op: dit is een zeer uitgebreid log: alle serveracties van vandaag worden hierin opgeslagen.

Zoeken in een log van een bepaald datum (tot een maand terug) kan als volgt:
/var/log/tomcat6/oldlogs/bxmas.log.2013-02-05.gz
Dit log is gezipt en kan worden bekeken met het commando 'zless'.

Het is ook mogelijk om te zoeken naar acties die uitgevoerd zijn m.b.t berichten. Zoek in dat geval op:
/berichtgetter

/whxxxx (xxxx=job, omschrijving etc.)

Jobs

Hieronder volgt een opsomming van de berichten jobs die opgenomen worden in het dashboard.

HERVZM - Herinneringen

Eens per 24 uur wordt deze verzameljob automatisch gestart, het tijdstip waarop deze job wordt gestart, wordt door de organisatie bepaald.

Controles
Tijdens deze job voert OCLC Wise de volgende controles uit op alle uitgeleende exemplaren:

Is aan het uitgeleende exemplaar een geldig reglement gekoppeld
Is het uitgeleende exemplaar gekoppeld aan een bestaande actor.

Tijdens deze job controleert OCLC Wise van alle uitgeleende exemplaren de inleverdatum.

Komt het exemplaar in aanmerking voor een inleverattendering?
Komt het exemplaar in aanmerking voor een herinnering?
Moet het exemplaar 'in nota' worden gezet?

Tijdens het selectieproces zal OCLC Wise bij de actor de berichtvoorkeuren onderzoeken (wat wil de klant: mail, sms, formulier). Nadat een exemplaar geselecteerd is zal OCLC Wise op datzelfde moment een regel schrijven in de tabel 'Berichten', aangevuld met de berichtvoorkeur van de klant. De status van de berichtregel wordt 0 (null, nog verzenden). Zo ontstaat een set geselecteerde exemplaren van verschillende voor verschillende berichtsoorten.

Na de controle door de job HERVZM wordt in het exemplaarrecord de controledatum gezet in het veld hervzm_dat.

Nadat de selectie is afgerond gaat de job HERVZM in de tabel 'Berichten' op zoek naar alle regels waarvan de status op 0 staat en de vorm (berichtvoorkeur) op M(mail) of S (sms) staat. Vanaf dit punt neemt de berichtenverwerker het over van HERVZM.
Berichtregels met vorm M en status 0 worden direct gefopt en verzonden.
Berichtregels met vorm S en status 0 worden om 8:30 verzonden.

De berichtregels die moeten worden afgedrukt op een formulier, worden in de tabel ' Berichten' opgenomen met status 0 en vorm F. Deze berichten worden via de client afgedrukt.

Actie per berichtsoort HERVZM

Inleverattenderingen
Inleverattenderingen worden uitsluitend via de mail of SMS verzonden. De HERVZM verzamelt de exemplaren op basis van de instellingen in de (aan)maanmethode. De mail en SMS wordt direct verzonden.

Herinneringen
De exemplaren die in aanmerking komen voor een herinnering worden door de HERVZM weggeschreven in de tabel 'Berichten' met vorm S, M of F. De berichtregels met vorm Mail en SMS worden direct verzonden.

Nota's
Voor exemplaren die in aanmerking komen voor een nota geldt een afwijkende werkwijze;

De geselecteerde exemplaren worden weggeschreven in de tabel 'nota_proc'. De inhoud van deze tabel wordt getoond in de client in het menu berichten > nota's. Met deze tussenstap heeft de organisatie de mogelijkheid om in te grijpen op een nota-regel nog voor dat deze wordt verzonden.

Financiële attenderingen
Financiële attenderingen worden door de job 'lnrfin' verzameld en door de job PUBVZM opgepakt en verzonden.

BALRSV - SnelReserveringen

Deze job wordt eens per uur automatisch gestart en verzamelt de ontvangen reserveringen van het afgelopen uur. Het gaat hierbij uitsluitend om reserveringen die via de mail of SMS worden verzonden.

In de tabel 'Reservering' wordt gezocht naar reserveringen met status O (ontvangen) en waarvan de klant het bericht via de mail of SMS wil ontvangen. Tijdens het verzamelproces wordt in de tabel 'Berichten' een regel geschreven met status 0 (null) en vorm M of S; de status van de reservering wijzigt naar 'Bericht'.

Zodra de reserveringen zijn verzameld start de berichtenverwerker om de reserveringsberichten met status 0 op te maken en te versturen (foppen) en vervolgens de status in de tabel 'Berichten' te wijzigen naar B (bericht).

Van elke run (ieder uur) wordt een verslag geschreven dat via het dashboard kan worden opgevraagd. Indien een dergelijk verslag niet gewenst is, moet in etc/bwise/bxmas/bwise.properties de volgende regel worden toegevoegd:
balrsv.useBirt=false

RSRVZM - reservering-verzamelaar

Deze job wordt eens per 24 uur automatisch gestart en verzamelt de ontvangen reserveringen van de afgelopen 24 uur. Het gaat hierbij uitsluitend om reserveringen die via een formulier worden verzonden.

In de tabel 'reservering' wordt gezocht naar reserveringen met status O (ontvangen) en waarvan de klant het bericht via een formulier wil ontvangen. Tijdens het verzamelproces wordt in de tabel 'Berichten' een regel geschreven met status 0 (null) en vorm F.

Via de client > berichten > printklaar maken >printen worden de reserveringsberichten afgedrukt en wijzigt de status van het bericht van 0 naar B (bericht). Tegelijkertijd wordt ook de status van de reservering gewijzigd naar Bericht.

De verslaglegging is terug te vinden in het dashboard.

LNRFINHER - verzamelaar voor financiele herinnering (PFA)

Deze job verzamelt eens per 24 uur de actoren waarbij de financiële posten aan de volgende voorwaarde voldoen;

Max. rood-staan bedrag is bijna bereikt (volgens instellingen in abonnement_definities).
De termijn van ouderdom in dagen van de een openstaande post is over 5 dagen in zicht.

NOTVZM - verzamelaar

Deze job wordt eens per 24 uur automatisch gestart en verzamelt exemplaren die via de nota-procedure zijn geselecteerd maar nog niet verwerkt. De niet verwerkte regels worden nu alsnog verwerkt en klaargezet in de functie 'printklaar maken' in de client.

Let op:
Er zijn organisaties waarvan de vestigingen de selectie van de nota's voor hun rekening nemen maar de 'centrale' de nota's verwerkt en print.
Indien de centrale de nota's ook verwerkt (groene regels verwerken) dan moet deze job op false gezet worden, hiermee wordt voorkomen dat geselecteerde regels te vroeg worden verwerkt.

Job NOTVZM op false zetten:
etc/bwise/bxmas/bwise.properties

De verslaglegging is terug te vinden in het dashboard.

PUBVZM - publieksberichten-verzamelaar

Deze job is permanent actief. Via deze job worden de publieksberichten naar klanten verzonden. Er zijn diverse publieksberichten, zoals bevestiging na een verlenging of reservering, meldingen die voortvloeien uit de internet-inschrijfprocedure (verificatiecode, welkomstwoord), en het mailen naar de klant van ww en gebruikersnaam als de klant daar om vraagt.

Tijdens bovenstaande acties wordt een berichtregel geschreven in de tabel Berichten.

De job PUBVZM zoekt constant in deze tabel Berichten, op zoek naar berichtregels van de soort Pxx en met status 0. Zodra een regel is gevonden wordt de job doorgegeven aan de berichtenverwerker die vervolgens een mail aanmaakt die meteen wordt verzonden.

Standaard wordt in het dashboard van iedere gestarte PUBVZM job geen verslag geschreven. Dit zou heel veel regels opleveren.

VSTVZM - verzamelaar

Deze job verzamelt eens per 24 uur de berichten die de klant heeft ingebracht, een omgekeerde situatie dus. Het gaat hier om de volgende berichten:

vva: Het verzoek om aanschaf
vav: Ingediende vrije aanvraag

De job verzamelt deze regels uit de tabel Berichten, maakt de berichten op en verstuurt ze naar het e-mailadres dat opgegeven is op tabblad 'naw' van de vestiging.

TIP: voor vestigingsberichten bestaat de mogelijkheid om deze op een afwijkend e-mailadres binnen te laten komen. In te stellen op het tabblad NAW van de vestiging.

In het dashboard wordt van iedere gestarte VSTVZM job een verslag geschreven.

MAILER

Zodra de opgemaakte berichten verzonden moeten worden, wordt de MAILER actief. De MAILER geeft de opgemaakte berichten door aan de lokale mailserver die vervolgens de berichten verzendt.

Per organisatie kan de inrichting van bovenstaande anders zijn.

SMS

Zodra de opgemaakte berichten verzonden moeten worden, wordt de SMS job actief. De SMS job geeft de opgemaakte berichten door aan de provider die de sms-jes verzendt, bijvoorbeeld smshosting.nl

Per organisatie kan de inrichting van bovenstaande anders zijn.