Tags können in Unterschiedlichen FH-Complete Applikationen vewendet werden um Einträge zu markieren. Es wird unterschieden zwischen manuell gesetzten Tags und automatisierten Tags.

Tags können aktuell nur von Adminsitratoren hinzugefügt werden. Enduser können keine neuen Tags definieren.

Diese werden in der Datenbank in der Tabelle public.tbl_notiztyp angelegt. Hier wird definiert ob ein Tag manuell oder automatisiert ist und das Design des Tags

In der Tags Tabelle ist ein style Attribut dass die CSS Klasse des Tags angibt. Die im Standard mitgelieferten Farben finden sich hier: public/css/tags.css

Die zur Verfügung stehenden Tags können pro Applikation Konfiguriert werden. zB in der Studierendenverwaltung

application/config/stv.php

$config['stv_prestudent_tags'] = [
	'prioone' => ['readonly' => false],
	'priotwo' => ['readonly' => false],
	'hinweis' => ['readonly' => false],
	'hinweis_assistenz' => ['readonly' => false],
	'dd_auto' => ['readonly' => true],
	'wh_auto' => ['readonly' => true],
	'unterbrecher_auto' => ['readonly' => true],
];

Oft werden Tags gesetzt um auf bestimmte Umstände aufmerksam zu machen. zB Person ist ein Unterbrecher. Wenn sich der Status ändert müsste der Tag wieder händisch entfernt werden. Das ist Fehleranfällig und Pflegeintensiv. In diesen Fällen können automatisierte Tags eingesetzt werden um Tags automatisch zu erstellen und wieder zu entfernen.

Es stehen im Standard ein Set an automatisierten Tags zur Verfügung die Verwendet werden können. zB Unterbrecher, Wiederholer, Fehlende Zugangsvoraussetzung, Incoming, Outgoing, Jahrgangsvertreter,

Sind für die eigene Instanz spezielle automtaisierte Tags nötig können diese beliebig erweitert werden.

Automatisierte Tags können per Job neu Berechnet werden:

php index.ci.php jobs/rebuildAutomatedTags

Alternativ gibt es auch die Möglichkeit Tags manuell für einzelnen Personen neu zu generieren in der Studierendenverwaltung.

Für jeden automatisierten Tag muss eine eigene Library erstellt werden. (Siehe application/libraries/tags/) für Beispiele Die Library wird dann beim Tag hinterlegt.

Beim Eintrag des automatischen Tags in der Tabelle public.tbl_notiz_typ muss das Flag automatisiert gesetzt sein und in der Spalte taglib der Pfad zu einer Library in der jeweiligen Extension (z.B. „extensions/FHC-Core-FHTW/tags/TAGNAMETagLib“ relativ zum Ordner <FHC-BASEDIR>/application/libraries/extensions/<FHC-Core-TODO>/ und ohne abschließendes '.php') angegeben werden.

Die Library muss die folgenden Funktionen implementieren:

FHC-BASEDIR/application/libraries/extensions/FHC-Core-EXTNAME/tags/TAGNAMETagLib.php

class TAGNAMEExtTagLib
{
	public function __construct() {...}

	public function getZuordnungIds(array $params) {...}

	public function isCriteriaSetFor(array $params) {...}
}

Methode getZordnungIds - bestimmt für welche Ids der Tag gesetzt werden soll

$params = array(
	'studiensemester_kurzbz' => $studiensemester_kurzbz
);

return (object) array(
	'data' => array(
		array(
			'id' => 123456,
			'von' => '2026-09-01',
			'bis' => '2027-02-03'
		)
	),
	'typeId' => 'prestudent_id'
);

Methode isCriteriaSetFor - prüft für die übergebenen Parameter für eine Id ob die Bedingungen f. den Tag noch gegeben sind.

$params = array(
	'typeId' => $typeId, // Notiz Verknüpfung via ID Typ z.B. 'prestudent_id'
	'id' => $id,
	'studiensemester_kurzbz' => $studiensemester_kurzbz
)

return success(array(
	(object) array(
		'id' => 123456,
		'von' => $studiensemester->start,
		'bis' => $studiensemester->ende
	)
));