Admidio Anforderungen-Plugin — Wiederkehrende Anforderungen und die Aktivitäten, die sie erfüllen, verfolgen [Admidio-Wiki]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Admidio Anforderungen-Plugin — Wiederkehrende Anforderungen und die Aktivitäten, die sie erfüllen, verfolgen ======

{{admidioplugins>info}}

==== Beschreibung ====
Plugin für Admidio 6.0 und neuer, das wiederkehrende Anforderungen verfolgt, die Mitglieder erfüllen müssen -- etwa Weiterbildung (CPD), Sicherheitsschulungen, regelmäßige Zertifizierungen oder Prüfungen -- sowie die Aktivitäten (Kurse, Seminare, Prüfungen), die dafür zählen.

Mitglieder erfassen ihre Aktivitäten und die Punkte, die jede einbringt. Für den laufenden und die früheren Zeiträume zeigt das Plugin, ob die Anforderungen erfüllt sind, die für ihre Rollen gelten. Prüfer kontrollieren das Angegebene und können die anerkannten Punkte korrigieren.

==== Downloads ====
<WRAP download 60%>
{{admidioplugins>releases}}
</WRAP>

==== Installation ====
Gehe als Administrator zum Plugin-Manager von Admidio (Admidio 6.0 oder neuer und PHP 8.2 oder neuer erforderlich), wähle „Plugin hinzufügen“, lade die Plugin-ZIP-Datei hoch und aktiviere das Plugin. Die Tabellen werden bei der Installation angelegt. Beim Deinstallieren werden die Einstellungen entfernt, auf Wunsch auch die Tabellen. Das Plugin hat einen eigenen Menüpunkt; seine Texte gibt es auf Deutsch und Englisch.

==== Funktionen ====
  * **Anbieter:** die Organisationen, die Schulungen anbieten. Eine Aktivität behält den Namen des Anbieters, auch wenn dieser später gelöscht wird.
  * **Aktivitäten:** Ein Mitglied erfasst einen Kurs, ein Seminar oder eine Prüfung mit Terminen, Ort, Teilnahme, Link und Anmerkungen. Eine Aktivität ist ein //Entwurf//, bis das Mitglied sie zur Prüfung //einreicht//; eine eingereichte Aktivität kann //zurückgezogen// werden. Ein normales Mitglied sieht nur seine eigenen Aktivitäten.
  * **Punkte:** Eine Aktivität kann Punkte für mehrere Anforderungen einbringen, zum Beispiel 6 CPD- und 3 Sicherheitspunkte, jeweils einem Zeitraum zugeordnet. Der von einem Prüfer anerkannte Wert überschreibt den angegebenen; ein anerkannter Wert von 0 bedeutet daher „nichts anerkannt“.
  * **Anforderungsarten:** ein Name, eine Beschreibung und ein Zeitraum: eine Anzahl von Kalendereinheiten (Jahr, Quartal, Monat oder Woche) oder ein Zeitraum, der nach der letzten Erfüllung wiederkehrt. Qualifiziert sich ein Mitglied über mehrere Rollen, legt die Anforderungsart fest, ob die höchste, die niedrigste oder die Summe der Rollenverpflichtungen gilt.
  * **Rollenregeln:** die Punkte, die eine Rolle für eine Anforderungsart erreichen muss, mit optionalen Gültigkeitsdaten, damit eine geänderte Anforderung nicht für ältere Zeiträume gilt. Eine Regel verlangt entweder den vollen Betrag oder einen anteiligen Betrag entsprechend der Mitgliedschaft, gerechnet nach Monat, Woche oder Tag. Frühere Zeiträume verwenden die historischen Rollenmitgliedschaften von Admidio.
  * **Anforderungsseite:** eine Seite für die Anforderungen der Organisation und die eigenen des Mitglieds. Administratoren legen dort die Anforderungen und Rollenregeln der Organisation fest; ein Mitglied sieht schreibgeschützt jene, die für es über seine aktuellen Rollen gelten.
  * **Eigene Anforderungen und eigene Ziele:** Jedes Mitglied kann eigene Anforderungen definieren, zum Beispiel die Schulungspflicht seines Arbeitgebers, mit Ziel und Beginn der Gültigkeit. Ein Mitglied kann auch ein eigenes Ziel für eine Anforderung der Organisation festlegen, die keine seiner Rollen vorsieht. Beides wird wie die Anforderungen der Organisation berechnet und erscheint in der Übersicht des Mitglieds. Andere Mitglieder sehen sie nie, Administratoren nur als Punkte bei den Aktivitäten des Mitglieds, und die Prüfung sowie die Kommandozeile lassen sie aus.
  * **Erfüllungsübersicht:** oberhalb der Aktivitätenliste für jede geltende Anforderung die erreichten Punkte im Verhältnis zu den geforderten, für den laufenden und eine einstellbare Anzahl früherer Zeiträume, mit Schaltflächen zum Zurückblättern. Eine Anforderung, die nach der letzten Erfüllung wiederkehrt, zeigt jede Erneuerung als das Zeitfenster, in dem sie gültig ist. Dieselbe Übersicht gibt es als Widget der Übersichtsseite, mit eigener Einstellung, wer es sieht und wie viele frühere Zeiträume es zeigt.
  * **Administrative Prüfung:** je Anforderung und Zeitraum die Abdeckung jedes Mitglieds, mit direkt bearbeitbaren anerkannten Punkten (nur Administratoren).
  * **Import:** Ein Assistent liest eine CSV- oder Tabellendatei mit Aktivitäten und deren Punkten ein (Datei, Spaltenzuordnung, Vorschau, Import, Ergebnis). Bereits früher importierte Zeilen werden erkannt und übersprungen.
  * **Nachweisdateien:** Optional hängen Mitglieder das erhaltene Zertifikat an eine Aktivität an. Die Dateien werden unterhalb von ''adm_my_files/'' gespeichert und können nur über das Plugin gelesen werden, das die Berechtigung prüft.
  * **Änderungshistorie:** Alle Tabellen schreiben in die Änderungshistorie von Admidio.
  * **Kommandozeile:** Alles Obige steht auch als Befehle ''admidio requirements:…'' zur Verfügung (Anbieter, Aktivitäten, Punkte, Nachweisdateien, Anforderungsarten, Rollenregeln, ''report'' und ''import''). Der Import meldet nur, was geschehen würde, solange ''--commit'' nicht angegeben ist.

==== Einstellungen ====
**Administration → Einstellungen → Inhalt → Anforderungen**

^ Einstellung ^ Standard ^ Bedeutung ^
| Plugin-Zugriff | Angemeldete Benutzer | Wer das Plugin nutzen darf; //Deaktiviert// schaltet es ab. |
| Bearbeitung durch Mitglieder | Immer | Mitglieder dürfen ihre eigenen Aktivitäten immer bearbeiten und löschen, oder nur Entwürfe. Administratoren können Einträge immer prüfen und korrigieren. |
| Standard-Anteilsbasis | Monat | Die Voreinstellung der Genauigkeit für neu angelegte anteilige Rollenregeln. Sie wird bei jeder Regel gespeichert, eine spätere Änderung deutet alte Regeln daher nicht um. |
| Frühere Zeiträume in der Übersicht | 4 | Wie viele Zeiträume vor dem laufenden die Erfüllungsübersicht zeigt. |
| Erfüllungsübersicht auf der Startseite | Angemeldete Benutzer | Zeigt jedem Mitglied die Erfüllung seiner Anforderungen als Widget auf der Übersichtsseite. |
| Frühere Zeiträume im Widget | 1 | Wie viele frühere Zeiträume das Widget zeigt. |
| Nachweisdateien erlauben | aus | Erlaubt Mitgliedern, Nachweise an Aktivitäten anzuhängen. |
| Dateien je Aktivität | 5 | |
| Maximale Dateigröße (MiB) | 10 | Das Upload-Limit des Servers gilt weiterhin. |
| Erlaubte Dateitypen | pdf,jpg,jpeg,png | Kommagetrennt; nur pdf, jpg und png können gespeichert werden. |
| Gesamtspeicher (MiB) | 0 | Die Größe aller Nachweise der Organisation; 0 bedeutet keine Begrenzung. |

==== Datenbank ====
Das Plugin verwendet die Tabellen ''req_providers'', ''req_activities'', ''req_requirement_types'', ''req_requirement_role_rules'', ''req_activity_credits'' und ''req_activity_files'' mit dem Tabellenpräfix der Installation.

==== Quellcode ====
Der Quellcode ist auf [[https://github.com/kainhofer/admidio-requirements|GitHub]] verfügbar.