Data Management installieren
Voraussetzungen
-
Sie haben eine der folgenden Datenbanken inkl. Treiber installiert:
Siehe auch Datenbankspezifische Einschränkungen.
-
Sie haben die Datenbankverbindung in den Backend Connections konfiguriert
-
Sie haben die erforderlichen Workflow-Pakete und Repositories heruntergeladen
-
Sie haben die erforderlichen BPC-Module heruntergeladen (
.vam,.jar)
Vorgehen
INUBIT:
-
In INUBIT die Benutzergruppe "VAM" anlegen.
-
Der Gruppe die gewünschten Benutzer zuweisen.
-
-
Workflow- und Repository-ZIPs in diese Benutzergruppe importieren.
-
ggf. Datenbanktreiber in INUBIT installieren
-
INUBIT Systemdiagramm: Datenbankverbindung eintragen
-
Connection-Pooling-Einstellungen in den DB-Connectoren prüfen/ändern
In INUBIT 7.4 ist dies nicht mehr nötig, da dort die Konfiguration direkt im Systemdiagramm erfolgen kann.
-
In das Modul VAM_api_configuration den DB-Typ ("oracle", "mssql" oder "postgresql") eintragen.
Das Modul finden Sie in den Workflows VAM_api_main_newSession und VAM_api_attachUser.
-
-
Manuell mit Datenbank verbinden und folgende Skripte manuell ausführen:
Die Skripte liegen im zuvor importierten INUBIT-Repository, z.B.
/Root/admin/VAM/backend/single-create-2.0.8-Oracle.sql.-
das jüngste zur Datenbank passenden single-create-Skript
-
alle zur Datenbank passenden single-upgrade-Skripte mit höherer Versionsnummer
Prüfen Sie bei Fehlern die DB-Berechtigungen - häufig fehlt bei Oracle
rant execute on ctxsys.ctx_ddl.
-
-
Workflows aktivieren
BPC:
-
BPC-Module bpc-fe-vam.war und bpc-be-vam.jar ins BPC deployen
-
Falls die BPC-URL vom Standard abweicht, individuelle BPC-URL ins Modul VAM_api_configuration eintragen
-
Berechtigungen im BPC oder BPC-Identity-Backend einrichten
Einfachstes Setup für Anwender des Data Managements:
-
für generell lesenden und schreibenden Zugriff: Rolle VAM-administrator
-
für Zugriff auf Artefakte des entsprechenden Datenpools ("Organisation"): Rolle VAM_organization_NAME - pro Organisation!
-
-
Im BPC aus- und wieder einloggen
-
Falls nicht vorhanden, HTTP-Proxy zum INUBIT einrichten, siehe Backend Connections
-
Data-Management-Modulkomponente erstellen
-
HTTP-Proxy eintragen
-
Organisations-ID (frei wählbar) eintragen
-
Änderungen speichern
Das Data-Management-Modul ist nun aufrufbar.
Ohne Templates können jedoch bis hierhin nur z.B. Test-Queries angelegt und gelöscht werden. -
INUBIT:
-
Echtes Passwort generieren und in das Modul VAM_api_http_listener_protocol eintragen
Verwenden Sie dieses Passwort auch für automatisierte Zugriffe.
Legen Sie ggf. neben "bpcadmin" noch einen anderen ("technischen") Benutzer für die automatisierten Zugriffe an.
Datenbankspezifische Einschränkungen
Oracle
-
Standardfeld Beschreibung:
Beschreibung kann nur maximal 4000 Zeichen lang sein -
Kontextsuche auf Benutzernamen (“erzeugt von” und “geändert von” / “enthält”):
Suche funktioniert aufgrund eines Optimizer-Bugs in manchen Oracle-Versionen nicht
MSSQL
-
Kontextsuche in Standardfeldern:
Nur Suche nach Präfixen von Wörtern möglich -
Zeichensatzkodierung:
ohne viel Aufwand Verwendung von Nicht-Latin-1-Zeichen in indizierten Feldern (z.B. Benutzerdefinierte ID, Benutzer-ID) problematisch;
ebenso bei schlechten DB-Defaults Schlüssel nur mit Unterschieden in Groß-/Kleinschreibung oder Akzenten -
Schlüssellänge:
Schlüssel für Indizes dürfen maximal 931 Zeichen lang sein
(derzeit kein Anwendungsfall bekannt, wo diese Länge überläuft)
