Branding, Vorschauen und Feldlayouts konfigurieren

Zweck und Einsatzbereich

Unter Einstellungen → Firma bündelt NeuraPort Firmendaten, Dokumenten-Design, Vorlagen und Formular-Anpassung. Diese Seite behandelt zwei davon:

Dokumenten-Design verwaltet Logo, Farben, Schrift, Seitengröße, Ausrichtung, Ränder und zusätzlichen Fußzeilentext für erzeugte PDFs. Eine PDF-Vorschau kann den noch nicht gespeicherten Entwurf mit synthetischen Beispieldaten darstellen.
Formular-Anpassung speichert mandantenweite Vorgaben für Sichtbarkeit, Kennzeichnung als Pflichtfeld, Bezeichnung, Reihenfolge und Spalte ausgewählter Seitenfelder.

Die Einstellung ist kein visueller Webseiten-Baukasten. Branding verändert keine bereits erzeugten PDFs. Feldkonfiguration ändert weder Datenbankfelder noch serverseitige Berechtigungen und nur teilweise die fachliche Validierung. Prüfen Sie Änderungen deshalb in einer isolierten Testorganisation mit realistisch unvollständigen, aber vollständig synthetischen Daten.

Die Auswahl einer ganz bestimmten gespeicherten Dokumentvorlage zusammen mit dem aktuellen Branding ist serverseitig vorbereitet, im aktuellen Hauptfrontend aber nicht als eigener Bedienweg angeschlossen. Der sichtbare Branding-Bereich rendert den aktuellen beziehungsweise noch ungespeicherten Brandingstand; Vorlagen besitzen einen getrennten Editor. Details dazu stehen unter Operative Dokumente und Vorlagen.

Voraussetzungen und Berechtigungen

ADMIN sieht Einstellungen → Firma und kann Branding, Logo und Formular-Anpassung bedienen.
MANAGER darf Branding und Feldkonfiguration serverseitig ändern, sieht den Bereich Firma in der aktuellen Einstellungsnavigation jedoch nicht. Ein belegter sichtbarer Verwaltungsweg fehlt daher.
Ein Plattformadministrator sieht Firma, kann dort aber keinen Zielmandanten auswählen. Die gemeinsame Modulprüfung weist Plattformidentitäten ohne normalen Mandanten- und OE-Kontext ab. Die sichtbare Plattformoberfläche ist damit kein belastbarer Weg zur Pflege eines Kundenbrandings.
Lesen und Vorschauerzeugung sind serverseitig für angemeldete Mandantenbenutzer breiter freigegeben als die sichtbare Navigation. Das ist kein Auftrag, technische Nebenwege zu verwenden; die reguläre Änderung erfolgt durch ADMIN.
Der Mandant benötigt in der aktuellen Organisationseinheit mindestens ein lesbares beziehungsweise für Änderungen schreibbares Produktmodul. Im Modus READ_ONLY bleiben gespeicherte Werte lesbar; Speichern, Logoänderung und die sichtbare Entwurfsvorschau werden als Schreibaktionen abgewiesen.
Branding und Feldkonfiguration werden für den gesamten Mandanten gespeichert. Sie besitzen keinen eigenen Organisationseinheiten-Bezug. Die aktuelle OE steuert den Zugang, begrenzt die Wirkung aber nicht auf diese OE.
Branding- und Feldkonfigurationstabellen sind über Mandantenrichtlinien der Datenbank getrennt. Das Logo liegt zusätzlich im mandantenbezogenen Uploadspeicher. Berücksichtigen Sie diesen Speicher in Sicherung, Wiederherstellung und Löschkonzept.

Schritt-für-Schritt-Anleitung

Dokumenten-Design ändern und als Entwurf prüfen

Öffnen Sie als ADMIN Einstellungen → Firma → Dokumenten-Design.
Prüfen Sie den aktuell angezeigten Mandanten. Einen OE-spezifischen Brandingstand gibt es nicht.
Laden Sie unter Logo eine PNG-, JPEG- oder SVG-Datei hoch. Verwenden Sie ausschließlich freigegebene Bilddateien bis 2 MB. Die Angabe „mindestens 300 Pixel breit“ ist eine Empfehlung der Oberfläche, keine technische Prüfung.
Stellen Sie Logo-Breite, Hauptfarbe, Akzentfarbe, Schriftart, Schriftgröße, Header-Stil, Seitengröße, Ausrichtung, vier Ränder und optionalen Fußzeilentext ein. Verwenden Sie plausible positive Maße; die Zahlenfelder besitzen keine belastbaren Min-/Max-Grenzen.
Wählen Sie rechts unter Vorschau für einen Dokumenttyp und danach Live-Vorschau generieren. Die Vorschau verwendet synthetische Beispieldaten und den aktuellen Entwurf, ohne ihn zu speichern.
Prüfen Sie Logo, Farben, Umbrüche, Ränder und leere Werte im eingebetteten PDF. Die Vorschau bestätigt weder die fachliche Vollständigkeit einer echten Akte noch die tatsächlich später automatisch ausgewählte Custom-Vorlage.
Wählen Sie Speichern, wenn der Entwurf freigegeben ist. Zurücksetzen verwirft in diesem Bereich nur ungespeicherte Änderungen und lädt den gespeicherten Stand wieder in die Anzeige; es löscht kein gespeichertes Branding.
Erzeugen Sie anschließend mit einer fiktiven Testakte jeden tatsächlich verwendeten Dokumenttyp und vergleichen Sie ihn mit der Vorschau. Bereits gespeicherte PDFs bleiben unverändert.

Logo ersetzen oder entfernen

Verwenden Sie Logo hochladen, um die vorhandene Datei zu ersetzen. Rasterbilder werden intern als PNG abgelegt; SVG bleibt als SVG erhalten.
Prüfen Sie unmittelbar danach die kleine Logoanzeige und mehrere PDF-Vorschauen. Ein erfolgreicher Upload bestätigt nur Dateityp, Größe und den konfigurierten Malware-Prüfweg, nicht die gestalterische Eignung.
Wählen Sie Entfernen, wenn das Logo nicht mehr verwendet werden soll. Die Aktion besitzt in der aktuellen Oberfläche keine zusätzliche Bestätigung.
Prüfen Sie nach Entfernen oder Ersetzen auch bestehende Vorlagen und neue Test-PDFs. Bereits erzeugte Dokumentdateien werden nicht rückwirkend geändert.

Formular-Anpassung speichern

Öffnen Sie Einstellungen → Firma → Formular-Anpassung.
Wählen Sie Akte — Übersicht, Akte — Transport, Kundenformular oder Rechnungsformular.
Schalten Sie ein Feld über das Kontrollkästchen sichtbar oder unsichtbar. Markieren Sie Pflicht nur nach Prüfung der tatsächlichen Fachvalidierung; die Einstellung erzeugt nicht automatisch eine serverseitige Pflichtprüfung.
Verschieben Sie Felder mit ↑ und ↓ oder mit Nach Spalte 1/2. Wählen Sie ein Feld, um Label, Hilfetext, Standardwert und Sektion zu bearbeiten.
Wählen Sie Speichern. Dabei wird die vollständige Feldliste dieser Seite ersetzt, nicht nur das zuletzt bearbeitete Feld. Öffnen Sie die Zieloberfläche danach neu, damit der zwischengespeicherte Feldstand aktualisiert wird.
Prüfen Sie jede sichtbare Wirkung. Belegt sind:
- Akte — Übersicht: sichtbare Katalogfelder, Bezeichnungen und Reihenfolge im konfigurierten Sendungsblock; unbekannte oder nicht implementierte Felder werden nicht gerendert.
- Akte — Transport: Sichtbarkeit und Bezeichnungen ausgewählter Transportfelder. Reihenfolge, Spalten, Pflichtstatus, Hilfetext und Standardwert werden dort nicht vollständig angewendet.
- Kundenformular: Sichtbarkeit und Bezeichnungen ausgewählter Felder sowie eine Pflichtmarkierung. Reihenfolge, Spalten, Hilfetext und Standardwert bleiben wirkungslos; die echte Formularvalidierung folgt weiterhin dem fest eingebauten Schema.
- Rechnungsformular: im Editor auswählbar, aber im aktuellen Hauptfrontend ist keine konsumierende Rechnungsmaske belegt. Änderungen daran sind daher nicht als sichtbare Funktion bestätigt.
Beachten Sie, dass weitere Felder für Akten-Ladung und Container im serverseitigen Katalog existieren, aber nicht im aktuellen Editor auswählbar sind. Die kompatiblen Kurzbezeichnungen für Akte, Kunde und Rechnung sind technische Altpfade und kein zusätzlicher Nutzerablauf.

Auf Standard zurücksetzen

Dokumentieren Sie den freigegebenen Ist-Stand vor dem Zurücksetzen. Die Oberfläche bietet keinen Versionsverlauf und keinen Export der Feldkonfiguration.
Wählen Sie die richtige Zielseite und dann Auf Standard zurücksetzen. Anders als im Brandingbereich ist dies eine sofort gespeicherte Löschaktion; eine Bestätigung wird nicht abgefragt.
Nach Erfolg zeigt die Seite wieder den statischen Standardkatalog.
Öffnen Sie die betroffene Fachmaske neu und prüfen Sie Sichtbarkeit und Beschriftungen. Ein Browser-Cache kann den vorherigen Stand noch bis zur Aktualisierung halten.

Feldreferenz

Feld	Pflicht	Bedeutung	Validierung
Logo-Datei	Nein	Mandantenweites Logo für künftige Dokumentausgaben	PNG, JPEG oder SVG; maximal 2 MB. Erweiterung und gemeldeter MIME-Typ müssen passen; Rasterdateien müssen als Bild lesbar sein.
Logo-Breite	Ja	Breite des Logos im PDF in Millimetern	Zahlenfeld ohne belastbare Min-/Max-Grenze; mit Test-PDF prüfen.
Hauptfarbe	Ja	Primäre Dokumentfarbe	Farbwähler, Freitext oder Vorgabe; gültigen Hex-Farbwert verwenden.
Akzentfarbe	Ja	Sekundäre Dokumentfarbe	Farbwähler, Freitext oder Vorgabe; gültigen Hex-Farbwert verwenden.
Schriftart	Ja	Schriftfamilie der Dokumentausgabe	Sichtbar auswählbar: Helvetica, Arial, Times New Roman, Courier oder Calibri. PDF auf verfügbare Ersatzschrift prüfen.
Schriftgröße	Ja	Grundschriftgröße im PDF	Zahlenfeld ohne belastbare Min-/Max-Grenze; Lesbarkeit und Umbruch testen.
Header-Stil	Ja	Standard, Minimal, Zentriert oder Eigener HTML-Header	Sichtbare Auswahl. Einen eigenen Header-Inhalt kann der Branding-Reiter selbst nicht bearbeiten.
Seitengröße	Ja	A4 oder Letter	Sichtbare Auswahl; mit verwendetem Druck- und Archivformat abgleichen.
Ausrichtung	Ja	Hoch- oder Querformat	Sichtbare Auswahl; alle betroffenen Dokumenttypen prüfen.
Ränder	Ja	Abstand oben, unten, links und rechts in Millimetern	Vier Zahlenfelder ohne belastbare Bereichsprüfung. Keine negativen oder übergroßen Werte verwenden.
Fußzeilentext	Nein	Zusätzlicher Text in der Dokumentfußzeile	Kein sichtbares Längenlimit; keine Geheimnisse oder unnötigen personenbezogenen Daten eintragen.
Vorschau für	Ja für Vorschau	Dokumenttyp der synthetischen PDF-Vorschau	Buchungsbestätigung, House B/L, VGM-Erklärung, Shipping Instruction, Transportauftrag, Packauftrag oder Rechnung.
Seite	Ja	Zielkatalog der Formular-Anpassung	Sichtbar sind Aktenübersicht, Transport, Kundenformular und Rechnungsformular.
Sichtbar	Ja je Feld	Blendet ein unterstütztes Feld in angebundenen Oberflächen ein oder aus	Keine Berechtigungs- oder Datenschutzgrenze; Wirkung je Zieloberfläche prüfen.
Pflicht	Ja je Feld	Kennzeichnet ein Feld als erforderlich	Wird nicht durchgängig als echte Client- oder Servervalidierung umgesetzt; nicht als fachliche Sperre verwenden.
Label	Nein	Benutzerdefinierte sichtbare Feldbezeichnung	Freitext; ändert weder Datenfeld noch technische Bedeutung.
Hilfetext	Nein	Vorgesehener Hinweis zum Feld	Wird in den geprüften Zielmasken nicht durchgängig angezeigt.
Standardwert	Nein	Vorgesehener Vorbelegungswert	Wird in den geprüften Zielmasken nicht durchgängig angewendet.
Sektion	Nein	Vorgesehene fachliche Gruppierung	Der aktuelle Editor speichert sie; Zielmasken verwenden weiterhin weitgehend feste Bereiche.
Spalte / Reihenfolge	Ja je Feld	Position im konfigurierten Layout	Nur teilweise von den Zielmasken ausgewertet; nach Speicherung visuell prüfen.

Status und mögliche Übergänge

Objekt	Ausgang	Aktion	Ergebnis und Grenze
Brandingentwurf	Gespeicherter Stand	Feld ändern	Nur lokaler Entwurf; noch keine Wirkung auf neue PDFs.
Brandingentwurf	Geändert	Live-Vorschau generieren	Temporäres PDF mit synthetischen Daten und Entwurfswerten; keine Speicherung.
Brandingentwurf	Geändert	Zurücksetzen	Ungespeicherte Änderungen werden verworfen.
Brandingentwurf	Geändert	Speichern	Mandantenweiter Brandingstand für künftige Erzeugungen.
Logo	Nicht vorhanden oder vorhanden	Logo hochladen	Datei wird gespeichert beziehungsweise ersetzt; keine automatische Änderung alter PDFs.
Logo	Vorhanden	Entfernen	Gespeicherte Logodatei und Verweis werden ohne zusätzlichen Bestätigungsdialog entfernt.
Feldlayout	Geladen	Sichtbarkeit, Label oder Position ändern	Nur lokaler Editorstand.
Feldlayout	Geändert	Speichern	Alle Overrides der gewählten Seite werden vollständig ersetzt.
Feldlayout	Angepasst	Auf Standard zurücksetzen	Mandantenspezifische Overrides der Seite werden sofort gelöscht; kein Undo oder Versionsverlauf.
Feldlayout	Parallel geändert	Zweiter Bearbeiter speichert	Kein Konflikthinweis oder Versionsabgleich; der spätere vollständige Schreibvorgang kann den anderen Stand ersetzen.

Was im Hintergrund passiert

Brandingwerte werden in einem Datensatz je Mandant gespeichert. Beim erstmaligen Erzeugen übernimmt dieser Datensatz einige Firmendaten als Ausgangswerte. Spätere Änderungen im getrennten Reiter Firmendaten werden jedoch nicht automatisch in einen bereits vorhandenen Brandingdatensatz übernommen. Prüfen Sie deshalb den Absenderblock jedes Test-PDFs; der Branding-Reiter bietet für mehrere dieser gespeicherten Absender- und Bankfelder keine Eingabefelder.

Logo-Uploads werden nach Dateiendung, gemeldetem MIME-Typ und Größe geprüft. Rasterbilder werden geöffnet und als PNG gespeichert. SVG-Dateien werden unverändert abgelegt. Ein Malware-Scan wird aufgerufen, kann aber abhängig von der Betriebskonfiguration deaktiviert oder ohne verfügbaren Scanner nicht zwingend blockierend sein. Die PDF-Erzeugung begrenzt externe Ressourcen und lokale Dateizugriffe; ein SVG sollte trotzdem aus vertrauenswürdiger Quelle stammen und vorab bereinigt werden.

Die sichtbare Vorschau erzeugt ein PDF mit synthetischen Beispieldaten. Dabei werden die ungespeicherten Formularwerte als temporäre Überschreibung verwendet. Die separate serverseitige Vorschau mit explizit ausgewählter Custom-Vorlage fällt auf das passende Systemlayout zurück, wenn die gewählte Vorlage im Mandanten nicht auflösbar ist; dieser spezielle Auswahlweg ist im Branding-Reiter nicht eingebunden.

Für Feldlayouts existiert ein statischer Katalog. Lesen mischt Katalogwerte mit mandantenbezogenen Overrides. Speichern löscht zunächst sämtliche Overrides der gewählten Seite und legt die übermittelte Liste neu an; Zurücksetzen löscht sie. Die Kurzbezeichnungen für Akte, Kunde und Rechnung werden intern auf die heutigen Seitennamen abgebildet. Diese Kompatibilität ändert den sichtbaren Bedienweg nicht.

Feldlayouts sind keine Sicherheitskontrolle. Ausgeblendete Werte bleiben über andere berechtigte Ansichten oder Datendienste erreichbar. Ebenso kann ein als Pflicht markiertes Feld serverseitig optional bleiben. Lizenz-, Rollen-, Mandanten- und OE-Prüfungen werden unabhängig vom Layout ausgewertet.

Es wurden keine gezielten automatisierten Backend- oder Browsertests für Branding, Logo, Vorschau und Feldkonfiguration gefunden. Belegt sind die gemeinsamen Test-Fixtures für das Uploadlimit, nicht jedoch Rollenmatrix, Plattformgrenze, SVG-Behandlung, Fehler-/Leerzustände, paralleles Speichern oder die Wirkung jeder Feldoption in jeder Zielmaske.

Typische Fehler und Lösungen

Meldung oder Zustand	Ursache	Vorgehen
Dokumenten-Design wird geladen… bleibt dauerhaft stehen	Laden ist fehlgeschlagen; die Ansicht besitzt keinen eigenen sichtbaren Fehlerzustand	Sitzung, aktuelle OE und mindestens ein lesbares Modul prüfen; neu laden. Nicht als laufenden Upload interpretieren.
Einstellungen konnten nicht gespeichert werden	Rolle, Schreibmodus, Werte oder Modulzugriff wurden abgewiesen	Als ADMIN im schreibbaren Mandantenkontext erneut prüfen; Werte nicht durch wiederholtes Speichern erzwingen.
Logo konnte nicht hochgeladen werden	Typ, MIME, Größe, Bildprüfung, Rate-Limit oder Malware-Prüfung schlug fehl	PNG/JPEG/SVG unter 2 MB aus vertrauenswürdiger Quelle verwenden; konkrete Betriebsprotokolle prüfen lassen.
Vorschau bleibt leer	PDF-Erzeugung ist fehlgeschlagen; die aktuelle Aktion zeigt keinen verlässlichen Fehlerhinweis	Entwurfswerte und Dokumenttyp prüfen, Seite neu laden und Fehler intern melden. Nicht speichern, solange die Vorschau fehlt.
Vorschau zeigt alte Firmendaten	Brandingdatensatz wurde früher aus Firmendaten angelegt und später nicht synchronisiert	PDF nicht verwenden; Absenderdaten im tatsächlich wirksamen Brandingstand administrativ korrigieren lassen.
MANAGER findet Firma nicht	Backendrecht und Frontendnavigation stimmen nicht überein	Änderung durch ADMIN ausführen lassen und Navigationslücke melden; keinen technischen Nebenweg als reguläre Bedienung etablieren.
Plattformadministrator sieht Firma, Daten laden aber nicht	Kein normaler Mandanten-/OE-Kontext und kein Zielmandantenwähler	Nicht im Kundenauftrag speichern; Organisationsadministrator des Zielmandanten verwenden.
Formular-Anpassung zeigt nach Abruffehler leere Spalten	Die Ansicht trennt Fehler nicht vom leeren Ergebnis	Nicht Speichern oder Auf Standard zurücksetzen wählen; neu laden und Modul-/Sitzungszustand prüfen.
Formular-Anpassung konnte nicht gespeichert werden	Rolle, Modulschreibzugriff oder übermittelte Konfiguration wurde abgewiesen	Seite neu laden, Änderungen erneut kontrollieren und als ADMIN speichern.
Feld ist als Pflicht markiert, lässt sich aber leer speichern	Zielmaske wertet die Konfiguration nur als Kennzeichnung oder gar nicht aus	Fachliche Pflicht serverseitig beziehungsweise im festen Formularschema absichern lassen; Layout nicht als Kontrolle verwenden.
Reihenfolge, Hilfetext oder Standardwert erscheint nicht	Zielmaske konsumiert diese Option nicht	Nur die unter Schritt-für-Schritt-Anleitung belegte Teilwirkung verwenden und Funktionslücke melden.
Rechnungsformular wurde angepasst, aber bleibt unverändert	Im aktuellen Hauptfrontend ist kein Verbraucher dieser Seitenkonfiguration belegt	Nicht als ausgelieferte Funktion zusagen; erst nach UI-Einbindung und Test verwenden.
Nach paralleler Bearbeitung fehlen Änderungen	Es gibt keinen Versions- oder Konfliktabgleich, und Speichern ersetzt die vollständige Liste	Bearbeitung organisatorisch serialisieren, Zielseite neu laden und Stand erneut prüfen.