Nuclos Mandant Mandantenwesen Multi-Tenancy: Ebenen, STRUID_NUCLOSMANDATOR, $mandator, NuclosMandatorProvider, Datentrennung, Mandantenauswahl.

Sprache: Deutsch · English

Mandant

Mehrmandantenfähigkeit in Nuclos – Ebenen, Benutzerzuordnung, automatische Datentrennung, Datenquellen und Mandanten-Provider.

Auf dieser Seite

Menü Administration → Mandant. Mit dem Mandantenwesen (Multi-Tenancy) betreibst du in einer Nuclos-Instanz mehrere unabhängige Organisationseinheiten. Nuclos trennt die Datenbestände dabei automatisch – ohne dass du in Regeln oder Suchen manuell filtern musst.

Grundprinzipien

Mandanten sind instanzabhängig (nicht Teil eines Nuclets).
Benutzer werden Mandanten m:n zugewiesen.
Mandanten bilden eine Hierarchie aus Ebenen (z.B. Land → Bundesland → Stadt).
Pro Businessobjekt wird einzeln entschieden, ob es mandantenabhängig ist (und auf welcher Ebene).
Die Trennung greift auch für Super-User.

Ebenen & Berechtigung

Eine Berechtigung auf einer höheren Ebene schließt die darunterliegenden ein. Beispiel: Anmeldung als Bayern ergibt die gültigen Mandanten Deutschland, Bayern, München. Nuclos hängt allen relevanten Statements automatisch ein WHERE STRUID_NUCLOSMANDATOR IN (…) an.

Anmeldung

Hat ein Benutzer mehr als einen Mandanten zur Auswahl, erscheint nach erfolgreicher Authentifizierung eine Mandantenauswahl; der zuletzt verwendete ist vorselektiert (5-Sekunden-Timer). Neue Datensätze werden automatisch mit dem passenden Mandanten der geforderten Ebene verknüpft.

Datenquellen

Datenquellen im Standardmodell werden automatisch auf den Mandanten eingeschränkt.
Bei manuellem SQL steht der Parameter $mandator zur Verfügung (Liste der gültigen Mandanten-UIDs) – immer mit IN einbinden:

T3.STRUID_NUCLOSMANDATOR in ('$mandator')

Eigenes SQL in Datenquellen darf nur schreiben, wer die entsprechende Berechtigung besitzt – sonst ließe sich die Mandantentrennung aushebeln.

Mandant in Jobs/Regeln: NuclosMandatorProvider

Wenn ein Job Datensätze in einem mandantenabhängigen BO anlegt, muss der Mandant ermittelt werden. Dafür implementierst du das Interface NuclosMandatorProvider (vollqualifiziert) – Nuclos ruft es vor der InsertRule auf, falls der Mandant nicht bereits aus verarbeiteten Daten hervorgeht:

public class InvoiceMandatorProvider implements org.nuclos.api.provider.NuclosMandatorProvider<Invoice> {
    @Override
    public MandatorId getNuclosMandatorId(Invoice invoice) {
        // Mandant z.B. aus Land/PLZ/Straße der Rechnung ermitteln
        return mapping.resolveMandatorId(invoice);
    }
}

Farbliche Unterscheidung (ab 4.5)

Einem Mandanten lässt sich in der Administration eine Farbe zuweisen, die in der Toolbar der Detailansicht angezeigt wird – so ist auf einen Blick erkennbar, in welchem Mandanten man arbeitet. Zudem merken sich Arbeitsumgebungen die zuletzt geöffneten Tabs pro Mandant, und Nucletparameter können mandantenspezifische Werte annehmen.