| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
Innledning
Grovt om hva denne integrasjonen er fra hvor / Til hvor?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).
| Inc drawio | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Bakgrunn
Litt om grunnen til integrasjonen. Hva for en behov dekkes av integrasjonen.
Interessenter
...
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) ?
Hvis vi har noen
Systemer/tjenester
Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?
Hvilken kø-mekanisme brukes evt.?
Om Int-ark komponenter er brukt og eventuelt hvilke deler
Data
Hvilke data utveksles? Alle attributter som utveksles?
Samhandlingsmønster
Hva driver utvekslingen? Request eller Push
Er utvekslingen synkron eller asynkron?
Om involverte API
Brukte API endepunkter
Tilgangsstyring og logging
Hva logges?
Eventuelle tilgangstyring
Forretningsregler
Forretningslogikken i integrasjonen. Feks. Bare dokumenter med status X leses etter Y antall dager osv …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
Hva er antallet meldinger pr. døgn i denne forbindelsen (Min, Avg, Max)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
...