← Hilfe

Glossar

Schlage Begriffe aus der Oberfläche nach. Die technischen Abschnitte erklären die Schnittstellen für Plugins.

Arbeitsbereich

App-Version
Nummer des installierten Stands von ZeitenSchleife, etwa 1.0.0. Du findest sie im Hilfefenster.
Versionshinweise
Übersicht der Änderungen pro dokumentierter App-Version. Versionshinweise öffnen
Versionsentwurf
Oberster Eintrag der Versionshinweise mit dem Platzhalter next. npm run release:update erhöht die Patch-Version und übernimmt den Entwurf als neuen Eintrag. Versionsentwurf anlegen
Fenster-Ansicht / WebApp-Ansicht
Zwei Anordnungen für dieselben Funktionen. In der Fenster-Ansicht öffnest du verschiebbare Fenster über das Startmenü. In der WebApp-Ansicht navigierst du über die Seitenleiste und der ausgewählte Bereich füllt den Arbeitsbereich.
Einrasten
Ordnet ein Fenster am linken, rechten oder oberen Rand an. Die Vorschau zeigt vor dem Loslassen, wo es einrastet.
Fensterebene
Bearbeitungsansicht über dem Plugin-Inhalt. „Zurück“ oder Escape führt zur zuvor geöffneten Ansicht. Die Kopfzeile enthält Aktionen wie „Speichern“.
Aufklappbare Karte
Ein Eintrag mit Kurzdaten im Kopf. Ein Klick auf den Kartentitel öffnet zum Beispiel die Termindetails, Formularfelder oder Aufgabenaktionen.
Kernfenster und Startmaß
Fenster wie Übersicht, Mein Konto oder Dateiverwaltung. Das Startmaß bezeichnet Breite und Höhe beim Öffnen eines neuen Fensters. „Administration → Allgemein → Fenstergrößen“ akzeptiert Pixel und Prozent vom Arbeitsbereich.
Desktop
Eine der persönlichen Übersichten, zwischen denen du wischen oder über Randpfeile wechseln kannst. Jeder Desktop hat eigene Minianwendungen.
Kioskmodus
Bedienbare Übersicht unter /kiosk. Du kannst mit den Rechten deines Kontos Minianwendungen bearbeiten, virtuelle Desktops wechseln und am Zahnrad Theme, Schriftart und Schriftgröße einstellen.
Minianwendung
Kompakte Anzeige in der Übersicht, etwa Uhr, Kalender, Notizen, Wetter oder eine Tabelle aus einer freigegebenen Datenquelle.
Handschrift
Notiztyp zum Schreiben und Zeichnen mit Stift, Finger oder Maus. Die App speichert die einzelnen Striche im Benutzerkonto.
Notizblatt
Eine Seite einer Notiz-Minianwendung. Jedes Blatt hat seinen eigenen Inhalt und Typ. Datenblätter können ihre selbst eingegebenen Werte als Tabelle oder Diagramm darstellen.
Spalten für Checklisten
Maximale Anzahl nebeneinander angeordneter Spalten im Notizbuch. Bei knapper Breite verwendet die Minianwendung weniger Spalten. Gruppen und Untereinträge bleiben zusammen. Checkliste bearbeiten
Untereintrag
Ein Checklistenpunkt unter einem anderen Eintrag. Am Ziehgriff kannst du ihn mit seinen eigenen Untereinträgen verschieben. Checkliste bearbeiten
Registrierungslink
Persönlicher Zugang zum Registrierungsformular. ZeitenSchleife versendet den Link auf Anfrage per E-Mail. Er gilt 30 Minuten und ist einmal für die zugehörige E-Mail-Adresse einlösbar.
Registrierungs-Token
Einmaliger Code im Registrierungslink. ZeitenSchleife liest ihn beim Öffnen automatisch aus, entfernt ihn aus der sichtbaren Adresse und prüft ihn beim Absenden des Formulars.
Kennwort-Reset-Link
Persönlicher E-Mail-Link mit einem einmalig verwendbaren Token für ein bestehendes Konto. Er gilt 30 Minuten. Beim Öffnen übernimmt ZeitenSchleife den Token. Nach dem Speichern des neuen Kennworts endet die Gültigkeit des Links und aller bisherigen ZeitenSchleife-Sitzungen dieses Kontos. Kennwort zurücksetzen
Registrierungsanfrage
Antrag für ein Benutzerkonto, der nach dem Öffnen des Registrierungslinks über ein Formular eingereicht wird. Admins prüfen offene Anfragen unter „Administration → Registrierungen“.
Abgeschlossene Registrierungen
Genehmigte und abgelehnte Anfragen unter „Ereignisse → Registrierungen“. Bei Freigaben sind dort auch der Versandstatus der Bestätigungsmail und bei Bedarf „Bestätigung erneut senden“ verfügbar.
Automatischer Benutzername
Bei der Registrierung aus Vor- und Nachname erzeugte Anmeldekennung, zum Beispiel julia.mueller. ZeitenSchleife prüft vorhandene Konten und offene Registrierungen und vergibt bei Namensgleichheit den ersten freien Zusatz .1, .2 und so weiter.
Registrierungsgenehmigung
Verbindliche Prüfung einer abgeschickten Registrierung durch einen Admin. Bei Freigabe erstellt ZeitenSchleife das Konto und sendet den endgültigen Benutzernamen mit einem Link zur Anmeldung an die angegebene E-Mail-Adresse. Für die Anmeldung gilt das im Registrierungsformular gewählte Kennwort.
Statuskachel
Filter mit einem Zähler. Wähle eine Kachel, um beispielsweise wartende Meldungen oder erledigte Aufgaben zu sehen. Der Zähler bezieht sich auf die gewählte Ansicht und die aktuell geladenen Daten.
Benachrichtigung
Persönlicher Hinweis mit Quelle und Zeitpunkt. Beim Öffnen springt die App zum verknüpften Vorgang, zum Plugin oder zur Systemmeldung, sofern du Zugriff darauf hast.
Terminerinnerung
Persönliche Benachrichtigung zum Beginn eines Termins oder zu einer ausgewählten Zeit davor. ZeitenSchleife speichert sie auch für abgemeldete Konten.
Hinweis
Ankündigung oder Treffer einer Datenquelle mit Zeitplan und Zielgruppe. Hinweise können beim Start als kleine Meldungen erscheinen.
Hinweisvariable
Ein im Hinweisformular ausgewählter Platzhalter für Titel oder Nachricht. Beim Anzeigen wird er durch einen aktuellen Kontextwert, ein lesbares Feld der Quelle oder eine freigegebene Eigenschaft eines ausgewählten Benutzerkontos ersetzt.
Zusatzquelle eines Hinweises
Liefert dem Titel oder Nachrichtentext eines internen Hinweises zusätzliche lesbare Werte aus ihrem ersten passenden Datensatz.
Hinweisverlauf
Liste der aktuell gültigen Hinweise für das angemeldete Administratorkonto unter „Ereignisse → Hinweise“. Dort lassen sich ausgeblendete Vorkommen wieder anzeigen. Die Regeln verwaltest du im Fenster „Hinweise“.
Vorkommen
Ein konkreter Termin eines Hinweises, gegebenenfalls zu einem einzelnen Datensatz. „Nicht mehr anzeigen“ gilt für dieses Vorkommen. Die nächste Wiederholung kann erneut erscheinen.
Deckkraft der Desktopfarbe
Bestimmt im Style-Designer, wie deutlich das Hintergrundbild zu sehen ist. Bei 100 Prozent deckt die Farbe das Bild vollständig ab.

Arbeitsbereich in der Benutzer-Hilfe

Abläufe und Portal

Ablaufvorlage
Wiederverwendbare Definition der Schritte, Zuständigkeiten, Aktionen und Übergänge. Im Designer unter „Erstellen“ kannst du Vorlagen bearbeiten.
Vorgang
Eine gestartete Ausführung mit Titel, Status, Zuständigkeit und Verlauf. Jeder Vorgang behält die zum Start gespeicherte Vorlage.
Pflichtaktion
Aktion, die erfolgreich sein muss, bevor der Vorgang weiterrückt. Der Vorgang bleibt am aktuellen Schritt. Nach einem endgültigen Fehler kann der zuständige Bearbeiter die Aktion erneut versuchen.
Portal-Feldzuordnung
Verbindung zwischen einem Feld im Meldeformular und einem passenden Aktionsfeld im Ablauf. Bei der Übernahme wird die beim Absenden geprüfte Antwort im Vorgang gespeichert. Fehlt sie, kann die Aktion einen eingestellten Ersatzwert verwenden.
Übernahmeauftrag und Übernahmebeleg
Der Auftrag hält eine Plugin-Übergabe über Neustarts hinweg fest. Der Beleg speichert die ID des im Ziel erzeugten Eintrags. Beide verwenden dieselbe Auftragskennung.
Terminfreigabe
Öffentlicher Link zu Titel und Zeitraum eines lokalen Termins. Jeder Link läuft zu einem eigenen Zeitpunkt ab und lässt sich einzeln widerrufen. Bei Löschung des Originaltermins verlieren alle zugehörigen Links ihre Gültigkeit.
Leseberechtigung einer Datenquelle
RBAC-Recht an einer konkreten Bereitstellung. Es steuert Auswahl und Nutzung, etwa für ein IMAP-Postfach oder einen externen Kalender.
Aktueller Schritt
Die Stelle, an der ein offener Vorgang gerade steht oder wartet. Nach Ende des Vorgangs bleibt die Historie sichtbar.
Miniatur-Prozessablaufplan
Kleine Anzeige der Schrittfolge auf der Vorgangskarte und im Bearbeitungsstand eines verknüpften Portal-Tickets. Der aktive Schritt steht nummeriert und in Akzentfarbe in der Mitte. Unter „Abläufe → Einstellungen“ lässt sich die Anzeige auf den Vorgangskarten ausblenden.
Maximale Kartenspalten
Obergrenze für die Spalten der Kartenansicht. Auf einem schmalen Fenster passt sich die sichtbare Spaltenzahl an den verfügbaren Platz an.
Prozessablauf im Vorgang
Grafik der beim Start gespeicherten Vorlage mit aktuellem Schritt, tatsächlich durchlaufenen Verbindungen, Verzweigungen und Schleifen.
Wartend
Im Ablauf steht eine Bearbeitung, Freigabe, Pflichtaktion oder ein Auslöser aus. Im Portal-Eingang umfasst „Wartende“ zusätzlich Meldungen, die noch übernommen oder geprüft werden.
Auslöser
Ereignis, das eine Vorlage automatisch startet oder einen wartenden Ablauf fortsetzt, etwa eine neue IMAP-Nachricht oder der Beginn eines ausgewählten Kalendertermins.
IMAP-Automation
Lizenzpflichtiger E-Mail-Auslöser für Abläufe, Pläne und Kalender. Die manuelle Vorschau und der Download von Anhängen in Datenquellen verwenden den IMAP-Adapter direkt.
Verarbeitung von E-Mails in Pläne
Eine Liste kann passende neue E-Mails zur Annahme sammeln oder automatisch als Aufgabe speichern. Betreff, Absender und Nachrichtentext liefern Titel und Beschreibung.
E-Mail-Filter
Bis zu zehn Bedingungen für den Posteingang. Alle müssen passen. Felder sind Betreff, Nachrichtentext, Absenderadresse und Benutzer als Absender. Das Benutzerkonto liefert die aktuelle Vergleichsadresse.
Erinnerungen aus einem Kalender
Erinnerungen aus Outlook, CalDAV oder iCalendar. Im Terminformular und in den Termindetails zeigt ein Badge den Quellkalender. Erinnert dich auch ZeitenSchleife zum selben Zeitpunkt, stehen beide Badges am selben Eintrag. Beim Hinzufügen einer Erinnerung kannst du unter „Speichern in“ ZeitenSchleife und den schreibbaren Quellkalender einzeln oder zusammen auswählen.
Listenvorlage
Eine persönliche Vorlage mit Aufgabentiteln und Beschreibungen. Eine daraus angelegte Liste ist eigenständig und ihre Aufgaben beginnen offen.
SMTP-Regel
Verbindet ein registriertes Plugin-Ereignis mit einem Empfängerkonto und der SMTP-Zuordnung des Plugins. Mit app.mail.changed(name, audience, actorId) meldet Plugin-Code eine gespeicherte Änderung. audience enthält die betroffenen Konten. null steht für Ereignisse, die jedes Konto mit dem zugehörigen Leserecht sehen darf. Die optionale actorId bezeichnet das Konto, das die Änderung ausgelöst hat.
Teampostfach
Ein E-Mail-Postfach, das einer RBAC-Gruppe zugeordnet ist. Gruppenmitglieder verwenden es mit ihren jeweiligen Funktionsrechten. Business enthält die Freigabe. Die Kennung für eine separate Freigabe lautet feature.mailclient.teampostfaecher.
Verzweigungsfall
Ordnet ein Ablaufergebnis einem Folgeschritt zu. „Sonst“ ist der Folgeschritt für Ergebnisse ohne eigenen Fall.
Schleifenende
Prüft Ausstiegsbedingungen nach einem Durchlauf. Erfüllte Bedingungen beenden die Wiederholung.
Tickettyp
Ein im Portal freigegebenes Ablaufformular mit einer Standard-Ablaufvorlage.
Portal-Designer
Editor für Formulare zu Abläufen, Terminen und neuen Bestandseinträgen. Er steuert die Felder, Pflichtangaben und Zugänge. Beim Ablauf können Regeln eine andere Vorlage wählen.
Öffentliche Portal-Adresse
Pfad zum Meldeformular für Kunden ohne Konto. /portal ist der Standard. Ein weiterer Pfad kann in den Portal-Einstellungen hinterlegt werden. Der Servername kommt aus der Browseradresse.
Interne Portal-Adresse
/portal/intern öffnet das Portal nach der App-Anmeldung. Eigene Meldungen werden dem Konto zugeordnet und über die Portal-Rechte freigegeben.
Persönlicher Statuslink
Link zu einer einzelnen öffentlichen Meldung. Der Zufallsschlüssel im Link dient als Zugriffsnachweis. Er wird in der Portal-Datenbank als Hash gespeichert.
Übernahme
Aktion im Portal-Eingang, die aus einer Meldung einen Vorgang, Termin, Bestandsdatensatz oder eine Aufgabe im Ziel-Plugin erstellt.
Bearbeitungsstand
Für Melder sichtbarer Status. Bei einem verknüpften Ablaufticket können dazu Meilensteine und die letzten freigegebenen Ereignisse erscheinen. Bei einer verknüpften Aufgabe zeigt er, ob diese offen oder erledigt ist.
Terminmitteilung
Veröffentlichung eines gespeicherten Kalendertermins mit Titel, Beginn und Ende. Der Kalender gibt dem Mitarbeiter einen Freigabelink für Kunden aus.

Vorgänge verfolgen · Portal-Eingang bedienen

Bestand, Kalender und Pläne

Teamliste
Liste in Pläne, die ihr Ersteller für eine eigene RBAC-Gruppe freigibt. Die Gruppenmitgliedschaft und das Plugin-Recht bestimmen, wer die Liste sehen oder Aufgaben bearbeiten kann.
Bestandstyp
Legt die Felder eines Bestandsobjekts fest. In der Ansicht kannst du nach Typen, Gruppen und Feldern filtern.
Hauptobjekt
Bestandseintrag, der Eigenschaften an seine Unterobjekte weitergibt. Ein Unterobjekt kann mehrere geordnete Hauptobjekte haben. Eigene Einträge haben Vorrang.
Bestands-QR-Code
Verweist mit /?bestand=ID auf einen Eintrag. Der Scanner in Bestand liest auf Mobilgeräten Kamera oder Foto und öffnet Codes dieser Installation. Zugriff und Bearbeitung richten sich nach den Bestandsrechten. Bestands-QR-Code scannen
QR-Aktion
Regel pro Bestandstyp für den Scanner in Bestand. Sie öffnet einen Eintrag oder ändert nach Bestätigung ein ausgewähltes Feld. QR-Aktion einrichten
Kalenderquelle
Bereitstellung eines externen Kalenders. Du kannst Kalender in der Ansicht einblenden und aus unterstützten Quellen lokale Kopien importieren, wenn die Funktion freigegeben ist.
Zentrales Abrufintervall
Vorgabe der Kalender-Datenquelle für automatische Anbieterabfragen. Bei „Manuell“ verwenden Ansichten und Erinnerungen nur vorhandene Abrufdaten. Das persönliche Intervall im Kalender und die Einstellung je Minianwendung können weitere automatische Abfragen verzögern.
Ganztagstermin
Termin für einen oder mehrere Kalendertage. Die Termindetails zeigen die Daten und die Kennzeichnung „Ganztägig“.
Kalenderfilter einer Minianwendung
Eine Liste ausgeblendeter Kalender-IDs, die je Minianwendung gespeichert wird. Der Kalender und weitere Minianwendungen bleiben davon unabhängig.
Liste / Aufgabe
Pläne gliedert persönliche Aufgaben in Listen. Eine Aufgabe hat einen Titel, einen Erledigungsstatus und bei Bedarf ein Fälligkeitsdatum.
Aufgabe aus dem Portal
Bei der Übernahme in Pläne speichert das Ziel-Plugin die Meldungsnummer und die Formularantworten in den Aufgabendetails. Ein im Portal-Designer zugeordnetes Datum wird als Fälligkeit weitergegeben.
Unterschrift
Bestätigung eines gespeicherten Eintragsstands durch ein angemeldetes Konto mit Freigabe für den Dienst. Gespeicherte Fassungen sind über den Eintrag nachvollziehbar.

Bestand · Kalender · Pläne

E-Mail-Client

Mail-LinkProvider
Durchsuchbare E-Mails aus freigegebenen Eingangsordnern. Als Ausgangspunkt für Verknüpfungen stehen unter anderem Betreff, Von, An, Cc, Bcc, Nachrichtentext, Datumsangaben und Anhänge zur Verfügung. E-Mails verknüpfen
Kennzahl der E-Mail-Minianwendung
Wählbarer Wert zum Postfach. „Ungelesen“, „Gelesen“ und „Gesamt“ zählen Nachrichten im Eingangsordner. „Größe“ misst die freigegebenen Ordner. Mehrere Kennzahlen können gleichzeitig angezeigt werden. Die Tabelle zeigt eine Zeile pro Postfach mit den gewählten Spalten. E-Mail-Minianwendung einstellen
Sichtbare Postfächer
Persönliche Auswahl unter „Einstellungen → Postfächer“. Berechtigte Postfächer erscheinen automatisch. Ausgeblendete Postfächer fehlen auch im gemeinsamen Posteingang und in den Mail-Minianwendungen.
Nachrichtenspalte
Optionale Klartextvorschau neben dem Betreff. Unter „Einstellungen → Mailliste → Spalten“ kannst du sie für dein Konto einblenden und eine oder drei Zeilen festlegen.
Lesestatus
Kennzeichnet eine E-Mail als gelesen oder ungelesen. Der Spaltenfilter „Lesestatus“ wendet die Auswahl auf die IMAP-Suche über alle Nachrichtenseiten an. Weitere Spaltenfilter grenzen die bereits geladene Seite ein.
Ordnerbaum
Ansicht der Postfachordner mit gestrichelten Verbindungslinien. Pfeile klappen Unterordner ein und aus. Unter „Einstellungen → Ordner → Ordnerstruktur“ kannst du die Anzeige der übergeordneten Ordnernamen ausschalten.
E-Mail-Archiv
Persönliche Ablage vollständiger E-Mail-Kopien mit Anhängen in der Plugin-Datenbank. Unter „Archiv“ findest du die Kopien nach Postfach und ursprünglichem Ordner. „Aus Archiv entfernen“ löscht deine Kopie samt Anhängen. Das Original bleibt im Postfach. E-Mails archivieren

Administration

Benutzerdefiniertes Datumsformat
Formatmuster für die Darstellung von Datum und Uhrzeit. Die Administration legt damit Reihenfolge und Trennzeichen der Bestandteile fest.
RBAC
Rollenbasierte Zugriffskontrolle. Berechtigungen legen erlaubte Funktionen fest. Rollen bündeln Berechtigungen. Konten können Rechte direkt und über Rollen oder Gruppen erhalten.
RBAC-Prüfung
Zeigt unter „Administration → RBAC → Prüfung“, welche Konten, Rollen oder Berechtigungen keine wirksame Zuordnung haben und welche Konten Vollzugriff erhalten.
RBAC-Schnappschuss
Wiederherstellbarer Stand der Rollen, Gruppen, Berechtigungen und Zuweisungen in der Kerndatenbank. Beim Zurückspielen entsteht automatisch ein Rückfallstand. Die Verwaltung und ihre Minianwendung verwenden feature.rbac-snapshots. Schnappschüsse verwalten
Microsoft Graph und Gmail-API
Schnittstellen, über die der E-Mail-Client auf ein Outlook-, Microsoft-365- oder Gmail-Postfach zugreift. Eine API-Bereitstellung kann lesen und versenden. Das Postfach erteilt die Freigabe beim Anbieter über OAuth 2.0. Outlook und Gmail einrichten
Mail-App
In ZeitenSchleife hinterlegte Anbieterregistrierung für Microsoft Graph oder Gmail. Sie enthält Client-ID und verschlüsseltes Client-Geheimnis. Mehrere Postfächer können dieselbe Mail-App verwenden und erteilen ihre Freigaben einzeln. Mail-App anlegen
Weiterleitungs-URI
HTTPS-Rückrufadresse der ZeitenSchleife-Installation. Nach der Postfachfreigabe kehrt der Browser darüber vom Anbieter zurück. Die genaue Adresse steht unter „Datenquellen → Mail-Apps“.
Anzeigenamensformat
Instanzweite Reihenfolge und Schreibweise von Vor- und Nachnamen. Ein eigenes Muster verwendet {vorname} und {nachname}. Die Anmeldekennung bleibt gleich.
Floating-Platz
Vorübergehend belegter Lizenzplatz für ein Konto mit mindestens einem geöffneten, angemeldeten App-Tab. Tabs und Geräte desselben Kontos teilen einen Platz. Der Platz wird nach dem Schließen der letzten App-Verbindung frei. Die Anzahl kommt aus maxSeats in der signierten VaultiFy-Lizenz. Der lokale Admin und das öffentliche Portal belegen keinen Platz.
Lizenzkatalog
Liste der Hauptlizenz, Plugins, separat lizenzierbaren Funktionen und Dienste. Unter „Administration → Lizenzen“ siehst du, welche Einträge für deine Installation aktiv sind.
Root-Key-Fingerabdruck
SHA-256-Kennung des öffentlichen VaultiFy-Schlüssels, mit dem ZeitenSchleife Lizenzsignaturen prüft. Unter „Administration → Lizenzen → Installation“ kannst du sie mit VaultiFy vergleichen und den letzten Schlüsselwechsel per ZIP nachsehen.
Authentik / OpenID Connect
Externer Anmeldeanbieter für bereits verknüpfte ZeitenSchleife-Konten. Die Freigabe service.authentik schaltet die Verbindung zur Authentik-Anwendung frei. Konten werden über die Ausstelleradresse und die eindeutige Benutzerkennung aus Authentik zugeordnet.
LDAP-Zuordnung
Verbindet ein LDAP-Attribut mit einer Spalte in der ZeitenSchleife-Benutzertabelle, etwa department mit abteilung.
BookStack (REST)
Adapter mit der Dienstfreigabe service.bookstack für einen Inhaltstyp aus BookStack. Er stellt Listen von Regalen, Büchern, Kapiteln oder Seiten per API-Token bereit. BookStack anbinden.
Adapter / Bereitstellung
Ein Adapter kennt die Verbindung zu einem System. Eine Bereitstellung speichert die konkrete Verbindung samt Einstellungen und Freigaben. Unter „Datenquellen“ kannst du sie testen.
LinkProvider
Registry-Eintrag, über den eine Anwendung oder ein Plugin eine freigegebene Funktion, Aktion oder einen Auslöser aufrufen kann.
Objektverknüpfung
No-Code-Zuordnung einer Eigenschaft zu einem Zielfeld einer freigegebenen Plugin-Liste. „Ist“ vergleicht den ganzen Wert. „Enthält“ findet auch Teiltreffer im Zielfeld. Klickbare Werte sind gestrichelt unterstrichen. Berechtigte Treffer erscheinen in einer Seitenleiste, einer FeedBox oder einem Tooltip. LinkProvider einrichten.
Eventlog
Technische Meldungen von Server, Plugins und berechtigten Nutzern der Oberfläche. Unter „Ereignisse → Eventlog“ erscheint die aktuelle Liste automatisch. Bei Fehlern und Warnungen lassen sich weitere Details öffnen.
Audit
Protokolliert Anmeldungen und ändernde Anfragen angemeldeter Konten mit Zeit, Identität und Ergebnis. Die Ansicht unter „Ereignisse → Audit“ lädt neue Einträge automatisch.
Dateimaskierung
Zufällige Kennungen im physischen Speicher. Die Dateiverwaltung zeigt den Anzeigenamen. Tags helfen dabei, Dateien zu finden und zu gruppieren.
Datei-Tag
Ein Schlagwort, das du einer Datei zuordnest und später als Filter verwenden kannst.
EAV
Entity–Attribute–Value. Eine Zeile verbindet einen Datensatz mit einer Eigenschaft und ihrem Wert. Details stehen unter Datenbankaufbau.

Admin-Hilfe · Lizenzierung mit VaultiFy

Plugin-Schnittstelle

Importiere im Plugin services aus ../../server/serviceRegistry.js. Passe im Kern den relativen Pfad an. Plugins laufen in eigenen Workern. SQL und WebSockets sind für Plugins auf ihren jeweiligen Namespace beschränkt.

AufrufWirkung
services.get('adapters').list()Im Kern die verfügbaren Adapter auflisten.
services.get('connections').for('calendar').test('calendar')Die einem Plugin zugewiesene Bereitstellung einer Kategorie testen.
services.get('sql').for('workflow').query(sql, parameter)Parametrisierte Abfrage auf der zugewiesenen Plugin-Datenbank. Im Kern ist zusätzlich der Namespace SYSTEM verfügbar.
services.get('sql').for('workflow').transaction(anweisungen)Mehrere Anweisungen in einer Transaktion ausführen. Ein optionales expectedRows verhindert gleichzeitiges Bearbeiten.
services.get('websocket').for('workflow').send(userId, ereignis, daten)Eine Nachricht nur an die Verbindungen des angegebenen Benutzers senden.
services.get('registry').call(id, parameter)Eine geladene und freigegebene Plugin-Funktion aufrufen.
services.get('plugins').list()Im Plugin die Liste bekannter Plugins und ihren Zustand abrufen.
services.get('plugins').call(id, parameter)Im Plugin eine freigegebene Funktion aus der Registry aufrufen. Start und Stopp bleiben dem Kern vorbehalten.
services.get('rbac').has(userId, permission)Im Plugin eine Berechtigung über den Kern abfragen.
services.get('rbac').permissions(user)Im Kern die zwischengespeicherten Berechtigungen eines Benutzers abrufen.
app.registry.register(eintrag)Eine Aktion oder einen LinkProvider beim Start registrieren. Ein LinkProvider mit dashboard stellt seine Daten auch als Minianwendung bereit.
app.routes.register(route)Eine Plugin-Funktion, HTTP-Methode und erforderliche Berechtigung anmelden.
app.notifications.send(userId, nachricht, ziel, integrationKey, actorId)Eine Nachricht speichern, die beim Anklicken das sendende Plugin öffnet. Eine optionale serverinterne Auftragskennung verhindert doppelte Nachrichten bei Wiederholungen. Mit actorId speichert die Benachrichtigung das auslösende Konto. Mit ziel kann das Plugin einen konkreten Eintrag angeben, etwa { view: 'run', id: vorgangId }.
app.eventlog.write(code, nachricht, fehler)Pluginname und Aufrufstelle automatisch im Eventlog erfassen.

Aufrufe über Worker-Grenzen liefern Promises und benötigen await. Die IDs workflow und calendar bezeichnen in der Oberfläche die Plugins Abläufe und Kalender.

Registry und Datenquellen

LinkProvider-Konfiguration pro Plugin
In der Administration stellst du Freigabe, Filter und sichtbare Spalten einer Anbieter-Liste pro Plugin ein. Bis zu zehn Filterbedingungen lassen sich mit UND oder ODER verbinden. Die Vorschau verwendet die Rechte des angemeldeten Kontos.
providerFilterFields(columns)
Liefert die Namen und Typen der Filterfelder für die Registry. providerListRestriction(filter, columns) verbindet die einzelne Bedingung oder die Filtergruppe mit der Plugin-Abfrage. Die Werte werden gebunden und die Gruppe wird vor dem Ergebnislimit ausgewertet.
app.connections.options('calendar', userId)
Liefert die für das Konto freigegebenen Quellen. app.connections.calendar(id, from, to, userId) liest und app.connections.calendarUpdate(id, event, userId) bearbeitet Einträge mit der jeweiligen Berechtigung. event.sourceReminderChanges kann Änderungen an Quellerinnerungen mitgeben. Die bearbeitbaren IDs liefert sourceReminderEditing des gelesenen Termins. Ohne sourceReminderChanges bleiben die Quellerinnerungen erhalten.
app.mail.sources(userId)
Liefert die für das Konto freigegebenen IMAP-Postfächer. app.mail.prepare(sourceId, userId) initialisiert den Lesestand. app.mail.events(options, userId) gibt dem Plugin die zulässigen Eingangssignale zurück.
app.mail.accounts(userId, ids)
Liefert Konten für E-Mail-Absenderfilter. Ohne ids erhält der Dialog nur Kennungen und Namen. Für die ausgewählten Kennungen liefert der Aufruf dem Plugin zusätzlich die aktuellen E-Mail-Adressen für den Vergleich.
app.mailClient.call(operation, sourceId, userId, input)
Stellt dem E-Mail-Client geprüfte IMAP- und SMTP-Operationen bereit. Der Client prüft die Postfachzuordnung. Der Kern prüft die Route, die sichere Verbindung und beim Versand den bestätigten Absender. app.mailClient.sourcesFor(userId) liefert die für das Konto freigegebenen Quellen für automatische Postfächer. app.mailClient.options() liefert Einrichtungsoptionen und app.mailClient.teamLicensed() die aktuelle Freigabe für Teampostfächer.
app.groups.mine(userId)
Liefert dem geladenen Plugin Pläne die RBAC-Gruppen eines Kontos. Über app.groups.members(groupId) ermittelt Pläne die Empfänger der Änderungssignale für eine Teamliste.
app.connections.options('ai')
Liefert in Abläufe verfügbare KI-Quellen. app.connections.ai(id, prompt) führt den REST-Aufruf im Kern aus.
app.registry.register({ id, label, kind: 'dashboard', method, route })
Meldet Daten für Minianwendungen an. route nennt die freigegebene Lesefunktion. method liefert je Benutzer Zeilen mit label und value.
app.registry.register({ id, label, kind: 'portal-intake', route, method, … })
Meldet eine Meldeart aus dem Ziel-Plugin an. route und method bezeichnen das Ziel der Übernahme. optionLabel, optionsMethod und optionsRoute ergänzen bei Bedarf eine Auswahl. needsPeriod blendet zwei Zeitfelder ein. Aufrufen kann die Verbindung nur das Portal mit einem Benutzer, der sowohl übernehmen als auch die Ziel-Funktion ausführen darf.
portal-publication
Interner Registry-Typ für Veröffentlichungen aus einem Quell-Plugin. Bei portal.calendarPublication ist publisher das Kalender-Plugin. route bezeichnet die Berechtigungsprüfung im Kalender. optionsMethod liefert berechtigte Empfängerkonten. method speichert die Terminmitteilung und löst die Benachrichtigung aus.
plans.addTask
Registry-Aktion für Abläufe. title ist der Aufgabentitel. Der Server prüft das Schreibrecht für das Konto, in dessen Liste „Aufgaben aus Abläufen“ eingetragen wird.
plans.overview
Datenquelle für Minianwendungen. Liefert pro eigener Liste die Spalten „Liste“, „Aufgaben“ und „Erledigt“.
consumers, requiresDatabase und checkActor
Optionale Angaben bei Registry-Aktionen. consumers gibt vorgesehene Plugin-Aufrufer an. requiresDatabase setzt beim Plugin-Zugriff eine aktive Datenbank voraus. Mit checkActor prüft die Registry die Berechtigung des angegebenen userId für die zugeordnete route.
app.registry.call('portal.workflowUpdate', { id })
Internes Signal des Ablauf-Plugins nach einem Schrittwechsel. Das Portal sucht die verknüpften Meldungen und benachrichtigt deren Melder und den berechtigten Eingang über WebSocket.
plans.portalIntake
Registry-Eintrag, über den das Portal eine Meldung als Aufgabe in eine eigene Liste des Bearbeiters übernimmt.
app.registry.call('portal.planUpdate', { id })
Internes Signal von Pläne an das Portal bei einer Änderung. Beim Löschen einer Liste kann Pläne mit { ids } mehrere Aufgaben melden.
app.websocket.broadcast(event, route)
Verteilt ein Signal an angemeldete Benutzer mit Zugriff auf die angegebene Plugin-Funktion.
service.signatures
Separat lizenzierbarer Dienst für Unterschriften im Kern. Eine Plugin-Leseroute kann mit signatureTarget eine gleichbleibende Dokumentansicht aus der Datenbank bereitstellen. Der Dienst bindet die Stiftzüge an den SHA-256-Hash dieser Version und das angemeldete Konto.
signatureTarget({ id, userId })
Liefert den Inhalt, der unterschrieben wird. Die Liste fields enthält Kennung, Beschriftung und Wert. Prüfe im Plugin, ob das Konto den Eintrag sehen darf, und gib bei fehlendem Zugriff null zurück.

Mit providesData: true, previewMethod und route kann ein Plugin einen Registry-Eintrag als Datenquelle kennzeichnen. Die Vorschaufunktion liefert bis zu 25 Zeilen. columns legt die Spalten auch für leere Ergebnislisten fest.

Im Kern ist die Bereitstellungs-Registry über services.get('dataSources') erreichbar und der Adapter-Katalog über services.get('adapters'). Ein Plugin verwendet seine SMTP-Verbindung über app.connections.sendMail(nachricht). app.files.add(name, bytes, userId) legt eine Datei zentral ab und gibt ihre Kennung zurück. Der Namespace ergibt sich aus dem laufenden Plugin.

Bedienelemente

PluginWindow
Gemeinsames Layout für Pluginfenster. sections und active steuern das Seitenmenü. In menu stehen Filter und Ansichten, in actions die Aktionen der Kopfleiste. Der Standardslot enthält den scrollbaren Inhalt.
FeedBox
Zeigt Hinweise, Bestätigungen und Details an. Mit modal und title öffnet sich die FeedBox als Dialog über dem abgedunkelten Arbeitsbereich, etwa für Eventlog-Details. cancel meldet das Schließen per Escape oder Klick außerhalb.
CheckBox
Markiert einen einzelnen Eintrag. Die Eigenschaft label gibt der Checkbox einen Namen für Screenreader. Sichtbarer Text wird als Inhalt übergeben. In Bestand trägt jede Checkbox den Namen des jeweiligen Eintrags.
StatusTiles
Gemeinsame Kacheln für Statusfilter und Trefferzahlen. Die Ansicht definiert die Filter und den gewählten Status.