Formeleditor: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
(→‎Abbrechen)
(→‎Formelfeld)
 
(12 dazwischenliegende Versionen desselben Benutzers 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>
−
Im Formeleditor werden Formeln für Eigenschaften des Typs "Formel" zu erstellt und bearbeitet. Der Titel des Dialogfensters ist, entsprechend von der zu bearbeitenden Eigenschaft, unterschiedlich.
 
  
 +
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===
+
== Formelfeld ==
−
Geben Sie hier Formeln ein, um sie zu erstellen und zu editieren. Eine Formal kann direkt eingegeben- oder aus gespeicherten Formeln und internen Funktionen hinzugefügt werden. Geben Sie ein Schlüsselwort ein, das die Objekte ME, OTHER, HOLDER, oder PROJECT bezeichnet. Wenn einem Schlüsselwort ein Punkt "." folgt, wird eine Dropdown-Liste (IntelliSense) angezeigt, welche in diesem Objekt nutzbare Eigenschaften anzeigt.
+
{|
 +
|- 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.
 +
|
 +
{| 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]]
 +
|-
 +
|}
  
−
[[Image:sikidialog001.jpg]]
+
=== 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.
  
−
Im Falle von nicht-spezifizierten Objekten wie Child, Parent, etc., werden alle Objekte mit langen Namen 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:sikidialog101.jpg]]
+
[[Image:expressiondialog-tip04.png]]
  
−
In einem Enum-Ausdruck oder einem Bool'schen Ausdruck, können auch<br />==<br />!=
+
=== 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 das Bedienfeld eingeben werden. Dadurch wird eine Dropdown-Liste aller möglichen Werte angezeigt.
+
[[Image:Expressiondialog-smp01.png]]
  
 +
[[Image:Expressiondialog-smp02.png]]
  
−
[[Image:sikidialog002.jpg]]
+
; Hinweis
 +
: Erfordert mindestens Asprova Version 13.0.  
  
−
====Hervorhebung bei Fehlern====
+
=== Zeilenumbrüche und Leerzeichen ===
−
Während Formeleingabe werden Teile davon in roter Schrift dargestellt, wenn sie nicht erkannt werden. Zum Beispiel:
+
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
  
−
: Der Name einer Eigenschaft oder einer Funktion ist falsch geschrieben: 'Castomer' anstatt 'Customer'<br />- Die Groß- und Kleinschreibung der Eigenschaft ist nicht korrekt: 'Starttime' anstatt 'StartTime'<br />- Klammern werden nicht korrekt benutzt werden: (10 + (10 * 2) -> Hier fehlt eine Klammer.
+
; 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.
  
−
Dieser Teil der Formel ist ungültig und muss berichtigt werden, bevor Asprova die Formel akzeptieren kann.
+
=== Kommentare ===
 +
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.
  
 +
; 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.
  
−
[[Image:sikidialog-col01.jpg]]
+
=== 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.
  
−
====Klammerpaare werden in Farbe angezeigt====
+
{| class="wikitable"
−
Bei Verwendung von Formeln mit vielen Klammerpaaren werden diese in gleichen Farben angezeigt, um die Arbeit damit zu erleichtern.
+
|-
 +
|+ 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-col02.jpg]]
+
[[Image:sikidialog-col04.png]]
  
−
Die Größe des Textfeldes im Formeleditor kann durch Ändern der Fenstergröße angepasst werden.
+
=== 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]]
 +
|-
 +
|}
  
 +
=== Umbrechen ===
 +
Drücken sie [Umbrechen], um automatisch Zeilenumbrüche in der Darstellung der Formel einzufügen.
  
−
[[Image:sikidialog011.jpg]]
+
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.
  
−
===Standardformeln===
+
{| class="wikitable"
−
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.
+
|+ 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]]
 +
|-
 +
|}
  
 +
; Hinweis
 +
: Erfordert eine Asprova-Lizenz mindestens für Version 13.0.
  
−
[[Image:gui025.jpg]]
+
== 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.
  
−
===Selbst definierte 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.
+
|- valign="top"
−
Neu erstellte Formeln sind der Liste von selbst definierten Formeln hinzufügbar. Klicken Sie dazu auf "In Formeltabelle speichern...".
+
|
 +
=== 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].
  
−
Eigene Formeln sind anhand des Button "Löschen" aus dem Kontextmenü löschbar.
+
==== Formeltabelle ====
 +
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-4.jpg]]
+
== Leeren ==
−
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).
 
−
 
 
−
 
 
−
[[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.
 
−
 
 
−
 
 
−
===In Formeltabelle 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.
 
−
 
 
−
 
 
−
[[Image:gui025-1.jpg]]
 
−
 
 
−
Im Falle bereits benutzter Namen wird folgende Nachricht angezeigt. Ein Klick auf "OK" überschreibt die Formel mit dem neuen Inhalt.
 
−
 
 
−
 
 
−
[[Image:gui025-2.jpg]]
 
−
 
 
−
===Löschen===
 
 
Löscht den Inhalt des Formelfeldes.
 
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.
  
−
===Alias/ Anzeigenamen verwenden===
+
{| class="wikitable"
−
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"]].
+
|- 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-00.jpg]]
+
== Mehr/Weniger ==
 +
{|
 +
|- 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]]
 +
|-
 +
|}
  
−
===Mehr===
+
|-
−
Zeigt weitere Details einer Formel an, die festgelegt wurden oder gerade festgelegt werden.
+
|}
  
−
 
+
=== HOLDER ===
−
[[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 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.
+
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. 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.
 
−
 
 
−
 
 
−
===Ergebnisdatentyp der Formel===
 
−
Zeigt den Datentyp des Formelergebnisses an.
 
−
 
 
−
 
 
−
===Formelergebnis für das gewählte Beispiel===
 
−
Zeigt das Formelergebnis 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 Einstellungen.
 
  
 +
----
  
−
===Abbrechen===
+
; Hinweise
−
Verwirft alle Einstellungen.
+
* 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.
  
−
Bitte klicken Sie [[Formeln|hier]], um zu erfahren wie Formeln definiert werden.
+
== 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“