DisplayNames im Filingassistant konfigurieren

Mit der Konfiguration DisplayNames.json in der MetaDB können Sie steuern, welcher Anzeigename für Einträge in Listen des Filingassistants erscheint. Die Konfiguration erfolgt über sogenannte Selektoren, die bestimmen, aus welchen Metadaten der Anzeigename zusammengesetzt wird.

Ablageort in der MetaDB

Die Konfiguration liegt im folgenden MetaDB-Pfad:

MAIN_MODULE_MANAGEMENT/filingassistant/2.0/control/AddOns/[ <projekt-name> ]/<priorität> <name>/DisplayNames.json

Aufbau der Pfadstruktur

Pfad-Segment	Beschreibung
AddOns	Übergeordneter Ordner für alle AddOn-Konfigurationen des Filing Assistants.
[ <projekt-name> ]	Konfigurations-Gruppenordner für das jeweilige Projekt bzw. Modul, z. B. [ agorum.directory.sync ]. Der Name steht in eckigen Klammern.
<priorität> <name>	Ordner mit einer numerischen Priorität und dem Modulnamen, z. B. 900 agorum.directory.sync. Die Priorität bestimmt die Reihenfolge der Auswertung.
DisplayNames.json	MetaDB Property-Entry vom Datentyp Zeichenkette (String), der die JSON-Konfiguration als Wert enthält.

Beispiel eines vollständigen Pfads

MAIN_MODULE_MANAGEMENT/filingassistant/2.0/control/AddOns/[ agorum.directory.sync ]/900 agorum.directory.sync/DisplayNames.json

 

In der folgenden Abbildung sehen Sie den MetaDB Property-Entry-Dialog mit einer Beispielkonfiguration:

Aufbau der JSON-Konfiguration

Der Wert der DisplayNames.json ist ein JSON-Array. Jedes Element im Array definiert eine Regel, die über Selektoren bestimmt, für welche Objekte ein bestimmter Anzeigename gilt.

Grundstruktur

[
  {
    "selectors": {
      "<metadatum_display_name>": "<Selektor-Wert>"
    },
    "value": "<Anzeigename>"
  }
]

Selektoren

Der Schlüssel im selectors-Objekt gibt an, auf welches Metadatum sich der Selektor bezieht. Der Wert des Schlüssels definiert, welche Objekte dazu passen.

Dabei ist der Selektor-Wert in der Regel ein Verweis auf ein anderes Metadatum, das mit eckigen Klammern [~metadatum_name] angegeben wird. Dieses Muster prüft, ob das referenzierte Metadatum am Objekt existiert.

DisplayName für ein eigenes AddOn erstellen

1. Öffnen Sie links in der App-Leiste Administration und dann MetaDB.
2. Öffnen Sie den Pfad:

   MAIN_MODULE_MANAGEMENT/filingassistant/2.0/control/AddOns
   

3. Erstellen Sie über ein Property-Bundle mit beliebigem Namen für Ihr Konfigurationsprojekt.
4. Erstellen Sie über die folgenden Property-Entrys.

    

   Name	Datentyp	Wert (String)
   format	Zeichenkette (String)	1.8
   DisplayNames.json	Zeichenkette (String)	Geben Sie über Selektoren eine Bedingung an, um den jeweiligen Anzeigenamen zu setzen. Beispiel: [ { "selectors": { "acso2_object": "[~acso2_displayName]" }, "value": "${~acso2_displayName}" } ]
   version	Zeichenkette (String)	1  Hinweis: Die Version muss anders sein, damit Änderungen wirksam werden. Ein Wechsel zwischen 0 und 1 reicht aus.

5. Änderungen an der MetaDB-Konfiguration werden erst nach einem Neuladen der Bedienoberfläche wirksam.