Doorgaan naar hoofdcontent

 

OCLC Wise Support NL

Stappenplan Single Identity

In de voorbereiding op de implementatie van Single Identity zijn er een aantal stappen die je volgt, van het configureren van de Wisecat+, tot het activeren van Single Identity voor je instantie.

image (1).png

Concreet gaat het om de volgende stappen (per instantie):

  1. Configuratie nieuwe Wisecat+, zoals de gewenste styling en menu-items    
  2. Rechten koppelen
  3. Activeren nieuwe Wisecat+  
  4. Migreren klanten
  5. Activeren inloggen via Inlogaccount en ondersteuning van Single Identity via de Wise Client
  6. Opruimen van het systeem

(  als de instantie een Joomla website gebruikt, kijk je voor deze stap in handleiding Joomla stappenplan). 

Voor de implementatie zijn de volgende systeemopties van belang:

Naam systeemoptie Omschrijving Functie

NLKBLOG

Gebruik inlogaccount (Single Identity)
  • Voor overstap op inloggen met inlogaccount in de Wisecat+.
  • Voegt nieuwe checkbox toe aan inschrijven via Client: 'Gebruik inlogaccount'.
  • Zorgt ervoor dat menu 'inlogaccount' zichtbaar wordt in de Klantenadministratie.

OPACCFG

Toon de Wisecat+ configuratie in de systeeminstellingen

Maakt nieuw menu-item zichtbaar: Manager > systeemWise > Wisecat+ configuratie. Voor instellen van styling en menu's.

OPACV2L

Gebruik Wisecat+ ipv oude Wise portal

Voor publiceren Wisecat+. Als deze optie aanstaat, worden gebruikers altijd geredirect naar de nieuwe Wisecat+.

ABADDON

Toon inlogaccountrechten abonnement (alleen NL)

Maakt extra menu-item beschikbaar in de Manager: Producten en diensten > Abonnementen > Abonnementsinstellingen > Inlogaccountrechten. 

Stap 1: Configuratie Wisecat+

Zet de systeemoptie OPACCFG aan op systeemniveau. Deze optie maakt een nieuw menu-item zichtbaar in de Manager: Wisecat+ configuratie.
Onder dit menu vallen de opties Wisecat+ menu en Wisecat+ styling.

Als de instantie een Joomla website gebruikt, is er een alternatieve stap voor configuratie. Deze vind je in Joomla stappenplan.

Wisecat+ menu

Via deze optie kun je per instantie je menu configureren. Als je site geen gebruik maakt van Joomla of de header URI (WaaS-Wise) integratie, kun je het standaardmenu van de Wisecat+ hier configureren. 

In het geval van Joomla wordt het menu beheerd in Joomla zelf. Bij gebruik van de header URI (WaaS-Wise) haalt een job dagelijks de xml op vanuit de header URI (zoals ingesteld bij de instantie) en wordt op basis hiervan de getoonde menustructuur bepaald. In een later stadium wordt het ook mogelijk om zelf een xml te uploaden via de Manager.

Standaardmenu
Om je standaardmenu te configureren of aan te passen:

  1. Ga naar systeemWise > Wisecat+ configuratie > Wisecat+ menu
  2. Klik op Detail bij de instantie waarvan je het menu wil veranderen of klik op Nieuw om een nieuwe regel te maken
  3. Vul bij Logo in welk logo gebruikt moet worden. Dit kan op basis van de bestandslocatie op de server of op basis van een URL
  4. Kies vervolgens bij Menu configuratie welke menu-items getoond moeten worden en welke niet

clipboard_e9631756bf4c917fe5ed895473bb77551.png

Wisecat+ styling

Stel hier per instantie het gewenste Wisecat+ thema in. Het thema bepaalt welk kleurenschema gebruik wordt in de Wisecat+, hoe de knoppen, tekst en headers eruitzien etc.
Er zijn twee standaardthema's beschikbaar:

  • Koninklijk oranje: dit thema matcht met de huidige landelijke huisstijl
  • Presidentieel blauw: dit thema voldoet aan alle toegankelijkheidseisen voor een website

Daarnaast is het ook mogelijk om een volledig aangepast thema te gebruiken.

Om het thema in te stellen of aan te passen:

  1. Ga naar systeemWise > Wisecat+ configuratie > Wisecat+ styling
  2. Klik op Detail bij de instantie waarvan je het thema wil veranderen of klik op Nieuw om een nieuwe regel te maken
  3. Selecteer het gewenste thema uit het drop-downmenu. 
  4. Plak – afhankelijk van het gekozen thema – de gewenste CSS in de velden Aangepaste CSS en/of Aanvullende CSS

clipboard_e66cb8c0b06a0019834f77b6a537fa2d1.png

Aangepaste CSS
Kies je voor een volledig aangepast thema? Plak dan de gewenste CSS-styling, bijvoorbeeld een bootstrap-thema, in het veld 'Aangepaste CSS'. Dit veld is niet beschikbaar bij keuze voor één van de standaardthema's.

Aanvullende CSS
Gebruik dit veld als in aanvulling op je thema, bijvoorbeeld om één of enkele html-elementen te stylen. Dit veld kan bij alle thema's (standaard en aangepast) gebruikt worden.

Demopagina
Om te kunnen controleren hoe de nieuwe Wisecat+ eruitziet voordat deze gepubliceerd wordt, is er een demopagina beschikbaar. Op deze pagina vind je alle basiselementen van de Wisecat+ in het thema van de geselecteerde instantie.
Klik op de link om de pagina te openen.

Demopagina.png

  Voor meer informatie over aangepaste/aanvullende CSS-styling:

Styling CGI pagina's

Omdat een aantal pagina's in de Wisecat+ zijn 'gewrapped' en nog niet herschreven in Angular, wordt de opmaak van deze pagina's niet beïnvloed door de Wisecat+ styling. Om de styling van deze CGI pagina's in te stellen volg je deze stappen: 

  1. Ga naar systeemWise > Marketing > Thema kiezer.
  2. Klik op Nieuw en kies de juiste instantie.
  3. Kies een thema (hetzelfde thema als die je hebt gekozen bij de Wisecat+ styling).
  4. Klik op Ok.

Deze extra stap is nog nodig totdat alle CGI pagina's zijn herschreven naar Angular. 

Stap 2: Koppelen inlogaccountrechten per abonnement

Of een actor met een bepaald abonnement toegang heeft tot de Online Bibliotheek en wat hij/zij hier precies mag (aantal uitleningen etc.) is op dit moment vastgelegd aan de kant van de KB in de zogenaamde G!ds.

Met de overgang naar Single Identity worden deze rechten ondergebracht in Wise zelf. Dit gebeurt aan de hand van de inlogaccountrechten. Deze stel je als volgt in:

  1. Activeer systeemoptie ABADDON, zodat de nieuwe menu-ingang 'Inlogaccountrechten' zichtbaar wordt.
  2. Ga naar Producten en diensten > Abonnementen > Abonnementsinstellingen > Inlogaccountrechten.
  3. Klik op 'Open' naast een bestaande instantie.
  4. Klik op 'Detail' bij het betreffende abonnement.
  5. Klik op 'Wijzigen' onderaan het scherm en wijzig de rechten van het abonnement.
  6. Klik op 'OK' om de wijzigingen op te slaan.

Inlogaccountrechten nieuw.png

Job: wijzigingen aan inlogaccountrechten worden opgepakt door de job add-actor-rights-to-av. Deze job wordt ingeschoten voor de combinatie van instantie- en abonnementsnummer en wordt 24 uur na de wijziging uitgevoerd. De job verzamelt alle actoren met dezelfde combinatie van instantie- en abonnementnummer en zet ze klaar voor synchronisatie. De job authorize-actors-to-av synchroniseert vervolgens de nieuwe rechten met de KB. Zie ook hieronder bij Stap 4: Starten migratie

Autorisatie-synchronisatie

Voordat klanten gebruik kunnen maken van de diensten van de Online Bibliotheek moet hun inlogaccount eerst geautoriseerd worden. Dit gebeurt aan de hand van de zogenaamde autorisatie-synchronisatie.

Dit doet de job authorize-actors-to-av. Deze job kijkt in de tabel wise2av of er regels met mutatietype = ‘A’ klaarstaan en synchroniseert de inlogaccountrechten van deze actoren met de authenticatievoorziening van de KB. De job draait elke 10 minuten.

Wijzigingen aan de inlogaccountrechten

Worden de inlogaccountrechten van een bepaald abonnement gewijzigd in de Manager? Dan wordt dit opgepakt door de job add-actor-rights-to-av. 24 uur na de wijzigingen worden alle actoren verzameld met het gewijzigde abonnement en toegevoegd aan wise2av. Zie ook Inlogaccountrechten.

Wijzigt het abonnement van een actor of wordt het abonnement opgezegd? Dan veranderen de inlogaccountrechten (mogelijk) ook. De nieuwe rechten van deze actoren worden opgehaald en klaargezet voor synchronisatie.

De job authorize-actors-to-av zal de gewijzigde rechten vervolgens synchroniseren.  

In de Client

Het is ook mogelijk om de autorisatie-synchronisatie handmatig voor een klant te starten vanuit de Klantenadministratie in de Client. Zie hiervoor Autoriseer inlogaccount.

Stap 3: Activeren Wisecat+

  Als de instantie een Joomla website gebruikt, is er een alternatieve instructie voor het activeren van de Wisecat+. Deze vind je in Stap 3 van het Joomla stappenplan.

Zodra alles naar wens is, kan de nieuwe Wisecat+ geactiveerd worden:

  1. Ga naar systeemWise > SysteemWise > Systeemopties
  2. Klik op Nieuw en kies bij Optie 'OPACV2L'
  3. Vul bij Vestiging vervolgens de instantie in waarvoor je de Wisecat+ wil activeren
  4. Kies bij Aan voor 'Ja' en klik op Ok

Stap 4: Starten migratie

Als alle voorbereidende taken afgerond zijn, kan de migratie van de klanten gestart worden. Dit gebeurt in de Manager aan de hand van een procedure:

  1. Ga naar systeemWise > Rapporten > Rapportverwerker > Tabblad Procedures.
  2. Typ ‘manager_call_fill_wise2av’ in de zoekbalk en klik op ‘Zoeken’.
  3. Klik op de procedure in de lijst.
  4. Vul vervolgens aan de rechterkant de benodigde info in:

Veld Uitleg
Parameters
  • in_instantie: vul in dit veld de instantie in waarvoor de migratie gestart moet worden.
  • send_email: vul hier '1' in om na succesvolle migratie een bevestigingsmail (inclusief gebruikersnaam) te versturen naar de klant. Geen automatische mail laten versturen? Vul dan '0' in, of laat het veld leeg.
    Klik hier om te zien hoe de bevestigingsmail eruit ziet

    [Onderwerp] Servicebericht over inloggen bij de Bibliotheek
    [Preheader] Nieuw inlogsysteem bij de Bibliotheek

    Beste {klantnaam},

    We hebben je eerder verteld dat we overstappen naar een nieuw inlogsysteem. Dat is nu gebeurd en alles is goed gegaan.

    Jouw gebruikersnaam: {gebruikersnaam}

    Wat moet ik doen?
    Het enige wat je hoeft te doen is opnieuw inloggen, via de app of [de website] van de bibliotheek.
    Gebruik je gebruikersnaam en je wachtwoord zoals altijd.

    Ben je je wachtwoord vergeten of lukt het inloggen niet met je wachtwoord?
    Geen probleem. Je kunt die eenvoudig opnieuw instellen op het nieuwe inlogscherm.

    Wil je meer weten? Ga dan naar bibliotheek.nl/hulp-bij-inloggen.
    Vragen? Bel ons gerust op [telefoonnummer vestiging] of stuur een e-mail naar [e-mailadres vestiging]. We helpen je graag!

    Met vriendelijke groet,

    Je bibliotheek [naam vestiging]

    Dit is een automatisch verstuurd bericht. Je kan hier niet op antwoorden, gebruik voor vragen het in dit bericht genoemde e-mailadres

Omschrijving Vul een omschrijving in waarmee de procedure makkelijk teruggevonden kan worden op tabblad ‘Jobs’, bijv. ‘Migratie I001’.
Periode Aan de hand van dit veld kan de migratie ingepland worden

Klik ten slotte op ‘Voeg toe’ om de procedure in de wachtrij te zetten.

De procedure verzamelt alle actoren die in aanmerking komen voor migratie en zet deze klaar in de tabel wise2av.

Welke actoren worden gemigreerd?

  • Alle actoren met een geldig abonnement (rol ABON), met uitzondering van actoren met een waarde voor rol ABON, bijv. administratieve passen (ADMI), anonieme klanten (ANON) of speciale klanten (SPEC).
  • Alle nieuwsbrief- en theaterklanten, en alle donateurs (rollen NBRF, THEA en DONA)
  • Actoren zonder geldig abonnement, maar:
    • met openstaande financiële posten;
    • met uitgeleende items thuis; 
    • niet geregistreerd als overleden.

Wat wordt er precies gemigreerd?  

  • Gebruikersnaam
  • E-mailadres (indien bekend)
  • Instantienummer
  • ISIL-code Bibliotheek
  • Encrypted wachtwoord

Nadat alle actoren klaargezet zijn in tabel wise2av worden ze gemigreerd door de job migrate-actor-to-av.

 Let op: deze job draait pas nadat de nieuwe Wisecat+ in gebruik genomen is door de systeemoptie OPACV2L op ‘Ja’ te zetten voor de instantie.

De job controleert of er actoren klaarstaan om te migreren. Zijn er actoren om te migreren? Dan draait de job elke vijf minuten. Vindt de job geen actoren (meer) om te migreren? Dan wordt de job automatisch voor twee uur later opnieuw ingepland.

Is een actor succesvol gemigreerd? Dan wordt het aangemaakte inlogaccount gekoppeld aan de actor en toegevoegd aan de tabel actor_auth_middel. Ook wordt voor de actor door dezelfde job een nieuw record klaargezet in wise2av om de inlogaccountrechten te synchroniseren. Zie ook Autorisatie-synchronisatie.

Rapportage

Om de migratie te kunnen monitoren zijn er drie rapporten beschikbaar in de Manager: Single Identity Migratie Voortgang, Single Identity Migratie E-mail en Single Identity Migratie Adres. Je vindt de rapporten via systeemWise > Rapporten > Rapportverwerker > Tabblad Rapporten.

Daarnaast kunnen de rapporten ook via een procedure opgevraagd en ingepland worden via tabblad Procedures.

Naam rapport

Functie

Procedure

Single Identity Migratie Voortgang

Overzicht status migratie, met daarin:

  • Totaal te migreren actoren voor deze instantie
  • Totaal gemigreerd
  • Nog te migreren
  • Percentage gemigreerd
  • Percentage gefaald
  • Percentage gemaild

Single_identity_migration_progress

Single Identity Migratie E-mail

Overzicht van alle gemigreerde actoren mét e-mailadres en de gebruikersnaam

Single_identity_migration_email

Single Identity Migratie

Overzicht van alle gemigreerde actoren met een adres, maar waarvan geen e-mailadres bekend is (maar wel een gebruikersnaam)

Single_identity_migration_address

Nieuwe inschrijvingen tijdens migratie

Het kan voorkomen dat nieuwe klanten zich inschrijven tijdens de migratie. Deze klanten hebben nog geen inlogaccount en zullen dus ook gemigreerd moeten worden.
Daarom wordt er bij nieuwe inschrijvingen gecontroleerd of de migratieprocedure voor deze instantie gestart is. Zo ja, dan wordt de nieuwe actor toegevoegd aan de wachtrij in wise2av. Dit proces draait totdat de systeemoptie NLKBLOG geactiveerd is.

Stap 5: Neem Single Identity in gebruik

Zet de systeemoptie NLKBLOG op basis van de instantie die gemigreerd is. Nadat je de systeemoptie aangezet hebt, schoon dan de VarCache op voor dezelfde instantie via systeemWise > SysteemWise > VarCache opschonen.

Hierna kunnen klanten met de KB-bekende gegevens inloggen in de online omgevingen.

Clients herstarten

Als de systeemoptie aanstaat moeten alle Clients herstart worden. Pas na een herstart kunnen nieuwe klanten met een Inlogaccount ingeschreven worden, en kunnen bibliotheekmedewerkers gemigreerde klanten helpen aan de balie als er vragen zijn. Om bibliotheekmedewerkers te herinneren dat de Client herstart moet worden, kun je de ‘Wise systeem notificaties’ functionaliteit gebruiken. Deze is te vinden in de Manager onder systeemWise > Wise > Wise systeem notificaties. Hier kan je instellen dat er per instantie een systeemnotificatie naar de Clients verstuurd wordt.

clipboard_edc51b61cfe24391615ec34b4c89cd04c.png

Vul in dit scherm de velden in:

  • Notificatie: het bericht dat je wilt tonen in de Client na inloggen
  • Scope: de instantie waar je wilt dat deze notificaties worden getoond
  • Datum en tijd: de tijdsspanne waarin je wilt dat de notificatie wordt getoond

Zorg er verder voor dat je in de Client configuratie (Vestigingsbeheer > Werkplekbeheer > Configuratie > Voorkeruen) de Systeemmeldingen correct hebt geconfigureerd:

clipboard_e79fe5e84a4cad8fc0b0f578991d6ff04.png

Als dit allemaal is ingesteld, krijgt de baliemedewerker meteen na het inloggen een pop-up te zien met de ingestelde notificatie.

Stap 6: Opruimen van het systeem

Als het hele systeem gemigreerd is, verwijder je alle procedures die je hebt geactiveerd in de Manager bij systeemWise > Rapporten > Rapportenverwerker > Jobs.

Aanvullende acties bij gebruik Argos

Zodra systeemoptie NLKBLOG geactiveerd wordt, verandert ook een aantal zaken voor Argos.

Inschrijven nieuwe Argos-klanten 

Bij inschrijven van ARGOS-klanten wordt niet langer een wachtwoord gegenereerd, maar een PIN-code:

clipboard_eb8a5fac669efec792fb990380870f289.png

Inloggen op werkstations  

Inloggen op werkstations kan alleen nog met pasnummer/gebruikersnaam en PIN-code.

 Let op: de getoonde schermteksten worden niet automatisch aangepast, waardoor hier nog om een wachtwoord gevraagd wordt. 

Om dit aan te passen: 

  1. Open Manager > Wise > Baliebeheer > Publieksbalie > Argos werkplekbeheer > Argos schermteksten
  2. Zoek de volgende teksten op: panel.login.label.patron.password en panel.login.tooltip.patron.password
  3. Verander 'Wachtwoord'  naar 'PIN' .

 

  • Was dit artikel nuttig?