| commit | author | age | ||
| fe50f9 | 1 | <h1>Bedienung</h1> |
| U | 2 | <p>Hier ist die Bedienung der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> beschrieben.</p> |
| 3 | <p style="padding-left: 30px;"><a href="#aufruf">WebBox aufrufen</a><br /><a href="#perspub">Persönliche und öffentliche Inhalte</a><br /><a href="#edittext">Dateien erstellen und ändern</a><br /><a href="#dokedit">Textdokumente erstellen und bearbeiten</a><br /><a href="#bearb">Ordner anlegen, Inhalte verschieben, kopieren, löschen</a><br /><a href="#view">Inhalte ansehen</a><br /><a href="#upload">Inhalte zur WebBox übertragen</a><br /><a href="#bilder">Bilder verwenden</a><br /><a href="#mng-user">Benutzer verwalten</a><br /><a href="#mng-apps">Apps verwalten</a><br /><a href="#mng-db">Datenbanken verwalten</a></p> | |
| 4 | <p> </p> | |
| 5 | <h2><a name="aufruf"></a>WebBox aufrufen</h2> | |
| 6 | <p>Nach <a href="Installation.htmi">Installation</a> und Start ist die WebBox mit einem Browser bedienbar. Wird der Uniform Resource Locator (URL)</p> | |
| 7 | <p style="padding-left: 30px;"><code>http://localhost:8098</code> (unverschlüsselt) oder</p> | |
| 8 | <p style="padding-left: 30px;"><code>https://localhost:8442</code> (verschlüsselt) </p> | |
| 9 | <p>im Browser aufgerufen, erscheint unter diesen Adressen jeweils die Hauptseite der WebBox.</p> | |
| 10 | <p style="padding-left: 30px;"><a href="Bilder/startseite.png" data-lightbox="startseite"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/startseite_tn.png" alt="foto" width="120" height="80" /></a></p> | |
| 11 | <p style="padding-left: 30px;"><em>Die Hauptseite der WebBox</em> <br /><span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 12 | <h2><a name="perspub"></a>Persönliche und öffentliche Inhalte</h2> | |
| 13 | <p>Die WebBox unterscheidet für jeden Benutzer einen öffentlichen und einen nicht öffentlichen Bereich. Im öffentlichen Bereich befindliche Inhalte sind ohne Einschränkung sichtbar. Inhalte im persönlichen Bereich sind nur für den angemeldeten Benutzer sichtbar. Jeder angemeldete Benutzer sieht dabei im persönlichen Bereich nur seine eigenen Inhalte. Beide Bereiche sind mit einem eigenen Uniform Resource Locator (URL) zugänglich:</p> | |
| 14 | <p style="padding-left: 30px;"><code>https://localhost:8442/home/[benutzername]/</code> (persönliche Inhalte)</p> | |
| 15 | <p style="padding-left: 30px;"><code>https://localhost:8442/data/[benutzername]/</code> (öffentliche Inhalte)</p> | |
| 16 | <p>Die URLs für persönliche und öffentliche Inhalte wie sie oben beschrieben sind geben dabei Inhalte aus den Ordnern <code>Persoenlich</code> und <code>Oeffentlich</code> wieder. Deren Inhalt wird erstellt und verwaltet wie in den folgenden Kapiteln beschrieben.</p> | |
| 17 | <h2><a name="edittext"></a>Dateien erstellen und ändern</h2> | |
| 18 | <p>Die WebBox ist mit einer Dateiverwaltung ausgestattet, mit der <a href="https://de.wikipedia.org/wiki/Datei">Dateien</a> erstellt und deren Inhalte bearbeitet werden können. Die Dateiverwaltung der WebBox wird mit der Schaltfläche <code>Dateien</code> auf der Hauptseite aufgerufen. </p> | |
| 19 | <p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> | |
| 20 | <p style="padding-left: 30px;"><em>Die Schaltfläche 'Dateien'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 21 | <p>Mit Betätigen der Schaltfläche <code>Dateien</code> erscheint zunächst die Anmeldeseite und mit erfolgreicher <a href="#mng-user">Anmeldung</a> die Dateiverwaltung</p> | |
| 22 | <p style="padding-left: 30px;"><a href="Bilder/dateiverwaltung.png" data-lightbox="dateiverwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dateiverwaltung_tn.png" alt="foto" width="120" height="70" /> </a></p> | |
| 23 | <p style="padding-left: 30px;"><em>Die Dateiverwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 24 | <p>Mit Klick auf den Ordner <code>Persoenlich</code> wird dessen Inhalt angezeigt, anfangs ist dieser leer. Auswahl des Punkts <code>Neuer Text...</code> im Menü <code>Datei</code> öffnet den Texteditor.</p> | |
| 25 | <p style="padding-left: 30px;"><a href="Bilder/texteditor.png" data-lightbox="texteditor"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/texteditor_tn.png" alt="foto" width="120" height="80" /> </a></p> | |
| 26 | <p style="padding-left: 30px;"><em>Der Texteditor der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 27 | <p>Hier kann nun beliebiger Textinhalt eingetragen werden. Auswahl des Punkts <code>Speichern</code> oder <code>Speichern unter..</code> im Menü <code>Datei</code> fragt einen Namen für die neue Datei ab.</p> | |
| 28 | <p style="padding-left: 30px;"><a href="Bilder/speichern-unter.png" data-lightbox="speichern-unter"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/speichern-unter_tn.png" alt="foto" width="120" height="60" /> </a></p> | |
| 29 | <p style="padding-left: 30px;"><em>Dialog Datei speichern</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 30 | <p>Mit Betätigen der Schaltfläche <code>Speichern</code> wird die neue Textdatei unter dem eingetragenen Namen in dem Ordner gespeichert, von dem aus der Texteditor gestartet wurde, in diesem Fall also im Ordner <code>Persoenlich</code>. Die Auswahl <code>Schließen</code> aus dem Menü <code>Datei</code> schließt den Texteditor und es wird wieder der Inhalt des Ordners <code>Persoenlich</code> angezeigt. Dort ist jetzt die neu angelegte Datei dargestellt.</p> | |
| 31 | <p>Zum Bearbeiten einer Textdatei wählt man <code>Als Text öffnen</code> aus dem Menü <code>Datei</code>.</p> | |
| 32 | <h2><a name="dokedit"></a>Textdokumente erstellen und bearbeiten</h2> | |
| 33 | <p>Mit der Dateiverwaltung lassen sich auch Textdokumente schreiben und bearbeiten. Die Vorgehensweise ist genauso wie im vorigen Abschnitt für Textdateien beschrieben. Für Textdokumente wird <code>Neues Dokument</code> aus dem Menü <code>Datei </code>gewählt woraufhin sich der Dokumenteditor der Dateiverwaltung öffnet.</p> | |
| 34 | <p style="padding-left: 30px;"><a href="Bilder/dokeditor.png" data-lightbox="dokeditor"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dokeditor_tn.png" alt="foto" width="120" height="90" /> </a></p> | |
| 35 | <p style="padding-left: 30px;"><em>Der Dokumenteditor der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 36 | <p>Hier kann ein Textdokument mit Formatierungen direkt im Browser erstellt und bearbeitet werden, wie man es von üblichen Textverarbeitungen gewohnt ist. Das Speichern oder bearbeiten erfolgt wie im vorigen Abschnitt beschrieben. Textdokumente werden dabei als reines HTML gespeichert, der Autor benötigt keine HTML-Kenntnisse für das Schreiben oder Bearbeiten. Die Dokumente sind so bestens für die Verwendung im Netz geeignet.</p> | |
| 37 | <h2><a name="bearb"></a>Ordner anlegen, Inhalte verschieben, kopieren, löschen</h2> | |
| 38 | <p>Mit den Punkt <code>Neuer Ordner</code> im Menü <code>Datei</code> kann im gerade angezeigten Ordner ein neuer Ordner erstellt werden. Nach Eingabe eines Namens für den neuen Ordner wird der neue Ordner im aktuell geöffneten Ordner angelegt. Ordner und deren Inhalte können mit den Optionen im Menü <code>Bearbeiten</code> verschoben, kopiert oder gelöscht werden. Hierzu werden folgende Schritte ausgeführt</p> | |
| 39 | <ol> | |
| 40 | <li>Inhalt auswählen, der bearbeitet werden soll,</li> | |
| 41 | <li>Menü <code>Bearbeiten</code> -> <code>Kopieren</code> oder <code>Ausschneiden</code> wählen,<code></code></li> | |
| 42 | <li>Ordner öffnen, in den die ausgewählten Inhalte verschoben oder kopiert werden sollen und</li> | |
| 43 | <li><code>Menü <code>Bearbeiten</code> -> Einfügen</code> wählen.</li> | |
| 44 | </ol> | |
| 45 | <p>Die gewählten Inhalte werden kopiert bzw. verschoben und befinden sich anschließend am gewählten Ort.</p> | |
| 46 | <h2><a name="view"></a>Inhalte ansehen</h2> | |
| 47 | <p>Über den Punkt <code>Ansehen</code> im Menü <code>Datei</code> wird der Inhalt der gewählten Datei im Browser angezeigt. Auf diese Weise lässt sich auch der URL bestimmen, unter dem die Datei im Browser aufgerufen werden kann. Freilich werden so nur Inhalte dargestellt, die im Browser angesehen werden können. Dateien mit nicht darstellbaren Formaten werden heruntergeladen.</p> | |
| 48 | <h3>Textdokumente und HTML-Seiten</h3> | |
| 49 | <p>Ein Textdokument wie es mit der WebBox erstellt werden kann ist einer HTML-Seite ähnlich, insbesondere, da sein Inhalt als HTML gespeichert wird. Es beinhaltet den Teil einer HTML-Seite, der in einer HTML-Seite im Element <code>body</code> untergebracht ist. Zu vollwertigen HTML-Seiten fehlt den Textdokumenten der WebBox allerdings die Gesamtstruktur mit dem Kopf-Teil, dem HTML-Element <code>head</code>.</p> | |
| 50 | <p>Werden mit der WebBox erstellte Textdokumente mit der zuvor beschriebenen Funktion <code>Inhalte ansehen</code> dargestellt, also über ihren URL aufgerufen, gibt die WebBox deren HTML-Inhalt aus, was im Webbrowser wie eine HTML-Seite aussieht. Der Webbrowser verwendet zur Anzeige Standardeinstellungen für die Gestaltung des Dokuments, deshalb kann die Darstellung von Browser zu Browser unterschiedlich ausfallen.</p> | |
| 51 | <p>Gibt man beim Speichern des Textdokuments einen Namen an der mit <code>.htm i</code> endet bettet die WebBox den Inhalt des Textdokuments in eine komplette HTML-Struktur bestehend aus <code>head</code>- und <code>body</code>-Element ein und fügt Verweise auf Gestaltungsvorlagen hinzu (CSS-Stylesheets). Als Gestaltungsvorlage wird das der WebBox beiliegende Stylesheet von Bootstrap <code>/jslib/bootstrap/css/bootstrap.min.css</code> sowie die Datei <code>stile.css</code> eingebettet. Legt man im Ordner, in dem das betrffende Textdokument abgelegt ist, eine Datei <code>stile.css</code> an, können dem Textdokument auf diese Weise eigene Gestaltungsvorgaben mitgegeben werden.</p> | |
| 52 | <h3>Textdokumente als HTML exportieren</h3> | |
| 53 | <p>Um ein Textdokument, das mit der WebBox erstellt wurde, auch ohne eine WebBox einfach im Browser ansehen zu können, muss es als HTML-Seite vorliegen. Mit dem Punkt <code>Export HTML</code> im Menü <code>Datei</code> werden zu diesem Zweck alle Textdokumente, also die <code>.htm i</code>-Dateien, des aktuell geöffneten Ordners als HTML-Seiten erzeugt. Die HTML-Seiten werden dazu in einen Ordner gelegt, der genauso heißt wie der aktuell geöffnete Ordner und dessen Name der Zusatz _html angehängt wurde. Dieser neue Ordner liegt nach dem HTML-Export in dem Ordner, in dem der aktuell geöffnete Ordner liegt.</p> | |
| 54 | <h2><a name="upload"></a>Inhalte zur WebBox übertragen</h2> | |
| 55 | <p>Lokale Inhalte werden zur WebBox übertragen und im aktuellen Verzeichnis abgelegt, wenn sie per Ziehen und Ablegen (Drag and Drop) im gerade geöffneten Ordner der Dateiverwaltung 'fallengelassen' werden.</p> | |
| 56 | <h3>WebDAV verwenden</h3> | |
| 57 | <p>Die WebBox stellt einen zentralen Ordner zur Verwendung von WebDAV bereit. Über folgenden URL kann per WebDAV auf die WebBox zugegriffen werden.</p> | |
| 58 | <p><code>https://localhost:8442/dav</code></p> | |
| 59 | <p>Der obige URL verweist auf den Ordner <code>dav</code> im Datenverzeichnis der WebBox, also den Ordner <code>$wbx/daten/dav</code>. Benutzer mit Rolle <code>wbxAdmin</code> können in der Dateiverwaltung der WebBox den Ordner <code>$daten</code> verwenden, um auf Inhalte des dort zugänglichen Ordners <code>dav</code> zuzugreifen. Auf diese Weise können via WebDAV auf die WebBox übertragene Dateien auch über die Dateiverwaltung der WebBox an andere Ablageorte kopiert werden.</p> | |
| 60 | <p>Benutzer, die den Zugriff via WebDAV nutzen sollen müssen die Rolle <code>davNutzer</code> besitzen. </p> | |
| 61 | <h2><a name="bilder"></a>Bilder verwenden</h2> | |
| 62 | <p>Werden Bilder des Typs JPEG, PNG oder GIF auf die WebBox übertragen, erscheint für sie als Dateisymbol eine Minituransicht des Bildinhalts. Das Bild kann angesehen werden wie im Abschnitt Inhalte ansehen beschrieben. Die Miniaturansicht eines Bildes wird zudem von der WebBox dynamisch erzeugt und kann angesehen werden, wenn dem Namen des Bildes im URL der Zusatz <code>_tn</code> hinzugefügt wird.</p> | |
| 63 | <p>Ist beispielsweise eine Bilddatei <code>MeinBild.png</code> im Ordner <code>Persoenlich/Bilder</code> des Nutzers <code>fred</code> abgelegt, kann ihre Minituransicht mit folgendem URL angesehen werden:</p> | |
| 64 | <p style="padding-left: 30px;"><code>http://localhost:8098/home/fred/Bilder/MeinBild_tn.png</code></p> | |
| 65 | <p>Auf diese Weise müssen nicht die unter Umständen großen Datenmengen des Originalbildes für eine Miniatur-Vorschau übertragen werden. <span style="font-size: 1em;">Neben der Miniaturansicht lassen sich die folgenden weiteren Bildgrößen erzeugen:</span></p> | |
| 66 | <table> | |
| 67 | <tbody> | |
| 68 | <tr> | |
| 69 | <td><strong>Größe</strong></td> | |
| 70 | <td><strong>Endung</strong></td> | |
| 71 | </tr> | |
| 72 | <tr> | |
| 73 | <td>120</td> | |
| 74 | <td>_tn</td> | |
| 75 | </tr> | |
| 76 | <tr> | |
| 77 | <td>240</td> | |
| 78 | <td>_kl</td> | |
| 79 | </tr> | |
| 80 | <tr> | |
| 81 | <td>500</td> | |
| 82 | <td>_dd</td> | |
| 83 | </tr> | |
| 84 | <tr> | |
| 85 | <td>700</td> | |
| 86 | <td>_mt</td> | |
| 87 | </tr> | |
| 88 | <tr> | |
| 89 | <td>1200</td> | |
| 90 | <td>_gr</td> | |
| 91 | </tr> | |
| 92 | </tbody> | |
| 93 | </table> | |
| 94 | <p> </p> | |
| 95 | <p>Ohne Endung wird das Bild in Originalgröße ausgegeben.</p> | |
| 96 | <p>Bilder können mit Hilfe des Dokumenteditors in Dokumente eingebunden werden. Vom Ablageort des betreffenden Dokuments ausgehend genügt eine relative Pfadangabe. Zum Beispiel könnte ein Dokument im Ordner <code>Persoenlich</code> des Nutzers <code>fred</code> das oben erwähnte Bild mit der relativen Angabe <code>Bilder/MeinBild.png</code> einbinden.</p> | |
| 97 | <h3>Bilder betrachten (Diashow)</h3> | |
| 98 | <p>Aus der Dateiverwaltung der WebBox heraus können Bilder als Diashow betrachtet werden. Dazu wird die Diashow-Funktion zunächst eingeschaltet, indem der Punkt "Diashow nicht zeigen" gewählt wird. Damit wird die standardmäßig ausgeschaltete Diashow-Funktion aktiviert. Anschließend wird ein Ordner geöffnet, der Bilder enthält. Mit Klick auf eines der Bilder wird die Diashow gestartet.</p> | |
| 99 | <p>Sollen Bilder wieder als Dateien in der Dateiverwaltung behandelt werden, beispielweise zum Markieren einzelner Bilddateien, wird die Funktion "Diashow zeigen" im Menü gewählt. Damit wird die Diashow-Funktion ausgeschaltet.</p> | |
| 100 | <h2><a name="mng-user"></a>Benutzer verwalten</h2> | |
| 101 | <p>Eine WebBox kann von verschiedenen Benutzern zugleich verwendet werden. Jedem Nutzer muss in der Benutzerverwaltung ein Benutzerkonto angelegt werden. </p> | |
| 102 | <h3>Rollen und der Benutzer <code>admin</code></h3> | |
| 103 | <p>Den Zugang zu Inhalten regelt die WebBox über Rollen, die ein Benutzer besitzen kann. Über die Benutzerverwaltung können Rollen erteilt und entzogen werden. Im Auslieferungszustand der WebBox ist diese mit einem Benutzer namens <code>admin</code> ausgestattet. Der Benutzer <code>admin</code> besitzt die folgenden Rollen:</p> | |
| 104 | <p style="padding-left: 30px;"><code>nutzerAdmin</code> - Benutzer verwalten<br /><code>wbxAdmin</code> - Apps verwalten<br /><code>ownFileAdmin</code> - eigene Dateien verwalten<br /><code>sqlKonsole</code> - Datenbanken verwalten<br /><code>nutzerProfil</code> - Angaben zur Person und eigenes Kennort ändern<br /><code>manager-script</code> - interne Rolle zur Verwaltung von Apps</p> | |
| 105 | <p>Mit dem Benutzer <code>admin</code> kann die erste Einrichtung der WebBox erfolgen. Das Kennwort des Benutzers <code>admin</code> lautet <code>admin</code>. Bevor die WebBox für andere Zwecke verwendet wird sollte mit Hilfe des Benutzers <code>admin</code> mindestens ein anderer Benutzer angelegt werden, der die obigen Rollen besitzt. Anschließend sollte der Benutzer <code>admin</code> gelöscht werden.</p> | |
| 106 | <p>Um die Verwaltung der WebBox von deren Nutzung abzugrenzen empfiehlt es sich, mindestens einen weiteren Benutzer anzulegen, der nur die Rolle <code>ownFileAdmin</code> besitzt. Nur Benutzer, die Teile der WebBox administrieren sollen, benötigen die Rollen <code>nutzerAdmin</code>, <code>wbxAdmin</code> und <code>manager-script</code>.</p> | |
| 107 | <h3>Aufruf der Benutzerverwaltung</h3> | |
| 108 | <p>Die Benutzerverwaltung der WebBox wird mit der Schaltfläche <code>Benutzer</code> auf der Hauptseite aufgerufen. </p> | |
| 109 | <p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung2"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> | |
| 110 | <p style="padding-left: 30px;"><em>Die Schaltfläche 'Benutzer'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 111 | <p>Mit Betätigen der Schaltfläche <code>Benutzer</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die Benutzerverwaltung.</p> | |
| 112 | <p style="padding-left: 30px;"><a href="Bilder/benutzerverwaltung.png" data-lightbox="benutzerverwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/benutzerverwaltung_tn.png" alt="foto" width="120" height="100" /> </a></p> | |
| 113 | <p style="padding-left: 30px;"><em>Die Benutzerverwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 114 | <p>Nur Benutzer mit der Rolle <code>nutzerAdmin</code> können die Benutzerverwaltung aufrufen.</p> | |
| 115 | <h3>Benutzer anlegen</h3> | |
| 116 | <p>Mit Betätigen der Schaltfläche <code>Neu</code> erscheint das Formular zur Anlage eines Benutzers. </p> | |
| 117 | <p style="padding-left: 30px;"><a href="Bilder/nutzer-neu.png" data-lightbox="nutzer-neu"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/nutzer-neu_tn.png" alt="foto" width="120" height="100" /> </a></p> | |
| 118 | <p style="padding-left: 30px;"><em>Formular zur Anlage eines Benutzers</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 119 | <p>Hier können Angaben zum Benutzer gemacht und ein Kennwort erteilt werden. Der neue Benutzer wird angelegt, wenn die Schaltfläche <code>Speichern</code> betätigt wird.</p> | |
| 120 | <p>Die WebBox speichert die Angaben zum Benutzer in einer Datenbank im Ordner <code>$wbx/daten/db</code>. Kennworte werden dabei verschlüsselt in der Datenbank abgelegt und sind auch für Administratoren der Maschine, auf der die WebBox läuft nicht im Klartext lesbar.</p> | |
| 121 | <h3>Rollen erteilen und entziehen</h3> | |
| 122 | <p>Wird in der Liste der Benutzer einer der Anmeldenamen geklickt erscheint die Rollen-Ansicht.</p> | |
| 123 | <p style="padding-left: 30px;"><a href="Bilder/rollen.png" data-lightbox="rollen"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/rollen_tn.png" alt="foto" width="120" height="100" /> </a></p> | |
| 124 | <p style="padding-left: 30px;"><em>Die Rollen-Ansicht der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 125 | <p>Oben sind die Rollen zu sehen, die der Benutzer besitzt. Unten erscheinen die verfügbaren Rollen. Mit den Schaltflächen <code>Erteilen</code> und <code>Entziehen</code> werden dem Benutzer Rollen erteilt und entzogen. Eine neue Rolle kann mit der Schaltfläche <code>Neu</code> angelegt werden.</p> | |
| 126 | <h3>Eigenes Kennwort ändern</h3> | |
| 127 | <p>Jeder Benutzer kann sein eigenes Kennwort und die Angaben zur eigenen Person selbst ändern. Die Funktion ist unabhängig von den übrigen Funktionen der Benutzerverwaltung und an die Rolle <code>nutzerProfil</code> geknüpft, die jedem Benutzer erteilt sein muss.</p> | |
| 128 | <p>Zur Änderung dieser Angaben wird im Menü der Punkt <code>Profil</code> gewählt.</p> | |
| 129 | <h2><a name="mng-apps"></a>Apps verwalten</h2> | |
| 130 | <p>Die WebBox kann Programme ausführen, die ein Benutzer zu diesem Zweck auf die WebBox überträgt. Solche Programme werden an dieser Stelle Apps genannt. Ob eine App auf der WebBox läuft ist gewöhnlich an ihrer Dateiendung <code>.war</code> erkennbar und in der Dokumentation zur App erwähnt.</p> | |
| 131 | <h3>Aufruf der App-Verwaltung</h3> | |
| 132 | <p>Die App-Verwaltung der WebBox wird mit der Schaltfläche <code>Apps</code> auf der Hauptseite aufgerufen. </p> | |
| 133 | <p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung3"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> | |
| 134 | <p style="padding-left: 30px;"><em>Die Schaltfläche 'Apps'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 135 | <p>Mit Betätigen der Schaltfläche <code>Apps</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die App-Verwaltung.</p> | |
| 136 | <p style="padding-left: 30px;"><a href="Bilder/apps.png" data-lightbox="apps"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/apps_tn.png" alt="foto" width="120" height="70" /> </a></p> | |
| 137 | <p style="padding-left: 30px;"><em>Die App-Verwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 138 | <p>Nur Benutzer mit der Rolle <code>wbxAdmin</code> können die App-Verwaltung aufrufen.</p> | |
| 139 | <h3>App an die WebBox übertragen</h3> | |
| 140 | <p>Betätige zur Übertragung einer App auf die WebBox zunächst die Schaltfläche <code>Durchsuchen</code>. Navigiere zum Ablageort des Webarchivs, das die App enthält und wähle sie aus. Der Name eines solchen Webarchivs endet üblicherweise mit <code>.war</code> und erscheint neben der Schaltfläche <code>Durchsuchen</code>, sobald er ausgewählt wurde.</p> | |
| 141 | <p>Die App wird an die WebBox übertragen, wenn die Schaltfläche <code>Deploy</code> betätigt wird. In aller Regel wird die App von der WebBox ausgeführt, nachdem die Übertragung abgeschlossen ist. Die Kombination aus dem Übertragen der App an die WebBox, deren dortige Vorbereitung zur Ausführung und ggf. das Ausführen wird <em>Deploy</em> genannt.</p> | |
| 142 | <p>Die App erscheint in der Liste der Apps, sobald die Übertragung abgeschlossen ist.</p> | |
| 143 | <h3>Ausführung einer App stoppen</h3> | |
| 144 | <p>Die Ausführung einer App wird gestoppt, indem ihr Eintrag in der Liste der Apps gewählt und die Schaltfläche <code>Stopp</code> betätigt wird. Mit der Schaltfläche <code>Start</code> kann die App wieder ausgeführt werden. Die App bleibt gestoppt bis sie von einem Administrator der App-Verwaltung wieder gestartet wird.</p> | |
| 145 | <h3>App löschen</h3> | |
| 146 | <p>Auswahl einer App aus der Liste der Apps und Betätigen der Schaltfläche <code>Entfernen</code> stoppt die App und löscht sie von der WebBox.</p> | |
| 147 | <h3>Interne Apps entsperren</h3> | |
| 148 | <p>Teile der WebBox sind selbst als Apps angelegt. Diese sollen nicht unbeabsichtigt gestoppt oder gelöscht werden und sind in der App-Verwaltung für solche Aktionen gesperrt. Die Sperre gilt für folgende Apps:</p> | |
| 149 | <p style="padding-left: 30px;"><code>/wbx</code> - Bedienoberfläche der App-Verwaltung<br /><code>/um</code> - Benutzerverwaltung<br /><code>/file-cms</code> - Dateiverwaltung der WebBox<br /><code>/wbx-dbcon</code> - Datenbank-Konsole der WebBox<br /><code>/home</code> - Persönliche Nutzerdaten<br /><code>/data</code> - Öffentliche Nutzerdaten<br /><code>/</code> - Hauptseite der WebBox, der sogennante ROOT-Kontext<br /><code>/manager</code> - interner Teil der App-Verwaltung<br /><code>/jslib</code> - Javacsript-Ressourcen der WebBox</p> | |
| 150 | <p>Mit dem Punkt <code>Interne Apps entsperren</code> im Menü <code>Apps</code> kann die Sperre gelöst werden. <strong>Vorsicht:</strong> Das Stoppen oder Entfernen einer der oben aufgeführten Apps führt dazu, dass die WebBox nicht mehr richtig funktioniert.</p> | |
| 151 | <h2><a name="mng-db"></a>Datenbanken verwalten</h2> | |
| 152 | <p>Die WebBox stellt Datenbanken und deren Inhalt über einen eigenen Derby Network Server bereit. Die Datenbankfunktion der WebBox ist hauptsächlich für Apps vorgesehen, die sie zur strukturierten Ablage und Verwaltung von Daten verwenden können.</p> | |
| 153 | <p>Die Datenbanken der WebBox sind nur auf der Maschine zugänglich, auf der die WebBox läuft. Aufruf und Nutzung des Datenbankservers erfolgt über die Java Database Connectivity (JDBC) mit folgendem URL</p> | |
| 154 | <p style="padding-left: 30px;"><code>jdbc:derby://localhost:1528/[Name der Datenbank];create=true</code></p> | |
| 155 | <p>Datenbanken verwaltet der Datenbankserver der WebBox im eigenen Datenverzeichnis selbsttätig. Der Zusatz <code>;create=true</code> veranlaßt den Datenbankserver der WebBox, die betreffende Datenbank im Datenverzeichnis zu erstellen, wenn sie noch nicht existiert. Dabei wird keine Datenbankstruktur wie z.B. Tabellen oder Indizes erstellt, diese muss mit entsprechenden SQL-Kommandos von der App oder von Hand in der Datenbank-Konsole erzeugt werden.</p> | |
| 156 | <h3>Aufruf der Datenbank-Konsole</h3> | |
| 157 | <p>Zum Umgang mit Datenbanken enthält die WebBox eine Datenbank-Konsole. Kommandos der Structured Query Language (SQL) können über die Datenbank-Konsole eingegeben und ausgeführt werden. Sie wird mit der Schaltfläche <code>Datenbank</code> auf der Hauptseite aufgerufen. </p> | |
| 158 | <p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung4"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> | |
| 159 | <p style="padding-left: 30px;"><em>Die Schaltfläche 'Datenbank'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 160 | <p>Mit Betätigen der Schaltfläche <code>Datenbank</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die Datenbank-Konsole.</p> | |
| 161 | <p style="padding-left: 30px;"><a href="Bilder/dbcon.png" data-lightbox="dbcon"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dbcon_tn.png" alt="foto" width="120" height="70" /> </a></p> | |
| 162 | <p style="padding-left: 30px;"><em>Die Datenbank-Konsole der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 163 | <p>Nur Benutzer mit der Rolle <code>sqlKonsole</code> können die Datenbank-Konsole aufrufen.</p> | |
| 164 | <h3>Datenbank-Verbindung erstellen</h3> | |
| 165 | <p>Die Arbeit mit einer Datenbank aus der Datenbank-Konsole heraus erfordert die Anlage einer Datenbank-Verbindung. Mit Auswahl von <code>Neu..</code> aus dem Mneü <code>Datenbank</code> erscheint der Dialog zur Anlage einer neuen Datenbank-Verbindung.</p> | |
| 166 | <p style="padding-left: 30px;"><a href="Bilder/db_neu.png" data-lightbox="dbneu"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/db_neu_tn.png" alt="foto" width="120" height="70" /> </a></p> | |
| 167 | <p style="padding-left: 30px;"><em>Der Dialog Neue Datenbankverbindung</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> | |
| 168 | <p>Hier wird der Name der Datenbank angegeben und die Schaltfläche <code>Neu</code> betätigt. Die Datenbankverbindung wird erstellt und ihr Name erscheint in der Seitenleiste links.</p> | |
| 169 | <h3>SQL-Kommandos anwenden</h3> | |
| 170 | <p><a href="https://builds.apache.org/job/Derby-docs/lastSuccessfulBuild/artifact/trunk/out/ref/crefsqlj23296.html">Kommandos der Structured Query Language</a> (SQL) sind ein mächtiges Werkzeug zur Arbeit mit Datenbanken. Mit ihnen lassen sich Datenbankstrukturen ebenso wie Datenbankinhalte erstellen und ändern. Mit der Datenbank-Konsole der WebBox können beliebige einzelne SQL-Kommandos wie auch SQL-Skripte an die Datenbank abgesetzt werden.</p> | |
| 171 | <p>Die betreffenden SQL-Kommandos werden dazu in der Textbox rechts oben in der Datenbank-Konsole eingetragen und die Schaltfläche Ausführen betätigt. Ergebnisse der Ausführung wie zum Beispiel die Antwort auf ein SELECT-Kommando werden im unteren Teil der Datenbank-Konsole als Ergebnistabelle dargestellt.</p> | |
| 172 | <p><strong>Vorsicht</strong>: Ein falsches SQL-Kommando kann Inhalt oder Struktur einer Datenbank beschädigen und zu Datenverlust führen. Die Datenbank-Konsole darf nur mit größtem Bedacht verwendet werden, ihre Verwendung geschieht auf eigenes Risiko.</p> | |
