Datenextraktion mit yuuvis® RAD extraction-service

yuuvis® RAD • 10.x »

yuuvis® RAD extraction-service ist ein Microservice, mit dessen Daten aus unterschiedlichen Dateiformaten extrahiert werden:

  • EXIF-Daten aus Audio-, Video- und Bilddateien,
  • XMP-Daten aus Office- und PDF-Dokumenten,
  • Rechnungsdaten aus ZUGFeRD-Dokumenten (Versionen 1 und 2.2.1 ) und Factur-X-Dokumenten (Version 1.0),

  • XRechnung (Version 3.0.1) mit der Syntax UNCEFACT,

  • Standardeigenschaften aus E-Mails im MSG- oder EML-Format.

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.

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 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, 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, 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.

Plugins

yuuvis® RAD extraction-service kann durch Plugins ergänzt werden, über die das Extrahieren von Daten aus konfigurierten Dateiformaten ermöglicht wird.

Die Dokumentation finden Sie im Entwickler-Bereich.