Sist oppdatert for: ingest Ingest 1.5359
Asta ingest er et verktøy som eksporterer data fra Asta5 til Asta7. Verktøyet kan hente ut arkivenheter, magasinstruktur, bestillinger (best å gjøre i én operasjon) og filer i hele baser, eller eksportere ut enkeltarkiver.
...
Ingest krever java 17 eller nyere. Dersom en annen versjon av java ligger i java path, må det spesifiseres at ingest skal kjøre i en annen versjon av java som er installert (serun.sh ).
Legg godt merke til tekst merket med rødt!
Innhold
Ingest kommer i en .zip-fil som inneholder:
...
Linje 13 er databasens adresse – kan slås opp i fila \ASTA5\jboss-as-7.2.0.Final\standalone\configuration\standalone-full.xml (NB! i denne fila vil databasenavnet alltid stå med : foran)
...
Hvis basen er en multitenant, bruk : i stedet for / før databasenavnet i application.yml
...
er arkivenheter på alle nivåer av strukturen (innhold i tabellen ARKIVENHET i Asta5)
...
Archive units må være på for at repository og requisition skal kunne hente ut noe data (grensesnittet tillater at kun repository er skrudd på, men den vil da hente ut tomme XML-filer. Se repository.)
...
Asta5 institute lar deg sortere ut innholdet fra én av depotinstitusjonene som finnes i basen.
Dersom Archive units er på, og feltet Archive Identifiers er tom, vil Ingest hente ut alle arkivene i basen.
Dersom det fylles inn gyldige identifikatorer i Archive Identifiers, vil Ingest kun hente ut disse. Det må trykkes enter for å legge til en identifikator, slik at det blir en liten boks:
...
NB! – Ingest validerer ikke disse, så identifikatorer som ikke finnes i basen vil fremdeles eksporteres, men da som tomme XML-filer.
Ved eksportering av enkeltarkiver, må modusen Single Archive benyttes. Enkeltarkiver mangler en referanse til rotnode dersom dette gjøres med Archive units-eksport.
Prepend Institute ID with Archive Identifier legger til depotinstitusjonsID som prefiks på arkivenes identifikator. Arkiv A-1000 i depotinstitusjon ASTA blir da til ASTA-A-1000. Dette er primært for institusjoner som har operert med flere separate depotinstitusjoner i basen, og skal samle innholdet i én base.
...
henter ut bestillinger og aktiverer de samme tilleggsfeltene som repository, men krever ikke at disse er fylt ut for å starte eksporten.
...
Dersom Archive Units ikke er på, vil ikke Requisition kunne skrus på.
XML-filene for bestillinger havner i mappe data\requisition i datapakken.
...
Vinduet viser prosentvis fremgang, antall eksporterte arkivenheter og totalt antall arkivenheter som eksporteres, samt tidsbruk. Eventuelle feilmeldinger listes opp under Failures. (Antallet opplistede feil vil ikke alltid samsvare med telleverket her)
Nedlastingsknappen til høyre kopierer alle feilmeldingene til utklippstavle.
...
Kritiske feil
(Introdusert i versjon 1.58)
Dersom ingest oppdager problemer med dataintegriteten som vil forhindre import til Asta7, vil den stanse importen og gi en feilmelding med en forklaring og noen ganger en SQL-spørring for å finne problemet i Oracle-basen. Eksempler på ting ingest sjekker er:
Leading og trailing zeros
Padded whitespacing
Inkonsistens mellom hyller og lagringsenheter
Orphans eller referanser til slettede rader
Feil antall sifre og feil datatype i hylleid, fagid og reolid
Merk at noen problemer kan være så like at de utløser en bestemt feilmelding, men at feilmeldingens spørring ikke finner noen rader i databasen. Ved slike tilfeller kreves en grundigere undersøkelse av hva som er galt med datasettet. Ingest kan ikke utvikles til å kjenne igjen og løse alle typer problemer, men de som oftest dukker opp kan tas hensyn til.
Eksportfil
Når eksport er ferdig, sendes nedlastingsfil med navnet asta7-data.zip til nedlastingsmappenedlastingsmappa. Hvis eksporten er veldig stor, kan det hende det tar veldig lang tid å få fila sendt til nedlastinger. Den kan da hentes manuelt i temp-mappe for den brukeren man er logget inn som:
...
Filnavnet er en streng på 18 forskjellige tall:
...
Fila inneholder mapper med XML-filer avhengig av hvilke moduser man har aktivert:
...
XML-filene importeres inn i et prosjekt med sys-admin bruker.
Import til Asta7
Installer siste versjon av Asta 7
Laste opp siste eksport av alt fra Asta 5 til Asta 7 instansen (på Docker vertsmaskin)
Endre passord på sys_admin og admin
Slette testbruker
Rotere nøkler
Endre app secrets
Legge inn rett URL for redirects
Omstart for å oppdatere secrets
Legge inn siste ISAD(G) template
Opprett organisasjon - F.eks. Min Organisasjon
Opprette isadg prosjekt og kjør init - Prosjekt navn: Min Organisasjon/isadg
Importere standard kodetabeller
Importer GUI innstillinger
Importer innhold
Legge inn tilpassede restriksjoner ved behov
Importer filer - cp fungerer ikke på stort innhold benytt - sudo rsync -avzh --inplace /data/uploads/data/digital-file/ /data/am-import-folder/am-project/isadg/hot/digital-file/
Importere bestillingshistorikk
Importere magasinstrying
Sette opp SSO