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 (se run.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
...
Archive units er arkivenheter på alle nivåer av strukturen (innhold i tabellen ARKIVENHET i Asta5)
Archive units må være på for at repository 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.)
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, vil Ingest kun hente ut disse. Det må trykkes enter for å legge til en identifikator, slik at det blir en liten boks:
...
Ingest validerer ikke disse, så identifikatorer som ikke finnes i basen vil fremdeles eksporteres, men som XML-filer uten metadata.
NB! Ved eksportering av enkeltarkiver, må modusen Single Archive benyttes. Dette er fordi eksport av 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.
...
Files henter ut filer fra fillageret Jackrabbit-2.2. Dersom man ikke har en gyldig innlogging i application.yml, vil forsøkene på å eksportere filene få feilkode litt ulike feilkoder avhengig av hva som er feil:
401 Unauthorized from GET – Brukernavn og/eller passord er feil
No bean named 'asta5WebClient.XXX' available (der XXX er depotinstitusjonskode) – Depotinstitusjonen er feil
Hvis det er referanser filreferanser i klienten som er feil, og klienten derfor ikke finner filene, vil heller ikke Ingest kunne hente dem ut. Det vil da gi en annen feilmelding om at det ikke kan opprettes kobling, eller at det blir timeout.
Repository henter ut magasinstyringsmodulen. Den legger til feltene Organization Name, Project ID og Asta7 URL. Organization Name og Project ID må fylles ut for å starte eksporten, informasjonen i disse feltene kan overstyres i importen til Asta7. NB! Archive Units må være på for at requisition skal klare å hente ut noe data, ellers genereres det tomme XML-filer.
...
XML-filene for magasinstyringen havner i mappe data\repository i datapakken.
...
Vinduet viser prosentvis fremgang, antall eksporterte arkivenheter og totalt antall arkivenheter som eksporteres, samt tidsbruk. Eventuelle feilmeldinger listes opp under Failures. (antallet Antallet opplistede feil vil ikke alltid samsvare med telleverket her)
Nedlastingsknappen til høyre kopierer alle feilmeldingene til utklippstavle.
...