Feld und Platzhalter
Ein Feld besteht aus einem FPScript-Ausdruck, der einen darzustellenden Wert bzw. die darzustellende Zeichenkette liefert, und einem Formatierer, der festlegt, wie die Daten für die Ausgabe zu formatieren sind.
Sie können Felder in beliebige Texte, z. B. Achsenbeschriftungen, Textobjekte, Beschriftungen in Dokumenten usw. einfügen. Bei den darzustellenden Werten kann es sich um Berechnungsergebnisse, Kopfinformationen wie Name und physikalische Einheit von Datensätzen aber auch um das aktuelle Datum oder die aktuelle Uhrzeit handeln.
Das folgende Feld stellt z. B. den ersten Wert in der X-Komponente eines Signals mit drei Nachkommastellen dar:
%.3f{Signal.x[0]}
In diesem Beispiel ist Signal.x[0] der FPScript-Ausdruck, der den Wert liefert und %.3f{...} der Formatierer, der bestimmt, dass die Zahl ohne Exponent und mit drei Nachkommastellen zu formatieren ist. Die Angaben zur Formatierung sind hierbei optional, der einfache Formatierer %{...} gibt beliebige Datentypen in einem Standardformat aus. Fließkommazahlen werden hierbei mit einer Anzahl gültiger Stellen ausgegeben, die auf der Registerkarte Allgemein im Eigenschaften-Dialogfeld der FlexPro-Projektdatenbank eingestellt werden kann.
Felder beginnen immer mit einem %-Zeichen. Falls Sie ein einzelnes Prozent-Zeichen in einen Text einfügen möchten, sollten Sie dieses daher doppelt schreiben, um zu verhindern, dass es als Formatierer interpretiert wird, z. B.:
Die Irrtumswahrscheinlichkeit beträgt %{Probability}%%.
Zugriff auf Objektattribute in Feldern
Da FPScript vollen Zugang zum Automation-Objektmodell von FlexPro hat, können Sie beliebige Objektattribute, auch Eigenschaften genannt, darstellen. Die vordefinierten Felder zur Achsenbeschriftung in Diagrammen machen hiervon z. B. intensiv Gebrauch, um die Namen, Kommentare und Einheiten der über einer Achse geplotteten Datensätze zu ermitteln. Die hierzu verwendeten FPScript-Felder sind teilweise recht länglich, weshalb FlexPro für gängige Felder Platzhalter verwendet. Platzhalter verfügen ebenfalls über einen Formatierer, der aber nicht von FPScript-Code, sondern von einem Namen gefolgt wird. Der Standardtext zur Y-Achsenbeschriftung eines 2D-Kurvenzuges sieht z. B. so aus:
%<NameOrQuantityOrComments> %<[Unit]>
FlexPro ersetzt die beiden Platzhalter bei der Erstellung des Textes durch folgende FPScript-Felder:
%{.Data.YValueObject(%<ListElement>).NameOrQuantityOrComments(.Data.YComponent)}
%{ThisFPObject.YAxes(.YAxis).Scaling.CurrentUnitInBrackets(%<YAxisElement>)}
FPScript definiert ein Standardobjekt, welches mit dem optionalen Schlüsselwort ThisObject angesprochen werden kann. Der Ausdruck .Data ist also äquivalent zum Ausdruck ThisObject.Data. Bei der Auswertung der Achsenbeschriftung eines Kurvenzugs ist ThisObject eine Referenz auf den Kurvenzug. Mit ThisFPObject greifen Sie auf das FlexPro-Objekt, z. B. das Diagramm oder die Tabelle zu, die das Feld enthält.
Falls dem Kurvenzug eine Liste mit mehreren Datensätzen zugeordnet ist, werden die für jedes Element der Liste ausgewertet. %<ListElement> ist hierbei ein Platzhalter, der vor der Auswertung durch den Index des jeweiligen Listenelementes ersetzt wird.
Folgende Tabelle gibt an, welche Objekte ThisObject und ThisFPObject referenzieren:
Feld befindet sich in |
ThisObject zeigt auf |
ThisFPObject zeigt auf |
|---|---|---|
Achsenbeschriftung einer Achse |
Achse |
Diagramm |
Achsenbeschriftung, Kurvenzugbeschriftung oder Legendeneintrag eines Kurvenzugs |
Kurvenzug |
Diagramm |
Legendentitel |
Legende |
Diagramm |
Farblegendenbeschriftung |
Farblegende |
3D-Diagramm |
Titel einer Spaltentabelle |
Spaltentabelle |
Spaltentabelle |
Titel einer Spalte in einer Spaltentabelle |
Tabellenspalte |
Spaltentabelle |
Titel einer Zellentabelle |
Zellentabelle |
Zellentabelle |
Zelle in einer Zellentabelle |
Zelle |
Zellentabelle |
Textobjekt |
Textobjekt |
Textobjekt |
Beschriftung in einem Dokument/Diagramm |
Beschriftung |
Dokument/Diagramm |
Platzhalter für FPScript-Felder
Die Folgende Liste enthält die Platzhalter, die Sie über ein Auswahlmenü in Beschriftungen einbetten können.
Die meisten Platzhalter greifen auf Objektattribute zu. Die Funktion mancher Platzhalter ist von der Art der Beschriftung abhängig, in der der Platzhalter verwendet wird. Der Platzhalter %<Comments> referenziert z. B. im Titel einer Tabellenspalte den Kommentar der in der Spalte dargestellten Komponente eines Datensatzes. Wird er dagegen in einem Diagrammtitel verwendet, referenziert er den Kommentar des Diagramms.
Bezeichnung |
Platzhalter |
Bedeutung |
|---|---|---|
FPScript-Ausdruck |
%{ ... } |
Fügt ein Feld ein, in das Sie beliebigen FPScript-Code einbetten können |
Parameter |
%{ ... .Parameters("Name")} |
Der Wert des Parameters Name des Objektes, das den Platzhalter enthält, oder der Wert des Parameters Name des Datenobjektes, auf den sich der Platzhalter bezieht. |
Projektdatenbankname |
%<DatabaseName> |
Der Name der Projektdatenbank. |
Projektdatenbankpfad |
%<DatabasePath> |
Der Name der Projektdatenbank einschließlich ihres Pfads auf der Festplatte. |
Pfad |
%<Path> |
Der Name des Objektes, das den Platzhalter enthält, einschließlich seines Pfads in der Projektdatenbank. |
Name |
%<Name> |
Der Name des Objektes, das den Platzhalter enthält, oder der Name des Datenobjektes, auf den sich der Platzhalter bezieht. |
Elementname |
%<ElementName> |
Der Name des Listenelements oder der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Name oder Kommentar |
%<NameOrComments> |
Für die Y-Komponente der Name und für die restlichen Komponenten der Kommentar der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Name oder Größe oder Kommentar |
%<NameOrQuantityOrComments> |
Für die Y-Komponente der Name und für die restlichen Komponenten, falls vorhanden, die physikalische Größe und ansonsten der Kommentar der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Kommentar |
%<Comments> |
Der Kommentar des Objektes, das den Platzhalter enthält, oder der Y-Kommentar des Datenobjektes, auf den sich der Platzhalter bezieht. |
Kommentar oder Name |
%<CommentsOrName> |
Je nach Verfügbarkeit der Kommentar oder der Name des Objektes, das den Platzhalter enthält, oder der Kommentar oder der Name der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Größe, Kommentar oder Name |
%<QuantityOrCommentsOrName> |
Je nach Verfügbarkeit die physikalische Größe, der Kommentar oder der Name der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Einheit |
%<Unit> |
Die physikalische Einheit der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
[Einheit] |
%<[Unit]> |
Die physikalische Einheit in eckigen Klammern der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. Wenn die Einheit leer ist, werden auch keine Klammern ausgegeben. |
(Einheit) |
%<(Unit)> |
Die physikalische Einheit in runden Klammern der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. Wenn die Einheit leer ist, werden auch keine Klammern ausgegeben. |
Größe |
%<Quantity> |
Die physikalische Größe der Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Autor |
%<Author> |
Der Autor des Datenobjektes, auf den sich der Platzhalter bezieht. |
Erstellungsdatum |
%<CreationDate> |
Das Datum der Erzeugung des Objektes, das den Platzhalter enthält, oder das Datum der Erzeugung des Datenobjektes, auf den sich der Platzhalter bezieht. |
Erstellungszeit |
%<CreationTime> |
Die Uhrzeit der Erzeugung des Objektes, das den Platzhalter enthält, oder die Uhrzeit der Erzeugung des Datenobjektes, auf den sich der Platzhalter bezieht. |
Modifikationsdatum |
%<ModificationDate> |
Das Datum der letzten Änderung des Objektes, das den Platzhalter enthält, oder das Datum der letzten Änderung des Datenobjektes, auf den sich der Platzhalter bezieht. |
Modifikationszeit |
%<ModificationTime> |
Die Uhrzeit der letzten Änderung des Objektes, das den Platzhalter enthält, oder die Uhrzeit der letzten Änderung des Datenobjektes, auf den sich der Platzhalter bezieht. |
Herkunft |
%<Origin> |
Die Herkunft des Datenobjektes, auf den sich der Platzhalter bezieht. |
Z-Wert |
%<ZValue> |
Bei Darstellung einer Signalreihe ist dies der Z-Wert, der dem als Kurvenzug dargestellten Signal der Signalreihe zugeordnet ist. |
Z-Kommentar |
%<ZComments> |
Bei Darstellung einer Signalreihe ist dies der Kommentar der Z-Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
Z-Einheit |
%<ZUnit> |
Bei Darstellung einer Signalreihe ist dies die physikalische Einheit der Z-Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. |
[Z-Einheit] |
%<(ZUnit)> |
Bei Darstellung einer Signalreihe ist dies die physikalische Einheit in eckigen Klammern der Z-Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. Wenn die Einheit leer ist, werden auch keine Klammern ausgegeben. |
(Z-Einheit) |
%<(ZUnit)> |
Bei Darstellung einer Signalreihe ist dies die physikalische Einheit in runden Klammern der Z-Komponente des Datenobjektes, auf den sich der Platzhalter bezieht. Wenn die Einheit leer ist, werden auch keine Klammern ausgegeben. |
Datum |
%<Date> |
Das Datum der letzten Aktualisierung des Platzhalters. |
Uhrzeit |
%<Time> |
Die Uhrzeit der letzten Aktualisierung des Platzhalters. |
Ordnername |
%<FolderName> |
Der Name des Ordners in der Projektdatenbank, in dem sich das Objekt befindet, das den Platzhalter enthält. |
Ordnerkommentar |
%<FolderComments> |
Der Kommentar des Ordners in der Projektdatenbank, in dem sich das Objekt befindet, das den Platzhalter enthält. |
Aktivierter Unterordner Name |
%<ActiveFolderName> |
Der Name des aktivierten Unterordners des Ordners in der Projektdatenbank, in dem sich das Objekt befindet, das den Platzhalter enthält. |
Aktivierter Unterordner Kommentar |
%<ActiveFolderComments> |
Der Kommentar des aktivierten Unterordners des Ordners in der Projektdatenbank, in dem sich das Objekt befindet, das den Platzhalter enthält. |
Benutzer |
%<User> |
Der Name des aktuell bei Windows angemeldeten Anwenders. |
Dokumentpfad |
%<DocumentPath> |
Der Pfad in der Projektdatenbank des Containerobjektes, indem sich das Objekt, das den Platzhalter enthält, befindet. Für ein in ein Dokument oder Arbeitsblatt eingebettetes Diagramm ist dies der Pfad des Dokumentes bzw. Arbeitsblattes und ansonsten der Pfad des Ordners, in dem sich das Diagramm befindet. |
Dokumentname |
%<DocumentName> |
Der Name des Containerobjektes, indem sich das Objekt, das den Platzhalter enthält, befindet. Für ein in ein Dokument oder Arbeitsblatt eingebettetes Diagramm ist dies der Name des Dokumentes bzw. Arbeitsblattes und ansonsten der Name des Ordners, in dem sich das Diagramm befindet. |
Eingebaute Platzhalter
FlexPro verwendet auch einige Platzhalter, die keinen FPScript-Code hinterlegt haben:
Platzhalter |
Bezeichnung |
Verwendet in |
Bedeutung |
|---|---|---|---|
%<DataSet> |
Datensatzindex |
Achsenbeschriftung, Kurvenzugbeschriftung und Legendeneintrag für 3D-Kurvenzug |
Repräsentiert die Nummer der jeweiligen Datenreihe im Kurvenzug, für den eine Achsenbeschriftung, eine Kurvenzugbeschriftung oder ein Legendeneintrag erstellt wird, und wird im FPScript-Code als Index für die Curve3DDataSets-Auflistung des Curve3D-Objektes verwendet. |
%<Index> |
Datenreihenindex |
Achsenbeschriftung, Kurvenzugbeschriftung und Legendeneintrag für 2D- oder 3D-Kurvenzug. Marke an 2D- oder 3D-Kurvenzug und Koordinaten am Cursor. |
Repräsentiert die Nummer der jeweiligen Datenreihe im 3D-Datensatz, für den eine Beschriftung erstellt wird. Wird im Text zur Anzeige des Datenreihenindex oder im FPScript-Code als Index-Variable verwendet. |
%<[Index]> |
Datenreihenindex, geklammert |
" |
Wie %<Index>, jedoch erfolgt die Ausgabe in eckige Klammern gesetzt. Dieser Platzhalter kann nicht im FPScript-Code verwendet werden. |
%<ListElement> |
Listenelementindex |
Achsenbeschriftung, Kurvenzugbeschriftung und Legendeneintrag für 2D- oder 3D-Kurvenzug und Spaltentitel einer Spaltentabelle. |
Repräsentiert die Nummer des jeweiligen Listenelements im Kurvenzug, für den eine Achsenbeschriftung, eine Kurvenzugbeschriftung oder ein Legendeneintrag erstellt wird. Wird im FPScript-Code als Argument für die ValueObject-Eigenschaft verwendet. |
%<YAxisElement> |
%<YAxisElement> |
Achsenbeschriftung, Kurvenzugbeschriftung und Legendeneintrag für 2D-Kurvenzug |
Repräsentiert die Nummer der Skala der Y-Achse, über der der Kurvenzug dargestellt wird, für den eine Achsenbeschriftung, eine Kurvenzugbeschriftung oder ein Legendeneintrag erstellt wird. Wird im FPScript-Code als Argument für die CurrentUnit-Eigenschaft verwendet. |
%<XAxisElement> |
%<XAxisElement> |
" |
Repräsentiert die Nummer der Skala der X-Achse, über der der Kurvenzug dargestellt wird, für den eine Achsenbeschriftung, eine Kurvenzugbeschriftung oder ein Legendeneintrag erstellt wird. Wird im FPScript-Code als Argument für die CurrentUnit-Eigenschaft verwendet. |
%<YName> |
Y-Name Z-Name |
Datenbeschriftung und Marke an 2D- oder 3D-Kurvenzug und Koordinaten am Cursor |
Die Namen der einzelnen Komponenten des zu beschriftenden Datenpunktes. %<ZName> kann nur in 3D-Kurvenzügen verwendet werden. Die Namen entsprechen dem Datensatznamen (Y) oder den entsprechenden Kommentaren (Y, Z). |
%<YValue> |
Y-Wert Z-Wert |
" |
Die Werte der einzelnen Komponenten des zu beschriftenden Datenpunktes. %<ZValue> kann nur in 3D-Kurvenzügen verwendet werden. |
%<Y2Value> |
Y2-Wert Z2-Wert |
Bereichsmarke an 2D- oder 3D-Kurvenzug |
Die Werte der einzelnen Komponenten des 2. Datenpunktes der Bereichsmarke. %<Z2Value> kann nur in 3D-Kurvenzügen verwendet werden. |
%<YUnit> |
Y-Einheit Z-Einheit |
" |
Die physikalischen Einheiten der einzelnen Komponenten des zu beschriftenden Datenpunktes. %<ZUnit> kann nur in 3D-Kurvenzügen verwendet werden. |
%<DeltaY> |
Delta-Y |
Bereichsmarke an 2D- oder 3D-Kurvenzug und Koordinaten am Cursor |
Die Differenzwerte der beiden Cursor bzw. der beiden Positionen der Bereichsmarke. %<DeltaZ> kann nur in 3D-Kurvenzügen verwendet werden. |
%<DeltaYPerc> |
Delta-Y % |
Bereichsmarke an 2D- oder 3D-Kurvenzug und Koordinaten am Cursor |
Die Differenzwerte der beiden Cursor bzw. der beiden Positionen der Bereichsmarke ind Prozent, bezogen auf den ersten Wert. %<DeltaZPerc> kann nur in 3D-Kurvenzügen verwendet werden. |
%<OrderTrackingName> |
Ordnungsanalysename |
Marke mit Ordnungslinie bzw. Frequenzhyperbel und Koordinaten am Cursor in Drehzahl-Frequenz-Spektrum oder Ordnungsspektrum. |
Gibt entweder "Ordnung" (Drehzahl-Frequenz-Spektrum) oder "Frequenz" (Ordnungsspektrum) aus. |
%<OrderTrackingValue> |
Ordnungsanalysewert |
" |
Die Ordnung ist das Verhältnis von Drehzahl und Frequenz an der markierten Stelle. |
%<OrderTrackingUnit> |
Ordnungsanalyseeinheit |
" |
Die Einheit des Ordnungsanalysewertes. |
%<AreaName> |
Flächeninhaltsname |
Bereichsmarke mit Fläche unter Kurve als Markencursor |
Gibt "Flächeninhalt" aus. |
%<AreaValue> |
Flächeninhaltswert |
" |
Gibt den Flächeninhalt der Fläche unter dem markierten Kurvenzugbereich aus. |
%<AreaUnit> |
Flächeninhaltseinheit |
" |
Die Einheit des Flächeninhalts. |
%<SlopeName> |
Steigungsname |
Bereichsmarke mit Tangente als Markencursor |
Gibt "Steigung" aus. |
%<SlopeValue> |
Steigungswert |
" |
Gibt die Steigung am markierten Punkt des Kurvenzuges aus. |
%<SlopeUnit> |
Steigungseinheit |
" |
Die Einheit des Steigung. |
%<Length> |
Länge |
Bereichsmarke mit Bemaßungslinie |
Die Länge der Bemaßungslinie in der Einheit des Kurvenzuges. |
%<DataSetName> |
Name von Datensatz |
Datenbeschriftung in 2D- oder 3D-Kurvenzug |
Der Name des zur Datenbeschriftung angegeben zusätzlichen Datensatzes. |
%<DataSetValue> |
Wert aus Datensatz |
" |
Der dem zu beschriftenden Datenpunkt zugeordnete Wert des zur Datenbeschriftung angegeben zusätzlichen Datensatzes. |
%<DataSetUnit> |
Einheit von Datensatz |
" |
Die Einheit des zur Datenbeschriftung angegeben zusätzlichen Datensatzes. |
%<XIndex> |
X-Index |
Datenbeschriftung oder Marke |
Der Zeilenindex des zu beschriftenden/markierenden Datenpunktes. |
%<ZIndex> |
Z-Index |
Datenbeschriftungoder Marke in 3D-Kurvenzug |
Der Spaltenindex des zu beschriftenden/markierenden Datenpunktes im 3D-Datensatz. |
%<PlotOrder> |
Zeichenreihenfolge |
Marke in einem Diagramm |
Die Marken sind über die Zeichenreihenfolge aufsteigend nummeriert. Marken mit höherer Zeichenreihenfolge erscheinen im Vordergrund. Beim Auslesen der Marken ohne Sortierung werden diese gemäß ihrer Zeichenreihenfolge zurückgegeben. |
%<PageNumber> |
Seitennummer |
Form "Beschriftung" in Dokument |
Die Nummer der Seite im Dokument, auf der sich die Form befindet. |
%<NumberOfPages> |
Seitenanzahl |
Form "Beschriftung" in Dokument |
Die Seitenanzahl des Dokuments, in dem sich die Form befindet. |
%<H1> ... %<H9> |
Gliederungsebenenzähler 1 - 9 |
Form "Beschriftung" in Dokument |
Der aktuelle Zählwert für die entsprechende Gliederungsebene des Dokumentes. |
%<N> |
Beschriftungszähler |
Form "Beschriftung" in Dokument |
Der aktuelle Zählwert für die der Beschriftung zugewiesene Gliederungsebene. |
Felder zur Ausgabe von komplexen Zahlen
Wenn der Datensatz, dessen Inhalt Sie darstellen möchten, komplexe Zahlen beinhaltet, können Sie im Feld die folgenden Funktionen verwenden:
Funktion |
Bedeutung |
|---|---|
RealPart(Datensatz) |
Gibt den Realteil der komplexen Zahl im Datensatz aus. |
ImaginaryPart(Datensatz) |
Gibt den Imaginärteil der komplexen Zahl im Datensatz aus. |
Absolute(Datensatz) |
Gibt den Betrag der komplexen Zahl im Datensatz aus. |
Phase(Datensatz) |
Gibt die Phase der komplexen Zahl im Datensatz aus. |
Indizierung von Einzelwerten zur Darstellung
Wenn der Datensatz, dessen Wert dargestellt werden soll, keinen Einzelwert, sondern eine Datenreihe oder eine Datenmatrix beinhaltet, können Sie einen Index verwenden, um einen bestimmten Wert zur Darstellung zu bringen. Wenn Sie keinen Index verwenden, wird der erste Wert entnommen. Wenn Sie die Zahl -1 als Index eintragen, wird immer der letzte Wert entnommen.
Wenn der Datensatz ein Signal, eine Signalreihe oder eine Raumkurve beinhaltet, können Sie durch Anhängen von .X, .Y bzw. .Z an den Namen die gewünschte Komponente auswählen. Wenn Sie keine Komponente angeben, wird die Y-Komponente verwendet.
Beispiele
%{Signal.Y[10]} |
Stellt den 11. Wert der Y-Komponente des Signals dar. |
%{Signal.X[-1]} |
Stellt den letzten Wert der X-Komponente des Signals dar. |
%{Datenmatrix[0][10]} |
Stellt den 11. Wert der 1. Spalte der Datenmatrix dar. |
%{Signalreihe.Z[%<Index>]} |
Stellt den Z-Wert der als Kurvenzug dargestellten Reihe einer Signalreihe dar. |
Felder mit Eingabeaufforderung
Über entsprechende Felder können Sie auch Eingabeaufforderungen in Texte einbetten. Verwenden Sie diese Möglichkeit, um z. B. im Rahmen einer Aktualisierung des Dokumentes Eingaben vom Benutzer abzufragen, die dann im Dokument angezeigt werden sollen.
Es gibt zwei Möglichkeiten, eine Eingabeaufforderung in einen Text einzubetten. Sie können entweder in den FPScript-Ausdruck eines Feldes eine Eingabeaufforderung einbauen, z. B. %{TextInput("Bitte geben Sie Ihren Namen ein")}, oder Sie verwenden einen speziellen Formatierer, der zu einer Eingabe auffordert, z. B. %"Messgerät:\DM2000\MX2000". Die zweite Alternative hat diverse Vorteile, erstens können Sie Vorgabewerte zur Eingabe angeben, im Beispiel "DM2000" und "MX2000". Diese werden dann in einem Auswahlfeld angezeigt. Zweitens fasst FlexPro mehrere Eingabeaufforderungen, die im gleichen Text eingebettet sind, zusammen und drittens merkt sich FlexPro einmal getätigte Eingaben, sodass Sie bei erneuter Aktualisierung nur Änderungen eingeben müssen.