Datenextraktion mit yuuvis® RAD extraction-service

yuuvis® RAD • 8.x »

yuuvis® RAD extraction-service ist ein Microservice, mit dessen Hilfe EXIF-Daten aus Audio-, Video- und Bilddateien, XMP-Daten aus Office- und PDF-Dokumenten, ZUGFeRD-Daten sowie Standardeigenschaften aus E-Mails im MSG- oder EML-Format extrahiert werden können.

Der Dienst wird beim Speichern von neu erstellten oder geänderten Dokumenten in yuuvis® RAD client aufgerufen. Die extrahierten Daten werden bei entsprechender Konfiguration des Mappings als Metadaten gespeichert.

Die Extraktion muss mit Beispieldaten getestet werden. Extrahierte Daten, die mit 'OS:' gekennzeichnet sind, können gemappt werden. Das Mapping anderer Daten kann zu Fehlern, führen, insbesondere zu Fehlern durch nicht passende Datentypen und Formate.

Konfiguration von yuuvis® RAD extraction-service

Für das Extrahieren können Dateiendungen und maximale Dateigrößen angegeben werden, für die keine Extraktion von Daten erfolgt. Die Konfiguration erfolgt über die Konfigurationsdatei extraction-prod.yml aus dem Verzeichnis \config von yuuvis® RAD service-manager.

Beispiel:

skipexif:
  extensions: "xml,xsd"
  threshold: 10MB

Parameter:

extensions

Dateiendungen der Dateien, die ab der angegebenen Größe nicht extrahiert werden sollen.

Der Platzhalter '*'steht für alle Dateiendungen.
threshold

Nur Dateien, die Kleiner sind als angegeben, werden extrahiert.

Angabe in MB oder KB.

Ohne diesen Parameter werden keine Dateien mit angegebenen Dateiendungen extrahiert.

Sie können zunächst den Microservice testen:

  1. Administrationsseite der Microservices per URL http://<service-admin-IP>:<port> öffnen.

    Standard-Port: 7273

    yuuvis® RAD extraction-service wird unter dem Namen EXTRACTION aufgeführt.

  2. Auf EXTRACTION klicken und erneut durch eine Klick den Extraction-Bereich öffnen.

  3. Auf Insights > Details klicken.

    Die Detailseite wird geöffnet.

  4. Auf den Link zur Swagger-UI in der oberen Zeile klicken.
  5. Auf der Seite Extraction API aus der Liste in der Kopfzeile extraction-api auswählen.
  6. Auf Expand Operations klicken.
  7. Nach unten zum Bereich POST /extraction/api/xmp scrollen und im Abschnitt Parameters auf Durchsuchen klicken.
  8. Datei aus Dateisystem wählen.
  9. Mit einem Klick auf Try it out! Extraktion starten.

Die Daten werden unmittelbar extrahiert und das Ergebnis unten angezeigt.

Für die Übernahme der von yuuvis® RAD extraction-service extrahierten Daten muss das Schema in yuuvis® RAD designer angepasst werden:

  • Für jedes Metadatenfeld eines Objekttyps, in das extrahierte Daten übernommen werden sollen, müssen Sie in den Feldeigenschaften das gewünschten yuuvis® RAD-Alias aus der Tabelle Metadatenmapping angeben.

Wenn das Neuerstellungsformular ein Metadatenfeld enthält, in das nur eindeutige Werte eingegeben werden dürfen, dann wird ungeachtet des Imports mehrerer Dateien nur ein Dokument mit der ersten zu importierenden Datei in yuuvis® RAD erstellt. Deshalb dürfen Metadatenfelder von Objekttypen, die für die Datenextraktion vorgesehen sind, nicht die Eigenschaft Eindeutig erhalten.
Wenn extrahierte Daten die maximale Länge der Metadatenfelder überschreiten, dann werden sie abgeschnitten.

Die extrahierten Daten der Medien- und Dokumentdateien werden so verarbeitet, dass der Wert der ersten passenden Information in die Metadaten übernommen wird.

Die Schreibweise der yuuvis® RAD-Aliasse ist Namensraum.Name.

Beispiel:
  extract.OS:Title

Für die Übernahme der von yuuvis® RAD extraction-service extrahierten Daten muss das Schema in yuuvis® RAD designer angepasst werden. Dies erfolgt hier beispielhaft anhand eines Dokumenttyps für E-Mails.

yuuvis® RAD extraction-service stellt die Zuweisungen von Standardeigenschaften aus E-Mail-Dateien auf yuuvis® RAD-Aliasse bereit (siehe Metadatenmapping).

Schema anpassen:

  1. In yuuvis® RAD designer den Dokumenttyp E-Mail öffnen und in den Bereich Felder wechseln.
  2. Das Feld From wählen, ein Alias hinzufügen und folgende Angaben machen:
  3. In der Eigenschaft Name den Text OS:MailFrom eintragen.
  4. In der Eigenschaft Namensraum den Text extract eintragen.
  5. Bei Bedarf das Feld schreibgeschützt setzen.
  6. Mit allen weiteren Feldern des Dokumenttyps ebenso verfahren.
  7. Schema speichern und aktivieren.

Damit ist die Konfiguration abgeschlossen.

Sie können nun in ein E-Mail-Programm wechseln und eine E-Mail in yuuvis® RAD übernehmen. Prüfen Sie in yuuvis® RAD client, ob die Metadatenfelder der übernommenen E-Mail korrekt ausgefüllt sind.

Aliasse für Dateieigenschaften

Unabhängig vom yuuvis® RAD extraction-service und dessen Konfiguration können folgende Dateieigenschaften direkt übernommen werden:

  • dms.Path: Dateiname mit Pfad

  • dms.FileSize: Dateigröße

  • dms.Digest: Digest der Dateigröße

  • dms.DigestAlgorithm: Algorithmus, mit dem der Digest erstellt wurde

  • dms.MimeType: MimeType der Datei

  • dms.Extension: Dateiendung