Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- breedmaster:merkmaltemplates [01.04.2016 08:42] – angelegt Manfred Link
+++ breedmaster:merkmaltemplates [30.08.2020 11:51] (aktuell) – [Beispiele:] Manfred Link
@@ Zeile 1: / Zeile 1: @@
-====== Merkmaltemplates ======
+====== Merkmal-Minitemplates ======
-Um die Ausgabe der Merkmale/Gesundheit/Genetik besser steuern zu können besteht die Möglichkeit zu jedem Merkmal ein eigenes Mini-Template zu hinterlegen.
+Um die Ausgabe der Hunde-Merkmale (Gesundheits-/Genetikinformationen etc.) besser steuern zu können besteht die Möglichkeit zu jedem Merkmal ein eigenes Mini-Template zu hinterlegen.
-Mögliche Variablen die Zur Verfügung stehen:
+=== Mögliche Variablen die Zur Verfügung stehen: ===
 ^ Variable ^ Erläuterung ^
-| %%{kurzbezeichnung}%% | xxx |
+| %%{unterkategorie}%% | Beispiel: Patella, Augenerkrankung, K-Locus, PRA  |
-| %%{bezeichnung}%% | xxx |
+| %%{merkmal}%% | Beispiel: PL-0, Ektropium, %%K^B/K^B%%, N/N |
-| %%{wert}%% | xxx |
+| %%{wert}%% | Zahlenwert aus dem Feld ''wert'' |
-| %%{datum}%% | xxx |
+| %%{datum}%% | Datumswert aus dem Feld ''datum'' |
-| %%{bemerkung}%% | xxx |
+| %%{quelle}%% | Text aus dem Feld ''quelle'' |
+| %%{bemerkung}%% | Text aus dem Feld ''bemerkung'' |
+| %%{phrase}%% | Text aus dem Feld ''phrase'' |
-Die Minitemplates finden Anwendung bei der Generierung der Angaben die in den Hundestammdaten im Feld ''untersuchungen'' angezeigt werden.
+=== Beispiele: ===
+^ Template ^ Ausgabe ^ Erläuterung ^
+| %%{wert}cm%% | 75cm | An den Zahlenwert wird die Einheit cm Angehangen |
+| %%{unterkategorie}: {wert}kg%% | Gewicht: 52kg | Die Unterkategorie Größe wird mit der Einheit kg ausgegeben |
+| %%{merkmal} {wert}g%% | Geburtsgewicht 352g | Die Bezeichnung Geburtsgewicht wird mit der Einheit Gramm ausgegeben |
+| PRA%%-{merkmal}%% | PRA-Frei | Aus den Abkürzungen N/N der Laborwerte wird eine besser lesbare Form  |
+| PRA%%-{merkmal}%% | PRA-Träger | Aus den Abkürzungen N/m der Laborwerte wird eine besser lesbare Form  |
+Die Minitemplates finden Anwendung bei der Generierung der Angaben die in den Hundestammdaten im Feld ''untersuchungen'' angezeigt werden, der Ausgabe im Pedigree unter ''Stammdaten'' sowie unter ''Datenverwaltung->Merkmale''.
+Seit Version ''12.10.2'' kann das Feld ''wert'' über die Formatierung angepasst werden. Dadurch sind u. a. Rundung der Zahlenwerte, Festlegung der Dezimalstellen und weitere Manipulationen möglich.
+**Achtung: Wenn die Variable ''{wert}'' im Feld Template verwendet wird, so muss diese auch zeitgleich im Feld Formatierung genutzt werden, auch wenn keine Besondere Formatierung verwendet werden soll!
+**
+**Achtung: Nach Änderungen an den Merkmaltemplates ist die Stapelverarbeitung der Gesundheitswerte durchzuführen!**
+====== Formatierung von Merkmalen ======
+Um den Zahlenwert des Feldes ''wert'' zu formatieren stehen eine Reihe von PHP-Funktionen zur Verfügung. Für eine  genaue Erläuterung der Funktionsweise bzw. Syntax und möglicher Parameter folgen Sie bitte der offiziellen PHP-Dokumentation.
+^ Befehl ^ Funktionsbeschreibung ^ Beispiel ^ Formatierung ^ Ergebnis ^
+| floor | **Abrunden eines Zahlenwerte**\\ Um einen Zahlenwert mit Kommastelle abzurunden. So kann aus 7.9 dann 7 gemacht werden.\\ \\ https://www.php.net/manual/de/function.floor.php  | 7.8 | floor({wert}) | 7 |
+| ceil | **Aufrunden eines Zahlenwerte** \\Analog zum Abrunden können Werte auch aufgerundet werden. Aus 3.3 wird dadurch 4\\ \\ https://www.php.net/manual/de/function.ceil.php | 2.3 | ceil({wert}) | 3 |
+| round | **Auf-/Abrunden eines Zahlenwertes**\\ Werte werden auf-/abgerundet. Hierbei kann die Anzahl der zu Berücksichtigen Nachkommastellen angegeben werden. \\ \\ https://www.php.net/manual/de/function.round.php | 2.1 | round({wert},1) | 2.2 |
+| str_replace | **Zeichenersetzung**\\ Im Beispiel wird der Punkt durch einen Schrägstrich ersetzt.\\ \\ https://www.php.net/manual/de/function.str_replace | 5.3 | str_replace('.', '/', {wert}) | 5/3 |
+| number_format | **Zahlenformatierung**\\ Mit number_format() kann neben den Nachkommastellen auch eine Formatierung des Tausendertrennzeichens vorgenommen werden.\\ \\ https://www.php.net/manual/de/function.number-format | 1234.5678 | number_format({wert}, 2, ',', '.') | 1.234,57 |
+Wird eine ungültige Syntax verwendet, so erhalten Sie eine Fehlermeldung.
+==== Beispiele ====
+Nachfolgende Bildschirmkopie zeigt Anwendungsmöglichkeiten für die Formatierung und den Einsatz eines Mini-Templates:
+{{ :wiki:screenshots:merkmale14.png |}}