Gruppenlisten: Unterschied zwischen den Versionen

Aus dem IServ-Wiki
Zur Navigation springen Zur Suche springen
(Notfallversion 1.7.5 veröffentlicht)
 
(12 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
|einsatzbereich=[[IDesk]]
 
|einsatzbereich=[[IDesk]]
 
|beschreibung=Einfache Gruppenlisten erstellen
 
|beschreibung=Einfache Gruppenlisten erstellen
|version=1.6.1
+
|version=1.7.5 (Entwicklung eingestellt)
 
|autor=[[Benutzer:Joerg.Hoffmann|Jörg Hoffmann]]
 
|autor=[[Benutzer:Joerg.Hoffmann|Jörg Hoffmann]]
  
 
}}
 
}}
 +
 +
'''Achtung, die Entwicklung dieser Gruppenlisten wurde Eingestellt und für IServ3 unter [https://jcraft.de/iserv/gruppenlisten Gruppenlisten_IServ3] als Neuentwicklung fortgeführt'''
 +
 
Das Modul Gruppenlisten bringt eine einfache Möglichkeit anpassbare
 
Das Modul Gruppenlisten bringt eine einfache Möglichkeit anpassbare
  
Zeile 37: Zeile 40:
 
Über Feedback zur Installation und Anwendung würden wir (->Autor) uns freuen.
 
Über Feedback zur Installation und Anwendung würden wir (->Autor) uns freuen.
  
== Konfigurationsparameter ==
+
== Konfigurationsparameter (Verwaltung->System->Konfiguration->Modul: Gruppenlisten) ==
Standard ist "lastname firstname actuser stat email" (pro Eintrag eine Zeile)
+
Standard sind lastname firstname actuser stat und email (pro Werte Feld ein Parameter!)
  
Es gibt zu dem noch role, importid und auxinfo.
+
Es gibt zu dem noch role, importid, auxinfo und owner.
  
 
Die Felder role und auxinfo enthalten die Rollen bzw. Zusatzinformationen die in Iserv3 Anwendung finden.
 
Die Felder role und auxinfo enthalten die Rollen bzw. Zusatzinformationen die in Iserv3 Anwendung finden.
 
Das Feld importid enthält die ID der Zeile beim Import der Benutzer aus anderen Programmen.
 
Das Feld importid enthält die ID der Zeile beim Import der Benutzer aus anderen Programmen.
 +
Das Feld owner enthält den Namen des Gruppeneigentümers.
  
 
== Changelog ==
 
== Changelog ==
 
Die jeweils letzte Version enthält den "bis jetzt" Stand und kann noch Änderungen bis zum Release unterliegen. Dies ist bei manueller Paketinstallation der .deb zu beachten da wir kein minorversioning machen.
 
Die jeweils letzte Version enthält den "bis jetzt" Stand und kann noch Änderungen bis zum Release unterliegen. Dies ist bei manueller Paketinstallation der .deb zu beachten da wir kein minorversioning machen.
 
Die über den IDesk installierte Version wird nach Release automatisch auf die aktuellste Version aktualisiert.
 
Die über den IDesk installierte Version wird nach Release automatisch auf die aktuellste Version aktualisiert.
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.6.2_all.deb V1.6.2]
+
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.5_all.deb V1.7.5]
 +
  Durch die Versionsaktualisierung von PHP auf Version 8 wurde die Grundfunktion der Gruppenlisten beschädigt.
 +
  Aufgrund der noch vorhandenen Restnutzer wurden die Fehler behoben, es erfolgt aber keine automatische Aktualisierung via iServ!
 +
  * Behoben wurde der Fehler "TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given"
 +
  * sowie ein Fehler der angezeigt wurde, wenn es keinen Gruppeneigentümer für die selektierte Gruppe gibt.
 +
<pre>
 +
Die manuelle Aktualisierung wird wie folgt durchgeführt:
 +
Als root via ssh an iserv anmelden und folgendes eingeben:
 +
wget -q https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.5_all.deb
 +
dpkg -i iserv-mod-grouplist_1.7.5_all.deb
 +
/etc/init.d/apache2 restart
 +
iservchk postgresql apache
 +
</pre>
 +
 
 +
  [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.4_all.deb V1.7.4] (letzte über iServ veröffentlichte Version)
 +
  Paketstatus auf deprecated gesetzt. Das Modul wird nicht weiter entwickelt.
 +
 
 +
  [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.3_all.deb V1.7.3]
 +
  Der Gruppenbesitzer kann ab jetzt in den Listen mit angezeigt und exportiert werden.
 +
  Dazu muss der Konfigurationsparameter "owner" eingefügt werden (Siehe Konfigurationsparameter oben).
 +
 
 +
  [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.2_all.deb V1.7.2]
 +
  Kleine Änderung um auch mit PHP 7.2 zu funktionieren.
 +
 
 +
  [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.1_all.deb V1.7.1]
 +
  Kleine Änderung um die erhöhte Sicherheit beim Datenbankzugriff in Zukunft zu unterstützen.
 +
 
 +
  [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7_all.deb V1.7]
 
   Die vorherige Korrektur der Rollen hat dafür gesorgt dass nur noch einmalige Werte im jeweiligen Sortierkriterium angezeigt wurden.
 
   Die vorherige Korrektur der Rollen hat dafür gesorgt dass nur noch einmalige Werte im jeweiligen Sortierkriterium angezeigt wurden.
 
   Bei der Anzeige der Rollen werden nun wie erwartet die Benutzer mehrfach angezeigt, ohne Rollenanzeige werden die Benutzer nur einmal angezeigt.
 
   Bei der Anzeige der Rollen werden nun wie erwartet die Benutzer mehrfach angezeigt, ohne Rollenanzeige werden die Benutzer nur einmal angezeigt.
 +
  Der Drucken-Knopf funktioniert nun auch unter IServ 3.
  
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.6.1_all.deb V1.6.1]
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.6.1_all.deb V1.6.1]
Zeile 73: Zeile 105:
  
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.4_all.deb V1.4]:
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.4_all.deb V1.4]:
   <span style="color:red">Gruppenmerkmal "Gruppe in Gruppenlisten anzeigen" funktioniert nun korrekt.
+
   Gruppenmerkmal "Gruppe in Gruppenlisten anzeigen" funktioniert nun korrekt.
 
   Recht "Gruppenmitglieder nicht in der Auswertung anzeigen" darf leer sein.
 
   Recht "Gruppenmitglieder nicht in der Auswertung anzeigen" darf leer sein.
   Kleine Optimierungen im Quellcode.</span>
+
   Kleine Optimierungen im Quellcode.
  
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.3_all.deb V1.3]:
 
   [https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.3_all.deb V1.3]:

Aktuelle Version vom 19. November 2021, 10:34 Uhr

Gruppenlisten
Gruppenliste01.png
Einsatzbereich IDesk
Beschreibung Einfache Gruppenlisten erstellen
Version 1.7.5 (Entwicklung eingestellt)
Autor Jörg Hoffmann


Achtung, die Entwicklung dieser Gruppenlisten wurde Eingestellt und für IServ3 unter Gruppenlisten_IServ3 als Neuentwicklung fortgeführt

Das Modul Gruppenlisten bringt eine einfache Möglichkeit anpassbare

Listen von Gruppenmitgliedern zu erstellen, auszudrucken oder in eine CSV Datei zu exportieren.

Konfigurierbar ist unter Verwaltung->Rechte->Gruppenlisten bei welchen Gruppen die Auswertefunktion unter Informationen->Gruppenlisten erscheint.

Es gibt eine Grundsatzkonfiguration (ab V.1.5) in iservcfg (Verwaltung->Erweiterte Funktionen->iservcfg) in der die anzuzeigenden Datenfelder Konfiguriert werden können.

Des weiteren lassen sich Mitglieder bestimmter Gruppen in den Listen ausblenden.

Die zur Auswahl stehenden Gruppen innerhalb der Gruppenlisten wird über das Gruppenmerkmal 'Gruppenlisten' definiert.

Alle dort aufgeführten Gruppen lassen sich dann auswerten.

Empfohlene Konfiguration:

Gruppenmerkmale für alle Klassen und ggf. Kurse

Die Rechte zur Auflistung für die Gruppen Lehrer und Verwaltung.

Die Rechte zum Ausblenden für die Gruppe Lehrer


Installation

Das Modul ist via Paketverwaltung auf dem IDesk verfügbar. Über Feedback zur Installation und Anwendung würden wir (->Autor) uns freuen.

Konfigurationsparameter (Verwaltung->System->Konfiguration->Modul: Gruppenlisten)

Standard sind lastname firstname actuser stat und email (pro Werte Feld ein Parameter!)

Es gibt zu dem noch role, importid, auxinfo und owner.

Die Felder role und auxinfo enthalten die Rollen bzw. Zusatzinformationen die in Iserv3 Anwendung finden. Das Feld importid enthält die ID der Zeile beim Import der Benutzer aus anderen Programmen. Das Feld owner enthält den Namen des Gruppeneigentümers.

Changelog

Die jeweils letzte Version enthält den "bis jetzt" Stand und kann noch Änderungen bis zum Release unterliegen. Dies ist bei manueller Paketinstallation der .deb zu beachten da wir kein minorversioning machen. Die über den IDesk installierte Version wird nach Release automatisch auf die aktuellste Version aktualisiert.

 V1.7.5
 Durch die Versionsaktualisierung von PHP auf Version 8 wurde die Grundfunktion der Gruppenlisten beschädigt.
 Aufgrund der noch vorhandenen Restnutzer wurden die Fehler behoben, es erfolgt aber keine automatische Aktualisierung via iServ!
 * Behoben wurde der Fehler "TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given"
 * sowie ein Fehler der angezeigt wurde, wenn es keinen Gruppeneigentümer für die selektierte Gruppe gibt.
Die manuelle Aktualisierung wird wie folgt durchgeführt:
Als root via ssh an iserv anmelden und folgendes eingeben:
wget -q https://igf-kiel.de/idesk/share/iserv-mod-grouplist_1.7.5_all.deb
dpkg -i iserv-mod-grouplist_1.7.5_all.deb
/etc/init.d/apache2 restart
iservchk postgresql apache
 V1.7.4 (letzte über iServ veröffentlichte Version)
 Paketstatus auf deprecated gesetzt. Das Modul wird nicht weiter entwickelt.
 V1.7.3
 Der Gruppenbesitzer kann ab jetzt in den Listen mit angezeigt und exportiert werden.
 Dazu muss der Konfigurationsparameter "owner" eingefügt werden (Siehe Konfigurationsparameter oben).
 V1.7.2
 Kleine Änderung um auch mit PHP 7.2 zu funktionieren.
 V1.7.1
 Kleine Änderung um die erhöhte Sicherheit beim Datenbankzugriff in Zukunft zu unterstützen.
 V1.7
 Die vorherige Korrektur der Rollen hat dafür gesorgt dass nur noch einmalige Werte im jeweiligen Sortierkriterium angezeigt wurden.
 Bei der Anzeige der Rollen werden nun wie erwartet die Benutzer mehrfach angezeigt, ohne Rollenanzeige werden die Benutzer nur einmal angezeigt.
 Der Drucken-Knopf funktioniert nun auch unter IServ 3.
 V1.6.1
 Benutzer mit mehreren Rollen werden nun nur einmalig angezeigt solange die Rollen ausgeblendet werden.
 Bei eingeblendeten Rollen wird die korrekte Anzahl der Benutzer angezeigt und nicht die Anzahl der angezeigten Einträge
 V1.6
 Datenbankbenutzer erneut gewechselt.
 Absicherung des Quellcodes gegen die bösen Seiten des Internets
 Unkonventionelle Bezeichnungen und kodierte Zeichen sollten nun keine Fehler verursachen.
 V1.5
 Datenbankbenutzer gewechselt.
 Lehrer und Schüler werden nun getrennt dargestellt.
 Auswahl der anzuzeigenden Datenfelder hinzugefügt.
 Gelöschte Benutzer sowie Gruppen werden nicht mehr angezeigt bzw. zur Auswahl angeboten.
 Optische Anpassungen zur Feature Umsetzung.
 Des weiteren wurde die Ausdruckbreite fixiert während
 die normale Darstellungsansicht nun von der Fenstergröße abhängig ist.
 Mailadressen werden nur bei aktiven Benutzern angezeigt.
 Die zur Auswahl stehenden Felder sind nun in der Grundsatzkonfiguration in iservcfg anpassbar.
 V1.4:
 Gruppenmerkmal "Gruppe in Gruppenlisten anzeigen" funktioniert nun korrekt.
 Recht "Gruppenmitglieder nicht in der Auswertung anzeigen" darf leer sein.
 Kleine Optimierungen im Quellcode.
 V1.3:
 Die gewünschte Exportmöglichkeit als CSV wurde hinzugefügt.
 Auswahlmöglichkeit im Gruppenmerkmal "Gilt für" wurde implementiert. 
 Ergänzte Absicherung gegen unberechtigte Datenbankzugriffe.
 Standardauswahl des Filters wurde umgekehrt.
 Bei keiner Auswahl wird nun eine Anleitung angezeigt.
 Das Druckdatum wird nur noch im Ausdruck angezeigt.
 Die Druckfarbe wurde auf tiefschwarz geändert.
 Der Gruppeneigentümer wird nun angezeigt.
 V1.2:
 Fehlermeldung bei Gruppen ohne Mitglieder behoben.
 Sortierung der Gruppen optimiert.
 Gruppen die eigentlich selbst gefiltert werden, können nun auch angezeigt werden. Der Filter ist hier deaktiviert.

Export als CSV (Ab V1.3)

 Der Export nimmt immer die selektierte Auswahl, es ist nicht nötig vorher 'Auswerten' zu drücken.
 Die Dateien enthalten jeweils Überschriften 
 für Auswerung: Gruppenname,Nachname,Vorname,Benutzername,Status
 und für den E-Mail Export: Gruppenname,Nachname,Vorname,E-Mail,Benutzername
 Die 'Auswertung'-Variante enthält alle Datensätze die auch angezeigt werden würden gegenüber der
 'Email Kontakte'-Variante, diese enthält nur Kontakte die aktiv sind.
 Eingeschränkte wie auch inaktive Nutzer haben keinen Email Zugriff.
 Der Import funktioniert in Outlook nur mit der 'Email Kontakte'-Variante da keine Datensätze mit Lücken vorhanden sein dürfen.

 Als Trennzeichen werden Komma (,) und Anführungszeichen (") für Feldbegrenzungen benutzt.
 Die Zeichenkodierung ist UTF-8 (In Excel unter 65001 zu finden)
 
 Es wird empfohlen über Daten->Aus Text einen Import durchzuführen mit den oben genannten Einstellungen.
 Das Resultat ist dann eine korrekte Darstellung in Tabellenform
 Es kann zu einer Einschränkung beim Import in Kontakte kommen, da je nach Selektion Nutzer mehrfach vorkommen. Hier wäre wie immer ein Feedback gerne erwünscht. 
 Denkbar wäre es falls dies in der Tat ein Problem darstellt doppelte im Email Kontakte-Export zu filtern.
 Wir haben zudem mit einem vCard export rumprobiert, aber Outlook bzw. Microsoft haben eine Abneigung gegen mehrere Kontakte in einer vCard.

Konfiguration

Die Konfiguration findet über den iDesk statt. Dort können folgende Optionen gesetzt werden:

Konfiguration Name Auswirkung
Rechte Gruppe berechtigen Berechtigt Mitglieder die Auswertung zu benutzen
Rechte Gruppe ausblenden Blendet Mitglieder diese Gruppe bei der Auswertung aus
Gruppenmerkmal Gruppenauswahl Gruppen zur Auswahl der Gruppenlisten hinzufügen

Screenshots

Autor

Jörg Hoffmann

Lizenz

Das Modul unterliegt keiner Lizensierung.