Metadaten Designer konfigurieren

Der Metadaten Designer unterstützt Sie bei der Erstellung von Metadaten, die Sie dann in agorum core verwenden können, z.B. in agorum core docform.

Hinweis: Der Metadaten Designer ist eine veraltete Oberfläche und wird zur Konfiguration von Metadaten nicht mehr eingesetzt. Verwenden Sie stattdessen die Datei metadata.yml.

Verwenden Sie den Metadaten Designer nur, um diesen als eine Art Inhaltsverzeichnis einzusetzen und sich einen Überblick über Ihre vorliegenden Metadaten zu machen. Auch für Bestandskunden, deren Metadaten nicht auf der Datei metadata.yml basieren, ist der Metadaten Designer noch relevant.

Durch Metadaten können Sie Dokumente differenzieren, suchen und in automatischen Abläufen gezielt ansprechen.

Wichtig: Einmal erstellte Metadaten können Sie nicht ändern. Erstellen Sie beispielsweise das Metadatum "test" mit dem Typ "Ganzzahl" und löschen den Typ wieder, so können Sie kein neues Metadatum namens "test" mit dem Typ "Zeichenkette" erstellen. Dies ist nur sehr schwer rückgängig zu machen. Dementsprechend sollten Sie sich vorher gut überlegen, wie Ihre Metadaten benannt und strukturiert werden sollen.

Aufbau des Metadaten Designers

Im Metadaten Designer befinden sich die Metadaten in einer Spalte links, im Standard sind die diese ungruppiert. Wird ein Metadatum ausgewählt, so wird dieses in der grauen Fläche geöffnet.

Mit Setzen des Hakens bei Gruppiert werden die Metadaten in der jeweilig zugeordneten Gruppe dargestellt. Metadaten die keine Gruppe besitzen, werden unter Ungruppiert zusammengefasst.

Wird ein Metadatum ausgewählt, sieht dies so aus:

Beispiel für ein ausgefüllte Metadatummaske:

Erstellung eines neuen Metadatums

Um ein neues Metadatum anzulegen, klicken Sie auf den Button Metdatum in der linken Spalte. Es öffnet sich diese Eingabemaske:

Bereich 1

Die Angaben hier sind zwingend erforderlich. Es gibt folgende Felder:

Feld	Bedeutung
Interner Name	Eingabe des internen Namens, dieser wird bei der Nutzung des Metadatums zur Konfiguration verwendet, z.B. im smart assistant konfigurator oder bei Workflows. Achtung: Der interne Name muss eindeutig sein. Wichtig: In Workflows werden Metadaten die mit `hidden_` und `ac_` beginnen nicht weitergereicht, sondern nur intern für den Workflow verwendet.
Angezeigter Name	Eingabe des Namens, der später dem Anwender angezeigt wird, z.B. lautet der interne Name ag_REnumber, angezeigt wird jedoch Rechnungsnummer.
Typ	Auswahl des Types (siehe nachfolgende Liste).
Vererbung	Auswahl zwischen Nicht vererbtes, vererbtes und eingebautes Metadatum.

Sie können folgende Typen wählen:

Zeichenkette
- abc
Ganzzahl (integer)
- 13
Ganzzahl (long)
- 13333 (einfach größere Zahlen möglich als bei Integer)
Gleitkommazahl (double)
- 13,3 (einfach größere Zahlen möglich als bei float)
Gleitkommazahl (float)
- 2,5
Datum
- Format dd-MM-yyyy
Boolescher Wert
- Ja/Nein

Bereich 2: Optionale Angaben (Allgemein)

Hier können Sie das Metadatum näher spezifizieren.

Es gibt folgende Felder:

Feld	Bedeutung
Anzeigetyp	Auswahl zwischen Standard (normales Textfeld), mehrzeiliger Textbereich und Drop-Down Auswahl.
Eingeschränkt	Einschränkung auf Werte der Datenquelle, Verhinderung der freien Eingabe (nur bei Drop-Down Auswahl vorhanden).
Datenquelle	Auswahl zwischen Keine, MetaDb Pfad und Eingabe (nur bei Drop-Down Auswahl vorhanden).
Standardwert	Eingabe eines Wertes, der vorausgefüllt wird. Dieser ist änderbar durch den Anwender.
Multi	Das Metadatum kann mehrere Werte haben (bei gesetztem Haken).
Nur lesen	Das Metadatum kann nicht bearbeitet werden (bei gesetztem Haken).
Optional	Das Metadatum kann leer gelassen werden (bei gesetztem Haken).

Bei Anzeigetyp Drop-Down Auswahl kann man eine Datenquelle auswählen:

Wenn Sie eine csv. mit Eingabewerten haben, die zur auswahl angezeigt werdens ollen, so müssen Sie einen MetaDb Pfad zu einem DataHandler, in welchem die csv Datei hinterlegt ist, angeben.

Bereich 3: Optionale Angaben (Verifizierung)

Sie können die Eingaben in das Metadatenfeld überprüfen lassen. Wenn Sie z.B. das Metadatum Rechnungsnummer haben, so können Sie definieren, dass dieses immer mit RE* beginnt. Wird dies weggelassen, so erscheint eine Fehlermeldung.

Es gibt folgende Felder:

Feld	Bedeutung
Verifizierungstyp	Auswahl zwischen Standard und RegEx.
Fehlertext	Fehlermeldung, die bei erfolgloser Verifizierung angezeigt wird.
RegEx	Angabe des regulären Ausdrucks, nach welchem verifiziert werden soll.

Beachten Sie, dass die Felder Fehlertext und RegEx nur bei Auswahl des Verifizierungstyps RegEx angezeigt werden.

Bereich 4: Optionale Angaben (Hinweise)

Hier können Sie zusätzliche Angaben zu dem Metadatum machen, beispielsweise zum besseren Verständnis der Anwender oder um auf besondere formale Anforderungen hinzuweisen.

Es gibt folgende Felder:

Feld	Bedeutung
Kurzbeschreibung	Text, der im Feld als Hinweis angezeigt wird.
Beschreibung	Text, der als Beschreibung des Feldes genutzt wird.

Bereich 5: Gruppe (optional)

Hier können Sie das Metadatum Gruppen zuweisen.

Es gibt folgende Felder:

Feld	Bedeutung
Gruppen	Auswahl einer Gruppe, nicht ausgefüllt bedeutet ungruppiert.

Nach dem Ausfüllen

Durch Klick auf Ok können Sie das Anlegen das Metadatums abschließen. Sie können auch auf Weiteres Metadatum hinzufügen klicken, um direkt das nächste anzulegen. Denken Sie daran, abschließend in der Spalte links oben auf den Button Speichern zu klicken.