Reporter¶
Reporter sind eine spezielle Art von Feld. Sie werden automatisch befüllt und nicht wie normale Felder vom Benutzer direkt bearbeitet.
Tipp
Feldsynonyme von Reportern beginnen immer mit einen ?.
Achtung
Änderungen in Systemeinstellungen werden oft erst wirksam, wenn nach dem Schließen der Systemeinstellungen ein Neustart durchgeführt wird (Menüpunkt unter dem Button mit dem Benutzernamen oben rechts, s.a. Einführung).
Hinzufügen¶
Eine neue Reporterdefinition wird mittels des Buttons Hinzufügen 
über der Liste angelegt.
Dies öffnet den Reportereditor.
Alternativ kann der +-Button im Reportereditor genutzt werden:
Bearbeiten¶
Um eine Reporterdefinition zu bearbeiten, wird auf den Button Bearbeiten 
geklickt.
Dies öffnet den Reportereditor.
Alternativ kann mit dem Button Reporter laden 
im Reportereditor eine Reporterdefinition zur Bearbeitung ausgewählt werden:
Wichtig
Updates / bzw. Neuanlage nur aktiv, wenn über CortexAdmin eine (Re-)Initialisierung gemacht wird!
Löschen¶
Um eine Reporterdefinition zu löschen, wird diese zur Bearbeitung geöffnet und mit dem Button Löschen 
im Reportereditor gelöscht.
Wichtig
Ein Reporter kann nicht gelöscht werden, wenn er in einem Datensatztyp verwendet wird!
Gruppen¶
Reporter können mit der Gruppen-UI zur leichteren Verwaltung in Gruppen organisiert werden.
Globale Variablen¶
Ermöglicht das Anlegen von global verfügbaren Variablen zur Nutzung in JavaScript V8 Code.
Reportereditor¶
Der Reportereditor dient dem Erstellen, Bearbeiten und Löschen von Reporterdefinitionen.
Definition aktiv¶
Nur wenn der Reporter aktiv ist, wird er bei der Re-Initialisierung des CortexAdmin berücksichtigt!
Zeitstempel¶
Bezeichnung¶
Frei wählbare Bezeichnung für den Reporter. Diese wird von Nutzern zur Identifizierung des Reporters genutzt und sollte daher möglichst sprechend sein.
Nummer¶
Reporter-Typ¶
Legt fest, worauf sich dieser Reporter bezieht:
| Typ | Beschreibung |
|---|---|
| S | Reporter für eigenen Datensatz: Reporter bezieht sich auf Felder im aktuell betrachteten Datensatz. |
| @ | Reporter zu verwiesenem Datensatz: Reporter bezieht sich auf Felder eines im aktuellen Datensatz verwiesenen Datensatzes. |
| F | Reporter über Feldinhaltsliste: Reporter bezieht sich auf die Inhalte aller Felder eines bestimmten Datensatztyps. |
Wichtig
Nicht alle Attribute sind für alle Reportertypen verfügbar.
Verweisfeld¶
Trigger Synonym¶
Bestimmt, welches Feld die (Re-)Evaluierung zu berechnender Werte auslöst.
Trigger Wert¶
Legt fest, welcher Wert im Feld mit Trigger-Synonym vorhanden sein muss, damit die (Re-)Evaluierung auslöst.
Quellmenge aus¶
Die für die Berechnung des Reporters notwendigen Daten können entweder mit Hilfe von JavaScript oder durch Angabe eines Synonyms ermittelt werden.
JavaScript V8 Code¶
Werte des Reporters können mit Hilfe von JavaScript ermittelt werden. Gültig ist valides JavaScript.
Folgende Funktionen stehen im Reporter zur Verfügung, um auf Inhalte der CortexEngine zuzugreifen:
| Funktion | Signatur | Beschreibung |
|---|---|---|
| Informationen zu Feldern | ||
| HrIId | () | Liefert die IId des aktuell geladenen Cortex Container |
| HrSyn | (nPos) | Liefert das Synonym des n-ten Feldes im Container |
| HrFid | (sSyn, nPos) | Liefert zur n-ten Wiederholung eines Feldes die Feld(Wiederholungs)-ID |
| HrFidCnt | ([ sSyn ]) | Gibt die Anzahl der Felder im Container zurück oder liefert die Anzahl der Wiederholungen eines Feldes |
| HrTyp | (sSyn [, sFid ]) | Liefert den Basis-Feldtyp zu einem Synonym |
| HrHasIId | (sIId24) | Vergleicht die übergebene (24-stellige) IId mit der des geladenen Containers |
| Feldinhalte lesen | ||
| HrChar | (sSyn [, sFid ]) | Liefert den Inhalt des Character-Feldes aus dem CORTEX Container |
| HrCharJSON | (sSyn [, sFid ] [, nTime ]) | Liefert die Verlaufsinformationen eines char-Feldes in Form eines JSON Objects |
| HrDouble | (sSyn [, sFid ]) | Liefert den Inhalt des Character-Feldes aus dem CORTEX Container als Gleitkommazahl |
| HrDoubleJSON | (sSyn [, sFid ] [, nTime ]) | Liefert die Verlaufsinformationen eines Double-Feldes in Form eines JSON Objects |
| HrInt224 | (sSyn [, sFid ]) | Liefert den Inhalt des Character-Feldes aus dem CORTEX Container als positive Ganzzahl |
| HrInt224JSON | (sSyn [, sFid ] [, nTime ]) | Liefert die Verlaufsinformationen eines Integer-Feldes in Form eines JSON Objects |
| HrLink | (sSyn [, sFid ]) | Liefert den Inhalt eines Verweisfeldes als JSON Object. Bei gültigen Verweisen mit den Elementen "t" = "@", "i" = 24-stellige IId und "r" = Rest des Feldinhalts. Bei ungültigen Verweisen: "t": "!" und "c": Feldinhalt |
| HrLinkJSON | (sSyn [, sFid ] [, nTime ]) | Liefert die Verlaufsinformationen eines Verweisfeldes-Feldes in Form eines JSON Objects |
| HrAnsi | (sSyn [, sFid ]) | Liefert einen Feldinhalt, dieser wird über die Ansi-Codepage in UTF8 gewandelt. |
| HrRaw | (sSyn [, sFid ]) | Liefert einen Feldinhalt, dieser wird direkt in UTF8 gewandelt. |
| Stringfunktionen | ||
| HrStrGetLen | (sStr) | Liefert die Stringlänge in Bytes eines UTF8-Strings zurück |
| HrStrSetLen | (sStr, nMaxLen) | Begrenzt einen UTF8-String auf die übergebene Maximallänge in Bytes unter Beachtung der Multibyte-Grenzen der UTF8-Zeichen |
| Konvertierung | ||
| HrTs2Dt | (nTimeStamp) | Wandelt einen Zeitstempel in ein Datum |
| HrDt2Ts | (sDateStr) | Wandelt ein Datum in einen Zeitstempel |
| HrStr2IId | (sIId24) | Wandelt eine 24-stellige IId ins 12-stellige Format und liefert sie als UTF8-String |
| HrIId2Str | (sIId12) | Wandelt eine IId vom UTF8-Format in eine 24-stellige IId |
Globale JS Variablen¶
Legt fest, ob dieser Reporter Zugriff auf die globalen JS-Variablen hat.
Synonym¶
Werte aus Feldern mit Synonym X werden als Liste dargestellt.
Filter¶
Das Ergebnis kann durch einen oder mehrere Filter eingeschränkt werden. Gefiltert werden kann basierend auf dem unter Synonym konfigurierten Feld oder auf Basis anderer Felder.
Achtung
Felder, über die gefiltert wird, müssen aus dem gleichen Datensatztyp stammen wie das unter Synonym konfigurierte Feld!
Rückgabewert¶
Legt fest, welche Art von Wert von diesem Reporter zurückgeben wird. Siehe auch Feldtypen.
Ziel Reporterfeld¶
Bestimmt, unter welchem Synonym die Reporterdefinition in Feldauflistungen (z.B. bei ungenutzten Feldern im Datensatztypeditor) zu finden ist.
Wichtig
Das Synonym darf maximal 6 Zeichen lang sein.
Exportieren¶
Mittels der Markier-Checkboxen können eine oder mehrere Reporterdefinitionen in der Liste markiert werden.
CSV-Export¶
Markierte Reporterdefinitionen können mit dem Button Markierte Daten als CSV exportieren 
im CSV-Format exportiert werden.
Exportiert wird eine Liste mit folgenden Informationen:
| Spalte | Beschreibung |
|---|---|
| ID | Eindeutige ID des Reporters |
| Aktiv | Ist dieser Reporter aktiv? |
| Typ | Typ des Reporters |
| Name | Bezeichnung des Reporters |
| Zeitstempel | Zeitstempel des Reporters |
| Syn | Nutzt dieser Reporter Synonym als Quellmenge (Y/N) |
| Trigger | Wird ein Trigger-Wert eingesetzt? |
| Quelle | Quellmenge des Reporters |
| Ziel | |
| Ziel Reporterfelder | Ziel Reporterfeld des Reporters |