Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Kommentar: Aktualisierung der Anforderung an die Ergebnisse der Umsetzung
Seiteneigenschaften
Zielveröffentlichung4.12
DesignMandantenwesen
Dokumentstatus
Status
colourGreen
titleENTWURFENTWICKLUNG
Dokumenteigentümer

Maik Stüker

DesignerMaik Stüker, Ramin Göttlich
Entwickler Maik Stüker
QS
Jira
serverNuclos Issue Tracking
keyNUCLOS-2726
 

Ziele

  • Nuclos soll um ein hierarchisches Mandantenwesen erweitert werden.

...

Anforderungen

#BeschreibungPrioritätNuclos VersionNotizen
1Neues SystemBO "Mandant"14.2
  • T_MD_MANDATOR
  • PK: UID
  • Name, Beschreibung
  • Referenz auf sich selbst (STRUID_PARENTPARENTMANDATOR) -> hierarchisches Mandantenwesen
2Neues SystemBO "Mandanten Parameter" 
  • Statt Mandanten Parametern können in den Nuclet Parametern pro Mandant ein Wert definiert werden.
1
  • T_MD_MANDATOR_PARAMETER
  • PK: UID
  • Name, Beschreibung, Defaultwert
  • Zuweisung zum Nuclet (wird entsprechend transferiert)
  • Java Klasse für die Verwendung in Regeln generieren, ParameterProvider erweitern
3Neues SystemBO "Mandanten Parameter Wert"14.2
  • T_MD_MANDATOR_PARAM_PARAMETERVALUEVALUE
  • PK: UID
  • Wert
  • Referenz auf Mandant und Nuclet Parameter
  • Dies ist optional, wird kein spezifischer Wert angegeben, so greift der Default Wert im Nuclet Parameter selbst.
4Neues SystemBO "Mandanten Zuordnung"14.2
  • T_MD_MANDATOR_USER
  • PK: UID
  • Referenz auf Mandant und User
5BO Wizard um Konfiguration der Mandantenabhängigkeit erweitern1
  • INTMANDATORLEVEL
  • Die Abhängigkeit wird in Form einer Ebene/Level angegeben. NULL = keine Mandantenabhängigkeit4.2
    • Tabellen erhalten eine neue Spalten Spalte STRUID_NUCLOSMANDATOR
    5aNeues SystemBO "Mandanten Ebene"4.2
    • T_MD_MANDATOR_LEVEL
    • PK: UID
    • Beschriftung
    • Referenz auf sich selbst (STRUID_PARENTLEVEL)
    • Wird automatisch verwaltet. Erste Ebene wird mit dem ersten Mandanten erzeugt. Weitere Ebene folgen automatisch wenn von der Möglichkeit einer übergeordneten Ebene Gebrauch gemacht wird. In der Administration der Ebene (Einstieg über die Mandanten Maske) kann nur die Beschriftung der Ebene geändert werden.
    6Existiert für ein BO eine Abhängigkeit, wird automatisch in Suchergebnislisten, SubformsUnterformulare, Aufgabenlisten, Datenquellenergebnissen eingeschränkt14.2
    • Mit der Anmeldung wird eine Liste der für diese Session gültigen Mandanten generiert (und gecached) und immer den Statements als IN angehängt. WHERE STRUID_NUCLOSMANDATOR IN (...)
    • Eine Berechtigung auf "Deutschland" beinhaltet auch automatisch alle darunter liegenden Ebenen.
    • Beispiel: Anmeldung "Deutschland" = Liste von Mandanten ("Deutschland", "Bayern", "München", "Berlin", "Berlin")
    • Beispiel: Anmeldung "Bayern" = Liste von Mandanten ("Deutschland", "Bayern", "München")
    • Siehe auch Punkt 12 u. 13
    7Neue Datensätze werde automatisch mit dem angemeldeten Mandanten verknüpft, falls erforderlich14.2
    • Meldet man sich mit einer höheren Ebene an (im Beispiel mit einer Stadt = Ebene 3) das BO fordert aber Ebene 1, so wird der Hierarchie entsprechend der Mandant aus Ebene 1 verwendet
    • Meldet man sich mit einer niedrigeren Ebene an (im Beispiel mit einem Bundesland = Ebene 2) das BO fordert aber Ebene 3, wird eine Dropdown mit den zur Auswahl stehenden Mandanten der Ebene 3 angeboten. Die Berechtigung des Benutzer muss berücksichtigt werden. Enthält die Auswahl nur einen Eintrag wird dieser automatisch selektiert.
    • Zu klären: Wo und wird die Dropdown dargestellt?
    8Der Loginbildschirm wird um die Auswahl des Mandanten erweitert14.2
    • Auswahl soll nur nötig sein, wenn der Benutzer mehr als einen Mandanten zur Auswahl hat
    • Auswahl erscheint erst nach erfolgreicher Authentifizierung
    • Stellt die Auswahl mehr als einen Mandanten zur Verfügung wird der zuletzt verwendete vorselektiert. Der Benutzer hat dann 5 Sekunden Zeit einen anderen Eintrag zu wählen, bevor die Anmeldung den Client öffnet. Der Timer wird unterbrochen, sobald der Benutzer die Mandanten-Dropdown anklickt.
    9Arbeitsumgebungen merken sich die zuletzt geöffneten Tabs abhängig pro Mandant1OFFEN 
    10Nuclet Zuweisung und Transfer um Mandanten Parameter erweitern1
    • Auch die Mandantenabhängigkeit eines BO soll transferiert werden. Grundsätzlich soll man aber immer in der Lage sein, eine vom Herausgeber nicht berücksichtigte Mandantenabhängigkeit, nachträglich zu aktivieren. Somit gilt: Ein Nuclettransfer (genauer ein UPDATE) löscht niemals eine Information zur Mandantenabhängigkeit. Erklärt der Herausgeber eines Nuclets nachträglich die Mandantenabhängigkeit so wird dies ebenfalls berücksichtigt und angewendet.
    • Die Handhabung ist also vergleich mit der der Jobausführungsfrequenz (wird initial beim Nucletimport gesetzt, aber nicht mehr überschrieben, wenn sie auf dem Zielsystem geändert wird) <- Nicht korrekt, ein UPDATE kann die Abhängigkeit nachträglich setzen (Siehe oberen Punkt).
     

     

    11Klassen Generierung für Mandanten Parameter und ParameterProvider erweitern1 
    • Man wird nicht direkt mit den Mandanten arbeiten. Nuclos wird automatisch, je nach Abhängigkeit der Daten und/oder Anmeldung des Benutzers die Abfragen (auch in Regeln!) einschränken.
    • Siehe auch Punkt 14
    • Neues Interface für solche Parameter, ähnlich den Nuclet Parametern
    • Mandantenabhängige BOs erhalten neue Methoden (setNuclosMandatorId(String), getNuclosMandatorId(), getNuclosMandator())
    12Datenquellen Ausführung erweitern1OFFEN
    • Ist die Datenquellen mit dem normalen Modell (nicht manuelles SQL Statement) erstellt worden, so werden alle verwendenden Tabellen auf den angemeldeten Mandanten eingeschränkt, sofern solch eine Abhängigkeit besteht.
    • Eine Datenquelle, basierend auf einem manuellen SQL wird nicht automatisch auf Mandanten eingeschränkt, da die Ermittlung hierfür zu komplex und fehleranfällig wäre. Ausnahme: Es existiert eine Ergebnisspalte "STRUID_NUCLOSMANDATOR". In diesem Fall würde das Statement nochmals umhüllt, wobei die WHERE Bedingung die IN Clause für Mandanten enthält.
    • Siehe auch Punkt 6
    13Neue Berechtigung auf SQL Ebene einer Datenquelle1OFFEN
    • Nur wenn ein Benutzer über dieses Recht verfügt kann er eigene SQL Statements in Datenquellen verfassen. Ansonsten bleibt ihm nur das normale Modell. Mit entsprechendem Wissen könnte man ansonsten die Mandanteneinschränkung aushebeln.

    ...

    14Optionale Mandanten Provider4.2
    • Nuclos wird automatisch, je nach Abhängigkeit der Daten und/oder Anmeldung des Benutzers die Abfragen (auch in Regeln!) einschränken. Wenn allerdings ein Job Datensätze in einem mandantenabhängigen BO anlegen muss, so stellt sich die Frage "Wie wird der Mandant ermittelt?". Für solche Fälle, und auch weil ein Nuclet Produzent die zukünftige Einrichtung der Mandanten seiner Kunden nicht kennt, können Provider individuell pro Kunde implementiert werden.
    • Jedes mandantenabhängige BO erhält ein neues Interface mit dem Namen "NuclosMandatorProvider". Findet Nuclos eine Implementierung in den Server Regeln, so wird die Methode "getNuclosMandatorId(<BusinessObject>) aufgerufen und der zurückgelieferte Mandant im Datensatz eingetragen. Dies geschieht noch vor einer InsertRule und auch nur, wenn nicht schon durch die Verarbeitung anderer Daten eine Mandantenabhängigkeit ermittelt werden konnte. Letzteres könnte z.B. der Fall sein, wenn man durch vorhandene Aufträge iteriert, welche ebenfalls die gleiche Mandantenabhängigkeit ausweisen.
    • Ein Beispiel, wann man solch einen Provider benötigt, könnte ein Rechnungsimport Job sein. Dieser verarbeitet Rechnungen im XML Format für alle Mandanten des Systems. Allerdings würde er keine Rechnungen mehr anlegen, wenn die Rechnung mandantenabhängig ist und solch ein Provider nicht implementiert wird. In der Implementierung steht die anzulegende Rechnung zur Verfügung, womit ein eigens für diesen Zweck geschaffenes Mapping aus Land, PLZ und Straße abgefragt wird. Teil des Mappings ist auch eine Referenz auf einen Mandanten welcher dann letztendlich zurückgeliefert wird. Der Mandant ist somit gefüllt und die Verarbeitung kann normal fortgesetzt werden.

    Benutzerinteraktion und -design

    Mandanten bzw. die Hierarchie wird in einer neuen Maske in der Administration konfiguriert. Die Parameter Werte für Mandanten werden im Nuclet Management bei den Parametern gepflegt. bzw. die Hierarchie wird über einen Baum konfiguriert. Name, Parameterwerte etc. werden in einem Eigenschaftsbereich rechts vom Baum konfiguriert.Neue Maske für die Administration der Mandanten Parameter (nicht für die Werte)

    Fragen

    Unten finden Sie eine Liste von Fragen, die aufgrund dieses Anforderungsdokuments angesprochen werden müssen:

    FrageErgebnis
    Welche Felder benötigt der Mandant ein Parameter noch? vorerst keine weiteren
    Wird ein Schnellwechsel, ohne erneute Authentifizierung, benötigt? 

    Klassen Generierung: Eine Klasse pro Nuclet mit den zugewiesenen Mandanten Parametern als Konstanten. Oder eine eigene Klasse pro Parameter?

    Interface Name "MandatorDepending"?

    Name des Interfaces für mandantenfähige BOs: Multitenant (neben Stateful, etc.) - wird erstmal nicht benötigt.

    Da es um den Parameter geht... MandatorParameter?!

    Datenquellen um einen neuen automatischen Parameter "MANDATOR" erweitern? (Ähnlich dem Username) 
    vorerst nicht
    Man kann eine Ebene nachträglich nur schwer zwischen vorhandenen platzieren. Z.B. man hat Anfangs die "Bundesländer" nicht gebraucht. Sollte man Ebenen extra Definieren? Ja, werden extra definiert. Es kann allerdings nur die Beschriftung geändert werden. (Siehe auch Punkt 5a)
    Zu klären: Defaultbelegung bestehender Datensätze bei nachträglicher Einführung der Mandantenfähigkeit in einer Entität?Vielleicht ähnlich wie beim Pflichtfeld?Ja, sind bereits Daten vorhanden, so muss ein Default Mandant ausgewählt werden.
    Zu klären: Verletzung der "referentiellen Integrität" bei Umhängen eines referenzierten Datensatzes zu einem anderen Mandanten kann nicht über die DB abgefangen werden. Aus Sicht des vorherigen Mandanten kommt das Umhängen aber einer Löschung gleich, darf also nicht zulässig sein, wenn referenziert.Vielleicht prinzipiell nicht zulassen? Das macht aber das nachträgliche Aufteilen von Daten auf zwei Mandanten bei nachträglicher Einführung der Mandantenfähigkeit (s.a. Defaulbelegung, vorheriger Punkt) unmöglich

    Wird nicht zugelassen. Für eine nachträgliche Einführung und Aufteilung auf Mandanten muss eine Migration auf Datenbank Ebene entwickelt werden. Nuclos bietet hierfür vorerst keine Unterstützung an.

    Zu klären: Dropdowns und LOVs müssen ebenfalls dynamisch auf die für den jeweiligen Mandatenkontext sichtbaren Daten eingeschränkt werden. Was genau ist der Mandantenkontext? Alle hierarchisch unter dem angemeldeten Mandanten hängenden Mandanten? 

    Verworfen

    Umgesetzt. Ein Mandantenkontext besteht aus der Schnittmenge der Anmeldung plus den Mandanten des zu verarbeitenden Datensatzes. Dabei wird immer der komplette Baum der Hierarchie (Siehe auch Punkt 6) herangezogen. Somit erfolgt auch eine Einschränkung von LOV & Co. bei einem Superuser.

    Verworfen

    • Mandanten Parameter
    • Eigene Klassen/Konstanten für Parameter und Provider
    • Direktes Arbeiten mit Mandant über Getter und Setter und Attributen für Querys.(noch nichts)