Portal Administrationshandbuch

Die Portaladministration umfasst Seitenstruktur, Boxen, Templates, Benutzersichtbarkeit und Zugriffskontrolle. Ziel ist eine fokussierte Oberfläche, ohne die interne WebUI-Komplexität offenzulegen.

Administrationsbereiche

Die Portal-Applikation stellt Administrationsrouten für Portal-Seiten, Benutzer, Sessions und Konfiguration bereit. Je nach Installation sind diese Seiten über /portal/admin und verwandte Routen erreichbar.

Administrativer Zugriff ist normalerweise auf admin, role_edit_portal, rolle_Portal_Administrator oder kundenspezifische Administratorrollen beschränkt.

Seitenstruktur

Portal-Seiten sind DMS-Objekte, typischerweise auf Basis einer Portal-Seitenmaske wie cqp_page.

Wichtige Konzepte sind Seitentitel, Beschreibung, Veröffentlichungsstatus, Layout, Navigationsverhalten, Metadaten, Icon und Farbe. Die effektiven Feldnamen werden pro Installation konfiguriert und zeigen häufig auf cq_*-Felder.

Boxen

Boxen sind DMS-Objekte, typischerweise auf Basis einer Portal-Boxmaske wie cqp_box. Eine Box wird nur gerendert, wenn sie in der aktuellen Seitenzone liegt, veröffentlicht ist und für den aktuellen Benutzer sichtbar ist.

Wichtige Box-Konzepte sind Zone, Veröffentlichungsstatus, Template, Layout, Resultatlimit, Sortierung, Query und ACL.

Zonen

Zonen sind logische Layoutbereiche. pb_zone_mapping ordnet fachliche Zonennamen den internen Template-Zonen zu.

Veröffentlichung

Seiten und Boxen besitzen üblicherweise ein Veröffentlichungsfeld. Sichtbar sind sie, wenn das Feld dem konfigurierten Ja-Wert entspricht, zum Beispiel Ja, Yes, true oder 1.

ACL-Sichtbarkeit

Portal-ACLs schränken die Sichtbarkeit zusätzlich zu den normalen DMS-Berechtigungen ein. ACL-Werte werden zuerst aus obj_acl gelesen und bei Bedarf aus dem alten Feld cq_acl.

Eine leere ACL bedeutet sichtbar für alle, die sonst Zugriff haben. Wenn ACL-Werte vorhanden sind, muss der aktuelle Benutzer mindestens eine passende Rolle besitzen.

Benutzer und Sessions

Portaladministratoren können Benutzer verwalten und aktive Sessions prüfen, sofern die entsprechenden Adminseiten aktiviert sind.

Benutzer werden als obj_user-Objekte gespeichert. Wichtige Felder sind Benutzer-ID, Loginname, Name, E-Mail-Adresse, Firma, Abteilung, Status, Benutzertyp und Rollen.

Checkliste

Vor der Veröffentlichung eines Portals prüfen:

• Portal-Präfix zeigt auf die erwartete Route
• Einstiegsseite existiert
• anonymer Benutzer existiert und hat minimale Rechte
• Login und Logout funktionieren
• SSO oder OIDC verhalten sich korrekt
• erforderliche Boxen sind vorhanden
• Seiten und Boxen sind veröffentlicht
• ACL-Werte passen zu echten Benutzerrollen
• Dokumentlinks geben keine fremden Inhalte frei