Inbox- en pushberichten

In bwise.config

De job PUSH verzendt berichten naar de Wise-app voor mobiele apparaten. De berichten worden verstuurd naar de wise4all-server waar ze verder worden afgehandeld (doorgestuurd naar de actor). De wise4all is gecertificeerd om mobiele apparaten te benaderen. In de configuratie bwise.config(*) moet de url naar de wise4all zijn opgenomen als:

w4a.baseurl=https://w4a.bicat.com

Dit is als default in code opgenomen.
Verder is op de wise4all nog een script (pep.pl) opgenomen om vanuit productie te pushen.
(*) Van bxmas, dit is het configuratiebestand in de map /etc/bwise/bxmas/bwise.conf.

In bwise.properties: schakelaar push AANzetten

• 'Gevaarlijke' jobs hebben een soort 'schakelaar' waarmee ze wel/niet actief worden gezet. Jobs (bijv. de mailer) staan standaard op NIET-actief. Deze worden op een productiesysteem alleen geactiveerd door een schakelaar 'aan' te zetten in het bestand bwise.properties (bwise.config van bxmas >> dit is het configuratiebestand in de map /etc/bwise/bxmas/bwise.conf).
• De aanpassing is actief nadat tomcat is herstart. Let op! Evt. pushberichten die al klaar staan, vliegen dan ook direct de deur uit. Is dit niet gewenst, dan deze jobs verwijderen alvorens de de schakelaar wordt aangezet!
• Om te voorkomen dat ook vanaf teststystemen gepusht wordt, staat de pushjob nu standaard NIET-actief en moet, daar waar van toepassing, de schakelaar worden AANgezet: d.i. push.runPush=true.

Stuurregels inbox- annex pushberichten

Instellen via SysteemWise > Berichten > SysteemTabel.

• Prefix: hier GEEN slash (/) gebruiken! Een naam met een / wordt gezien als een map met een submap – waardoor er niet gepusht kan worden.
• Device: 'nopnop' is goed, er wordt immers geen device gebruikt.
• Verzamel en Vestgroep: op de afbeelding staan deze ingevuld, maar dat hoeft niet als de organisatie dit niet gebruikt.

Hier hoeft geen volgjob (de keuze was tot dan toe: PUSHER) meer ingesteld te worden. Dit wordt nu 'onder water' geregeld.

Soorten om voor in te stellen:

Teksten inbox- annex pushberichten

Instellen via SysteemWise > Berichten > Teksten.

• Tekstregel nummer 1 is het onderwerp (en de onderwerpsregel in de mail) voor de inboxberichten. Daarnaast kunnen aanvullende regels met aanhef (2), de feitelijke melding (3), een tekst als “Wij verzoeken u ... + ophalen bij xxx” etc. (4) alsmede een toelichting al dan niet met URL (5) worden opgenomen.
• De ophaallocatie in het bericht wordt, net als bij bijv. de mailberichten, gehaald uit de Vestigingstabel (uit veld naam op Tabblad NAW).
• Een evt. URL moet op dezelfde manier worden opgebouwd als in bijv. de mailberichten, dus bijv.: Wilt u de materialen langer houden? Ga dan naar onze @@SITE@@URLhttp://www.debibliotheekabcdef.nl...RL@@website@@@ om te verlengen.

Een evt. aanwezige link opent naar een externe browser ('open in new window') zodat de gebruiker niet per ongeluk de app zal verlaten. I.g.v. iOS wordt gemeld (zie afbeelding) dat er op een externe link is geklikt. De gebruiker moet dit bevestigen om verder te kunnen:

Teksten pushes gaan via stylesheet

De tekst voor de push die achter het inboxbericht aan komt, is maar kort: één regel met daarin de aantallen (exemplaren, reserveringen). De aantallen (+ enkelvoud, meervoud) worden door het systeem ingevuld. De tekst voor de push komt uit de stylesheet push.xsl. Deze stylesheet wordt standaard meegeleverd en kan NIET worden gewijzigd. Pushteksten mogen niet worden gewijzigd omdat een andere samenstelling mogelijk niet geaccepteerd wordt door Apple en/of Android. Een pushbericht is vluchtig. Of een push wel/niet geaccepteerd wordt, wordt niet teruggemeld. Ook is er een kans dat gebruikers nooit pushberichten ontvangen.

Een paar aandachtspunten:

1. Een device (iOS, android) MOET zijn aangemeld.
2. Alleen aangemelde gebruikers kunnen pushberichten ontvangen + androids kunnen meerdere opgeslagen profielen hebben > maar dat zegt nog niet dat al die profielen zijn aangemeld
3. Iemand die de app al open heeft staan, zal geen push ontvangen – hij hoeft immers niet meer naar de app gedirigeerd te worden.

Vooralsnog worden alleen pushes verzonden voor RSO, IV1, HR1 en PIW (zie PIW: Publieksmelding-inbox-welkom). Als het systeem heeft gepusht, wordt dat direct opgeruimd. Alleen als er 'iets' in het pushproces niet goed is afgehandeld, wordt in het dashboard in het joboverzicht 'PUSH' vermeld.

De tekst HR1 is: Herinnering: de uitleentermijn van xx exemplaar is verstreken.

PIW: Publieksmelding-inbox-welkom

Een PIW is een welkomstbericht (publieksmelding-inbox-welkom, naar inbox gevolgd door push) dat wordt verzonden wanneer voor het eerst pushberichten op een app worden geconfigureerd.

PAI: Ongelezen berichten in de inbox

Is een inboxbericht na 5 dagen nog niet door de klant geopend, dan gaat er – mits een e-mailadres of sms-nummer bekend is – een mail of sms naar de klant met daarin de attendering dat er ongelezen berichten in de inbox aanwezig zijn.

Hiervoor wordt berichtsoort PAI gebruikt. Is van de klant geen mailadres of sms-nummer bekend, dan wordt er geen actie ondernomen (geen logging).

PRA: Publieksbericht Reservering Annulering

Het is mogelijk om bij de reserveerinstellingen per RMT een termijn in te voeren waarna een reservering moet komen te vervallen. Bij het vervallen van de reservering wordt archiefreden 7 gezet.
Bij het handmatig verwijderen van een reservering wordt archiefreden 9 gezet.
De klant wiens reservering op deze manier is geannuleerd of komen te vervallen krijgt hiervan een PRA-bericht in zijn inbox of e-mail.

Berichtvoorkeuren aanpassen

Om voortaan inbox- en pushberichten te kunnen ontvangen, moet een klant zijn berichtvoorkeuren (laten) aanpassen. Dit kan via de:

• App: inloggen > Instellingen > Berichtvoorkeuren (met keuze)
• Wisecat+: inloggen > Mijn Menu > Berichtvoorkeuren
• Client: Klantenadministratie > Klant > Tabblad 7. Eigenschappen-2 > Berichtvoorkeuren.

Als pusberichten worden aangeboden, heeft de klant de ook de mogelijkheid om 'Mail + Inbox' te kiezen.

iOS: pushberichten laten toestaan

• In het device moet bij de eerste keer starten van de app de melding: 'Bibliotheek Wise wil u pushberichten sturen' met een OK worden bevestigd. Vervolgens staat in het berichtencentrum dat pushberichten zijn toegestaan.
• Wanneer een klant bij deze melding op 'Sta niet toe' heeft geklikt, kan het device geen pushberichten ontvangen.
• Wil de klant alsnog pushberichten ontvangen, dan moet de app worden gedeïnstalleerd, en minstens een dag later opnieuw worden geïnstalleerd.

Na installatie zal de eerste keer bij het starten van de app de melding '… wil u pushberichten sturen' wederom worden getoond. Bevestig met een OK (!). Instellingen (bijv. inloggegevens en ingestelde machtigingen) blijven bewaard – deze zijn immers opgeslagen binnen Wise en niet op het device!

Voorbeeldtekst

Hieronder een voorbeeldtekst, vrij te gebruiken, met in ieder geval de elementen waarover de klanten geïnformeerd moeten/kunnen worden.

Nieuwe service
Kies voor inbox- en pushberichten!
Let op: stel uw berichtvoorkeuren goed in

Beste app-gebruiker, geachte mevrouw of mijnheer #naam#,

Nieuwe gratis service
U heeft nu enige tijd de Bibliotheek Wise app in gebruik, waarmee u o.a. kunt zoeken, verlengen en reserveren in de bibliotheekcatalogus.

Sinds kort heeft de bibliotheek een nieuwe service voor u: de inbox- en pushberichten. Dit betekent dat u ervoor kunt kiezen om voortaan uw ***reserveringsophaalberichten ('Er staat een reservering voor u klaar') en ****inleverattenties ('De uitleentermijn van de door u geleende materialen loopt binnen een aantal dagen af ...') niet meer ***alleen via de mail maar rechtstreeks in uw inbox en als pushbericht kunt ontvangen.

Berichtvoorkeuren veranderen
Wilt u hier ook gebruik van maken? Pas dan uw berichtvoorkeuren aan, dit gaat als volgt:

1. Ga in de app in het menu naar Instellingen > Berichtvoorkeuren.
2. Geef uw keuze (schuifje) aan bij de verschillende berichten.
3. Sla de wijzigingen op.

Voortaan ontvangt u dan pushberichten en staan er berichten in de inbox van de Bibliotheek Wise App. *** Heeft u ook voor mail gekozen, dan ontvangt u uw berichten ook nog eens via de mail.

Toestemming geven
Om deze pushberichten te kunnen ontvangen moet u wel AANGEMELD blijven in de Bibliotheek Wise App. Belangrijk: klik dus NIET op de knop 'Afmelden'! Ook moet u toestaan dat de app u pushberichten mag sturen. Heeft u dit bij de eerste installatie afgewezen, dan dient u de app te de-installeren en een dag later opnieuw te installeren.

Via de nieuwsbriefmodule?

Wanneer u de nieuwsbriefmodule van Wise gebruikt, kunt u eventueel onderstaande truc gebruiken.

• Maak via Statistieken en Selecties 'zo maar' een set aan. Of gebruik een oude bestaande set.
• Noteer het set-id: in dit voorbeeld is 12345 gebruikt.
• Verwjder via de MySql querybrowser de regels uit deze set: delete from set_regels where set_id=12345;
  Hierbij is '12345' het genoteerde set-id.
• Vervolgens met onderstaande query alle aangemelde appgebruikers met een mailadres selecteren en die met één beweging in set met set-id '12345' zetten:
  insert into set_regels (ent_id,sort,set_id);
  select distinct(x.actor_id) ent_id,func_bx_naam_actor(x.actor_id,'A') sort, 12345 as set_id from (select u.actor_id,e.e_adres from actor_app_usage u left join actor_e_adres e on u.actor_id=e.actor_id and e.soort='EML') x where !isnull(x.e_adres);
• De set staat nu klaar. Daarna kan de nieuwsbrief worden aangemaakt en opgemaakt, en verzonden m.b.v. set- id '12345'.

Bij innemen melding op scherm en bon

Bij het innemen van exemplaren waarvan blijkt dat die op de reserveringsplank moeten komen, wordt gemeld dat een reserveringsophaalbericht via de inbox (annex push) wordt verzonden. Hetzelfde wordt ook op de reserveringsbon vermeld.

Verzonden berichten bij klant

Welke (inbox)berichten zijn verzonden, is in de klantenadministratie te zien via > klant opzoeken > Klant > Klantberichten > sorteren op Vorm.
NB Via selecties kan op berichtsoort worden gesorteerd

Omzetten van de berichtvoorkeuren volgen

Via rol_bpref is te achterhalen welke afwijkende voorkeuren (= afwijkend van de standaardinstelling) de klanten hebben ingesteld: SELECT * FROM rol_bpref r;
Met onderstaande query is desgewenst te monitoren of klanten hun berichtvoorkeuren ook omzetten.

Inleverattenties:
SELECT * FROM rol_bpref r where berichtfunctie='IV1' and berichtvorm='I';

Reserveringsophaalberichten:
SELECT * FROM rol_bpref r where berichtfunctie='RSO' and berichtvorm='I';

Aantallen berichten checken

select * from berichten b where vorm='I' and soort='RSO';
select * from berichten b where vorm='I' and soort='IV1';

SELECT * FROM local_inbox l where soort='RSO';
SELECT * FROM local_inbox l where soort='IV1';

Device aangesloten: actor_app_usage

• De actoren die inbox- en pushberichten willen ontvangen op hun devices, moeten voorkomen in de tabel actor_app_usage. Deze tabel bevat actoren met één of meer actieve mobiele apparaten en de gegevens van deze apparaten. Een actor wordt opgeslagen in deze tabel op het moment dat de actor zich aanmeldt via de Bibliotheek App van Wise.
• Als een inboxbericht wordt gevolgd door een pushbericht dan wordt geprobeerd om alle inboxberichten te 'pushen'. M.a.w. de pushjob controleert of de actor van het bericht ook is aangemeld voor de app.
• Actoren die géén gebruik maken van de app worden opgenomen in het jobverslag.

Overzicht pushberichten

In de client kan een overzicht pushberichten worden gemaakt via Berichten > Overzichten > Overzicht pushberichten. Het pushen van berichten is te beschouwen als een 'bezorgdienst' van het bijbehorende inboxbericht; pushen is te vergelijken met de mailer. Van deze 'bezorgdiensten worden verder GEEN tellingen bijgehouden, slechts logregels. De logregels worden opgeslagen met een uniek id [vestiging-jaar-dagnummer]. Deze logregels kunnen nu met dit overzicht worden opgevraagd in rapportvorm zoals dat al kon via het dashboard.

Verslag over pushberichten worden opgeslagen met een id als push-[vestiging]-[jaar][dagnummer][volgnummer]. Via de querybrowser kan het bijv. als volgt worden opgevraagd: SELECT * from bcbirt where pid rlike '^push-....-16076+';
Daarbij is '16' het jaar en '76' is dag 76 = 16 maart (in 2016).

Een periode wordt genoteerd als '^push-....-16032+|^push-....-16060+';
In dit geval dag 32 t/m dag 60, oftewel 1 februari t/m 29 februari.

Bij het opvragen van het rapport wordt de ingevulde periode omgezet naar dagummers m.b.v. de kalendercomponent. Als dit niet lukt dan wordt het huidige jaar weergegeven.

In het rapport wordt per vestiging per dag o.a. het aantal inboxregels getoond met daaronder de geslaagde pushes binnen die set van berichten. Per push is vermeld naar welk device van welke actor. Daaraan is af te lezen of het pushen naar behoren werkt. Onderin het overzicht wordt overigens een aantal vermeld: dat is niet het aantal pushes, maar het aantal gebruikte regels in het overzicht (!).