Lånerimport fra webservices

Cicero indeholder mulighed for at importere informationer om lånere tilknyttet en institution fra
udvalgte webservices.

Oplysninger om elever og ansatte opdateres periodisk med nye informationer, således at elever f.eks. automatisk flytter klasse (rykker op) i takt med, at institutionen har opdateret oplysningerne i deres webservice.

Følgende beskriver hvorledes importen håndteres:

1. For hver filial oprettes der en lånergruppe med filialens navn. Lånergruppen oprettes som
   lånergruppe under ’Alle’ hvis den ikke allerede eksisterer.
2. Under Filial oprettes der tre lånergrupper der hedder henholdsvis ”Elever”, ”Ansatte” og ”Udgået”. I disse oprettes lånergrupper på baggrund af klasseoplysninger fra infotjenesten.
   • Importen ændrer ikke i andre lånergrupper end de nævnte.
   • Importen placerer ansatte direkte i gruppen Ansatte.
   • For elever oprettes der en lånergruppe per klasse. En elev kan være med i mange grupper, men det er som udgangspunkt kun hovedgruppen, der importeres.

Cicero matcher elever og ansatte på unilogin, sekundært på cpr-nummer, og til sidst matches på navn og
alle adresse-felter. Lånere (elever) placeres i de grupper der oprettes på baggrund af oplysningerne fra
infotjenesten. Hvis Cicero ikke kan finde låneren i systemet, vil låneren blive oprettet.

Elever vil således efter importen kunne findes i lånergrupper af denne form:

• Alle >Brædstrup Skole > Elever >6b

Første gang en import udføres, kan der potentielt set oprettes dubletter af lånergrupper, da strukturen fra
konvertering fra det eksisterende system ikke nødvendigvis stemmer overens med strukturen der læses
fra låner import webservicen. Importen bevarer både den originale struktur samt den importerede,
såfremt de ikke overlapper. Lånerne vil tilhøre begge lånergrupper. Hvis skolen er tilfreds med den
importerede struktur kan de gamle lånergrupper slettes.

Hvis flere filialer har samme institutionsnummer, vil klasserne blive oprettet på begge filialer, og dermed
vil lånerne være tilknyttet klassen på begge filialer. Det ses typisk i forbindelse med administrative
sammenlægning af skoler.

Konfiguration af import lånerdata fra webservice

Det er muligt at konfigurere hvilke data man ønsker at få importeret, via enten UNI*C, UC låner import
service, TIETO/IST eller CSV fil. Dette gøres via admin -->Generelle indstillinger -->Låner --> Import låner
regler.

Konfigurationen er lavet som XML syntaks og ser som udgangspunkt ud som følger:

<ImportLoanerConfiguration>
         <Service>


        </Service>


        <DataToImport>
                  <BirthDate>true</BirthDate>
                  <CPR>true</CPR>
                  <Address>true</Address>
                  <Email>true</Email>
                  <Phone>true</Phone>
                  <AllGroups>false</AllGroups>
                  <Guardian>true</Guardian>

                  </DataToImport>


                 <OverwritePhoneNumbers>false</OverwritePhoneNumbers>
                 <OverwriteEmails>false</OverwriteEmails>
                 <OverwritePickupBranch>true</OverwritePickupBranch>


    <EnableNotificationOnDataUpdate>
                 <SMS>false</SMS>
                 <Email>false</Email>
                 <DigitalPost>false</DigitalPost>
  </EnableNotificationOnDataUpdate>


                <UseCPRasUserId>false</UseCPRasUserId>
                <NotifyNewPatron>false</NotifyNewPatron>


</ImportLoanerConfiguration>

Det er vigtigt at den tekst, som står imellem ’< >’ ikke ændres og at der kun kan angives ”true” eller
”false”, afhængigt af om man vil aktivere eller deaktivere import af det pågældende felt.

• <BirthDate> hvis denne er false, indsættes/opdateres fødselsdato ikke
• <CPR> hvis denne sættes til false, vil CPR-feltet være tomt ved oprettelse af ny låner, og feltet
  opdateres ikke ved eksisterende lånere. CPR numre i de importerede data vil blive anvendt til at
  matche eksisterende lånere uanset denne indstilling.
• <Address> hvis denne er false, opdateres feltet ikke.
• <Email> hvis denne er false, indsættes/opdateres email-adresse ikke.
• <Phone> hvis denne er false, indsættes/opdateres telefonnummer ikke.
• <AllGroups>
  o Den er som udgangspunkt deaktiveret (false)
  o Ved import fra UNI*C og TIETO/IST gælder at hvis parameteren står til false vil kun
  hovedgruppen blive importeret. Det er typisk elevens klasse. Sættes den til true, vil alle
  grupper tilknyttet en låner fra UNI*C eller TIETO/IST blive importeret. Dette inkluderer
  ofte en masse faggrupper.
• <Guardian> dette er kun relevant ved import fra UNI*C, TIETO og IST. Hvis denne sættes til
  true, eller ikke er sat, vil økonomisk ansvarlige blive importeret på lånere. Hvis den er false,
  importeres de ikke. Er som udgangspunkt aktiveret.
• <OverwritePhoneNumbers> hvis denne er true vil eksisterende telefonnumre blive
  overskrevet/slettet.
• <OverwriteEmails> hvis denne er true vil eksisterende emails blive overskrevet/slettet.
• <OverwritePickupBranch> hvis denne er true vil lånernes tilhørsfilial blive overskrevet.
• <EnableNotificationOnDataUpdate><SMS> hvis denne er true vil der blive aktiveret SMS
  notifikationer for det importerede mobilnummer, hvis låneren ikke allerede har et mobilnummer
  til notifikationer.
• <EnableNotificationOnDataUpdate><Email> hvis denne er true vil der blive aktiveret email
  notifikationer for den importerede email, hvis låneren ikke allerede har en email til notifikationer.
• <EnableNotificationOnDataUpdate><DigitalPost> hvis denne er true vil digital post
  notifikationer aktiveres for en låner hvis det er første gang låneren importeres.
• <UseCPRasUserId> hvis denne er true vil der blive oprettet et Låner-ID af typen
  ”Sundhedskort” med lånerens CPR-nummer. Dog under forudsætning af at CPR-nummer
  importeres og er til stede.
• <NotifyNewPatron> hvis denne er true vil der blive sendt 'Velkomst til nye lånere'-emails til
  lånere der oprettes af importen.

Udover at de forskellige låner import regler skal konfigureres, så skal der også konfigureres hvilken låner import webservice der skal anvendes. Cicero understøtter følgende integrationer:

• UNI-Login’s Infotjeneste (ws17)
• UC låner import service
• Tieto, IST, Schoolsoft, Feide
• CSV-filer

UNI-Login’s Infotjeneste (ws17)

Hvis der skal integreres til denne service skal der tilføjes <UNICImport/> i <Service> elementet således
at det kommer til at se ud på følgende måde:

<ImportLoanerConfiguration>
<Service>
<UNICImport/>
</Service>
…
</ImportLoanerConfiguration>

En forudsætning for en lånerimport hvor UNI-Login’s Infotjeneste anvendes er en godkendt dataaftale
mellem KOMBIT eller Systematic og den enkelte skole.

Biblioteket skal godkende ”KOMBIT A/S Infotjeneste ws17” adgang til data via https://tilslutning.stil.dk/tilslutning/.

Læs evt. mere i STIL's dokumentation eller under FBS integration to STIL Infotjenesten.

UC låner import service

Hvis der skal integreres til denne service skal der følgende i <Service> elementet:

<ImportLoanerConfiguration>
           <Service>
                    <UCImport>
                              <ServiceURL>URL</ServiceURL>
                              <UcKortNavn>name</UcKortNavn>
                              <ApiKey>key</ApiKey>
                  </UCImport>
         </Service>
…


</ImportLoanerConfiguration>

• <ServiceURL>: URL’en på UC låner import webservicen.
• <UcKortNavn>: Kort navnet på instutitionen.
• <ApiKey>: En shared secret.

Tieto, IST, Schoolsoft, Feide

Hvis der skal integreres til denne service skal der tilføjes <Import/> i <Service> elementet således at
det kommer til at se ud på følgende måde:

<ImportLoanerConfiguration>
           <Service>
                    <Import>
                   <UseImportHierarchy>true/false</UseImportHierarchy>
                   </Import>
          </Service>
…
</ImportLoanerConfiguration>

<UseImportHierarchy>:

Boolean der bestemmer, hvorvidt Ciceros lånergruppe-hieraki skal afspejle gruppehierakiet fra den eksterne datakilde. Denne er sat til ”False” som standard.

Det kan være relevant at sætte denne til ”True”, når flere skoler benytter samme bibliotek (filial). Hvis
der er flere skoler under samme filial mens booleanen er sat til ”False”, vil det ikke være muligt at se,
hvilken skole den enkelte klasse tilhører. Hvis skolerne har klasser med samme navn, så vil de blive
oprette som én klasse i Cicero. Vi anbefaler derfor, at sætte booleanen til ”True” i disse tilfælde, idet
dette vil tilføje et niveau i lånergruppe-hierakiet, som gør det muligt at skelne skolerne mellem hinanden.
Dette vil dog betyde at alle skoler får endnu et niveau – ikke kun de skoler, hvor der er flere skoler per
bibliotek (filial).

Eksempler:

False: Der oprettes en lånergruppe-hierarki i Cicero på følgende måde:
- All
        Filial A
                  ▪ Elever
                              • Klasse A
                              • Klasse B
      Filial B
                ▪ Elever
                             • Klasse A
                             • Klasse B

True: Der oprettes en lånergruppe-hierarki i Cicero på følgende måde:
- All
       Filial A
                ▪ Elever
                           • Skole A
                                        o Klasse A
                                        o Klasse B
                          • Skole B
                                       o Klasse A
                                       o Klasse B
     Filial B (Skole C)
                ▪ Elever
                           • Skole C
                                     o Klasse A
                                     o Klasse B

CSV-filer

Ved import fra CSV-filer er <Service> elementet uden betydning, og kan derfor være tomt:

<ImportLoanerConfiguration>
<Service></Service>
…
</ImportLoanerConfiguration>