Metadaten anlegen

Sie benötigen für einen docform-Prozess definierte Metadaten, um diverse Dokumentarten und deren Metadaten auslesen zu können (siehe Konfigurationsvorbereitung).

Metadaten identifizieren

Soll docform etwa Rechnungen auslesen, müssen Sie die Metadaten identifizieren, die auf einer Rechnung vorhanden und für Sie von Interesse sind. Das gilt sowohl für Metadaten / Rechnungen ohne Positionen als auch für Metadaten / Rechnungen mit Positionen.

Beispiel: Metadaten ohne Positionen

Metadatum	Wert
Lieferant	Amazon EU S.a.r.l.
Rechnungsnummer	0EM6BZ07K84QFSM27MW4
Rechnungsdatum	19.01.2020
Gesamtbetrag	29,00
MwSt-Satz	19
MwSt-Betrag	4,63
Gesamt Nettobetrag	24,37

Beispiel: Rechnung ohne Positionen

Beispiel einer Rechnung ohne Positionen

Beispiel: Metadaten mit Positionen

Metadatum	Wert
Lieferant	SB - Großmarkt GmbH & CO. KG
Rechnungs-Nr.	17.09.2013/067/0/0/006/035000 (006-055114)
Rechnungsdatum	17.09.2013 19:18
Lieferschein-Nr.	8/0/0036/060691
Lieferdatum	17.09.2013 19:18
Gesamtbetrag	201,93
Positionen
Artikelbezeichnung	Powerstrips Poster Big-Pa 96 St
Menge	1
Einzelpreis	11,49
Gesamtpreis	11,49
Mengeneinheit	1
Lieferscheinnummer	8/0/0036/060691

Beispiel: Rechnung mit Positionen

Beispiel einer Rechnung mit Positionen

Optionale Metadaten oder Pflicht-Metadaten

Bei der späteren Konfiguration müssen Sie definieren, ob Metadaten zwingend oder optional vorhanden sein müssen. Sie benötigen diese Informationen beim Erstellen eines Dokumententyps.

Metadaten erstellen

Ihre Metadaten erstellen Sie in der Datei metadata.yml. Sie finden die Datei in Ihrem Konfigurationsprojekt und dort im Ordner yml:

Eigene Dateien/Administration/customers/<Ihr Konfigurationsprojekt>/yml

Voraussetzungen

Sie haben ein Konfigurationsprojekt erstellt.

Hinweis: Sind Sie bereits Kunde bei agorum, es existiert aber kein Konfigurationsprojekt, aktualisieren Sie agorum core, um ein solches Konfigurationsprojekt zu erstellen.

Ein Metadatum für docform hat folgenden Aufbau:

rechnungsnummer:
  displayname: <display Bezeichnung für unsere Anwender>
  type: <Datentyp>
  kind: notInherited

Regeln zum Erstellen von Metadaten

Metadaten, die Sie in docform verwenden, müssen Sie auf Nicht Vererbbar setzen:

kind: notInherited

Interne Name, type und kind können Sie nachträglich nicht anpassen.
Der Datentyp muss zum Metadatum passen (Metadaten aus Zahlen und Buchstaben, auch bei Positionsnummern, müssen etwa den Datentyp string haben).

Positionsmetadaten erstellen

Metadaten für Positionen und auch Tabellen definieren Sie in der Datei metadata.yml als list. Beachten Sie dabei die Punkte aus Regeln zum Erstellen von Metadaten.