Innledning
Denne integrasjonen henter oppdaterte bok-data (både tittel/forfatter og bilder) Nielsen databasen og oppdaterer informasjonen i Alma, vår bibliotek-system, via en intern AWS-api-endepunkt.
Siden antall kall til Nielsen databasen er begrenset til max 5000 vellykkede kall pr døgn og det ønskes å maksimere benyttelsen av dette, opererer vi på en liste over alle potensielle ISBN nummer som ønskes oppdatert. Listen oppdateres via en fil sync (sftp).
Nøkkel info
Initiering av flyt | Scheduler (4 ganger med noen timer mellomrom) |
|
|---|---|---|
Flyt mønster | Synkron | |
Bruk av meldingskø | Nei |
|
Open API | Nei |
|
IntArk | Nei |
|
Bakgrunn
Bibliotek data trenger visst å oppdateres. Til dette benyttes data fra Nielsen basen. Nielsen basen tillater bare ca 5000 vellykkede kall. Vi må derfor slå opp i den helt inntil vi får feilmeldingen max-limit-reached.
Interessenter
Det er bibliotek-tjenesten som er bestiller her ved Asbjørn Risan
Brukerhistorie (gjerne sekvensdiagram) ?
Hent 5000 av eldste (laveste sistOppdatert) ISBN records fra vår database
For hver av dem:
Slå opp i Nielsen basen 2 ganger, 1 gang for å hente bokdata og en gang for å hente eventuelle bilder
Hvis svar tilbake (vellykket oppslag) : Send informasjonen til AWS-Lamda endepunktet team smile har laget.
Gjenta operasjonen over 4 ganger pr natt
Hver natt, list ut filene i sftp-mappen
For hver fil:
hent filen, pakk den ut, less innholdet
For hver element (xml) i filen,
Hvis filenes navn inneholdet “new”, legg til record i databasen
Hvis filenes navn inneholdet “delete”, slett fra databasen
Systemer/tjenester/Data/API
TOBE DONE
Tilgangsstyring og logging
Integrasjonen logger til Humio med detaljert logging av prosessen. Loggene er viktige for å finne ut om antallet vellykkede kall til Nielsen basen har nådd maks grensen.
Ingen tilgangstyring er nødvendig.
Forretningsregler
Se under Brukerhistorie
Behandlingstid/responstid og volum
Volumet er begrenset/gitt av maks-grensen til Nielsen basen som igjen er begrenset av abonnemang avtalen.
Hver runde (som består av 5000 av våre ISBNer) kan ta opp til 1 time, men det er svært variert.
Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse
Hva skjer ved overload i kø?
Hva skjer med ufullstendinge meldinger?
Inneholder meldingene personopplysninger?
Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens). F.eks : Oppgavene som aldri vil publiseres, eller Oppgaver som ikke skal publiseres, publiseres.