← Hilfe

Admin-Hilfe

Richte die Installation ein, vergib Rechte und prüfe bei Störungen die passenden Einstellungen und Protokolle.

„Hilfe & Glossar“ öffnet innerhalb von ZeitenSchleife. Auf der Anmeldeseite erscheint die Hilfe als Dialog.

Start und erste Einrichtung

  1. Node.js 20.19 oder 22.12 und npm installieren. Im Projektordner npm install ausführen und die Anwendung mit npm run dev starten.
  2. Im Browser beim ersten Start den lokalen Administrator mit Namen, E-Mail und Passwort anlegen. Bestehende lokale Konten ohne E-Mail können diese nach der Anmeldung unter Mein Konto ergänzen. Seine Zugangsdaten liegen unabhängig von der Datenbank im persistenten Datenordner.
  3. Eine leere MySQL- oder MariaDB-Datenbank und einen Datenbankbenutzer anlegen. Als lokaler Administrator die Verbindungsdaten im Browser eintragen. Die Kerntabellen werden angelegt.

In Docker oder Portainer DATA_DIR=/app/data setzen und ein persistentes Volume unter /app/data einbinden. Der Ordner enthält das lokale Admin-Konto, Schlüssel, die gespeicherte Kernverbindung, Styles und eigene Schriftdateien. Auch das MariaDB-Datenverzeichnis braucht ein eigenes Volume: Dort liegen die Einstellungen der Benutzer und die verschlüsselten Plugin-Verbindungen. Wenn DATA_SOURCE_KEY über die Umgebung gesetzt ist, beim Neustart denselben Schlüssel verwenden.

Versionen und Versionshinweise pflegen

Die App-Version steht im Feld version in package.json. Das Hilfefenster zeigt diese Versionsnummer an.

  1. Ergänze oben in public/help/release-notes.html einen Entwurf mit den wichtigsten Änderungen. Verwende die folgenden Platzhalter.
  2. Führe npm run release:update aus. Der Befehl erhöht die Patch-Nummer und setzt Version, Anker und Datum im Entwurf. Derselbe Befehl kann erneut ausgeführt werden und erhöht erst mit einem neuen Entwurf wieder die Version.
  3. Erstelle die Web-App mit npm run build. Der Build übernimmt einen noch offenen Entwurf automatisch und prüft danach, dass Paketversion und oberster Eintrag übereinstimmen.
<article class="help-category" data-release-version="next" aria-labelledby="version-next">
  <header>
    <h2 id="version-next">Version NEXT</h2>
    <p class="help-intro"><time datetime="next">NEXT</time></p>
  </header>
  <ul><li>Änderung beschreiben</li></ul>
</article>

Versionshinweise öffnen

Anmeldeschutz

Der lokale Administrator meldet sich mit Benutzername oder E-Mail-Adresse und Passwort im normalen Anmeldeformular an. Bei ausgefallener Datenbank öffnet seine Anmeldung die Einrichtung für Datenbank und Lizenzen.

Unter Administration → Sicherheit kannst du Sitzungsdauer, Fehlversuche pro Konto und IP sowie die Sperrdauer einstellen. Standard: 365 Tage, 5 Fehlversuche, 15 Minuten. Die Sitzungsdauer gilt ab der nächsten Anmeldung. DATA_DIR/login-policy.json gilt auch bei Ausfall der Datenbank für den lokalen Administrator. Laufende Sperren liegen im Arbeitsspeicher der Serverinstanz.

Kennwort-Reset per E-Mail einrichten

  1. Lege unter „Datenquellen → Dienste“ eine SMTP-Bereitstellung mit Absenderadresse an und teste die Verbindung.
  2. Wähle unter „Administration → Registrierungen → Einstellungen“ die SMTP-Bereitstellung und speichere die öffentliche App-Adresse.
  3. Bei einer verfügbaren SMTP-Bereitstellung und gespeicherten App-Adresse erscheint „Kennwort vergessen?“ auf der Anmeldeseite. Ob diese Instanz Registrierungslinks anbietet, stellst du separat ein.

Die E-Mail geht an die Adresse des bestehenden Kontos. Die Anmeldeseite zeigt für jede Anfrage dieselbe Bestätigung, damit Dritte keine Konten abfragen können. Der Link gilt 30 Minuten und ist einmal verwendbar. Nach erfolgreichem Zurücksetzen enden die laufenden ZeitenSchleife-Sitzungen des Kontos.

Der E-Mail-Reset gilt für Konten mit eigenem ZeitenSchleife-Kennwort in der Kerndatenbank. Für das datenbankunabhängige lokale Administratorkonto und Konten, die ihre Zugangsdaten ausschließlich bei einem externen Anbieter verwalten, gilt der jeweilige Wiederherstellungsweg. Kennwort in der Benutzer-Hilfe zurücksetzen

Registrierung per Link

Interessenten fordern ihren persönlichen Link auf der Anmeldeseite an. ZeitenSchleife versendet ihn direkt per E-Mail. Beim Öffnen übernimmt die App den Token aus dem Link. Nach dem Absenden des Formulars muss ein Admin die Registrierung freigeben.

Registrierung per E-Mail einrichten

  1. Lege unter „Datenquellen → Dienste“ eine SMTP-Bereitstellung mit Absenderadresse an und teste die Verbindung.
  2. Öffne „Administration → Registrierungen“. Wähle unter „Einstellungen“ die SMTP-Bereitstellung und trage die öffentliche HTTPS-Adresse dieser ZeitenSchleife-Instanz ein.
  3. Trage bei Bedarf die erlaubten E-Mail-Domains ein, etwa beispiel.de. Bei einer leeren Liste sind alle gültigen E-Mail-Domains zugelassen.
  4. Aktiviere „Registrierung gestatten“ und wähle „Registrierungseinstellungen speichern“. Bei verfügbarer SMTP-Bereitstellung erscheint „Registrieren“ auf der Anmeldeseite. Ein Link gilt 30 Minuten und ist einmal einlösbar.

Registrierungsmails

ZeitenSchleife versendet den persönlichen Registrierungslink und die spätere Bestätigung im eingebauten E-Mail-Layout. Beide Nachrichten enthalten auch eine Textversion. Nach erfolgreichem Versand des Links zeigt das Formular „E-Mail ist versendet“ an.

Registrierungsanfragen prüfen

Unter Administration → Registrierungen findest du die Einstellungen und die eingereichten Anfragen, die auf eine Entscheidung warten. Sobald die anfragende Person das Formular absendet, kannst du ihre Angaben prüfen.

Beim Absenden vergibt ZeitenSchleife den Benutzernamen aus Vor- und Nachname. Aus Julia Müller wird zum Beispiel julia.mueller. Ohne Nachnamen verwendet die App den Vornamen als Basis. Ist der Name bereits durch ein Konto oder eine offene Registrierungsanfrage belegt, erhält die nächste Anfrage den ersten freien Namen mit einem Zusatz wie julia.mueller.1 oder julia.mueller.2.

  1. Öffne eine Anfrage mit ausstehender Genehmigung über „Prüfen“ und wähle „Genehmigen“. ZeitenSchleife legt das Konto mit der Rolle „Mitglied“ an und sendet eine Bestätigung an die angegebene E-Mail-Adresse. Die Mail enthält den endgültigen Benutzernamen und den Link zur Anmeldung. Für die Anmeldung gilt das Kennwort aus dem Registrierungsformular.
  2. Mit „Ablehnen“ schließt du die Anfrage. Der Interessent kann im Rahmen der Anfragelimits einen neuen Link anfordern.

Abgeschlossene Registrierungen

Unter Ereignisse → Registrierungen findest du genehmigte und abgelehnte Anfragen. Die Details zeigen, wer wann entschieden hat. Bei genehmigten Anfragen siehst du auch den Versandstatus der Bestätigungsmail.

Bei fehlgeschlagener Bestätigung bleibt die Anmeldung freigegeben. Prüfe die SMTP-Bereitstellung, öffne unter „Ereignisse → Registrierungen“ die Details der Anfrage und wähle „Bestätigung erneut senden“.

Datum und Uhrzeit

Unter „Administration → Allgemein → Datum und Uhrzeit“ legst du das Anzeigeformat fest. Wähle eine Vorlage oder „Benutzerdefiniert“. Gib etwa dd.mm.yyyy als Datumsmuster und HH:MM als Uhrzeitmuster ein. Die Vorschau zeigt die Eingabe sofort. Über „Datumsformat speichern“ übernimmst du sie für alle Konten.

Für das Datum stehen Tag (d, dd), Monat (m, mm, mmm, mmmm) und Jahr (yy, yyyy) zur Verfügung. Für die Uhrzeit stehen Stunde (H, HH), Minute (M, MM) und Sekunde (S, SS) zur Verfügung. Großbuchstaben unterscheiden Minuten von Monaten. Die Uhr-Minianwendung kann ein eigenes Datumsformat verwenden.

Authentik einrichten

Der SSO-Adapter für Authentik wird unter „Administration → Sicherheit → Authentik · Single Sign-on“ eingerichtet. Dafür braucht die Installation die Lizenzfreigabe service.authentik. Benutzer verbinden ihr bestehendes ZeitenSchleife-Konto unter „Mein Konto“ mit Authentik. Anleitung zur Authentik-Einrichtung.

Corporate Design

Unter Administration → Styles → Corporate Design änderst du App-Name, Logo und Überschriftenschrift. Das Logo erscheint auch als Favicon. Farben, Abstände und Rahmen findest du im Style-Designer. Anleitung zum Corporate Design

Adapter und Bereitstellungen

Öffne „Datenquellen“ im Startmenü oder in der WebApp-Navigation und wähle „Adapter“. Ein Klick auf einen Adapter zeigt, wofür er gedacht ist und welche Verbindungsfelder er erwartet. Über „Bereitstellung hinzufügen“ wählst du zuerst einen Typ. Anschließend erscheint das passende Formular.

Unter „Datenquellen“ findest du Verbindungen und Registry-Einträge mit Datenvorschau. In einer Vorschau mit numerischen Spalten kannst du zwischen Tabelle, Tacho, Linie, Balken und Kreis wechseln. Wähle dazu die Wertespalte und bei Bedarf die Beschriftung. „LinkProvider“ zeigt aufrufbare Funktionen, Aktionen und Auslöser. SMTP und KI-Verbindungen findest du unter „Dienste“. Bei Plugin-Datenquellen steht der Plugin-Name als Typ. Für passwortgeschützte Verbindungen speichert ZeitenSchleife Zugangsdaten verschlüsselt.

Objekte mit LinkProvidern verknüpfen

  1. Öffne Datenquellen → LinkProvider. Öffne die Vorschau der Ziel-Liste und aktiviere unter „Plugin-Freigaben“ das Plugin, in dem du die Verknüpfung verwenden willst.
  2. Öffne „Vorlagenverknüpfungen“ im Ablaufdesigner einer gespeicherten Vorlage oder „Verknüpfungen“ in den Bestandseinstellungen für einen Typ beziehungsweise im Portal-Designer eines gespeicherten Formulars.
  3. Wähle „Verknüpfung hinzufügen“. Wähle eine Eigenschaft, den Anbieter und das Zielfeld. Beispiel für Bestand: Eigenschaft „Vorgangsnummer“, Anbieter „Abläufe · Meine Vorgänge als Tabelle“, Zielfeld „Vorgangsnummer“.
  4. Wähle unter „Vergleich“ die Option „ist“ für den ganzen Wert oder „enthält“ für einen Teil des Zielfelds. Wenn die Eigenschaft den Benutzernamen manuel.sowada liefert, findet „E-Mail-Client · Nachrichten → Absender-E-Mail-Adresse → enthält“ auch manuel.sowada@example.test. Nummern und Empfangsdatum verwenden „ist“. Für den Mailtext steht „enthält“ zur Verfügung.
  5. Wähle unter „Beim Klicken öffnen“ eine Seitenleiste, FeedBox oder einen Tooltip und speichere die Verknüpfungen. Die Seitenleiste öffnet am Bildschirmrand und lässt sich in der Breite ändern. Auf schmalen Bildschirmen öffnet dieselbe Option eine FeedBox. Pro Zuordnung erscheinen bis zu 50 passende Zielobjekte, die das angemeldete Konto öffnen darf.

Die Ziel-Listen bieten ihre Nummer und ihren Titel an. „Bestand · Einträge als Tabelle“ zeigt Typ, Gruppe und die ausgefüllten Felder direkt in der Vorschau. Abläufe bietet Felder aus freigegebenen Portalticket-Formularen an, wenn diese beim Start des Vorgangs als Antworten übernommen wurden. Im öffentlichen Gastportal steht die Seitenleiste nicht zur Verfügung.

In der Vorschau eines LinkProviders kannst du unter „Benachrichtigungen“ den Anbieter für Benachrichtigungen einschalten. Wähle unter „Name aus“ das Feld für den Objektnamen und unter „Eigenschaften anzeigen“ die gewünschten Details. Der NotifyHub prüft den aktuellen Zugriff auf das jeweilige Zielobjekt. Wenn beim Senden alte und neue Werte gespeichert wurden, zeigt „Details anzeigen“ die Änderung.

LinkProvider-Listen pro Plugin konfigurieren

  1. Öffne Administration → Plugins → Plugin-Einstellungen → LinkProvider. Klappe den gewünschten Anbieter im Registry-Katalog auf.
  2. Erteile im Bereich „Freigabe“ die Freigabe für das Plugin. Der Katalog zeigt dir auch deaktivierte Anbieter und Anbieter ohne Freigabe. Unter „Anzeige“ legst du fest, ob die Liste über die Plugin-Schnittstelle abrufbar ist.
  3. Füge unter „Filter“ bei Bedarf bis zu zehn Bedingungen hinzu. Mit UND müssen alle passen, mit ODER genügt eine. Für „Benutzer von ZeitenSchleife“ kannst du etwa „Nachname enthält Müller“ ODER „Benutzername ist gleich einkauf“ wählen.
  4. Wähle unter „Spalten“, welche Spalten in diesem Plugin sichtbar sein sollen. „Alle verfügbaren Spalten“ übernimmt die Vorgabe des Anbieters. Andere Plugins können dieselbe Liste mit einer eigenen Auswahl verwenden.
  5. Klicke auf „Vorschau laden“, um die Filter und Spalten deines Entwurfs mit deinen Leserechten zu prüfen. Über „Speichern“ wird die Konfiguration für das Plugin übernommen.

Die Liste respektiert die Leserechte der jeweiligen Datenquelle. Sie zeigt bis zu 50 Treffer. Die Benutzertabelle stellt Benutzernummer, Anzeigename, Vorname, Nachname und Benutzername bereit. Nach der Freigabe kann sie in den unterstützten Designern auch als Ziel einer Eigenschaftsverknüpfung ausgewählt werden.

Bereitstellung bearbeiten

Öffne den passenden Eintrag unter „Datenquellen“ oder „Dienste“ über „Bearbeiten“. „Einrichten“ gruppiert die Felder nach Grunddaten, Verbindung, Zugangsdaten, Übertragung und Zugriff sowie Adapteroptionen. Welche Bereiche erscheinen, hängt vom gewählten Adapter ab. LinkProvider haben eigene Ansichten für die Vorschau beziehungsweise Details, für Plugin-Freigaben und, falls verfügbar, für Benachrichtigungen.

IMAP unterstützt SSL/TLS, STARTTLS und eine unverschlüsselte Verbindung. SMTP unterstützt SSL/TLS und STARTTLS. Die Zertifikatsprüfung ist standardmäßig aktiv. Beim SMTP-Test wird die Verbindung verifiziert.

Öffne bei einer aktiven IMAP-Bereitstellung „Bearbeiten → Anhänge“. Wähle eine der 25 jüngsten Nachrichten des konfigurierten Ordners und klicke auf „Anhänge auslesen“. Lade einzelne Dateien bis 10 MB herunter. Eingebettete Bilder werden ausgeblendet. Die App speichert keine Kopie der Anhänge und öffnet das Postfach nur lesend.

Für den automatischen E-Mail-Eingang in Abläufe, Pläne und Kalender ist die VaultiFy-Freigabe service.imap.automation erforderlich. Vergib zusätzlich die Berechtigung für die konkrete IMAP-Bereitstellung und die Plugin-Funktion.

Admins mit den passenden Freigaben finden im E-Mail-Client unter „Einstellungen → Postfächer verwalten“ die Aktionen „Outlook- oder Gmail-Konto verbinden“, „IMAP und SMTP einrichten“, „IMAP- oder SMTP-Verbindung hinzufügen“ und „Postfach hinzufügen“. „IMAP und SMTP einrichten“ speichert IMAP- und SMTP-Verbindungen nacheinander in der zentralen Registry und verbindet sie zu einem Postfach. Unter „Datenquellen → Bearbeiten → Parameter“ vergibst du die Lese- oder Versandberechtigung. Für Konten mit der jeweiligen Freigabe und den passenden Plugin-Rechten erscheint das Postfach automatisch. Postfächer einrichten

Der LinkProvider „E-Mail-Client · Nachrichten“ kann für andere Plugins freigegeben und dort nach Absender, Betreff, Nachrichtentext und Empfangsdatum gefiltert werden. Treffer stammen aus den für das aufrufende Konto lesbaren und eingeblendeten Eingangsordnern. Mail-LinkProvider einrichten

Die IMAP-Regeln der drei Plugins verwenden dieselben Filter. Wähle Betreff, Nachrichtentext, Absenderadresse oder ein Benutzerkonto. Du kannst etwa „Betreff enthält Störung“ mit „Nachrichtentext enthält nicht Test“ kombinieren. Alle Bedingungen müssen zutreffen. Beim Vergleich mit einem Benutzerkonto verwendet ZeitenSchleife dessen aktuelle E-Mail-Adresse.

  1. Lege unter „Datenquellen → Dienste“ eine SMTP-Bereitstellung an. Gib eine zum Server passende Absenderadresse an und teste die Verbindung.
  2. Ordne die Verbindung in den Einstellungen des betreffenden Plugins unter „E-Mail“ zu.
  3. Wähle unter „SMTP-Regeln“ eine Änderung und ein Empfängerkonto. Unter „Ausgelöst von“ kannst du die Regel auf Änderungen eines bestimmten Kontos begrenzen. Aktiviere die Regel und speichere. Das Empfängerkonto erhält die E-Mail, wenn es betroffen ist und das zugehörige Leserecht besitzt.

Im Betreff steht die Art der Änderung. Objekt- und Eingabedaten bleiben in der App. Meldungen zu eigenen Kalenderterminen gehen nur an das betroffene Konto. Fehler beim Versand stehen im Eventlog unter SMTP_RULE.

Outlook und Gmail im E-Mail-Client einrichten

ZeitenSchleife verbindet Outlook.com, Microsoft 365 und Gmail über die Mail-API des Anbieters. Eine Bereitstellung empfängt und versendet Nachrichten. Das Postfach erteilt den Zugriff beim Anbieter über OAuth 2.0.

  1. Melde dich als Administrator über die reguläre HTTPS-Adresse deiner ZeitenSchleife-Installation an. Öffne Datenquellen → Mail-Apps und kopiere die angezeigte Weiterleitungs-URI. Sie hat die Form https://zeiten.beispiel.de/api/mail-oauth/callback.
  2. Registriere die Anwendung bei Microsoft oder Google. Hinterlege die Weiterleitungs-URI exakt wie angezeigt, einschließlich Protokoll, Hostname und Pfad.
  3. Klicke in ZeitenSchleife auf Mail-App hinzufügen. Wähle Microsoft Graph oder Gmail, gib der Mail-App einen Namen und speichere die Client-ID und das Client-Geheimnis. Für Microsoft trägst du auch die Mandanten-ID aus der Anleitung unten ein.
  4. Öffne Datenquellen → Bereitstellung hinzufügen und wähle Outlook und Microsoft 365 (Graph) oder Gmail (API). Gib einen Namen sowie die Postfach-Adresse an und wähle deine Mail-App. Die Postfach-Adresse muss zu dem Konto gehören, das die Freigabe erteilt.
  5. Klicke auf Anmelden und speichern, bestätige die Freigabe im Anbieterfenster und kehre zu ZeitenSchleife zurück. Prüfe die Bereitstellung mit Testen und öffne die Vorschau. Der Test prüft das Konto und den Zugriff auf den Posteingang. In der Vorschau siehst du die letzten Nachrichten. Mit einer Testmail im Mailclient prüfst du den Versand.

Das Postfach erscheint im E-Mail-Client für Administratoren mit Zugriff auf das Plugin. Für weitere Konten wählst du unter Datenquellen → Bearbeiten → Parameter eine Postfachberechtigung und weist sie in RBAC zu. Diese Freigabe gibt Zugriff auf die gemeinsame Mailquelle. Ob das Konto lesen, bearbeiten oder versenden darf, legen zusätzlich die Rechte des E-Mail-Clients fest.

ZeitenSchleife speichert Client-Geheimnisse und erneuerbare Freigaben verschlüsselt. Setze im ZeitenSchleife-Container den Datenquellenschlüssel DATA_SOURCE_KEY und behalte ihn bei Updates bei. Bei einem Widerruf öffnest du die Bereitstellung erneut und meldest das Postfach noch einmal beim Anbieter an. In Docker oder Portainer läuft der Rückruf über denselben HTTPS-Host wie die WebApp. Der Reverse-Proxy reicht den öffentlichen Hostnamen an ZeitenSchleife weiter.

Microsoft Graph in Entra registrieren

  1. Öffne das Microsoft Entra Admin Center in einem Verzeichnis, in dem du Apps registrieren darfst. Wähle App-Registrierungen → Neue Registrierung und vergib einen Namen. Microsoft-Anleitung zur App-Registrierung
  2. Wähle die unterstützten Kontotypen passend zum Postfach. Für private Outlook.com- oder Hotmail-Konten kannst du nur persönliche Microsoft-Konten zulassen und in ZeitenSchleife consumers als Mandanten-ID setzen. Für private und geschäftliche Konten wählst du beide Kontotypen und trägst common ein. Für Organisationskonten aus mehreren Verzeichnissen verwendest du organizations. Beschränkst du die App auf dein eigenes Verzeichnis, kopiere dessen Verzeichnis-ID.
  3. Füge unter Authentifizierung → Plattform hinzufügen → Web die Weiterleitungs-URI aus ZeitenSchleife hinzu.
  4. Wähle unter API-Berechtigungen → Berechtigung hinzufügen → Microsoft Graph → Delegierte Berechtigungen die Berechtigungen User.Read, Mail.ReadWrite und Mail.Send. ZeitenSchleife fordert bei der Anmeldung zusätzlich offline_access an, um den Zugriff erneuern zu können. Je nach Organisationsrichtlinie ist eine Administratorzustimmung nötig. Microsoft Graph-Berechtigungen
  5. Kopiere in der Übersicht die Anwendungs-ID (Client). Erstelle unter Zertifikate und Geheimnisse → Neuer geheimer Clientschlüssel ein Geheimnis und kopiere seinen Wert. Trage ID, Wert und Mandanten-ID unter Datenquellen → Mail-Apps ein. Erneuere das Client-Geheimnis vor seinem Ablauf. Client-Geheimnis in Entra erstellen

Microsoft führt die hier verwendeten Mail-Endpunkte als Standardzugriff auf das vorhandene Postfach. Für ein geschäftliches Exchange-Postfach gelten weiterhin die Lizenzbedingungen des Kontos. Microsoft-Liste nutzungsabhängig abgerechneter APIs

Gmail-API in Google Cloud registrieren

  1. Erstelle in der Google Cloud Console ein Projekt und aktiviere in der API-Bibliothek die Gmail API. Google-API für ein Projekt aktivieren
  2. Richte unter Google Auth Platform → Branding den Namen deiner App und die Kontaktadressen ein. Für eine externe App hinterlegst du die autorisierte Domain der Installation.
  3. Wähle unter Zielgruppe für private Gmail-Konten Extern und füge für den Test jedes verwendete Gmail-Konto unter Testnutzer hinzu. Innerhalb einer eigenen Google-Workspace-Organisation kann Intern zu den vorgesehenen Konten passen. Zielgruppe und Veröffentlichungsstatus bei Google
  4. Füge unter Datenzugriff den Berechtigungsbereich https://www.googleapis.com/auth/gmail.modify hinzu. Damit kann der E-Mail-Client Nachrichten lesen, versenden und verwalten. Gmail-Berechtigungsbereiche
  5. Wähle unter Clients → Client erstellen den Anwendungstyp Webanwendung. Hinterlege die ZeitenSchleife-Adresse mit /api/mail-oauth/callback unter Autorisierte Weiterleitungs-URIs. Kopiere Client-ID und Geheimnis beim Erstellen und trage beide unter Datenquellen → Mail-Apps ein. OAuth-Client bei Google erstellen

Google bietet für ein einziges eigenes Google-Konto den Personal mode an. Wähle in dessen Einrichtungsseite ebenfalls den Clienttyp Webanwendung. Diese Apps sind auf das erstellende Konto beschränkt und von der App-Verifizierung sowie der Sieben-Tage-Frist für Testfreigaben ausgenommen. Bei einer regulären externen App im Teststatus läuft die Gmail-Freigabe nach sieben Tagen ab. Google-Anleitung mit Personal mode · Google-Teststatus

Der Gmail-Bereich gmail.modify ist eingeschränkt. Für eine veröffentlichte App kann Google eine Verifizierung und bei Verarbeitung auf einem Server ein kostenpflichtiges Sicherheitsaudit verlangen. Google führt Ausnahmen etwa für persönliche oder begrenzte Nutzung auf. Die API-Standardnutzung ist laut Google ohne Zusatzkosten verfügbar. Für Abrufe oberhalb der veröffentlichten Schwellen kündigt Google nutzungsabhängige Kosten an. Ausnahmen von der Verifizierung · Sicherheitsprüfung für eingeschränkte Bereiche · Gmail-Kontingente und Preise

Bisherige Mailverbindungen umstellen

SMTP und IMAP verwenden Benutzer und Passwort. Für SMTP steht auch ein Relay ohne Anmeldung zur Verfügung. Zeigt eine bisherige OAuth-Bereitstellung „Anmeldung erforderlich“, öffne sie unter Bearbeiten → Einrichten und gib unterstützte Zugangsdaten des Mailservers ein. Für Outlook und Gmail kannst du stattdessen eine eigene Graph- oder Gmail-Bereitstellung wie oben einrichten und sie im E-Mail-Client verwenden. Die frühere Anbieterfreigabe gilt für ihre ursprüngliche Verbindung. Melde das Postfach daher einmal für die neue API an.

E-Mail-Eingangsregeln in Abläufe, Pläne und Kalender verwenden weiterhin eine IMAP-Bereitstellung. Für SMTP-Regeln, Registrierungslinks und Kennwort-Reset wählst du eine SMTP-Bereitstellung. Archivierte E-Mails gehören weiterhin zu ihrer ursprünglichen Postfachzuordnung im E-Mail-Client.

Für LDAP gibst du die Adresse und Basis-DN getrennt ein. Unter Filter stehen Objekttypen und ein LDAP-Filter zur Verfügung. „Benutzer synchronisieren“ legt gefundene Benutzer als Mitglieder an oder aktualisiert bereits über dieselbe Bereitstellung importierte Benutzer. Pro Lauf werden bis zu 500 Einträge verarbeitet. Die Synchronisierung startest du manuell. Die Anmeldung für importierte Konten kann ein Admin durch Vergabe eines lokalen Passworts freischalten. Eine Anmeldung direkt bei LDAP ist derzeit nicht verfügbar.

Für OpenWeather brauchst du einen API-Schlüssel und Koordinaten. In der Minianwendung stehen aktuelles Wetter, die nächsten 24 Stunden und die 5-Tage-Vorhersage zur Auswahl.

BookStack anbinden

Importiere zunächst eine VaultiFy-Lizenz mit der separaten Dienstfreigabe service.bookstack. BookStack verwendet einen Floating-Platz wie andere separat lizenzierte Datenquellen.

  1. Gib dem vorgesehenen BookStack-Konto die Berechtigung „Access System API“ und Leserechte für die benötigten Inhalte. Erzeuge im Profil des Kontos unter „API Tokens“ ein Token mit Ablaufdatum. Kopiere die Token-ID und das Token-Geheimnis beim Anlegen.
  2. Öffne in ZeitenSchleife „Datenquellen → Bereitstellung hinzufügen“ und wähle „BookStack (REST)“. Gib die HTTPS-Adresse der Installation ein, zum Beispiel https://wissen.example.org/wiki. Trage Token-ID und Token-Geheimnis ein und wähle Regale, Bücher, Kapitel oder Seiten.
  3. Speichere und klicke auf „Testen“. „Vorschau“ zeigt bis zu 25 Einträge nach letzter Änderung mit Links zu BookStack. Lege bei Bedarf für jeden weiteren Inhaltstyp eine eigene Bereitstellung an.

Unter „Parameter“ kannst du die Berechtigung für Minianwendungen wählen. Die Vorschau verwendet die Leserechte des Token-Kontos. Für die Links gilt die persönliche Anmeldung in BookStack. Der Adapter liest Listen und Metadaten. Offizielle BookStack-API-Dokumentation.

Hinweise einrichten

  1. Öffne mit einem Administratorkonto das Fenster „Hinweise“ und klicke auf „Hinweis anlegen“. Für Wartungszeiten, Versionshinweise und rechtliche Mitteilungen wählst du „Eigene Nachricht“. Trage einen Titel, bei Bedarf einen Text und einen Link ein.
  2. Wähle unter „Zielgruppe“ alle angemeldeten Konten, Administratoren, eine Gruppe oder eine Rolle. Mit „Öffentlich · auch beim Anmelden“ erscheint eine eigene Nachricht zusätzlich auf der Anmeldeseite.
  3. Unter „Wiederholung“ wählst du einen einmaligen Termin, einen Turnus in Stunden, Tagen oder Wochen oder eine monatliche Wiederholung. Für einen Hinweis jeden Montag um 08:00 Uhr wählst du „Im Turnus“, gibst unter „Alle“ die Zahl 1 ein und wählst „Wochen“. Setze den Start auf einen Montag um 08:00 Uhr und die Zeitzone auf „Europe/Berlin“. Trage unter „Anzeigedauer“ ein, wie lange der jeweilige Termin sichtbar bleibt. Ein Endzeitpunkt beendet den Zeitplan.
  4. Aktiviere die Regel und speichere. Das Fenster „Hinweise“ listet die Regeln auf. „Aktiv“ schaltet eine Regel an oder aus. Bearbeitete Inhalte gelten als neue Fassung.

Unter „Ereignisse → Hinweise“ siehst du die für dein Administratorkonto aktuell gültigen Hinweise, einschließlich ausgeblendeter Vorkommen. Mit „Wieder anzeigen“ blendest du ein ausgeblendetes Vorkommen für den Start wieder ein. Nach Ablauf der Anzeigedauer verschwindet der Hinweis aus dieser Ansicht.

Hinweise zu offenen Registrierungsanfragen

  1. Öffne „Hinweise → Hinweis anlegen“. Wähle als Quelle „Registrierungsanfragen“ und als Zielgruppe „Administratoren“. Mit einer Gruppe oder Rolle kannst du die Auswahl auf deren Administratorkonten eingrenzen.
  2. Wähle ein Titelfeld oder gib einen Titel ein. Ergänze bei Bedarf Eigenschaften wie E-Mail und Eingangszeit. Wähle „Einmalig“ ohne Endzeit, wenn Anträge bis zur Entscheidung sichtbar bleiben sollen. Aktiviere und speichere die Regel.
  3. Wenn eine Person das Registrierungsformular eingereicht hat, erscheint die offene Anfrage für die eingestellte Zielgruppe. „Eintrag öffnen“ führt direkt zur Anfrage unter „Administration → Registrierungen“. Nach der Entscheidung verschwindet der Antrag aus „Ereignisse → Hinweise“.

Hinweise mit Daten und Variablen

Wähle in „Hinweis anlegen“ eine Quelle. Wähle dann unter „Variable“ einen Wert und unter „Einfügen in“ den Titel oder die Nachricht. „Variable einfügen“ setzt den Platzhalter an die zuletzt gewählte Textposition. Beispiel: „Hallo “ und die Variable „Empfänger · Vorname“. Aus der gewählten Quelle stehen die Felder zur Verfügung, die für die Anzeige freigegeben sind. Öffentliche Hinweise bieten App- und Zeitplanwerte. Fehlende Werte erscheinen als Gedankenstrich.

Wähle unter „Variable“ den Eintrag „Konkretes Benutzerkonto“. Wähle das Konto und das gewünschte Kontofeld und klicke auf „Variable einfügen“. Wiederhole die Auswahl, um mehrere Konten im selben Hinweis zu erwähnen. Die Quelle kann beispielsweise ein Kalender sein. Anzeigename, Vorname und Nachname erscheinen für die festgelegte Zielgruppe. Der Benutzername erscheint für das betreffende Konto und für Personen mit „Benutzer ansehen“. Die Auswahl verwendet die aktive Benutzerdatenquelle.

Über „Zusatzquelle hinzufügen“ kannst du pro internem Hinweis bis zu drei weitere Datenquellen einsetzen. Wähle die Quelle und bei Bedarf eine Bedingung. Unter „Variable“ findest du die Felder mit dem Namen der Zusatzquelle. Jedes Feld verwendet den ersten Datensatz, der die Bedingung erfüllt. So kann der Hinweis zu einem offenen Vorgang zusätzlich den Titel eines geplanten Termins enthalten. Ein fehlender Wert oder eine fehlende Lesefreigabe erscheint als Gedankenstrich.

Wähle einen verfügbaren LinkProvider oder eine bereitgestellte Datenquelle. Stelle Titelfeld, angezeigte Eigenschaften und bei Bedarf eine Bedingung ein. Bei SQL wählst du zuerst unter „Datenquellen → Filter“ die Tabelle und die sichtbaren Spalten. Bei E-Mail verwendet der Hinweis den eingerichteten IMAP-Ordner. „E-Mail lesen“ zeigt berechtigten Konten den gespeicherten Nachrichtentext.

Für „Pläne · Fällige Aufgaben“ stellst du den Zeitraum ein. In Bestand kannst du für bald ablaufende Einträge den Typ und sein Datumsfeld wählen. In Abläufe kannst du für offene Vorgänge festlegen, ab wie vielen Stunden im aktuellen Schritt ein Hinweis erscheint. Unter „Benutzer · Erwähnung“ kannst du den Anzeigenamen eines Kontos verwenden. Eigene Benutzereigenschaften sind für das jeweilige Konto oder Konten mit „Benutzer ansehen“ sichtbar.

Hinweise gehören zum kostenlosen Kern. Berechtigungen, Freigaben und bestehende Lizenzen der ausgewählten Quelle werden beim Anzeigen geprüft. Deaktivierte Quellen liefern keine Treffer. Bei der Anmeldung erscheinen bis zu drei aktuelle Hinweise nach Priorität. Hinweise lesen und ausblenden

Dateiverwaltung

Öffne „Dateiverwaltung“ im Startmenü oder in der WebApp-Navigation. Dort kannst du Dateien hochladen, umbenennen, öffnen, herunterladen und über den Papierkorb verwalten. Tags helfen beim Wiederfinden. Auf dem Server bleiben die Dateinamen maskiert. Sichere den Speicherordner und die Datenbank gemeinsam. Dateiverwaltung und Speicherordner.

Plugin-Datenbanken

  1. Für jedes Plugin eine eigene MySQL-/MariaDB-Datenbank wählen. Die Option „Datenbank bei Bedarf anlegen“ erzeugt sie über die Oberfläche.
  2. Unter Administration → Plugins beim gewünschten Plugin „Plugin-Einstellungen“ öffnen. Server, Datenbank und Anmeldedaten eintragen und „Speichern und verbinden“ wählen.
  3. Bei einem gestarteten Plugin „Tabellen anlegen“ wählen. „Tabellen reparieren“ ergänzt fehlende Tabellen und bekannte fehlende Spalten. Für den Kern findest du die Reparatur unter „Administration → Datenbank → Tabellenpflege“. Bereits zugewiesene Verbindungen werden weiterhin verwendet und erscheinen im Plugin-Formular.

Fenstergrößen

Unter „Administration → Allgemein → Fenstergrößen“ findest du alle Kern- und Plugin-Fenster. Wähle pro Fenster eine gemeinsame Einheit für Breite und Höhe und speichere die Zeile. Prozentwerte von 1 bis 100 beziehen sich auf den Arbeitsbereich oberhalb der Taskleiste. Die Mindestmaße betragen, soweit Platz vorhanden ist, 384 × 256 Pixel. Mit „Zurücksetzen“ stellst du die Standardgröße wieder her.

Bei vorhandenen gemischten Maßen siehst du die ursprünglich gespeicherten Werte. Wähle eine gemeinsame Einheit, um die Maße anhand deines aktuellen Arbeitsbereichs umzurechnen und neu zu speichern.

Die Maße gelten als Startmaße für neu geöffnete Fenster in der Fenster-Ansicht. Schließe ein bereits geöffnetes Fenster und öffne es erneut, um die neuen Maße zu sehen. Bei Bedarf öffnet die App das Fenster kleiner, damit es neben die bereits sichtbaren Fenster passt. Die eingestellten Maße werden in der Kerndatenbank gespeichert.

Lizenzen und Pläne einrichten

Die Lizenzverwaltung zeigt die in VaultiFy signierte Anzahl an Floating-Plätzen. „Privat kostenlos“ umfasst einen Platz für den lokalen Admin. Bei Privat erweitert zählt der lokale Admin zur signierten Gesamtzahl. Ein neuer Import aktiviert die Freigaben im laufenden Betrieb. Authentik und LDAP brauchen auch bei Business eine zusätzliche Freigabe.

Öffne „Administration → Lizenzen“. Die Badges im Katalog zeigen die Lizenzfreigaben der Installation. Über „Lizenzdatei → Importieren“ spielst du einen VaultiFy-Export ein. Der Kern funktioniert ohne Lizenz. LDAP inklusive Synchronisierung, externe KI-APIs und Authentik haben eigene Freigaben. Plugin-Funktionen verwenden die Lizenz ihres Plugins. Business enthält den Import in den lokalen Kalender. Privat kann ihn separat buchen. Anleitung für den Lizenzimport.

Richte für „Pläne“ eine eigene SQL-Datenbank ein und lege die Tabellen in den Plugin-Einstellungen an. Vergib „Pläne öffnen“, „Pläne ansehen“ und bei Bedarf „Pläne und Aufgaben bearbeiten“. Über die Registry können berechtigte Abläufe Aufgaben hinzufügen und Aufgaben an den Kalender übergeben werden. Pläne einrichten.

Kundenportal veröffentlichen

Das öffentliche Meldeformular ist ohne Konto unter /portal erreichbar. Der interne Link /portal/intern verwendet die App-Anmeldung, RBAC und den Floating-Platz des Kontos. Unter „Portal → Einstellungen → Portal-Adressen“ siehst du beide Links und kannst den öffentlichen Pfad ändern. Vergib für eigene Meldungen das Portal-Recht „Meldungen erfassen und eigene Meldungen ansehen“ und für die Übernahme das Recht „Meldungseingang bearbeiten“. Für Terminlinks schalte „Termine aus dem Kalender zulassen“ ein und gib Mitarbeitern die Kalenderberechtigung zum Veröffentlichen.

Im „Portal-Designer“ unter den Portal-Einstellungen legst du Formulare für Abläufe, Termine, neue Bestandseinträge und Aufgaben an. Schalte jedes Formular für den internen oder öffentlichen Zugang frei und prüfe Felder und Regeln in der Vorschau. Beim Bestand kannst du Antworten passenden Bestandsfeldern zuordnen. Der Designer speichert seine Einstellungen in der Portal-Datenbank.

Teste den Ablauf mit einer öffentlichen und einer internen Meldung. Übernimm beide im Eingang und entscheide einen Schritt in Abläufe. Der Statuslink und „Meine Meldungen“ zeigen die öffentlichen Meilensteine des verknüpften Ablaufs. Schrittnamen, Kommentare und Zuständigkeiten stehen im vollständigen Vorgangsverlauf und erfordern dessen Berechtigungen. Die Statuskacheln im Eingang zählen die aktuell geladenen Meldungen. Öffne „Weitere Meldungen laden“, um ältere Tickets einzubeziehen.

Für Aufgaben aus dem Portal aktiviere Pläne samt Datenbank und richte im Portal-Designer ein Formular vom Typ „Aufgabe in Pläne“ ein. Das bearbeitende Konto braucht Zugriff auf den Portal-Eingang und Schreibrechte in Pläne. Bei der Übernahme wählt es eine persönliche Liste oder eine Liste seiner RBAC-Gruppe. Ein zugeordnetes Datumsfeld wird als Fälligkeit übernommen.

Plugin-Übergaben einrichten und prüfen

  1. Wähle bei bestehenden Datenbanken unter „Administration → Plugins“ in den Plugin-Einstellungen „Tabellen reparieren“ für Portal, Abläufe, Kalender, Bestand und Pläne. Die Aufträge bleiben in der Datenbank des sendenden Plugins. Ziel-Plugins speichern ihre Übernahmebelege gemeinsam mit ihren Einträgen.
  2. Öffne eine Kalender- oder IMAP-Bereitstellung unter „Datenquellen → Bereitstellungen → Parameter“. Wähle „Leseberechtigung“ aus dem RBAC-Katalog und ordne diese den gewünschten Rollen zu. Ohne Auswahl haben nur Administratorkonten Zugriff. Kalender, Minianwendungen und IMAP prüfen die Freigabe bei der Nutzung erneut. Für IMAP braucht das Konto zusätzlich die entsprechende Plugin-Berechtigung.
  3. Bei Änderungsmeldungen zu vorhandenen Bestandsobjekten muss das Objekt selbst freigegeben sein. Öffne den Eintrag in Bestand und aktiviere „Im Portal auswählbar“. Das öffentliche Formular zeigt Titel und Typ des freigegebenen Objekts.
  4. Ein Portal-Auftrag meldet nach fünf fehlgeschlagenen Versuchen „Übernahme prüfen“. Suche im Eventlog nach PORTAL_TRANSFER und der Meldungsnummer. „Erneut versuchen“ nutzt dieselbe Kennung und die aktuellen Rechte des ursprünglich bearbeitenden Kontos. Vor „Prüfung abschließen“ prüfe, ob der Zieleintrag bereits vorhanden ist.
  5. Prüfe bei einer wartenden Pflichtaktion im Ablaufverlauf den Aktionsstatus. Das Eventlog zeigt unter ACTION_FAILED Details für die Administration. Stelle die Verbindung oder Berechtigung wieder her und wähle am Vorgang „Erneut versuchen“.

Für unabhängige Unternehmen betreibe getrennte ZeitenSchleife-Instanzen mit eigenen Datenbanken, Dateispeichern und Berechtigungen. Portal, Benutzerverwaltung und Plugins gehören jeweils zur selben Instanz.

Benutzernamen

Der Benutzername ist Pflicht. Konten ohne bisherigen Benutzernamen erhalten beim Datenbankupdate einen eindeutigen Wert. Unter „Administration → RBAC → Benutzer“ zeigt die Benutzertabelle die aktuellen Spalten. Administratoren können zusätzliche Textspalten und deren Werte pflegen. Beim Löschen einer Spalte werden die Werte entfernt. Systemspalten bleiben geschützt. Bisherige eigene Eigenschaften sind beim Bearbeiten des Benutzerkontos verfügbar.

Bei einer LDAP-Quelle findest du unter „Filter“ die Attributzuordnung. Klicke auf „Attribute auslesen“ und wähle je Zeile ein LDAP-Attribut und eine Zielspalte. Speichere die Zuordnung, bevor du synchronisierst. Zusatzspalten legst du in der Benutzertabelle an.

Allgemeine Einstellungen

Die Auswahl für alle Konten findest du unter Datum und Uhrzeit.

Öffne „Administration → Allgemein → Serverbetrieb“. Bei einer Lokalinstallation betreffen beide Aktionen den Node-Webserver. In Docker steuert ZeitenSchleife den eigenen Container. Dafür muss der Docker-Socket im Container erreichbar sein. Falls der Container einen eigenen Hostnamen hat, setze DOCKER_CONTAINER_ID auf seine ID. Einen abweichenden Socket-Pfad legst du mit DOCKER_SOCKET fest.

Anleitung für Portal-Pfad, Proxy, Berechtigungen und Terminmitteilungen

Die Plugin-Tabellen dürfen nicht in der Kerndatenbank liegen. MSSQL ist als allgemeine Datenquelle verfügbar; die mitgelieferten Plugins benötigen MySQL/MariaDB. Die Datenbankbenutzer benötigen passende Rechte zum Erstellen und Ändern ihrer Tabellen.

Erstellung und Reparatur

Für den Kern gibt es server/database-create.js und server/database-repair.js; für die Plugins jeweils gleichnamige Dateien im Plugin-Ordner. Mit npm run db:create und npm run db:repair lässt sich der Kern auch über die Konsole einrichten. Die Reparatur ergänzt Tabellen und bekannte Spalten; sie stellt keine verlorenen Daten wieder her und prüft keine bestehenden Datentypen, Indizes oder Fremdschlüssel. Wenn für eine fehlende Pflichtspalte vorhandene Daten nötig wären, bricht sie ab. Vor Änderungen eine Sicherung anlegen.

Taskmanager und Eventlog

Administratoren können im Taskmanager einzelne Fenster verbundener Browser-Tabs nach Bestätigung schließen. Die Netzwerkzahlen sind Schätzungen für API-Aufrufe im jeweiligen Fenster. Das Eventlog übernimmt Konsolenmeldungen des Servers, geladener Plugins und angemeldeter Browser mit Schreibrecht. Zugangsdaten in URLs und bekannte Schlüsselmuster werden ausgeblendet. Konsolenobjekte werden nicht übertragen. Meldungen bei Verbindungsausfall bleiben vorübergehend in einem begrenzten Puffer.

Die geöffneten Listen unter „Ereignisse“ sowie die offenen Registrierungsanfragen in der Administration laden Änderungen automatisch nach, sobald der Server sie über WebSockets meldet. Nach einer Wiederverbindung lädt die App die aktuellen Einträge erneut. Mit „Aktualisieren“ kannst du die Liste jederzeit manuell laden.

Audit

Unter Ereignisse → Audit sind Anmeldungen, fehlgeschlagene Anmeldungen und ändernde Anfragen angemeldeter Benutzer sichtbar. Das Audit speichert Zeitpunkt, Identität, Methode, Pfad ohne Query-Parameter, HTTP-Ergebnis und die vom Server gesehene IP. Passwörter und Inhalte von Formularen werden nicht aufgezeichnet. Lesezugriffe werden nicht protokolliert. Hinter einem Proxy kann die angezeigte IP dessen Adresse sein.

Bei nicht erreichbarer Datenbank werden Einträge in data/audit-fallback.jsonl gespeichert und nach Wiederherstellung zusätzlich in der Audit-Ansicht angezeigt; sie werden nicht automatisch in die Datenbank importiert. Das Datenverzeichnis muss dauerhaft eingebunden werden. Audit-Einträge werden derzeit nicht automatisch gelöscht.

Styles und Schriftarten

Die mitgelieferten Werte stehen in styles.json. Fehlt diese Datei im Container, verwendet der Server die mitgelieferten Vorgaben aus server/services/styles.defaults.json; Änderungen über Administration → Styles werden in data/styles.json gespeichert. Unter Administration → Styles → Style-Designer ein Theme auswählen. Farben, Innenabstände, Abstände zwischen Texten und Elementen sowie Farbe, Dicke und Stil der Menü- und Fensterrahmen lassen sich in der Vorschau prüfen. „Speichern“ übernimmt die Änderungen ohne Neuladen. Für freie CSS-Regeln gibt es „CSS für Fortgeschrittene“. Gespeicherte CSS-Änderungen liegen in data/style-sheets.json und werden in geöffneten Sitzungen zur Laufzeit übernommen. Mit ?standardstyles=1 öffnest du die App bei Bedarf mit dem Standard-CSS. Unter Styles → Schriftarten kannst du einzelne TTF-, OTF-, WOFF- und WOFF2-Dateien oder einen ganzen Ordner auswählen. Entpacke einen ZIP-Download vorher. Der Import liest Schriftfamilien, Gewichte und Schnitte aus den Dateien und übernimmt Lizenztexte wie OFL.txt. Die Schriftfamilien stehen unter Einstellungen → Mein Konto zur Auswahl. Schriftdateien und Lizenzen bleiben in data/fonts/ gespeichert. Mitgelieferte Schriftarten werden beim Start in denselben aktiven Ordner übernommen.

RBAC verwalten und prüfen

Die Auswahllisten ordnen die Berechtigungen nach Plugin oder Funktionsbereich und zeigen den Bereich neben dem Namen. Das lokale Administratorkonto und Konten mit der geschützten Systemrolle „Administrator“ haben Vorrang bei der RBAC-Prüfung. Ein Administrator kann deshalb eine Funktion auch nutzen, wenn seine Gruppen und anderen Rollen dieses Recht nicht vergeben. Produktlizenzen und fachliche Regeln gelten weiterhin.

Wähle unter „Benutzer“, „Gruppen“, „Rollen“ oder „Berechtigungen“ zuerst den Eintrag aus und klicke auf „Löschen“. Bei Benutzerkonten steht die Aktion zusätzlich am Ende der Tabellenzeile. Eigene Rollen, Gruppen und Berechtigungen lassen sich nach Bestätigung entfernen. Die beiden Systemrollen, integrierte Berechtigungen und Administrationsschutz bleiben erhalten. Löse eine eigene Berechtigung zuerst von der zugewiesenen Plugin-Funktion, wenn sie dort noch verwendet wird.

Unter „Administration → Allgemein → Benutzernamen“ kannst du Profilbilder neben Namen einblenden. Die Einstellung gilt instanzweit für angemeldete Benutzer. Die persönliche Profilbild-Vorschau bleibt im eigenen Konto erreichbar.

Unter „Benutzernamen → Anzeigenamensformat“ wählst du die Reihenfolge von Vor- und Nachname mit oder ohne Komma. „Benutzerdefiniert“ setzt {vorname} und {nachname} in dein eigenes Muster ein. Die Vorschau zeigt das Ergebnis vorab. Die Einstellung gilt für Anzeigenamen in der Instanz. Kontodaten und Anmeldekennung bleiben erhalten.

Öffne „Administration → RBAC“. Unter „Benutzer“ bearbeitest du Konten und weist Gruppen, Rollen und direkte Rechte zu. Unter „Gruppen“ pflegst du Mitglieder, Rollen und Rechte. „Rollen“ bündelt Berechtigungen für mehrere Konten. Unter „Berechtigungen“ siehst du den Schlüssel und die Zuweisungen einer Berechtigung. Eigene Berechtigungen kannst du dort anlegen und bearbeiten.

In der Berechtigungsliste einer Rolle markiert Umschalt plus Klick die Einträge vom letzten Klick bis zum gewählten Eintrag. Wähle „Alle Berechtigungen“ einzeln, wenn du diese ausdrücklich vergeben möchtest.

„Prüfung“ zeigt Konten ohne Gruppe, ohne wirksame Rolle und ohne wirksame Berechtigung. Sie listet Rollen und Einzelrechte, die kein Konto erreichen, und alle Konten mit Vollzugriff. Eine Zuweisung an eine leere Gruppe hat keinen Empfänger. Das Recht „Alle Berechtigungen“ (*) und das lokale Administratorkonto zählen als Vollzugriff. Einzelrechte wertet die Prüfung anhand ihrer eigenen Zuweisungen aus.

Unter „Administration → Plugins → Plugin-Einstellungen → Funktionsberechtigungen“ verknüpfst du eine vorhandene Berechtigung mit „Plugin öffnen“ oder einer bestimmten Funktion. Für IMAP stehen eigene Berechtigungen für Kalender und Abläufe zur Verfügung. Ein entzogenes Recht stoppt auch die betroffene Automatik.

RBAC-Schnappschüsse sichern und wiederherstellen

  1. Importiere die separate VaultiFy-Freigabe feature.rbac-snapshots und öffne mit einem Administratorkonto „Administration → RBAC → Schnappschüsse“.
  2. Wähle „Schnappschuss anlegen“. Vergib bei Bedarf einen Namen, damit du den Stand später wiederfindest. Die Tabelle zeigt Ersteller, Zeitpunkt und Umfang.
  3. Wähle beim gewünschten Stand „Wiederherstellen“ und bestätige. ZeitenSchleife speichert den aktuellen Stand vorher automatisch. Bei Bedarf kannst du ihn über denselben Weg zurückspielen.

Ein Schnappschuss enthält Gruppen, Rollen, Berechtigungen, ihre Zuweisungen sowie abweichende Funktionsberechtigungen von Plugins. Kontodaten und Passwörter bleiben erhalten. Zuordnungen zu gelöschten Konten werden übersprungen. Seit der Sicherung vergebene Zuordnungen können entfallen. Die App verhindert, dass der letzte Administrator seinen Zugriff verliert, und aktualisiert die wirksamen Rechte nach erfolgreicher Wiederherstellung für laufende Sitzungen.

Füge „RBAC-Schnappschüsse“ über „Minianwendung hinzufügen“ zur Übersicht hinzu. Sie zeigt die Anzahl und den neuesten Stand und öffnet die Verwaltung. Dieselbe Lizenz gilt für beide Ansichten. Freigabe in VaultiFy einrichten

Unterschriften freigeben

Spiele eine VaultiFy-Freigabe für service.signatures ein. Der vollständige VaultiFy-Katalog enthält den Dienst „Unterschriften“. Gib den zuständigen Rollen unter „Administration → RBAC“ die Rechte „Unterschriften ansehen“ und bei Bedarf „Einträge unterschreiben“. Zusätzlich benötigen die Benutzer Zugriff auf den jeweiligen gespeicherten Eintrag und einen Floating-Platz. Im Portal steht der Dienst angemeldeten Bearbeitern im Eingang zur Verfügung.

Hintergrundbild

Unter „Administration → Styles → Style-Designer“ stellst du über „Deckkraft der Desktopfarbe“ ein, wie deutlich das Hintergrundbild zu sehen ist. Ein niedrigerer Wert macht das Bild sichtbarer. Bei einem bereits gespeicherten Theme passt du den Wert dort an.

Bestand und Dashboard

Lege für Bestand eine eigene MySQL-/MariaDB-Datenbank an. Verbinde sie unter Administration → Plugins → Bestand → Plugin-Einstellungen und wähle „Datenbank erstellen“. Die Feldtypen werden dabei automatisch eingetragen. „Beispieldaten anlegen“ legt Lebensmittel und Wartungen mit Kalenderterminen an. Weise „Bestand ansehen“ und „Bestand bearbeiten“ unter RBAC nach Bedarf zu. Die Funktionsliste im Plugin-Manager ist dauerhaft sichtbar.

Die Funktionsberechtigung „Ausgewählte Einträge löschen“ steuert die Mehrfachauswahl in Bestand. Benutzer mit dieser Berechtigung markieren die Einträge einzeln in der Liste oder Kartenansicht und bestätigen das Löschen unterhalb der Suche.

Die Kern-Datenbank speichert Minianwendungen samt Desktop und Position je Konto. Ein Plugin kann über seine Registry eigene Daten dafür bereitstellen. Die Anwendung prüft beim Laden, ob das Plugin läuft und der Benutzer die zugehörige Funktion verwenden darf.

Kalenderquellen und KI einrichten

Für Outlook (Microsoft 365) registriere eine App in Microsoft Entra. Hinterlege Mandanten-ID, Anwendungs-ID, Client-Geheimnis und das Postfach. Die Berechtigung Calendars.Read oder Calendars.ReadWrite wird als Anwendungsberechtigung erteilt und benötigt Administratorzustimmung. Begrenze den Zugriff in Exchange auf die vorgesehenen Postfächer. Bei leerer Kalender-ID wird der Standardkalender verwendet. Persönliche Outlook.com-Konten sind über diese Verbindungsart nicht unterstützt.

Unter „Datenquellen → Kalender-Bereitstellung → Einrichten → Aktualisierung“ stellst du das zentrale Abrufintervall ein. Die Anwendung verwendet denselben gespeicherten Abrufstand für berechtigte Ansichten, Minianwendungen und Erinnerungen, wenn er den benötigten Zeitraum abdeckt. Weitere Zeiträume werden im jeweiligen Intervall abgefragt. Bei „Manuell“ löst nur eine ausdrückliche Aktion wie „Kalender aktualisieren“, „Vorschau“ oder „Lokal importieren“ einen Abruf aus. Intervall und Freigaben bleiben nach dem Neustart gespeichert.

Lege im Fenster „Datenquellen“ für jeden Kalender eine eigene Verbindung an. Für iCalendar verwendest du eine HTTPS-Adresse einer ICS-Datei, für CalDAV die HTTPS-Adresse einer konkreten Kalendersammlung. Bei CalDAV verwende das passende Konto oder App-Passwort. „Schreibzugriff erlauben“ ist standardmäßig ausgeschaltet. Nur einzelne Termine ohne Serien oder Einladungen sind bearbeitbar. Zusätzlich braucht der Benutzer die Terminbearbeitungsberechtigung und das hinterlegte Konto Schreibrechte beim Anbieter. ICS bleibt lesbar. Gib Zugangsdaten nur für Kalender ein, die die berechtigten Kalenderbenutzer sehen dürfen.

Für Änderungen an CalDAV-Terminen prüft ZeitenSchleife die Version der einzelnen Terminressource. Fehlt der starke ETag im HTTP-Header, liest ZeitenSchleife nach Möglichkeit DAV:getetag und prüft den Termin erneut. Liefert der Server ausschließlich schwache oder gar keine Versionskennungen, ist der Termin schreibgeschützt. Prüfe in diesem Fall, ob der CalDAV-Server und der vorgeschaltete Reverse Proxy starke ETag-Kennungen bereitstellen und die Schreibbedingung If-Match weitergeben.

Für den optionalen Prozesscheck lege als Administrator eine KI-Bereitstellung an. Wähle das REST-Protokoll und trage den vollständigen Endpunkt sowie das Modell ein. Typische Pfade sind /api/chat für Ollama, /v1/chat/completions für OpenAI-kompatible Server und /v1/messages für Anthropic. Für API-Schlüssel muss DATA_SOURCE_KEY gesetzt sein. Ein lokaler Ollama-Endpunkt kann HTTP ohne Schlüssel verwenden. Der Prozesscheck ist Administratoren im Ablaufdesigner vorbehalten.