CMS-Frontend und Grundlagen
Zugriff
Das CMS-Frontend wird im Browser geöffnet, entweder direkt über seine Adresse1 oder über eine Kachel auf der NeuroomNet-Startseite, falls dort eingerichtet. Nach der Anmeldung erscheint die Project View:
Der Screenshot stammt aus einer internen Testumgebung. Hinweise auf Kunden sind mit blauen Rechtecken unkenntlich gemacht.
Aufbau des CMS
Die Project View ordnet die Daten in drei Ebenen:
- Projekt 1, z. B. „BrightSign Demo“
- Anwendung 2, z. B. „Medien“
- API 3, z. B. die gleichnamige API „Medien“, mit optionaler Beschreibung 4
Projekt und Anwendung dienen nur der Übersicht. Technisch gehört jede API zu einem Namensraum (Namespace). Die Namensräume zeigt die Namespace View, erreichbar über den Button 9 rechts oben2.
Projekte
Projekte trennen die Daten verschiedener Vorhaben, oder sie teilen ein großes Vorhaben auf. Die meisten Benutzer sehen hier nur das eine Projekt, an dem sie arbeiten.
Anwendungen
Eine Anwendung fasst die APIs zusammen, die zu einer Software, einem Exponat oder einem Themenbereich gehören.
Namensräume
Ein Namensraum steht meist für eine der folgenden Einheiten:
- eine Partei bzw. einen Mandanten, z. B. einen Exponat-Hersteller
- eine Anwendung, z. B. ein Exponat
- einen Themenbereich
- das ganze Projekt
Namensräume sind die Grundlage für Zugriffe und Rechte. Wer neue Namensräume anlegt, sollte deshalb vor allem bei einem CMS, das mehrere Parteien nutzen, Folgendes beachten:
- Namensräume sind eindeutig.
- Erlaubt sind Teile aus Buchstaben und Ziffern, die mit einem Buchstaben beginnen, verbunden mit
-und getrennt durch.. Leerzeichen,/und andere Sonderzeichen sind nicht erlaubt (Details: Konfiguration von APIs). - Ein sinnvolles Präfix macht Namensräume eindeutig und erleichtert die Vergabe von Rechten, z. B. die entwickelnde Firma in umgekehrter Domänen-Notation, ein eindeutiger Projekt- oder Kundenname.
- Alle APIs eines Namensraums verwenden dieselben Sprachen. Sie werden in einer API
languagesim Namensraum festgelegt.
| Gut gewählt | Ungünstig |
|---|---|
de.insynergie.BrightsignDemo | BrightsignDemo |
Museum-fuer-Kunst123.exponat.impressionismus2 | Impressionismus2 |
de.insynergie.Museum-fuer-Kunst123.backend | backend |
APIs
In den APIs liegen die eigentlichen Daten. Ein Namensraum enthält eine oder mehrere APIs. Jede API enthält eine Liste gleich aufgebauter Datensätze. Wie ein Datensatz aufgebaut ist, also welche Felder mit welchen Datentypen er hat, legt die Beschreibung (das Schema) der API fest.
Im CMS-Frontend lassen sich Datensätze ansehen, anlegen, ändern und löschen. Die Beschreibung einer API wird über die Programmierschnittstelle angelegt und geändert.
Datensätze ansehen und bearbeiten
Ein Klick auf eine API 1 öffnet ihre Datensätze:
API-Ansicht
Die API-Ansicht zeigt die Datensätze als Tabelle, eine Zeile je Datensatz, eine Spalte je Feld:
Im Beispiel enthält die Tabelle Städte mit weltbekannten Gebäuden. Die Felder und ihre Datentypen:
| Feld | Datentyp | Inhalt | Wert im ersten Datensatz 1 |
|---|---|---|---|
| CMS Identifier | – | technische Kennung, wird oft ausgeblendet | 373ba654-53af-48bc-8601-738eabdaea0a |
| Name | Zeichenkette | Name der Stadt | Gizeh |
| Postal code | Zeichenkette | Postleitzahl | 12512 |
| Country | Zeichenkette | Land | Egypt |
| Continent | Zeichenkette | Kontinent | Africa |
| Population | Zahl | Einwohnerzahl | 4100000 |
| GPS Location | GEO-Koordinate | Lage der Stadt | 29.9775, 31.1325 |
| Image | Mediendatei | Bild, hier mit automatisch erzeugtem Vorschaubild (192x108) | Satellitenbild |
| Description | Zeichenkette, mehrsprachig | Beschreibung | Location of the pyramids of Gizeh (englische Fassung) |
Mit dem Filter-Button 2 und den Buttons zum Blättern 3 lässt sich die Anzeige eingrenzen.
Datensatz anlegen
Der Button „Add new item“ 4 öffnet ein leeres Formular für einen neuen Datensatz. Es ist dasselbe Formular wie beim Bearbeiten.
Datensatz bearbeiten
Ein Klick auf eine Zeile öffnet den Datensatz im Formular, hier die Zeile zu Paris:
- Werte lassen sich direkt ändern. Bei Dateifeldern wie „Image“ lädt ein Button eine andere Datei hoch.
- Die roten Papierkorb-Symbole leeren einzelne Felder.
- „Save“ 3 speichert, „Cancel“ 2 verwirft ungespeicherte Änderungen.
- „Clone“ 4 legt eine Kopie des Datensatzes an.
- „Delete“ 5 löscht den Datensatz.
- Ist die API mehrsprachig, wählen die Sprach-Buttons 6 die angezeigte Sprache. Felder, die je Sprache gepflegt werden, tragen ein Symbol neben dem Papierkorb, im Beispiel nur „Description“ 83.
- Weitere Buttons rechts oben 7 legt die Beschreibung der API fest, z. B. „Preview“, um den gespeicherten Stand in einer anderen Anwendung anzuzeigen (siehe Schaltflächen). Im Beispiel sind keine eingerichtet.
Beispiel: Übersetzung ergänzen
Für Paris soll die französische Beschreibung nachgetragen werden:
- Im Formular die Sprache „Französisch“ wählen 1.
- Das mehrsprachige Feld „Description“ ist für Französisch noch leer 2. Dort den Text eintragen, z. B. „Localisation de la Tour Eiffel“.
- Mit „Save“ speichern 3.
Der Text steht damit im CMS bereit. Wann eine Anwendung ihn anzeigt, hängt davon ab, wann sie ihre Inhalte neu aus dem CMS lädt.
Export und Import
Ganze Projekte, Namensräume oder einzelne APIs lassen sich samt Mediendateien als ZIP-Archiv exportieren und wieder importieren, etwa für Sicherungen oder um Daten von einem CMS in ein anderes zu übertragen.
- Export: Projekte und Namensräume über die Download-Buttons 6 bzw. 7 in der Project View, einzelne APIs über „Export“ rechts oben in der API-Ansicht.
- Import: über den Button „Import“ 8 in der Project View.
Ein Export ist unkritisch, er dauert bei großen Mediendateien nur länger. Ein Import kann dagegen vorhandene Daten überschreiben, wenn es gleichnamige Namensräume und APIs schon gibt. Er sollte deshalb nur mit Kenntnis der Optionen ausgeführt werden, siehe Export und Import.
Benutzer und Rechte
Das CMS lässt sich auch ohne NeuroomNet betreiben und verwaltet Benutzer und Rechte deshalb selbst, nicht über die NeuroomNet-Rechteverwaltung. Benutzerkonten sind Datensätze der API users im Namensraum cms. Wer die nötigen Rechte hat, erreicht ihn über die Namespace View (Button 9) und kann dort Konten wie jeden anderen Datensatz anlegen, ändern oder löschen4.
Welche Rechte es gibt und wie sie zusammenwirken, beschreibt Rechte und Konten.