====== Valorisierung ======
Mitarbeitergehälter werden zur Anpassung an die **Teuerungsrate** (Inflation) regelmässig **valorisiert**. Hierzu ermöglicht FH Complete das Definieren von Valorisierungsmethoden sowie die Durchführung der notwendigen **Gehaltsanpassungen**.

Um eine Valorisierung zu definieren und durchzuführen, sind folgende Schritte notwendig:
  - Valorisierungsmethode definieren
  - Berechnungsprozess der Valorisierungsmethode definieren
  - Valorisierungsmethode zur Ausführung hinterlegen
  - Valorisierungsinstanz definieren
  - Valorisierung vorberechnen 
  - Valorisierung durchführen


==== Valorisierungsmethode definieren ====
Zunächst muss festgelegt werden, **welche Valorisierungsmethode** verwendet werden soll und **welche Paramter** hierfür notwendig sind.
Dazu wird in der Tabelle //hr.tbl_valorisierung_methode// der Name der Methode defniert. Anschließend werden in der //hr.tbl_valorisierung_instanz_methode// die Parameter, die bei Ausführung dieser Valorisierung übergeben werden, definiert. Dies können beispielsweise der Fix- oder Prozentbetrag zur Erhöhung des Gehalts, Gehaltsgrenzen oder ein bestimmter Stichtag, zu welchem ein aufrechtes Dienstverhältnis bestehen muss, sein. Nachfolgend ein Beispiel einer solchen Valorisierungsmethode:

{{:admin:valorisierunginstanzmethode.png?1000|}}

Es handelt sich hier um die Valorisierungsmethode mit dem Namen ValorisierungProzentSockelbetrag. Ein Kriterium für die Anwendung der Valorisierung ist ein aufrechtes Dienstverhältnis zum Stichtag 31.08.2026. Als Parameter zur Ausführung der Valorisierung werden ein Prozentbetrag sowie ein Sockelbetrag übergeben.

 
==== Berechnungsprozess der Valorisierungsmethode definieren ====
Nun muss definiert werden, wie die **Gehaltsanpassung** im Rahmen der Valorisierung **berechnet** werden soll. Hierzu muss in der Personalverwaltung extension unter //libraries/valorisierung// eine neue library (php-Klasse), die die //AbstractValorisatioMethod// Klasse erweitert, hinzugefügt werden. Dabei muss die //caluclateValorisation// Methode überschrieben werden. Die für die Valorisierung relevanten Gehaltsbestandteile erhält man durch Aufruf der Methode //getGehaltsbestandteileForValorisierung//. Das neue Gehalt nach der Valorisierung wird durch Aufruf der Methode //setBetrag_valorisiert// pro zurückgelieferten Gehaltsbestandteil festgelegt.

{{:admin:valorisierungklasse.png?1000|}}

Hier wird das Gehalt um den übergeben Prozentbetrag, oder um einen Fixbetrag, falls der Sockelbetrag unterschritten wird, erhöht. Der Gehaltsbetrag vor der Valorisierung erhält man mit //getBetrag_valorisiert// (valorisiert durch vorherige Valorisierungen). Ein für die Valorisierungsmethode spezifischer Parameter-check kann durch Überschreiben der Methode //checkParams//, ein spezifischer Anwendungscheck (basierend auf den in "1. Valorisierungsmethode definieren" übergebenen Parametern) definiert werden. Weitere hilfreiche Methoden wie z.B. //fetchWochenstunden// zur Lieferung der Wochenarbeitszeit Vertragsbestandteil sind vorhanden.

==== Valorisierungsmethode zur Ausführung hinterlegen ====
Damit die neu hinzugefügte Methode bei der Valorisierung verfügbar ist, muss sie in der **ValorisationFactory** Klasse hinzugefügt werden. Dabei wird eine neue Konstante sowie ein case statement hinzugefügt:

{{ :admin:valorisationfactory.png?750 |{{:admin:valorisationfactory.png?700|}}
==== Valorisierungsinstanz definieren ====
Nun wurde die Valorisierungsmethode vollständig definiert. Die Ausführung der Valorisierung mit dieser Methode kann nun **mehrmals, zu verschiedenen Zeitpunkten**, erfolgen: Dazu muss die Valorisierungsinstanz definiert werden. Dies wird mit einem Eintrag in der //hr.tbl_valorisierung_instanz// bewerkstelligt. In der Spalte "valorisierungsdatum" ist das Ausführungsdatum der valorisierung zu finden, die Spalte "ausgewaehlt" zeigt an, ob die Valorisierung zu der Instanz bereits ausgeführt wurde. Jede Instanz verweist auf eine **zugehörige Valorisierungsmethode**.

{{ :admin:valorisierunginstanz.png?1000 |}}
==== Valorisierung vorberechnen ====
Nach Definieren der Valorisierungsinstanz sollte diese nun in der GUI zur Ausführung verfügbar sein. Diese ist für eine Organisationseinheit und das Ausführungsdatum nach Klick auf "Valorisierung berechnen" durchführbar. Die Valorisierung wird für jede/n Mitarbeiter/in über alle relevanten Gehaltsbestandteile berechnet und in der Spalte "Summe Gehalt nach Valorisierung" angezeigt. **In diesem Schritt wird die Valorisierung noch nicht in der Datenbank gespeichert!**

{{ :admin:valorisierunggui.png?1000 |}}
==== Valorisierung durchführen ====
Durch Klick auf "gewählte Valorisierung abschließen" wird der in der Spalte "Summe Gehalt nach Valorisierung" angezeigte Betrag gespeichert und wird nun der neue Betrag vor Valorisierung. Dadurch, dass das Attribut "ausgewaehlt" bei der Valorisierungsinstanz nun auf "true" gesetzt ist, kann die abgeschlossene Valorisierung nicht mehr ausgewählt werden.

==== Valorisierungscheck ====
Durch nachträgliche Bearbeitung kann es passieren, dass die Valorisierungsbeträge verändert werden und die Beträge nicht mehr mit den berechneten Soll-Beträgen übereinstimmen. Die Valorisierungsprüfung ermöglicht das **Überprüfen der Korrektheit der Beträge**. Falls ein Valorisierungsbetrag nicht (mehr) korrekt ist, wird bei "Dienstverhältnis" der Link "Zur Valorisierungsprüfung" angezeigt. Dieser ermöglicht das Anzeigen der berechneten und tatsächlich eingetragenen Valorisierungsbeträge:

{{ :admin:valorisierungpruefung.png?800 |}}

{{ :admin:valorisierungscheck.png?1000 |}}

Hier weicht beim Gehaltsbestandteil "Basisgehalt", aktiv ab 01.01.2024, der valorisierte Betrag vom berechneten Betrag zum Datum 01.09.2025 ab. Nun kann der falsche Betrag mit Klick auf "Valorisierung neu berechnen und speichern" an den korrekten, berechneten Betrag angepasst werden.   

==== Berechtigungen ====
Zur Durchführung sowie Prüfung der Valorisierung ist die Lese- und Schreibberechtigung zum Recht **"extension/pv21_valorisierung"** erforderlich. 


==== "Relevante" Gehaltsbestandteile ====
Damit ein Gehaltsbestandteile für die Valorisierung relevant ist, muss Folgendes erfüllt sein:
  * Das **Datum der Valorisierung** muss in den Gültigkeitszeitraum (von - bis) des Gehaltsbestandteils fallen.
  * Das Flag **"valorisierung"** (//tbl_gehaltsbestandteil//) muss auf "true" gesetzt sein
  * Es darf keine **Valorisierungssperre** (//valorisierungssperre// in //tbl_gehaltsbestandteil//) vorhanden sein. Bis zu dem angegebenen Sperrdatum ist der Gehaltsbestandteil von der Valorisierung ausgenommen.