Inge und Dimag¶
Mit Inge ist es möglich, DIMAG als Repository für die Primärdaten zu integrieren. Die originalen Dateien werden dann nicht im lokalen Filesystem von Anton, sondern in DIMAG gespeichert. Nur die Dateien, die für das Internet optimiert wurden, bleiben in Anton. Wenn nötig können interne User die originalen Dateien herunterladen. Aus Perspekitve der Nutzerinnen und Nutzer gibt es deshalb kein Unterschied.
Requirements¶
- Setting
fulltext-from-webpdf
: true - Setting
cloud
: "inge" - .env INGE_API_TOKEN
- User "Inge" with Email address and api_token for Inge
Ablauf des SIP-Ingest¶
Anton¶
- User: SIP Upload (zip) (
/sip/uploadsip
) - User: SIP Validation (
/sip/validation
)- Anton kann das SIP auspacken (unzip) und die Metadaten-Datei ist lesbar.
- Die Dateien aus dem SIP sind vorhanden und die Prüfsummen sind korrekt.
- Anton kann für jedes Dossier im SIP einen parent in Anton finden.
- User: Anton-Ingest (
/sip/ingest
)- Backup der Datenbank
- Import SIP (
<dossier>
and<dokument>
/<datei>
)- SIP Eintrag im Akzessionsarchiv («Entwurf»)
- Import Dossiers and Dokumente/Dateien
- Anton erstellt Web-Versionen und Thumbs
- falls der SIP-Ingest mit Inge und DIMAG erfolgt löscht Anton die Masterdateien
- Signaturen und Dateinamen basieren zunächst auf UUIDs
- Post Import (Listener `ImportFinished``)
- Update der Archiv-Hierarchie (
path
) - Update der Datierungen und des Volltextindexes
- Update der Archiv-Hierarchie (
Mit dem event MediumAdded
wird der Import der einzelnen Medien ausgelöst, der jeweils asynchron erledigt wird.
Ingest mit Inge in DIMAG¶
Das event MediumAdded
wird verzögert ausgelöst, d.h. nachdem der Import abgeschlossen ist und die Signaturen bereits korrigiert wurden. Dieses event löst die Konvertierung der Medien aus (Listener MediumCreateWebVersion
). Bei Verwendung von Inge wird die Original Datei in den sips Pfad kopiert, wo auch Inge zugreifen kann. Dann erfolgt der Import in Inge (Anton\Helpers\Inge::class
, import
). Wenn Inge einen Erfolg zurückmeldet, werden die Konvertierungen durchgeführt und das Master Medium wir gelöscht.
Inge: - Anton schickt einen Request pro Datei an Inge mit dem SIP and einer Liste der Anton-Medien-Ids - Inge: Ingest der Dateien in DIMAG - Inge erstellt eine loadXML-Datei - Inge erstellt ein Ingest-Paket und sichert es auf DIMAGs SFTP-Storage - Inge sendet einen Request an DIMAG: Ingest des SIP - DIMAG: Importiert das Paket and sendet das Resultat an Inge - Inge: Inge sendet das Resultat an Anton - Anton: Finalisiere den SIP-Ingest - Bestätige den SIP-Ingest (SIP Eintrag ist «Final») oder stelle den Zustand vor dem Ingest aus dem Backup wieder her - Schicke eine Email an User Inge mit dem Resultat
Abfrage eines Master Files¶
CLI¶
php artisan anton:import --env {slug} --from-sip --no-validation
--create-actors -vv {path/to/sip} --import
Revert a SIP Import or Confirm Import with Inge¶
Before a SIP Import Anton backups the database, so if anything goes wrong you can come back to the status before the Import.
The backup name is stored in the SIP-Entry and the Status of description
is set to draft.
This will restore the database from the last/actual backup and sync the media with the database (namely delete media wich are not registered in the database):
php artisan anton:sip-import --env {slug} --id {sip_id} -vv --revert
The sip_id
is the ID of an AntonObject which is a SIP.
This will set the Status of description
in the SIP-Entry to "final":
php artisan anton:sip-import --env {slug} --id {sip_id} -vv --confirm
Debugging¶
Check the SIP Import Data¶
php artisan sip:check --env {slug} --path {path_to_sip} --show-sip_entry
php artisan sip:check --env {slug} --path {path_to_sip} --show-import-array