Formeleditor: Unterschied zwischen den Versionen
JF (Diskussion | Beiträge) (→Abbrechen) |
GK (Diskussion | Beiträge) (Überarbeitung und Ergänzung um neue Abschnitte) |
||
Zeile 1: | Zeile 1: | ||
{{DISPLAYTITLE:Formeleditor}} | {{DISPLAYTITLE:Formeleditor}} | ||
<div align="right">Hilfe Nummer: 737000</div> | <div align="right">Hilfe Nummer: 737000</div> | ||
− | + | <div align="right">[[Übersicht Dialoge]]</div> | |
<hr> | <hr> | ||
− | |||
+ | Im Formeleditor erstellen und bearbeiten Sie Formeln für Eigenschaften mit [Datentyp] "Formel". Der Fenstertitel ist immer der Name der Eigenschaft, deren Formel bearbeitet wird. | ||
− | + | == Formel == | |
− | + | {| | |
+ | |- valign="top" | ||
+ | |Hier erstellen und bearbeiten Sie Formeln, geben sei dafür Formeln direkt in das Textfeld ein. Neben der direkten Eingabe ist auch das Einfügen aus den Standardformeln, benutzerdefinierten Formeln oder internen Funktionen möglich. Sie können Schlüsselwörter wie <code>ME</code>, <code>OTHER</code>, <code>HOLDER</code> und <code>PROJECT</code> nutzen, um Objekte zu referenzieren. | ||
+ | === Intellisense === | ||
+ | Folgt auf ein Schlüsselwort ein Punkt ("."), so wird eine Dropdownliste (Intellisense) mit den, für das jeweilige Objekt zur Verfügung stehenden, Eigenschaften angezeigt. | ||
+ | |[[Image:sikidialog001.PNG]] | ||
+ | |- valign="top" | ||
+ | |Bei Objekten ohne eindeutigem Typ, wie [Untergeordnete Objekte], [Übergeordnetes Objekt] etc., werden alle Eigenschaften mit langem Namen angezeigt. | ||
+ | |[[Image:sikidialog101.PNG]] | ||
+ | |- valign="top" | ||
+ | |Die Dropdownliste wird bei der Eingabe von Text auf Einträge gefiltert, deren [Code], [Anzeigename], [Alias], Eigenschaften oder Aufzählungsobjekte den eingegebenen Text enthalten. | ||
+ | ; Hinweis | ||
+ | : Das Filtern erfordert eine Asprova-Lizenz mindestens für Version 13.0. | ||
+ | Die Dropdownliste verschwindet, wenn Sonderzeichen (außer Unterstrich ("_")) eingegeben werden. | ||
+ | | | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | !Ungefiltert!!Gefiltert | ||
+ | |- valign="top" | ||
+ | |[[Image:IntelliSenseFilterBefore.png]] | ||
+ | |[[Image:IntelliSenseFilterAfter.png]] | ||
+ | |- | ||
+ | |} | ||
+ | |- valign="top" | ||
+ | |Wenn Sie hinter Eigenschaften mit [Datentyp] "Enum" oder "Bool" die Operatoren <code>==</code> oder <code>!=</code> eingeben, so wird eine Dropdownliste mit den , für das jeweilige Objekt zur Verfügung stehenden, Werten angezeigt. | ||
+ | |[[Image:sikidialog002.PNG]] | ||
+ | |- | ||
+ | |} | ||
− | + | === Hinweisanzeige im QuickInfo === | |
+ | Wenn Sie den Cursor über einem Objektschlüsselwort, einer Eigenschaft oder einer interne Funktion platzieren, so wird eine Beschreibung als QuickInfo angezeigt. | ||
− | + | {| class="wikitable" | |
+ | |- | ||
+ | !Objekttyp!!Objekt im Beispiel!!Beispiel | ||
+ | |- valign="top" | ||
+ | |Objektschlüsselwort||<code>ME</code>||[[Image:ExpressionQuickInfo01.png]] | ||
+ | |- valign="top" | ||
+ | |Eigenschaft||<code>ME.Vorgang.Auftrag</code>||[[Image:ExpressionQuickInfo02.png]] | ||
+ | |- valign="top" | ||
+ | |Interne Funktion||<code>FValid()</code>||[[Image:ExpressionQuickInfo03.png]] | ||
+ | |- | ||
+ | |} | ||
+ | === QuickInfo während der Eingabe interner Funktionen === | ||
+ | Bei der Eingabe interner Funktionen werden der Datentypen von deren Rückgabewert und Parametern im QuickInfo angezeigt. | ||
− | [[Image: | + | [[Image:expressiondialog-tip04.png]] |
− | + | === Beispielanzeige der Auswahl === | |
+ | Wird ein Teil der Formel ausgewählt, so wird nur dieser Teil bewertet, so dass der Datentyp des Ergebnisses und das Beispielergebnis nur für die Auswahl angezeigt werden. | ||
− | + | [[Image:Expressiondialog-smp01.png]] | |
+ | [[Image:Expressiondialog-smp02.png]] | ||
− | + | ; Hinweis | |
+ | : Erfordert mindestens Asprova Version 13.0. | ||
− | === | + | === Fehlerhervorhebung === |
− | + | Können während der Eingabe der Formel Teile nicht erkannt werden, so werden diese in rot dargestellt, um den Fehler hervorzuheben. Der so hervorgehobene Teil der Formel ist ungültig und muss korrigiert werden, damit Asprova die Formel akzeptieren kann. | |
− | + | {| class="wikitable" | |
+ | |- | ||
+ | |+ Beispiele fehlerhafte Formelteile | ||
+ | |- | ||
+ | !Fehler!!Beispiel!!Screenshot | ||
+ | |- valign="top" | ||
+ | |Falscher Eigenschafts- oder Funktionsname||"Mänge" statt "Menge"||[[Image:sikidialog-col01.png]] | ||
+ | |- valign="top" | ||
+ | |Groß- und Kleinschreibung||"Starttime" statt "StartTime"||[[Image:sikidialog-col02.png]] | ||
+ | |- valign="top" | ||
+ | |Klammern nicht geschlossen||(10 + (10 * 2)||[[Image:sikidialog-col03.png]] | ||
+ | |- | ||
+ | |} | ||
− | + | === Farbige Klammerpaare === | |
+ | Bei Verwendung von Formeln mit mehreren Klammerpaaren, wird jedes Paar in einer eigenen Farben angezeigt, um klar zu zeigen, welche Klammern zusammengehören. | ||
+ | [[Image:sikidialog-col04.png]] | ||
− | + | === Größe anpassen === | |
+ | Sie können die Größe des Textfeldes durch Ändern der Fenstergröße des Formeleditors anpassen. | ||
− | + | [[Image:sikidialog011.jpg]] | |
− | |||
− | |||
− | |||
− | [[Image: | ||
− | |||
− | |||
− | + | === Umbrechen === | |
− | |||
===Standardformeln=== | ===Standardformeln=== | ||
Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Eine Formel kann in das Feld eingefügt werden, indem sie ausgewählt- und dann der Button "Einfügen" gedrückt wird. | Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Eine Formel kann in das Feld eingefügt werden, indem sie ausgewählt- und dann der Button "Einfügen" gedrückt wird. | ||
− | |||
[[Image:gui025.jpg]] | [[Image:gui025.jpg]] | ||
− | === | + | === Benutzerdefinierte Formeln === |
Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Standardmäßig verfügbare Formeln sind unter der Registerkarte "Standardformeln" aufgelistet. Selbst kreierte Formeln werden unter der Registerkarte "Selbst definierte Formeln" eingetragen. Fügen Sie eine beliebige Formel in das Formelfeld ein. Sie muss dafür ausgewählt- und dann der Button "Einfügen" gedrückt werden. | Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Standardmäßig verfügbare Formeln sind unter der Registerkarte "Standardformeln" aufgelistet. Selbst kreierte Formeln werden unter der Registerkarte "Selbst definierte Formeln" eingetragen. Fügen Sie eine beliebige Formel in das Formelfeld ein. Sie muss dafür ausgewählt- und dann der Button "Einfügen" gedrückt werden. | ||
Neu erstellte Formeln sind der Liste von selbst definierten Formeln hinzufügbar. Klicken Sie dazu auf "In Formeltabelle speichern...". | Neu erstellte Formeln sind der Liste von selbst definierten Formeln hinzufügbar. Klicken Sie dazu auf "In Formeltabelle speichern...". | ||
Zeile 57: | Zeile 107: | ||
Eigene Formeln sind anhand des Button "Löschen" aus dem Kontextmenü löschbar. | Eigene Formeln sind anhand des Button "Löschen" aus dem Kontextmenü löschbar. | ||
+ | [[Image:gui025-4.jpg]] | ||
− | + | === Interne Funktionen === | |
− | Interne Funktionen | ||
Dies ist eine Liste interner Funktionen und Plug-In-Funktionen. Wenn eine Funktion eingefügt wird, enthält diese Beispieleinstellungen. Dies kann, zum Beispiel, ein einfaches Datumsbeispiel sein (das geändert werden muss). | Dies ist eine Liste interner Funktionen und Plug-In-Funktionen. Wenn eine Funktion eingefügt wird, enthält diese Beispieleinstellungen. Dies kann, zum Beispiel, ein einfaches Datumsbeispiel sein (das geändert werden muss). | ||
− | |||
[[Image:gui025-0.jpg]] | [[Image:gui025-0.jpg]] | ||
− | + | == Einfügen == | |
Fügt eine Formel aus der Liste für gespeicherte Formeln und interne Funktionen an der Position des Mauszeigers ein. | Fügt eine Formel aus der Liste für gespeicherte Formeln und interne Funktionen an der Position des Mauszeigers ein. | ||
− | == | + | == Formel speichern... == |
Speichert Formeln aus dem Formelfeld in der Liste für selbst definierte Formeln ab. | Speichert Formeln aus dem Formelfeld in der Liste für selbst definierte Formeln ab. | ||
Dieser Button führt zur Anzeige des im folgenden Screenshot dargestellten Dialogfensters, das zur Eingabe eines Namens für die Formel da ist. | Dieser Button führt zur Anzeige des im folgenden Screenshot dargestellten Dialogfensters, das zur Eingabe eines Namens für die Formel da ist. | ||
− | |||
[[Image:gui025-1.jpg]] | [[Image:gui025-1.jpg]] | ||
Im Falle bereits benutzter Namen wird folgende Nachricht angezeigt. Ein Klick auf "OK" überschreibt die Formel mit dem neuen Inhalt. | Im Falle bereits benutzter Namen wird folgende Nachricht angezeigt. Ein Klick auf "OK" überschreibt die Formel mit dem neuen Inhalt. | ||
− | |||
[[Image:gui025-2.jpg]] | [[Image:gui025-2.jpg]] | ||
− | == | + | == Leeren == |
Löscht den Inhalt des Formelfeldes. | Löscht den Inhalt des Formelfeldes. | ||
− | + | == Alias/ Anzeigenamen == | |
− | |||
Wenn hier ein Häkchen gesetzt ist, werden Eigenschaftennamen in Formeln unter Verwendung ihrer Anzeigenamen (oder ihres Aliases, wenn bestehend) dargestellt. Wenn Sie einen Punkt "." eingeben, wird die Liste der angezeigten Eigenschaften in Alias/Anzeigenamen angezeigt, während interne Namen in Klammern angezeigt werden.<br />Für weitere Informationen hinsichtlich der Formeleingabe, siehe [[Formeleingabe mithilfe von Anzeigenamen - Alias|"Formeleingabe mithilfe von Anzeigenamen / Alias"]]. | Wenn hier ein Häkchen gesetzt ist, werden Eigenschaftennamen in Formeln unter Verwendung ihrer Anzeigenamen (oder ihres Aliases, wenn bestehend) dargestellt. Wenn Sie einen Punkt "." eingeben, wird die Liste der angezeigten Eigenschaften in Alias/Anzeigenamen angezeigt, während interne Namen in Klammern angezeigt werden.<br />Für weitere Informationen hinsichtlich der Formeleingabe, siehe [[Formeleingabe mithilfe von Anzeigenamen - Alias|"Formeleingabe mithilfe von Anzeigenamen / Alias"]]. | ||
− | |||
[[Image:gui025-00.jpg]] | [[Image:gui025-00.jpg]] | ||
− | + | == Mehr == | |
Zeigt weitere Details einer Formel an, die festgelegt wurden oder gerade festgelegt werden. | Zeigt weitere Details einer Formel an, die festgelegt wurden oder gerade festgelegt werden. | ||
− | |||
[[Image:gui025-3.jpg]] | [[Image:gui025-3.jpg]] | ||
− | ===HOLDER=== | + | === HOLDER === |
Objekt, zu dem diese Eigenschaft gehört. | Objekt, zu dem diese Eigenschaft gehört. | ||
− | + | === ME === | |
− | ===ME=== | ||
Zeigt ein Objekt an, auf das im Kontext der Formel unter ME Bezug genommen wird. Bestimmen Sie, welches Objekt als ME verwendet werden soll, um Formelergebnisse zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet ist, muss der Code davon in das Auswahlfenster eingegeben werden, um es auszuwühlen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt zur Verwendung als ME erkannt werden kann, wird eine entsprechende Nachricht angezeigt. | Zeigt ein Objekt an, auf das im Kontext der Formel unter ME Bezug genommen wird. Bestimmen Sie, welches Objekt als ME verwendet werden soll, um Formelergebnisse zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet ist, muss der Code davon in das Auswahlfenster eingegeben werden, um es auszuwühlen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt zur Verwendung als ME erkannt werden kann, wird eine entsprechende Nachricht angezeigt. | ||
− | + | === OTHER === | |
− | ===OTHER=== | ||
Zeigt das Objekt an, auf das im Kontext der Formel unter OTHER Bezug genommen wird. Sie können festlegen, welches Objekt als OTHER verwendet werden soll, um das Ergebnis der Formel zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet wird, muss der Code des gewünschten Objektes in das Auswahlfenster eingeben werden, um es auszuwählen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt (zur Verwendung als OTHER) erkannt werden kann, wird eine entsprechende Nachricht angezeigt. | Zeigt das Objekt an, auf das im Kontext der Formel unter OTHER Bezug genommen wird. Sie können festlegen, welches Objekt als OTHER verwendet werden soll, um das Ergebnis der Formel zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet wird, muss der Code des gewünschten Objektes in das Auswahlfenster eingeben werden, um es auszuwählen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt (zur Verwendung als OTHER) erkannt werden kann, wird eine entsprechende Nachricht angezeigt. | ||
− | + | === Datentyp des Ergebnisses === | |
− | === | ||
Zeigt den Datentyp des Formelergebnisses an. | Zeigt den Datentyp des Formelergebnisses an. | ||
− | + | === Beispielergebnis === | |
− | === | ||
Zeigt das Formelergebnis unter Verwendung des in der Dropdown-Liste ausgewählten Objektes an. | Zeigt das Formelergebnis unter Verwendung des in der Dropdown-Liste ausgewählten Objektes an. | ||
+ | === Automatisch aktualisieren === | ||
+ | ; Hinweis | ||
+ | : Erfordert mindestens Asprova Version 12.1. | ||
===Weniger=== | ===Weniger=== | ||
Schließt die Details. | Schließt die Details. | ||
− | + | == OK == | |
− | |||
Bestätigt Einstellungen. | Bestätigt Einstellungen. | ||
− | + | == Abbrechen == | |
− | |||
Verwirft alle Einstellungen. | Verwirft alle Einstellungen. | ||
− | + | == Weitere Information == | |
− | + | * [[Formeln]] | |
− | |||
<hr> | <hr> | ||
<div align="right">Hilfe Nummer: 737000</div> | <div align="right">Hilfe Nummer: 737000</div> |
Version vom 2. Januar 2019, 18:47 Uhr
Im Formeleditor erstellen und bearbeiten Sie Formeln für Eigenschaften mit [Datentyp] "Formel". Der Fenstertitel ist immer der Name der Eigenschaft, deren Formel bearbeitet wird.
Inhaltsverzeichnis
Formel
Hinweisanzeige im QuickInfo
Wenn Sie den Cursor über einem Objektschlüsselwort, einer Eigenschaft oder einer interne Funktion platzieren, so wird eine Beschreibung als QuickInfo angezeigt.
Objekttyp | Objekt im Beispiel | Beispiel |
---|---|---|
Objektschlüsselwort | ME |
|
Eigenschaft | ME.Vorgang.Auftrag |
|
Interne Funktion | FValid() |
QuickInfo während der Eingabe interner Funktionen
Bei der Eingabe interner Funktionen werden der Datentypen von deren Rückgabewert und Parametern im QuickInfo angezeigt.
Beispielanzeige der Auswahl
Wird ein Teil der Formel ausgewählt, so wird nur dieser Teil bewertet, so dass der Datentyp des Ergebnisses und das Beispielergebnis nur für die Auswahl angezeigt werden.
- Hinweis
- Erfordert mindestens Asprova Version 13.0.
Fehlerhervorhebung
Können während der Eingabe der Formel Teile nicht erkannt werden, so werden diese in rot dargestellt, um den Fehler hervorzuheben. Der so hervorgehobene Teil der Formel ist ungültig und muss korrigiert werden, damit Asprova die Formel akzeptieren kann.
Fehler | Beispiel | Screenshot |
---|---|---|
Falscher Eigenschafts- oder Funktionsname | "Mänge" statt "Menge" | |
Groß- und Kleinschreibung | "Starttime" statt "StartTime" | |
Klammern nicht geschlossen | (10 + (10 * 2) |
Farbige Klammerpaare
Bei Verwendung von Formeln mit mehreren Klammerpaaren, wird jedes Paar in einer eigenen Farben angezeigt, um klar zu zeigen, welche Klammern zusammengehören.
Größe anpassen
Sie können die Größe des Textfeldes durch Ändern der Fenstergröße des Formeleditors anpassen.
Umbrechen
Standardformeln
Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Eine Formel kann in das Feld eingefügt werden, indem sie ausgewählt- und dann der Button "Einfügen" gedrückt wird.
Benutzerdefinierte Formeln
Diese Liste enthält Formelbeispiele, die zur Anpassung einer Eigenschaft verwendet werden können. Standardmäßig verfügbare Formeln sind unter der Registerkarte "Standardformeln" aufgelistet. Selbst kreierte Formeln werden unter der Registerkarte "Selbst definierte Formeln" eingetragen. Fügen Sie eine beliebige Formel in das Formelfeld ein. Sie muss dafür ausgewählt- und dann der Button "Einfügen" gedrückt werden. Neu erstellte Formeln sind der Liste von selbst definierten Formeln hinzufügbar. Klicken Sie dazu auf "In Formeltabelle speichern...".
Eigene Formeln sind anhand des Button "Löschen" aus dem Kontextmenü löschbar.
Interne Funktionen
Dies ist eine Liste interner Funktionen und Plug-In-Funktionen. Wenn eine Funktion eingefügt wird, enthält diese Beispieleinstellungen. Dies kann, zum Beispiel, ein einfaches Datumsbeispiel sein (das geändert werden muss).
Einfügen
Fügt eine Formel aus der Liste für gespeicherte Formeln und interne Funktionen an der Position des Mauszeigers ein.
Formel speichern...
Speichert Formeln aus dem Formelfeld in der Liste für selbst definierte Formeln ab.
Dieser Button führt zur Anzeige des im folgenden Screenshot dargestellten Dialogfensters, das zur Eingabe eines Namens für die Formel da ist.
Im Falle bereits benutzter Namen wird folgende Nachricht angezeigt. Ein Klick auf "OK" überschreibt die Formel mit dem neuen Inhalt.
Leeren
Löscht den Inhalt des Formelfeldes.
Alias/ Anzeigenamen
Wenn hier ein Häkchen gesetzt ist, werden Eigenschaftennamen in Formeln unter Verwendung ihrer Anzeigenamen (oder ihres Aliases, wenn bestehend) dargestellt. Wenn Sie einen Punkt "." eingeben, wird die Liste der angezeigten Eigenschaften in Alias/Anzeigenamen angezeigt, während interne Namen in Klammern angezeigt werden.
Für weitere Informationen hinsichtlich der Formeleingabe, siehe "Formeleingabe mithilfe von Anzeigenamen / Alias".
Mehr
Zeigt weitere Details einer Formel an, die festgelegt wurden oder gerade festgelegt werden.
HOLDER
Objekt, zu dem diese Eigenschaft gehört.
ME
Zeigt ein Objekt an, auf das im Kontext der Formel unter ME Bezug genommen wird. Bestimmen Sie, welches Objekt als ME verwendet werden soll, um Formelergebnisse zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet ist, muss der Code davon in das Auswahlfenster eingegeben werden, um es auszuwühlen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt zur Verwendung als ME erkannt werden kann, wird eine entsprechende Nachricht angezeigt.
OTHER
Zeigt das Objekt an, auf das im Kontext der Formel unter OTHER Bezug genommen wird. Sie können festlegen, welches Objekt als OTHER verwendet werden soll, um das Ergebnis der Formel zu überprüfen. Wenn Ihr Objekt nicht standardmäßig in der Auswahlbox aufgelistet wird, muss der Code des gewünschten Objektes in das Auswahlfenster eingeben werden, um es auszuwählen. Der eingegebene Code wird den Inhalten der Liste im Auswahlfenster hinzugefügt. Wenn der eingegebene Code nicht als gültiges Objekt (zur Verwendung als OTHER) erkannt werden kann, wird eine entsprechende Nachricht angezeigt.
Datentyp des Ergebnisses
Zeigt den Datentyp des Formelergebnisses an.
Beispielergebnis
Zeigt das Formelergebnis unter Verwendung des in der Dropdown-Liste ausgewählten Objektes an.
Automatisch aktualisieren
- Hinweis
- Erfordert mindestens Asprova Version 12.1.
Weniger
Schließt die Details.
OK
Bestätigt Einstellungen.
Abbrechen
Verwirft alle Einstellungen.