System E-Mails

System-E-Mails im Backend

System-E-Mails zeigt gespeicherte Kopien versendeter Shop-Mails und hilft beim Suchen, Pruefen und Loeschen dieser Protokolleintraege.

Inhaltsverzeichnis

Voraussetzung und Zweck

Der Bereich ist nur mit dem Recht fuer System-E-Mails erreichbar. Eintraege entstehen, wenn Mailversandstellen im Shop Systememail::createEntry aufrufen und damit eine Kopie in der Systememail-Tabelle speichern.

  • Gespeicherte Daten: Ein Systememail-Eintrag enthaelt datumzeit, to_email, subject, body, meta, optional order_id und optional cust_id.
  • Systemadresse: Die System-E-Mail-Adresse wird in Stammdaten oder Multishop-Einstellungen gepflegt und kann fuer Kopien per BCC genutzt werden.
  • Kopiermodus: Wenn E-Mail-Kopien im System gespeichert werden, erscheinen diese Kopien in dieser Liste. Wenn stattdessen BCC-Kopien versendet werden, entstehen keine Listeneintraege.
  • Direktlink: Nach dem Speichern kann ein Loglink auf einen Eintrag zeigen und die Detailansicht beim Laden automatisch oeffnen.

Filter und Suche

Die Liste nutzt SystememailFilter mit maximal 1000 Ergebnissen. Die sichtbare Suchzeile durchsucht die wichtigsten Textfelder per Volltextsuche.

  • Suche: Suchbegriffe werden in einzelne Woerter zerlegt.
  • Suchfelder: Gesucht wird in to_email, subject, body und meta.
  • Trefferzaehler: Die rechte Filterbox zeigt die Gesamtanzahl gespeicherter E-Mails.
  • Aktive Filter: Der Filter kann aktive Kriterien erkennen und bei leerem Suchergebnis einen Reset-Hinweis anbieten.
  • Weitere Filterfelder: Die Filterklasse enthaelt geerbte Filtermasken, sichtbar und fachlich relevant ist in dieser Liste vor allem die Suchzeile.

Tabelle

Die Tabelle systememail ist eine konfigurierbare BsTable. Standardmaessig wird nach Datum/Zeit absteigend sortiert.

Tabellenspalten anpassen: In vielen Backend-Tabellen kannst du ueber die Tabelleneinstellungen festlegen, welche Spalten sichtbar sind. Blende selten benoetigte Spalten aus, wenn du eine kompaktere Arbeitsansicht brauchst, und aktiviere sie wieder, wenn du die Informationen pruefen oder bearbeiten willst.
  • Auswahl: Checkbox fuer Sammelaktionen.
  • ID: technische Nummer des gespeicherten E-Mail-Eintrags; auf kleinen Ansichten ausgeblendet.
  • Datum/Zeit: zeigt datumzeit und ist die Standardsortierung absteigend.
  • Betreff: zeigt subject.
  • Empfaenger: zeigt to_email.
  • Optionen: enthaelt Anzeigen. Die Lupe oeffnet die Detailansicht im Modal. Die Optionsspalte ist zentriert und nicht sortierbar.

Detailansicht

Die Aktion Anzeigen oeffnet den gespeicherten Eintrag im Modal E-Mail Details.

  • Datum/Zeit: Wert aus datumzeit.
  • Betreff: Wert aus subject.
  • Empfaenger: Wert aus to_email.
  • E-Mail: Wert aus meta. Dieser Bereich kann den gespeicherten MIME-Inhalt, HTML oder weitere Versandinformationen enthalten.
  • Automatisches Oeffnen: Wenn die Seite mit einem passenden Detailparameter geladen wird, oeffnet ein Script die Detailansicht direkt nach dem Laden.

Ausgewaehlte E-Mails loeschen

Die Sammelaktion Loeschen arbeitet mit markierten Tabellenzeilen.

  1. Eine oder mehrere E-Mail-Eintraege in der Tabelle markieren.
  2. Die Sammelaktion Loeschen auswaehlen.
  3. Das Bestaetigungsmodal absenden.
  4. Das Backend loescht die gewaehlten IDs und schreibt pro Eintrag einen Backend-Logeintrag mit der geloeschten Systememail-ID.
  5. Nach der Aktion leitet das Backend zur System-E-Mail-Liste zurueck.

Gebundelt loeschen

Backend-Benutzer mit der Benutzer-ID 1 sehen unter der Tabelle eine zusaetzliche Funktion zum Leeren der gesamten Systememail-Tabelle.

  • adminPass: Passwortfeld im Formular delall. Das Passwort wird gegen die aktuellen Admin-Anmeldedaten geprueft.
  • Erfolgreiche Pruefung: Das Backend schreibt einen Logeintrag und leert die gesamte Systememail-Tabelle.
  • Fehlerfall: Bei fehlender Berechtigung oder falschem Passwort bleibt der Datenbestand erhalten und das Modal zeigt eine Fehlermeldung.
  • Sichtbarkeit: Die Funktion wird nur fuer den Super-Admin-Benutzer mit ID 1 angezeigt.

API-Bezug

Die API-v2 stellt Systememails ebenfalls bereit. Die Backendseite nutzt diese API nicht direkt, aber die Felder und Suchlogik sind vergleichbar.

  • Liste: Die API liefert paginierte Systememail-Zusammenfassungen mit ID, Zeitpunkt, Empfaenger, Betreff, Bestell-ID und Kunden-ID.
  • Details: Detailabrufe koennen body, meta sowie Links zu Bestellung und Kunde enthalten.
  • Suche: Die API-Suche arbeitet ueber Empfaenger, Betreff, Body und Meta-Informationen.
  • Loeschen: Ein API-Delete entfernt den angegebenen Systememail-Datensatz.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.