MetaDB

Die MetaDB ist eine zentrale Konfigurationsdatenbank für agorum core und wie die Registry in Windows zu verstehen. Sie verwalten und konfigurieren dort Module und nehmen weitere Einstellungen vor.

Sie können etwa:

Freigaben für das DMS definieren
Einstellungen für den Serverpapierkorb vornehmen
neue Konverter anlegen

Diese Dokumentation zeigt einen Einblick in den Aufbau der MetaDB.

Icons

Diese Icons begegnen Ihnen in agorum core, wenn Sie mit der MetaDB arbeiten:

MetaDB Property Gruppe

MetaDB Property Entry

Die MetaDB öffnen

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Übersicht: MetaDB

Einige Einstellungen erfordern einen Neustart von agorum core (siehe Hinweise in den Dokumentationen).
Sie können einige Property-Bundles /-Entrys mit einem vorangestellten # auskommentieren.

Hinweis: Nehmen Sie nur Änderungen in der MetaDB vor, wenn Sie die Dokumentation explizit darauf hinweist.

Die Grundstruktur der MetaDB

Nach dem Öffnen der MetaDB erscheint links in der Baumstruktur eine Grundstruktur mit diversen Ordnern.

Name	Beschreibung
MAIN_ACL_MANAGEMENT	Erweiterte Einstellungen zu ACLs
MAIN_COMMON_MANAGEMENT	Kundenspezifische Einstellungen
MAIN_GROUP_MANAGEMENT	Erweiterte Einstellungen zu Benutzergruppen
MAIN_MACHINE_MANAGEMENT	Erweiterte Einstellungen zu Clients
MAIN_MODULE_MANAGEMENT	Speicherort aller Konfigurationen der agorum core-Module
MAIN_SERVER_MANAGEMENT	Speicherort aller Serverkonfigurationen (IP, Port, Protokoll und so weiter)
MAIN_USER_MANAGEMENT	Erweiterte Einstellungen zu Benutzern

Die Elemente in der MetaDB

Die Struktur der MetaDB besteht aus den Elementen:

Property-Gruppe
Property-Bundle
Property-Entry

Property-Gruppe

Eine Property-Gruppe dient der optischen Strukturierung und hat keine Funktion.

Aufbau einer Property-Gruppe

[ <Bezeichnung der Property-Gruppe> ]

Property-Gruppe anlegen

Klicken Sie in der MetaDB auf .

Property-Gruppe anlegen

Property-Bundle

Ein Property-Bundle ist vergleichbar mit Ordnern und dient zur Strukturierung von Daten. Üblicherweise enthält ein Property-Bundle ein Property-Entry oder mehrere Property-Entrys.

Property-Bundle anlegen

Klicken Sie in der MetaDB auf .

Property-Bundle anlegen

Property-Entry

Ein Property-Entry enthält die eigentlichen Informationen. Üblicherweise befindet sich ein Property-Entry innerhalb eines Property-Bundles.

Property-Entry anlegen

Klicken Sie in der MetaDB auf .

Property-Entry anlegen

Beispiel: Serverpapierkorb

Im Property-Bundle trashcan findet das System alle notwendigen Einstellungen (Property-Entrys), etwa die Information, wie lange gelöschte Objekte im Serverpapierkorb verbleiben sollen (über das Property-Entry DeleteObjectsExpirationTime einstellbar).

Beispiel für Property-Entrys anhand des Serverpapierkorbs

Datentypen eines Property-Entrys

Ein Property-Entry kann verschiedene Datentypen aufweisen, um verschiedensten Informationen speichern zu können.

Datentyp	Beschreibung	Beispiel
Zeichenkette (String)	Definiert einen einzelnen String, entweder reiner Text oder Pfade. Das System trägt diesen String automatisch in die Datenbank ein und gibt den String zurück.	/agorum/roi/customers/accompdoc/js/compdocMSWord.js
Zeichenkette-Liste (String-Array)	Definiert mehrere Strings in einer Array-Liste. Sinnvoll, wenn Sie mehrere Strings unter Beibehaltung der Reihenfolge benötigen. Geben Sie weitere Strings über an.	doc docx
Inhalt (Content)	Definiert einen einzelnen String, ähnlich wie Zeichenkette (String). Der String befindet sich in einem agorum core-Objekt: Das System legt dieses Objekt automatisch an, wenn Sie das Property-Entry speichern. Sinnvoll, wenn Sie Skripte angeben möchten.	console.log('Hier wird Text im Browser geloggt.');
Verschlüsselt (Encrypted)	Definiert einen Datensatz / String. Das System verschlüsselt diesen Datensatz automatisch mit einem lokalen Schlüssel, der sich für jede agorum core-Instanz unterscheidet, und schützt so gegen direkten Zugriff. Das Schreiben über die Oberfläche ist jederzeit möglich. Sie können den enthaltenen Wert dann nur über Umwege auslesen, etwa in einem JavaScript, um dort Werte zu verarbeiten. Der Datensatz befindet sich ebenfalls verschlüsselt in der Datenbank, damit auch ein DB-Dump geschützt ist. Sinnvoll, wenn Sie etwa Schnittstellen oder Anbindungen an andere Softwareprogramme verwenden und etwa das dafür verwendete Passwort verschlüsseln möchten. Das System exportiert die Datensätze in der export.yml nicht, sondern führt sie standardmäßig mit XXXXXXXX auf.	meinPasswort

Ein Property-Bundle kopieren

Sie können vorhandene Property-Bundles samt Ihren Property-Entrys kopieren, etwa, wenn es sich um eine neue Freigabenerstellung handelt.

Klicken Sie mit der rechten Maustaste auf das Property-Bundle.
Wählen Sie im Kontextmenü Kopieren.
Öffnen Sie den gewünschten Ordner in der MetaDB.
Wählen Sie im Kontextmenü Einfügen.
Passen Sie das kopierte Property-Bundle und die darin enthaltenen Property-Entrys an.

Grundeinstellungen in der MetaDB für das Hauptsystem

Sie können Grundeinstellungen, etwa die Systemsprache, systemweit unter diesem Pfad in der MetaDB festlegen:

MAIN_MODULE_MANAGEMENT/roi/control

Einstellung	Beschreibung	Datentyp
i18n/languages	Gibt an, welche Sprachen im System verfügbar sind und für Sprachangaben unterstützt werden. Sie können die Liste für spezielle Anwendungsfälle erweitern. Die Sprachen erscheinen anschließend in der Sprachauswahl in den Benutzereinstellungen. Das System kann nur in einer anderen Sprache angezeigt werden, wenn entsprechende Übersetzungen und andere Einstellungen (etwa Templates) verfügbar sind.	String
i18n/defaults/language	Definiert die Standardsprache des Systems. Für die Verwendung einer anderen Systemsprache müssen entsprechende Übersetzungen vorhanden sein. Standard de	String
relations/ CopyAttachmentsRelation	true Das System kopiert Verknüpfungen beim Kopieren. false (Standard) Das System kopiert KEINE Verknüpfungen beim Kopieren.	String

TotalDbSize

Die Einstellung für TotalDbSize finden Sie unter:

MAIN_MODULE_MANAGEMENT/roi/control/dbsettings

Einstellung	Beschreibung	Datentyp
TotalDbSize	Definiert die angezeigte Größe der Datenbank in Bytes. Standard 21474836480 (20 GB)	String

Hinweis: Sind die Einstellungen relations/CopyAttachmentsRelation, DefaultLanguage und TotalDbSize nicht in der MetaDB definiert, gilt jeweils deren Standard. Sollten Sie andere Werte benötigen, müssen Sie die Einstellung in der MetaDB manuell als Property-Entry anlegen.

Die MetaDB exportieren

Erweitern Sie die Datei export.yml Ihres Konfigurationsprojekts, um Einstellungen der MetaDB von einer agorum core-Installation auf eine andere zu überführen.