Sprache: Deutsch · English

Mandant

KONZEPT ADMINISTRATOR STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X

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')

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.

Verwandte Seiten