Formeleditor: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
(Imported from text file)
 
(→‎Formelfeld)
 
(24 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
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 Dialogfenster|Übersicht Dialogfenster]]</div>
+
<div align="right">[[Übersicht Dialoge]]</div>
 
<hr>
 
<hr>
−
Der Formeleditor kommt überall dort zur Anwendung, wo Formeln für Eigenschaften vom Typ "Formel" festzulegen sind.
 
  
−
Der Titel des Dialogfensters variiert in Abhängigkeit von der zu bearbeitenden Eigenschaft.
+
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.
  
 +
== Formelfeld ==
 +
{|
 +
|- 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.
  
−
===Formel===
+
=== Intellisense ===
−
In diesem Feld können Sie Formeln eingeben und verändern. Sie können eine Formel direkt eingeben oder eine Formel einfügen, indem Sie diese aus den gespeicherten Formeln und internen Funktionen auswählen. Sie können ein Schlüsselwort eingeben, das die Objekte ME, OTHER, HOLDER oder PROJECT bezeichnet. Wenn einem Schlüsselwort eine Periode folgt, "." wird eine Dropdown-Liste (IntelliSense) angezeigt, die die zur Nutzung in diesem Objekt verfügbaren Eigenschaften anzeigt.
+
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.
 +
|
 +
{| 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 Mauszeiger über einem Objektschlüsselwort, einer Eigenschaft oder einer interne Funktion platzieren, so wird eine Beschreibung als QuickInfo angezeigt.
  
−
[[Image:sikidialog001.jpg]]
+
{| 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]]
 +
|-
 +
|}
  
−
Im Falle von nicht-spezifizierten Objekten, wie Child, Parent etc., werden alle Objekte mit langen Namen angezeigt.
+
=== 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:expressiondialog-tip04.png]]
  
−
[[Image:sikidialog101.jpg]]
+
=== 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.
  
−
In einem Enum-Ausdruck oder einem Ausdruck vom Bool'schen Typ, können Sie auch ein<br />==<br />!=
+
[[Image:Expressiondialog-smp01.png]]
  
−
in das Bedienfeld eingeben. Hierdurch wird eine Dropdown-Liste der möglichen Werte angezeigt.
+
[[Image:Expressiondialog-smp02.png]]
  
 +
; Hinweis
 +
: Erfordert mindestens Asprova Version 13.0.
  
−
[[Image:sikidialog002.jpg]]
+
=== Zeilenumbrüche und Leerzeichen ===
 +
Wird der Formeleditor mit Klick auf [OK] geschlossen, so werden Leerzeichen und Zeilenumbrüche (kodiert als <code>\r</code>) beibehalten. So kann die Formatierung der Formeln beibehalten werden
  
 +
; Hinweise
 +
* In Versionen vor 15.2 werden unnötige Leerzeichen und Zeilenumbrüche beim Verlassen des Formeleditors automatisch gelöscht.
 +
* Formeln mit Zeilenumbrüchen können von Versionen vor 15.2 nicht gelesen werden. Um trotzdem Projekt- oder XML-Dateien mit älteren Versionen austauschen zu können, muss der [[Versionskompatibilität|Kompatibilitätsmodus]] genutzt werden.
  
−
====Hervorhebung bei Fehlern====
+
=== Kommentare ===
−
Während der Formeleingabe, wenn Teile der Formel nicht korrekt erkannt werden können, zum Beispiel wenn
+
Sie können in Formeln Kommentare eingeben, in dem Sie diese mit <code>/*</code> und <code>*/</code> umschließen, da der dazwischen stehen Text bei der Ausführung ignoriert wird. Kommentare haben keinen Einfluss auf die Geschwindigkeit der Formelauswertung. Sie können keine Formeln erstellen, die nur aus Kommentaren bestehen.
  
−
: - der Name einer Eigenschaft oder eine Funktion falsch geschrieben ist. Zum Beispiel: 'Castomer' anstelle von 'Customer'<br />- die Groß- und Kleinschreibung der Eigenschaft nicht korrekt ist. Zum Beispiel 'Starttime' anstelle von 'StartTime'<br />- die Anzahl der verwendeten Klammern nicht korrekt ist. Zum Beispiel in (10 + (10 * 2) fehlt eine Klammer
+
; Hinweise
 +
* In Versionen vor 15.2 können keine Kommentare gespeichert werden.
 +
* Formeln mit Kommentaren können von Versionen vor 15.2 nicht gelesen werden. Um trotzdem Projekt- oder XML-Dateien mit älteren Versionen austauschen zu können, muss der [[Versionskompatibilität|Kompatibilitätsmodus]] genutzt werden.
  
−
wird der Teil der Formel rot hervorgehoben, um zu zeigen, dass er ungültig ist. <br />Bitte prüfen Sie diesen Teil der Formel auf mögliche Fehler.
+
=== 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]]
 +
|-
 +
|}
  
−
[[Image:sikidialog-col01.jpg]]
+
=== 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 ===
 +
{| border="0"
 +
|- valign="top"
 +
|Sie können die Größe des Textfeldes durch Ändern der Fenstergröße des Formeleditors anpassen. Die Fenstergröße des Formeleditors ändern Sie, so wie bei anderen Fenstern auch, durch das Ziehen der Seiten oder Ecken des Dialogs.||[[Image:sikidialog011.png]]
 +
|-
 +
|}
  
−
====Klammerpaare werden in Farbe angezeigt====
+
=== Umbrechen ===
−
Bei der Verwendung von Formeln mit vielen Klammerpaaren werden die Klammern in derselben Farbe wie ihre zugehörigen Antagonisten angezeigt, um die Paarigkeit der Klammern zu verdeutlichen.
+
Drücken sie [Umbrechen], um automatisch Zeilenumbrüche in der Darstellung der Formel einzufügen.
  
 +
Die in die Darstellung eingefügten Zeilenumbrüche können nicht automatisch wieder entfernt werden. Da dieser aber nicht in der Formel gespeichert werden, verschwinden die Zeilenumbrüche beim erneuten Öffnen der Formel wieder.
  
−
[[Image:sikidialog-col02.jpg]]
+
{| class="wikitable"
 +
|+ Stellen an denen automatisch Zeilenumbrüche angezeigt werden
 +
!Stelle!!Standard!!Automatisch umgebrochen
 +
|- valign="top"
 +
|Nach einem expliziten Zeilenumbruch (<code>\n</code>)||[[Image:Wrap002.png]]||[[Image:Wrap001.png]]
 +
|- valign="top"
 +
|Vor den Operatoren <code>&&</code> und <code><nowiki>||</nowiki></code>||[[Image:Wrap003.png]]||[[Image:Wrap004.png]]
 +
|- valign="top"
 +
|Nach Komma (<code>,</code>), mit dem Parameter einen internen Funktion voneinander getrennt werden||[[Image:Wrap005.png]]||[[Image:Wrap006.png]]
 +
|-
 +
|}
  
−
Die Größe des Textfeldes im Formeleditor kann durch Änderung der Größe des gesamten Fensters angepasst werden. <br />Das Dialogfenster kann genau wie andere Fenster durch Ziehen der Ränder auf die gewünschte Größe eingestellt werden.
+
; Hinweis
 +
: Erfordert eine Asprova-Lizenz mindestens für Version 13.0.
  
 +
== Einfügen ==
 +
Fügen Sie den in der Liste für Standardformeln, benutzerdefinierte Formeln oder interne Funktionen ausgewählten Eintrag an der Position des Cursors im Formelfeld ein.
  
−
[[Image:sikidialog011.jpg]]
+
{|
 +
|- valign="top"
 +
|
 +
=== Standardformeln ===
 +
Liste mit Beispielformeln, die Sie direkt oder die als Grundlage für eigene Formeln nutzen können.
 +
|[[Image:Gui025.png]]
 +
|- valign="top"
 +
|
 +
=== Benutzerdefinierte Formeln ===
 +
Liste selbst erstellter Formeln. In Tabellen wird zur besseren Verständlichkeit statt der Formel an sich deren [Code] angezeigt.
 +
|[[Image:Gui027.png]]
 +
|- valign="top"
 +
|
 +
==== Hinzufügen ====
 +
Geben Sie zum Hinzufügen einer eigenen Formeln diese in das Formelfeld ein und klicken dann auf [Formel speichern...]. Es erscheint der Dialog "In Formeltabelle speichern", in dem Sie einen [Code] für die Formel setzen.
 +
|
 +
[[Image:Gui041.png]]
 +
|- valign="top"
 +
|Falls bereits eine Formel mit dem gleichen [Code] existiert, so erscheint eine Warnung und Sie können entscheiden, ob Sie die derzeitige Formel überschreiben, oder den [Code] ändern wollen.
 +
|
 +
[[Image:Gui042.png]]
 +
|- valign="top"
 +
|Falls die Formel bereits als Standardformel oder benutzerdefinierte Formel existiert, so erscheint eine entsprechende Meldung und das Speichern als benutzerdefinierte Formel ist nicht möglich.
 +
|
 +
[[Image:Gui040.png]]
 +
|-
 +
|colspan="2"|
 +
==== Löschen ====
 +
Zum Löschen benutzerdefinierter Formeln klicken Sie in deren Kontextmenü auf [Löschen].
  
−
===Standardformeln===
+
==== Formeltabelle ====
−
Dies ist eine Liste von Formelbeispielen, die zur Anpassung der Eigenschaft verwendet werden können. Sie können die Formel Ihrer Wahl in das Formelfeld einfügen, indem Sie den Button "Einfügen" klicken, während die Formel ausgewählt ist.
+
Benutzerdefinierte Formeln werden in der Formeltabelle gespeichert und können dort bearbeitet oder gelöscht werden.
 +
|- valign="top"
 +
|
 +
=== Interne Funktionen ===
 +
Liste [[Interne Funktionen|interner Funktionen]] und Plug-In-Funktionen, sie sie in Ihrer Formeln verwenden können.
 +
|[[Image:Gui029.png]]
 +
|-
 +
|}
  
 +
== Formel speichern... ==
 +
Siehe [[#Hinzufügen|Benutzerdefinierte Formeln hinzufügen]].
  
−
[[Image:gui025.jpg]]
+
== Leeren ==
 +
Löscht den Inhalt des Formelfeldes.
  
−
===Selbst definierte Formeln===
+
== Alias/Anzeigename ==
−
Dies ist eine Liste von Formelbeispielen, die zur Anpassung der Eigenschaft verwendet werden können. Als Standard verfügbare Formeln sind in der Registerkarte "Standardformeln" aufgelistet und vom benutzerdefinierte Formeln in der Registerkarte "Selbst definierte Formeln". Sie können die Formel Ihrer Wahl in das Formelfeld einfügen, indem Sie den Button "Einfügen" klicken, während die Formel ausgewählt ist. Sie können auch neu erstellte Formeln in der Liste der selbst definierten Formeln speichern, indem Sie auf den Button "In Formeltabelle speichern..." klicken.
+
Wenn Sie dies aktivieren, werden Eigenschaftsnamen und Enum-Werte mit deren [Alias]/[Anzeigename] angezeigt. Wenn Sie einen Punkt (".") eingeben, wird in der Dropdownliste passender Eigenschaften deren [Alias]/[Anzeigename] angezeigt, während deren interne Namen dahinter in Klammern angezeigt werden.
  
−
Sie können gespeicherte Formeln löschen, indem Sie nach einem Rechtsklick auf die Formel "Löschen" aus dem Kontextmenü auswählen.
+
{| class="wikitable"
 +
|- valign="top"
 +
!Standard
 +
|<code>ME.Operation.Order+'\n'+ME.Operation.OperationOutMainItem+'\n'+ME.Operation.OperationOutMainItemQty</code>
 +
|- valign="top"
 +
!Alias/Anzeigename
 +
|<code>ME.Vorgang.Auftrag+'\n'+ME.Vorgang.'Haupt-Output-Artikel'+'\n'+ME.Vorgang.Produktionsmenge</code>
 +
|-
 +
|}
  
 +
Für weitere Informationen siehe [[Formeleingabe mithilfe von Anzeigenamen - Alias|Formeleingabe mit [Alias]/[Anzeigename]]].
  
−
[[Image:gui025-4.jpg]]
+
== Mehr/Weniger ==
−
Interne Funktionen
+
{|
 +
|- valign="top"
 +
|Klicken Sie auf [Mehr], um weitere Details zur Formel anzuzeigen, der Dialog wird dafür nach unten vergrößert. Klicken Sie auf [Weniger], um die Details wieder zu verstecken.
 +
|
 +
{| class="wikitable"
 +
|- valign="top"
 +
!Ohne Details
 +
|
 +
[[Image:Gui043.png]]
 +
|- valign="top"
 +
!Mit Details
 +
|
 +
[[Image:Gui044.png]]
 +
|-
 +
|}
  
−
Dies ist eine Liste von internen Funktionen und Plug-In-Funktionen, die in Asprova gespeichert sind. Sie können Beispieleinstellungen der ausgewählten Funktion im Formelfeld des Dialogfensters einfügen, indem Sie eine Funktion auswählen und den Button "Einfügen" klicken.
+
|-
 +
|}
  
−
 
+
=== HOLDER ===
−
[[Image:gui025-0.jpg]]
 
−
 
 
−
===Einfügen===
 
−
Fügt eine Formel aus der Liste der gespeicherten Formeln und internen Funktionen an der Stelle ein, an der sich der Mauscursor im Formelfeld des Dialogfensters befindet.
 
−
 
 
−
 
 
−
===In Formeltabelle speichern...===
 
−
Speichert die Formel aus dem Formelfeld in der Liste der selbst definierten Formeln.
 
−
 
 
−
Ein Klick auf diesen Button führt zur Anzeige des unten dargestellten Dialogfensters zur Eingabe eines Namens für die Formel. Geben Sie einen Namen ein. Ein Klick auf den Button "OK" fügt die Formel unter dem angegebenen Namen zu den gespeicherten Formeln hinzu.
 
−
 
 
−
 
 
−
[[Image:gui025-1.jpg]]
 
−
Wenn Sie einen Namen eingeben, der schon belegt ist, wird die unten dargestellte Nachricht angezeigt. Ein Klick auf den Button "OK" überschreibt die Formel mit dem neuen Inhalt.
 
−
 
 
−
 
 
−
[[Image:gui025-2.jpg]]
 
−
 
 
−
===Löschen===
 
−
Löscht den Inhalt des Formelfeldes im Dialogfenster.
 
−
 
 
−
 
 
−
===Alias/ Anzeigenamen verwenden===
 
−
Wenn hier ein Haken gesetzt ist, werden Eigenschaftennamen in Formeln unter Verwendung ihrer Anzeigenamen (oder ihres Alias, wenn bestehend) dargestellt.<br />Wenn Sie einen Punkt eingeben ("."), wird die Liste der angezeigten Eigenschaften in Alias/ Anzeigenamen angezeigt, interne Namen werden in Klammern angezeigt. <br />Weitere Informationen zur Eingabe von Formeln siehe [[Formeleingabe mithilfe von Anzeigenamen - Alias|"Formeleingabe mithilfe von Anzeigenamen / Alias"]].
 
−
 
 
−
 
 
−
[[Image:gui025-00.jpg]]
 
−
 
 
−
===Mehr===
 
−
Zeigt weitere Details über eine Formel an, die festgelegt wurde oder gerade festgelegt wird.
 
−
 
 
−
 
 
−
[[Image:gui025-3.jpg]]
 
−
 
 
−
===HOLDER===
 
 
Objekt, zu dem diese Eigenschaft gehört.
 
Objekt, zu dem diese Eigenschaft gehört.
  
 +
=== ME ===
 +
Objekt für das <code>ME</code> im Kontext der Formel steht. Im Kombinationsfeld können Sie setzen, welches Objekt zur Bestimmung des Beispielergebnisses genutzt werden soll. Dafür können Sie ein Objekt aus der Liste des Kombinationsfeld aussuchen, oder selber den [Code] des gewünschten Objekts eingeben. Bei der Eingabe wird das Objekt temporär, bis zum Schließen des Formeleditors, der Liste hinzugefügt. Wenn Sie einen ungültigen [Code] eingeben, wird als Beispielergebnis "[ME] Keine Objekte gefunden." angezeigt. Alternativ können Sie auch direkt die [Objekt-ID] in dem zweiten Eingabefeld eingeben.
  
−
===ME===
+
=== OTHER ===
−
Zeigt das Objekt an, auf das im Kontext der Formel unter ME Bezug genommen wird. <br />Sie können festlegen, welches Objekt als ME verwendet werden soll, um das Ergebnis der Formel zu überprüfen. <br />Wenn das Objekt, das Sie verwenden wollen, nicht als Standard in der Auswahlbox aufgelistet wird, können Sie den Code des gewünschten Objekts in das Auswahlfenster eingeben, um es auszuwählen. Der eingegebene Code wird zu den Inhalten der Liste im Auswahlfenster hinzugefügt. <br />Wenn der eingegebene Code nicht als gültiges Objekt zur Verwendung als ME erkannt werden kann, wird eine Nachricht angezeigt, die dies erklärt.
+
Objekt für das <code>OTHER</code> im Kontext der Formel steht. Im Kombinationsfeld können Sie setzen, welches Objekt zur Bestimmung des Beispielergebnisses genutzt werden soll. Dafür können Sie ein Objekt aus der Liste des Kombinationsfeld aussuchen, oder selber den [Code] des gewünschten Objekts eingeben. Bei der Eingabe wird das Objekt temporär, bis zum Schließen des Formeleditors, der Liste hinzugefügt. Wenn Sie einen ungültigen [Code] eingeben, wird als Beispielergebnis "[OTHER] Keine Objekte gefunden." angezeigt. Alternativ können Sie auch direkt die [Objekt-ID] in dem zweiten Eingabefeld eingeben.
−
 
 
−
 
 
−
===OTHER===
 
−
Zeigt das Objekt an, auf das im Kontext der Formel unter OTHER Bezug genommen wird. <br />Sie können festlegen, welches Objekt als OTHER verwendet werden soll, um das Ergebnis der Formel zu überprüfen. <br />Wenn das Objekt, das Sie verwenden wollen, nicht als Standard in der Auswahlbox aufgelistet wird, können Sie den Code des gewünschten Objekts in das Auswahlfenster eingeben, um es auszuwählen. Der eingegebene Code wird zu den Inhalten der Liste im Auswahlfenster hinzugefügt. <br />Wenn der eingegebene Code nicht als gültiges Objekt zur Verwendung als OTHER erkannt werden kann, wird eine Nachricht angezeigt, die dies erklärt.
 
−
 
 
−
 
 
−
===Ergebnisdatentyp der Formel===
 
−
Zeigt den Datentyp des Formelergebnisses an.
 
−
 
 
−
Formelergebnis für das gewählte Beispiel
 
−
 
 
−
Zeigt das Ergebnis der Formel unter Verwendung des in der Dropdown-Liste ausgewählten Objektes an.
 
  
 +
=== Datentyp des Ergebnisses ===
 +
Datentyp des Rückgabewerts der Formel.
  
−
===Weniger===
+
=== Beispielergebnis ===
−
Schließt die Details.
+
Rückgabewert der Formel unter Verwendung der für ME und OTHER gesetzten Objekte.
  
 +
=== Automatisch aktualisieren ===
 +
Wenn Sie dies aktivieren, wird das Beispielergebnis sofort aktualisiert, wenn die Formel verändert oder für <code>ME</code>/<code>OTHER</code> ein anderes Objekt gesetzt wird. Wenn Sie dies nicht aktivieren, so müssen Sie auf [Aktualisieren] klicken, um das Beispielergebnis zu aktualisieren.
  
−
===OK===
+
Standardmäßig ist "Automatisch aktualisieren" aktiviert, die Deaktivierung empfiehlt sich, wenn die Aktualisierung des Beispielergebnisses, etwa auf Grund vieler Daten oder einer komplexen Formel, lange dauert.  
−
Bestätigt die Einstellungen.
 
  
 +
----
  
−
===Abbrechen===
+
; Hinweise
−
Verwirft die Einstellungen.
+
* Erfordert mindestens Version 12.1.
 +
* Eingabe der [Objekt-ID] erfordert mindestens eine Lizenz für Version 17.4.
  
−
Wie man Formeln definiert lesen Sie [[Formeln|hier]].
+
== OK ==
 +
Übernehmen Sie alle Änderungen und schließen den Dialog.
  
 +
== Abbrechen ==
 +
Verwerfen Sie alle Änderungen und schließen den Dialog.
  
 +
== Weitere Information ==
 +
* [[Formeln]]
 +
* [[Interne Funktionen]]
  
 
<hr>
 
<hr>
 
<div align="right">Hilfe Nummer: 737000</div>
 
<div align="right">Hilfe Nummer: 737000</div>

Aktuelle Version vom 24. Januar 2024, 11:10 Uhr

Hilfe Nummer: 737000
Übersicht Dialoge

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.

Formelfeld

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 ME, OTHER, HOLDER und PROJECT 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.

Sikidialog001.PNG
Bei Objekten ohne eindeutigem Typ, wie [Untergeordnete Objekte], [Übergeordnetes Objekt] etc., werden alle Eigenschaften mit langem Namen angezeigt. Sikidialog101.PNG
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.
Ungefiltert Gefiltert
IntelliSenseFilterBefore.png IntelliSenseFilterAfter.png
Wenn Sie hinter Eigenschaften mit [Datentyp] "Enum" oder "Bool" die Operatoren == oder != eingeben, so wird eine Dropdownliste mit den , für das jeweilige Objekt zur Verfügung stehenden, Werten angezeigt. Sikidialog002.PNG

Hinweisanzeige im QuickInfo

Wenn Sie den Mauszeiger ü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 ExpressionQuickInfo01.png
Eigenschaft ME.Vorgang.Auftrag ExpressionQuickInfo02.png
Interne Funktion FValid() 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.

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.

Expressiondialog-smp01.png

Expressiondialog-smp02.png

Hinweis
Erfordert mindestens Asprova Version 13.0.

Zeilenumbrüche und Leerzeichen

Wird der Formeleditor mit Klick auf [OK] geschlossen, so werden Leerzeichen und Zeilenumbrüche (kodiert als \r) beibehalten. So kann die Formatierung der Formeln beibehalten werden

Hinweise
  • In Versionen vor 15.2 werden unnötige Leerzeichen und Zeilenumbrüche beim Verlassen des Formeleditors automatisch gelöscht.
  • Formeln mit Zeilenumbrüchen können von Versionen vor 15.2 nicht gelesen werden. Um trotzdem Projekt- oder XML-Dateien mit älteren Versionen austauschen zu können, muss der Kompatibilitätsmodus genutzt werden.

Kommentare

Sie können in Formeln Kommentare eingeben, in dem Sie diese mit /* und */ umschließen, da der dazwischen stehen Text bei der Ausführung ignoriert wird. Kommentare haben keinen Einfluss auf die Geschwindigkeit der Formelauswertung. Sie können keine Formeln erstellen, die nur aus Kommentaren bestehen.

Hinweise
  • In Versionen vor 15.2 können keine Kommentare gespeichert werden.
  • Formeln mit Kommentaren können von Versionen vor 15.2 nicht gelesen werden. Um trotzdem Projekt- oder XML-Dateien mit älteren Versionen austauschen zu können, muss der Kompatibilitätsmodus genutzt werden.

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.

Beispiele fehlerhafte Formelteile
Fehler Beispiel Screenshot
Falscher Eigenschafts- oder Funktionsname "Mänge" statt "Menge" Sikidialog-col01.png
Groß- und Kleinschreibung "Starttime" statt "StartTime" Sikidialog-col02.png
Klammern nicht geschlossen (10 + (10 * 2) 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.

Sikidialog-col04.png

Größe anpassen

Sie können die Größe des Textfeldes durch Ändern der Fenstergröße des Formeleditors anpassen. Die Fenstergröße des Formeleditors ändern Sie, so wie bei anderen Fenstern auch, durch das Ziehen der Seiten oder Ecken des Dialogs. Sikidialog011.png

Umbrechen

Drücken sie [Umbrechen], um automatisch Zeilenumbrüche in der Darstellung der Formel einzufügen.

Die in die Darstellung eingefügten Zeilenumbrüche können nicht automatisch wieder entfernt werden. Da dieser aber nicht in der Formel gespeichert werden, verschwinden die Zeilenumbrüche beim erneuten Öffnen der Formel wieder.

Stellen an denen automatisch Zeilenumbrüche angezeigt werden
Stelle Standard Automatisch umgebrochen
Nach einem expliziten Zeilenumbruch (\n) Wrap002.png Wrap001.png
Vor den Operatoren && und || Wrap003.png Wrap004.png
Nach Komma (,), mit dem Parameter einen internen Funktion voneinander getrennt werden Wrap005.png Wrap006.png
Hinweis
Erfordert eine Asprova-Lizenz mindestens für Version 13.0.

Einfügen

Fügen Sie den in der Liste für Standardformeln, benutzerdefinierte Formeln oder interne Funktionen ausgewählten Eintrag an der Position des Cursors im Formelfeld ein.

Standardformeln

Liste mit Beispielformeln, die Sie direkt oder die als Grundlage für eigene Formeln nutzen können.

Gui025.png

Benutzerdefinierte Formeln

Liste selbst erstellter Formeln. In Tabellen wird zur besseren Verständlichkeit statt der Formel an sich deren [Code] angezeigt.

Gui027.png

Hinzufügen

Geben Sie zum Hinzufügen einer eigenen Formeln diese in das Formelfeld ein und klicken dann auf [Formel speichern...]. Es erscheint der Dialog "In Formeltabelle speichern", in dem Sie einen [Code] für die Formel setzen.

Gui041.png

Falls bereits eine Formel mit dem gleichen [Code] existiert, so erscheint eine Warnung und Sie können entscheiden, ob Sie die derzeitige Formel überschreiben, oder den [Code] ändern wollen.

Gui042.png

Falls die Formel bereits als Standardformel oder benutzerdefinierte Formel existiert, so erscheint eine entsprechende Meldung und das Speichern als benutzerdefinierte Formel ist nicht möglich.

Gui040.png

Löschen

Zum Löschen benutzerdefinierter Formeln klicken Sie in deren Kontextmenü auf [Löschen].

Formeltabelle

Benutzerdefinierte Formeln werden in der Formeltabelle gespeichert und können dort bearbeitet oder gelöscht werden.

Interne Funktionen

Liste interner Funktionen und Plug-In-Funktionen, sie sie in Ihrer Formeln verwenden können.

Gui029.png

Formel speichern...

Siehe Benutzerdefinierte Formeln hinzufügen.

Leeren

Löscht den Inhalt des Formelfeldes.

Alias/Anzeigename

Wenn Sie dies aktivieren, werden Eigenschaftsnamen und Enum-Werte mit deren [Alias]/[Anzeigename] angezeigt. Wenn Sie einen Punkt (".") eingeben, wird in der Dropdownliste passender Eigenschaften deren [Alias]/[Anzeigename] angezeigt, während deren interne Namen dahinter in Klammern angezeigt werden.

Standard ME.Operation.Order+'\n'+ME.Operation.OperationOutMainItem+'\n'+ME.Operation.OperationOutMainItemQty
Alias/Anzeigename ME.Vorgang.Auftrag+'\n'+ME.Vorgang.'Haupt-Output-Artikel'+'\n'+ME.Vorgang.Produktionsmenge

Für weitere Informationen siehe Formeleingabe mit [Alias]/[Anzeigename].

Mehr/Weniger

Klicken Sie auf [Mehr], um weitere Details zur Formel anzuzeigen, der Dialog wird dafür nach unten vergrößert. Klicken Sie auf [Weniger], um die Details wieder zu verstecken.
Ohne Details

Gui043.png

Mit Details

Gui044.png

HOLDER

Objekt, zu dem diese Eigenschaft gehört.

ME

Objekt für das ME im Kontext der Formel steht. Im Kombinationsfeld können Sie setzen, welches Objekt zur Bestimmung des Beispielergebnisses genutzt werden soll. Dafür können Sie ein Objekt aus der Liste des Kombinationsfeld aussuchen, oder selber den [Code] des gewünschten Objekts eingeben. Bei der Eingabe wird das Objekt temporär, bis zum Schließen des Formeleditors, der Liste hinzugefügt. Wenn Sie einen ungültigen [Code] eingeben, wird als Beispielergebnis "[ME] Keine Objekte gefunden." angezeigt. Alternativ können Sie auch direkt die [Objekt-ID] in dem zweiten Eingabefeld eingeben.

OTHER

Objekt für das OTHER im Kontext der Formel steht. Im Kombinationsfeld können Sie setzen, welches Objekt zur Bestimmung des Beispielergebnisses genutzt werden soll. Dafür können Sie ein Objekt aus der Liste des Kombinationsfeld aussuchen, oder selber den [Code] des gewünschten Objekts eingeben. Bei der Eingabe wird das Objekt temporär, bis zum Schließen des Formeleditors, der Liste hinzugefügt. Wenn Sie einen ungültigen [Code] eingeben, wird als Beispielergebnis "[OTHER] Keine Objekte gefunden." angezeigt. Alternativ können Sie auch direkt die [Objekt-ID] in dem zweiten Eingabefeld eingeben.

Datentyp des Ergebnisses

Datentyp des Rückgabewerts der Formel.

Beispielergebnis

Rückgabewert der Formel unter Verwendung der für ME und OTHER gesetzten Objekte.

Automatisch aktualisieren

Wenn Sie dies aktivieren, wird das Beispielergebnis sofort aktualisiert, wenn die Formel verändert oder für ME/OTHER ein anderes Objekt gesetzt wird. Wenn Sie dies nicht aktivieren, so müssen Sie auf [Aktualisieren] klicken, um das Beispielergebnis zu aktualisieren.

Standardmäßig ist "Automatisch aktualisieren" aktiviert, die Deaktivierung empfiehlt sich, wenn die Aktualisierung des Beispielergebnisses, etwa auf Grund vieler Daten oder einer komplexen Formel, lange dauert.

Hinweise
  • Erfordert mindestens Version 12.1.
  • Eingabe der [Objekt-ID] erfordert mindestens eine Lizenz für Version 17.4.

OK

Übernehmen Sie alle Änderungen und schließen den Dialog.

Abbrechen

Verwerfen Sie alle Änderungen und schließen den Dialog.

Weitere Information

Hilfe Nummer: 737000
Abgerufen von „http://hilfe.asprova.eu/index.php?title=Formeleditor&oldid=7642“