efa DokuWiki

Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== Konfigurieren und Einrichten ======

Dieses Dokument gibt einen Schnellüberblick über die wichtigsten Schritte zum Konfigurieren und Einrichten von efa.

===== Übersicht =====

Sämtliche administrativen Aufgaben in efa werden im //Admin-Modus// durchgeführt. In efa-Bootshaus gelangst Du über den Button Admin-Modus dorthin. efa-Basis läuft immer im Administrationsmodus - dort findest Du die entsprechenden Optionen in den jeweiligen Menüs. Nur Administratoren mit entsprechender Berechtigung haben Zugriff auf diese Funktionen.

Der Administrationsbereich bietet unter Anderem folgende Funktionen:

  * Konfiguration von efa über den Menüpunkt //Konfiguration//
  * Erstellen und Auswählen von Projekten und Fahrtenbüchern
  * Administration der Daten
  * Erstellen von Statistiken und Statistikeinstellungen
  * Nachrichten und Logdatei
  * Datensicherung und -wiederherstellung
  * Online-Update
  * Beenden von efa

{{ ::efaadminmodus.png?direct&600 |}}
===== Wichtige Konfigurationseigenschaften =====
Diese sind in den Registerkarten von Admin-Modus-->Konfiguration zu finden.

==== Sprache & Region ====

{{ :wiki_konfiguration_spracheregion.png?direct&600 |}}

Die gewünschte Sprache und einige regionale Einstellungen werden beim ersten Start von efa abgefragt. Nachträglich können diese in der Konfiguration unter //Sprache & Region// geändert werden.

//Sprache//\\ Dies stellt die Oberflächen-Sprache für efaBase und efaBootshaus ein.\\ Achtung, auch einige der Bezeichner werden durch die Sprache umgestellt, z.B. für Boote, Geschlecht, Fahrtarten.

//Funktionalitäten aktivieren für Rudern//\\ Wirkt sich in der Oberfläche aus für die verschiedenen Standard-Fahrtarten, Bootstypen etc. Zusätzlich für die Darstellung in der Statistik.

//Funktionalitäten aktivieren für Rudern in Deutschland//\\ Unterstützung von Wanderfahrten, Fahrtenabzeichen in efaBootshaus, efaBase und efaCLI. Zusätzliche Funktionen in der Statistik. Projektdaten: Eingabe von Daten im Kontext des Dachverbands. Automatische Erkennung von Wanderfahrten bei >30km oder bei Zuordnung einer Fahrtengruppe.

//Funktionalitäten aktivieren für Rudern in Berlin//\\ Unterstützung von Zielfahrten. Eigene Zielbereiche-Einstellung im Projekt sowie bei der Erfassung von Zielen. Zusätzliche Funktionen in der Statistik. 

//Funktionalitäten aktivieren für Kanufahren//\\ Projektdaten: Eingabe von DKV und LKV.

//Funktionalitäten aktivieren für Kanufahren in Deutschland//\\ Freischaltung Kanu-EFB-Synchronisation. Erfassung von Daten für die Kanu-EFB-Synchronisation. Erfassung von bestimmten efbID-Feldern im Kontext von Booten, Personen, Fahrtgruppen.

==== Bezeichnungen ====
{{ ::efaadminmodus_konfiguration_bezeichnungen.png?direct |}}

Bezeichnungen dienen in EFA dazu, wichtige Typen von Stammdaten klassifizieren zu können. So können unterschiedliche Bootsarten definiert werden, die dann in efaBootsHaus bei passender Konfiguration in [[#erscheinungsbild_efabootshaus|Erscheinungsbild efaBootsHaus]] für die Strukturierung der Bootslisten verwendet werden.

Bei der Nutzung von efaCloud sollten (müssen) diese Bezeichnungen über alle Stationen hinweg identisch sein.
Mehr bei der [[access_cloud|Dokumentation zur Nutzung von efaCloud in diesem Wiki]] und der [[https://www.efacloud.org/material.html|Online-Dokumentation von efaCloud]].

==== Allgemein ====
efa bietet zwei Programme an, über die die Eingabe von Daten möglich ist: //efaBase// für die Administration zu Hause, und //efaBootshaus (efaBths)// für die Nutzung als Kiosk-System im Bootshaus.

Der Bereich //Allgemein// steuert diejenigen Punkte, die sich auf beide Programme auswirken.

=== Allgemein --> Allgemein ===
{{ :wiki_konfiguration_allgemein_allgemein.png?direct&600 |}}

//Nutzerdatenverzeichnis//\\ Der Ordner, in dem efa sämtliche Daten ablegen soll, wird beim ersten Start von efa abgefragt. Nachträglich kann er in der Konfiguration unter //Allgemein - Allgemein// geändert werden.
**Achtung:** Bei nachträglicher Auswahl eines anderen Ordners verschiebt efa keine Daten dorthin. Dies mußt Du wenn gewünscht selbst tun.

//Experimentelle Funktionen aktivieren//\\
Dies aktiviert die für **efaCloud** erforderlichen Schaltflächen und Wahlmöglichkeiten im Administrations- und Projektbereich.

//Funktionalitäten für die Entwicklung//\\
Aktiviert die Übersetzungs-Schaltfläche im Administrations-Bereich.

//Debug-Logging aktivieren//\\
Erweitertes Logging in der efa.log aktivieren. Dies dient zur besseren Nachvollziehbarkeit des Verhaltens von efa und zur Fehleranalyse. 

//Trace-Topic//\\
Über die Trace Topics können die Debug-Loggins von EFA für bestimmte Themen eingeschaltet werden.
Folgende Trace-Topics sind verfügbar:
|**Name**|**Wert**|**Beschreibung**|
|TT_CORE                | 0x0001| EFA Core - Initialisierung der Basis von efaCLI, efaBase und efaBths. Öffnen und Schließen von Dateien. EMail-Versand, Sprachsupport.|
|TT_OTHER               | 0x0002| Auflösung der Aliase für Personen in den Lookup-Listen|
|TT_INTERNATIONALIZATION| 0x0004| Sprachsupport und Übersetzung|
|TT_EFATYPES            | 0x0008| Nicht benutzt|
|TT_BACKGROUND          | 0x0010| Email-Versand, automatische Hintergrundsarbeiten in efaBths|
|TT_MEMORYSUPERVISION   | 0x0020| Logging zum Speicherverbrauch|
|TT_FILEIO              | 0x0040| Thread zum Speichern von Dateien|
|TT_XMLFILE             | 0x0080| Verarbeitung von XML-Daten, z.B. beim Speichern von Datendateien, Exporten, usw.|
|TT_GUI                 | 0x0100| Anzeigen von Dialogen, Fensterhierarchie, Icons, Nutzer-Interaktionen in efaBths|
|TT_PRINT_FTP           | 0x0200| (S)FTP-Kommunikation, Drucken innerhalb von EFA|
|TT_STATISTICS          | 0x0400| Erstellung von Statistiken|
|TT_EXCEPTIONS          | 0x0800| Java-Exceptions (Programmfehler), die von efa gefangen werden, aber dem Anwender nicht angezeigt werden.|
|TT_HELP                | 0x1000| Hilfesystem: Start und Aufruf von bestimmten Hilfeseiten|
|TT_SYNC                | 0x2000| Kanu-EFB-Synchronisation|
|TT_REMOTEEFA           | 0x4000| EFA-Remote-Kommunikation|
|TT_PDF                 | 0x8000| PDF-Erstellung|
|TT_CLI                 | 0x10000| efa Command Line Interface|
|TT_WIDGETS             | 0x20000| Widgets in efaBths|
|TT_CLOUD               | 0x40000| efaCloud. Hier insbesondere die Erstellung und Verwaltung von Ecrids und Ecrid-Cache.|

Die Trace-Topics können durch Addition der Zahlenwerte kombiniert werden:
Trace-Topic //2800// bedeutet: Debug-Ausgaben zu Java-Exceptions und zur Kanu-EFB-Kommunikation protokollieren

//Trace-Level//\\
Intensität des Loggings. 1 = niedrig 9 = intensiv. Üblicherweise ist 5 ein guter Wert, der die sinnvollsten Debug-Ausgaben erzeugt.



=== Allgemein --> Eingabe ===
{{ :wiki_konfiguration_allgemein_eingabe.png?direct&600 |}}

Wichtig ist hier insbesondere das **Namensformat** für Personen. Sind mehrere Installationen im efa-Projekt vorgesehen (z.B. eine zu Hause zur Administration, ein Bootshaus) oder wird //efaCloud// eingesetzt, //muss// diese Einstellung über alle Installationen hinweg identisch sein.

Eine nachträgliche Änderung kann bei der Nutzung von efaCloud relativ aufwändig sein. Daher sollte diese Einstellung einmalig beim Projektbeginn festgelegt werden.

Bei der Eingabe von Namen im Kontext der Fahrtangabe ist seit efa 2.4.0 die Teilbegriffsuche der Standard; mit der anstehenden Version 2.4.1 wird diese nochmalig verbessert. 

Damit ist es für die spätere Eingabe der Namen bei Fahrtbeginn nicht mehr so relevant, welches Format hier genutzt wird. Daher sollte geprüft werden, ob es wirklich erforderlich ist, vom Standard //Nachname, Vorname// abzuweichen. Bei der späteren Datenverarbeitung mit anderen Programmen ist dieses Format einfacher zu nutzen.

Hinweis: In efa Konfiguration kann der //Expertenmodus// eingeschaltet werden, der deutlich mehr Konfigurationsoptionen anzeigt. Diese sind aber eher spezieller Natur und können im späteren Verlauf nach eigenem Gusto beliebig geändert werden.


==== Erscheinungsbild / Look & Feel ====

In der efa-Konfiguration kann unter //**Allgemein - Erscheinungsbild**// das Look & Feel gewählt werden. Ab Version 2.4.0 ist das //efaFlatLaf// voreingestellt. In früheren Versionen liefert meistens das //MetalLookAndFeel// die beste Darstellung. Weitere Informationen zu den Look & Feel siehe [[config_lookandfeel|Look&Feel konfigurieren]]. Diese Einstellung wirkt auf alle grafischen efa-Programme.

{{ :efaadminmodus_konfiguration_allgemein_fenster.png?direct&600 |}}
Falls die Darstellung im Vollbild die Taskleiste oder sonstige Bildschirmelemente verdeckt, kann unter //**Allgemein - Fenster** // die maximale Größe des Bildschirms, die efa verwenden soll, sowie die Position der linken oberen Ecke (//Offset//) eingestellt werden. Diese Einstellung wirkt auf alle grafischen efa-Programme.\\ Bei größeren Monitoren empfiehlt es sich aus Gründen der Benutzerfreundlichkeit, die Größe der Dialoge auf ca. 1280x900 Pixel zu beschränken.

{{ :efaadminmodus_konfiguration_bootshaus_erscheinungsbild.png?direct&600 |}}Damit diese Einstellung auch für efaBootshaus genutzt wird, muss unter //**efa-Bootshaus - Erscheinungsbild**// im //Expertenmodus// die Option "efa maximiert starten" aktiv sein.

Hier können auch weitere Einstellungen für die Oberfläche vorgenommen werden:\\ 
Eine große //Schriftgröße// kann die Lesbarkeit verbessern, allerdings können zu große Schriftgrößen je nach Bildschirmauflösung dazu führen, daß manche Dialoge nicht mehr ganz auf den Bildschirm passen. Für eine Auflösung von 1024x768 wird eine maximale Schriftgröße von 16 empfohlen.\\ \\ //Tabellenschriften// sollten stets 2 Punkte kleiner sein als die für EFA vorgesehene Standardschriftgröße. Damit ist sichergestellt, dass die meisten Spaltenbreiten ausreichend sind, um die Inhalte vollständig darzustellen.

Auch die //Schriftart// für efaBootshaus kann eingestellt werden. Wie unter Linux-Systemen zusätzliche, auf dem Bildschirm gut lesbare Schriften installiert werden können, steht unter [[quick_install#optionalinstallation_von_schriften_linux"|Installation von Schriften]].

==== Erscheinungsbild efaBootsHaus ====

{{ ::efaadminmodus_efabootshaus_erscheinungsbild_bootslisten.png?direct&600 |}}

Die Startseite von efaBoothaus ist weitgehend an eigene Bedürfnisse anpassbar. Die meisten Funktionen sind mit Standardwerten vorbelegt, die für viele Vereine passen. Daher sind viele Funktionen erst sichtbar, wenn in der Konfiguration der //Expertenmodus// aktiviert wird.

=== Bootslisten allgemein ===

//Erlaube Auswahl in Bootslisten alternativ auch über Personennamen//\\  Ist diese Option aktiv, blendet EFA über der Bootsliste eine Auswahlmöglichkeit ein: 
{{ ::efaadminmodus_konfiguration_bootshaus_listen_personen.png?direct&200 |}}

Über den Personennamen können dann ebenfalls Fahrten gestartet werden. Dann sind im "Fahrt beginnen" Dialog der Name der Person vorbelegt, und es wird das bei der Person hinterlegte Standardboot eingetragen.

//Bootslisten Filter-Felder//\\ Seit efa 2.3.x hat EFA Eingabefelder über den Listen, um diese nach Teilbegriff zu durchsuchen. Diese Filter-Felder können für die einzelnen Listen ein- und ausgeblendet werden.

//Filter-Feld: Einträge mit Sonderzeichen einfacher finden//\\ 
Ist diese Option aktiv, dann findet efa bei Eingabe von "muller" auch Einträge mit dem Text "Müller", "Múller" usw.\\ Wird allerdings nach "Müller" gesucht, werden nur Einträge gefunden, die auch das "ü" als Sonderzeichen beinhalten. \\  So verzeiht das Filterfeld - in Bezug auf Umlaute - nachlässig eingegebene Suchbegriffe, unterstützt aber auch bei korrekter Eingabe eines Filterbegriffs die exakte Filterung des gesuchten Eintrags.

//Filter-Felder leeren//\\ Wenn ein Nutzer eine Fahrt starten möchte, sucht er meist in einem der Filter-Felder nach einem Boot/Person, und ist nach der Eintragung der Fahrt schnell vom efa-PC verschwunden. \\ Die Suchbegriffe hingegen bleiben weiter bestehen, und der nächste Benutzer wundert sich, warum er sein Boot in der Liste nicht findet.\\ \\ Daher kann EFA nach dem Abschluss von Aktivitäten, die sich auf eine Fahrt beziehen (Eintragen/Ändern/Abschließen und weitere), die Filterfelder automatisch leeren. Damit hat der nächste Benutzer eine Standardmaske wieder verfügbar.\\ Alternativ kann man das Leeren der Filter-Felder auch zeitgesteuert veranlassen.

//Inhalte/Darstellung//\\ Über diese Einstellungen erhält EFA seine moderneren Listenansichten.
Allerdings kostet die Anzeige z.B. von Reservierungen, Tooltipps oder die Zwei-Spalten-Darstellung auf RASPI 1 und 2 etwas Performance.\\ Daher lassen sich diese Funktionen bei Bedarf einzeln ausschalten.

//Bootslisten Sortierung//\\ Diese Funktionen dienen zur Strukturierung der Boote in den angezeigten Bootslisten.

==== Widgets ====
Widgets sind Informationsschnipsel, die auf der Oberfläche von efa integriert werden können. 
Hierzu gehören 
  * Uhrzeit
  * Wetterinformationen (wieder funktional ab Version 2.5.1)
  * HTML-Seiten-Anzeige
  * Hinweis-Widget
  * Newsticker

Zur Konfiguration der Widgets gibt es eine [[widgets|eigene Seite]].

===== Administratoren =====

Nur Administratoren dürfen Administrationsaufgaben in efa durchführen. Administratoren identifizieren sich durch einen Namen und Paßwort, und können individuelle Rechte zugewiesen bekommen. Der Haupt-Administrator heißt //admin//, hat uneingeschränkten Zugriff auf alle Funktionen und wird beim ersten Start von efa angelegt.

Im Admin-Modus kann der Haupt-Administrator weitere Administratoren anlegen und ihnen die gewünschten Rechte zuweisen.

Dies gilt nicht mehr bei der Nutzung von efaCloud für das aktuelle Projekt, da hier das zentrale efaCloud die Administratoren verwaltet, und nur noch der generelle "Admin" für das Projekt bestehen bleiben sollte.

===== Statistikeinstellungen =====

Statistiken können vom Administrator interaktiv abgerufen werden, indem im Menüpunkt //Statistiken// die Funktion //Einmalige Statistik// verwendet wird.

Damit Statistiken für alle Mitglieder im Bootshaus zur Verfügung stehen, müssen sie zuvor vom Administrator als Statistikeinstellung mit der Option //Statistik allgemein verfügbar// erstellt und abgespeichert werden.

===== Datensicherheit =====

Damit - insbesondere im Betrieb im Bootshaus - im Fall von Hardwaredefekten, Softwarefehlern oder Bedienungsfehlern keine oder möglichst wenige Daten verloren gehen, sollten einige Vorkehrungen getroffen werden:

  * Backups:
    * manuell erstellen: In efa können interaktiv über die Funktion //Backups// Datensicherungen erstellt werden. Diese sollten, um einem Hardwarefehler vorzubeugen, auf einem separaten Datenträger (z.B. externe Festplatte oder USB-Stick) gespeichert werden.
    * automatisch erstellen: In der efa-Konfiguration unter //efa-Bootshaus - Automatische Abläufe// kann das automatische Erstellen eines Backups zu einer vorgegebenen Zeit konfiguriert werden. Optional kann dieses Backup auch per email verschickt werden. Zur Konfiguration siehe [[access_cli|efaCLI]].
    * Mit [[access_cli|efaCLI]] können auch skriptgesteuert Backups erstellt werden. [[http://efa.nmichael.de/efalive.html|efaLive]] integriert efaCLI, um automatisch zu konfigurierbaren Zeiten ein Backup zu erstellen, das auch per email verschickt werden kann.
  * Spiegelverzeichnis auf zweiter Festplatte: In der Konfiguration kann unter //Daten - lokale Dateien// ein Spiegelverzeichnis konfiguriert werden. Auf diesem legt efa dann bei jedem Speichern eine Kopie der Daten ab. Um einem Festplattenfehler vorzubeugen, sollte dieses Spiegelverzeichnis auf einer zweiten Festplatte oder einem dauerhaft eingesteckten USB-Stick liegen.

===== Remote-Zugriff =====

efa2 erlaubt es, auf ein entfernt (remote) laufendes efa (zum Beispiel in der Bootshalle) zuzugreifen. Dies kann genutzt werden, um beispielsweise von zu Hause oder aus dem Geschäftszimmer Administrationsaufgaben zu erledigen - vorausgesetzt der Computer in der Bootshalle verfügt über eine Netzwerkverbindung. Die Konfiguration des Remote-Zugriffs ist [[access_remote|hier beschrieben]].
efa DokuWiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
