Asprova Hilfe - Benutzerbeiträge [de]

Modulaufbau

2021-03-27T19:10:45Z

FW: /* Übersicht */

{{DISPLAYTITLE:Modulaufbau}}
<div align="right">Hilfe Nummer: 3000</div>
<hr>

== Übersicht ==
Asprova ist in verschiedenen, sogenannten Modulen, erhältlich. Das jeweils darin enthaltene Spektrum an Funktionen unterscheidet sich von Modul zu Modul:

{| class="wikitable
|-
!rowspan="4" colspan="2"| !!colspan="7" style="width: 70%;"|Module
|-
!colspan="4" style="width: 40%;"|Planen!!colspan="2" style="width: 20%;"|Bearbeiten!!style="width: 10%;"|Betrachten
|-
![[Asprova APS|APS]]!![[Asprova MS|MS]]!![[Asprova MS Light|MS Light]]!![[Asprova SCP|SCP]]!![[Asprova SED|SED]]!![[Asprova BOM|BOM]]!![[Asprova MES|MES]]
|- align="center"
|Advanced Planning and Scheduling||Manufacturing Scheduler||Manufacturing Scheduler Light||Supply Chain Planning||Schedule Editor||Bill of Material||Manufacturing Execution System
|- align="center" style="background:#E2EFDA"
!rowspan="10|Funktion!!Benutzeroberfläche
|✔||✔||✔||✔||✔||✔||✔
|- align="center" style="background:#E2EFDA"
!Ergebniseingabe
|✔||✔||✔||✔||✔||✔||✔
|- align="center" style="background:#E2EFDA"
!Stammdateneingabe
|✔||✔||✔||✔||✔||✔||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Auftragseingabe
|✔||✔||✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Planbearbeitung
|✔||✔||✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Materialbedarfsberechnung
|✔||✔||✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Reihenfolgenbildung
|✔||✔||✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Planung ohne Kapazitätsbeschränkung
|✔||✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFF2CC"|✔1||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Planung mit Kapazitätsbeschränkung
|✔||✔||✔||style="background:#FFBFBF"| ||style="background:#FFBFBF"| ||style="background:#FFF2CC"|✔1||style="background:#FFBFBF"|
|- align="center" style="background:#FFBFBF"
!Grobplanung mehrerer Werke
| || || ||style="background:#E2EFDA"|✔ || || ||
|- align="center" style="background:#E2EFDA"
!rowspan="8"|Option!!Verkaufsauftrag
|✔||style="background:#DDE2FF"|◯||style="background:#FFF2CC"|◯2,3||✔||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4
|- align="center" style="background:#E2EFDA"
!Einkaufsauftrag
|✔||style="background:#DDE2FF"|◯||style="background:#FFF2CC"|◯2,3||✔||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4
|- align="center" style="background:#DDE2FF"
!KPI
|◯||◯||style="background:#FFF2CC"|◯2||◯||style="background:#FFBFBF"| ||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#DDE2FF"
!Optimierungslogik
|◯||◯||style="background:#FFF2CC"|◯2||style="background:#FFBFBF"| ||style="background:#FFBFBF"| ||style="background:#FFBFBF"| ||style="background:#FFBFBF"|
|- align="center" style="background:#DDE2FF"
!Ereignis
|◯||◯||style="background:#FFF2CC"|◯2||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#DDE2FF"
!Gruppenzuweisung
|◯||◯||style="background:#FFF2CC"|◯2||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#DDE2FF"
!Zeitbeschränkung MAX
|◯||◯||◯||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#DDE2FF"
!Ressourcensperre
|◯||◯||◯||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#FFBFBF"
!Option für SCP!!Planbestand
| || || ||style="background:#DDE2FF"|◯||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||
|- align="center" style="background:#E2EFDA"
!rowspan="5"|Option für MS Light!!Planungsbefehl
|✔||✔||style="background:#DDE2FF"|◯||✔||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Automatisches Nachfüllen
|✔||✔||style="background:#DDE2FF"|◯||✔||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Subressource
|✔||✔||style="background:#DDE2FF"|◯||✔||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Vorgangsteilung
|✔||✔||style="background:#DDE2FF"|◯||✔||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|- align="center" style="background:#E2EFDA"
!Prozessaufteilung
|✔||✔||style="background:#DDE2FF"|◯||style="background:#FFBFBF"| ||style="background:#FFF2CC"|◯4||style="background:#FFF2CC"|◯4||style="background:#FFBFBF"|
|-
|colspan="9"|
|-
!rowspan="5"|''Legende''
|style="background:#E2EFDA" align="center"|✔||colspan="7"|Standardfunktion
|-
|style="background:#FFF2CC" align="center"|✔||colspan="7"|Standardfunktion mit Einschränkungen 1 "Quick Shoot-Funktion" plant bis zu 100 Aufträge und 250 Vorgänge.
|-
|style="background:#DDE2FF" align="center"|◯||colspan="7"|Option
|-
|style="background:#FFF2CC" align="center"|◯||colspan="7"|Option mit Einschränkungen 2 Erfordert MS Light Option ''Planungsbefehl'' 3 Erfordert MS Light Option ''Automatisches Nachfüllen'' 4 Kann genutzt werden, falls die Daten von einem Planungsmodul mit der Option gespeichert wurden.
|-
|style="background:#FFBFBF"| ||colspan="7"|Nicht verfügbar
|-
|}

== Vererbung von Optionen ==
Für die Bearbeitungsmodule können keine Optionen gekauft werden. Stattdessen erben sie die Optionen von den Planungsmodulen. Dies geschieht uanbhängig von der Art des Lizenzbezugs (lokaler Schutz oder Netzwerklizenz).

Auch wenn die Bearbeitungsmodule keine Planung erlauben, so sind durch das Ererben der Option die folgenden Aktionen möglich.
{| class="wikitable"
|-
!colspan="2"| !!Erlaubte Aktion
|-
!rowspan="8"|Option
|Verkaufsauftrag||
* Verschieben von Verkaufsaufträgen
* Bearbeiten von Verkaufsplänen
|-
|Einkaufsauftrag||
* Verschieben von Einkaufsaufträgen
* Planzusammenfassung
|-
|KPI||KPI berechnen
|-
|Optimierungslogik||Bearbeiten von Eigenschaften des Befehls "Sequenzsteuerung"
|-
|Ereignis||Ereignisaufträge verschieben
|-
|Gruppenzuweisung||
|-
|Zeitbeschränkung MAX||Verletzungen der [Zeitbeschränkung MAX] werden in Gantt-Diagrammen orange angezeigt
|-
|Ressourcensperre||Eigenschaften der Ressourcensperre bearbeiten
|-
!Option für SCP
|Planbestand||Eigenschaften des Planbestands bearbeiten
|-
!rowspan="5"|Option für MS Light
|Planungsbefehl||Befehle in der Planungsparametertabelle und dem Befehlseditor bearbeiten
|-
|Automatisches Nachfüllen||
* Automatisches Nachfüllen während "Vorgangserstellung und Stücklistenauflösung"
* Bearbeiten entsprechender Eigenschaften
|-
|Subressource||Nutzungsanweisungen für Subressourcen anlegen und bearbeiten
|-
|Vorgangsteilung||
|-
|Prozessaufteilung||Während "Vorgangserstellung und Stücklistenauflösung" sich aufteilende Prozesse erstellen
|-
|}

==== Beispiel ====
Für ein Projekt gibt es eine MS Lizenz mit Ressourcensperre, sowie eine SED Lizenz. SED erbt die Option Ressourcensperre, wenn die mit MS erstellte Projektdatei geöffnet wird. Beim Bearbeiten in SED werden Ressourcensperraufgaben aktualisiert oder neu angelegt.

=== Vererbungsprozess ===
# When the scheduler module saves a project file, it embeds the allocated options and the save date of the project file.
# The editor module reads the embedded options and the save date when loading a project file, and if the current date is within one year from the save date, it inherits those options.

1 is done for the Professional Edition only. It is not done in Asprova for the likes of the Trial Edition, Distributor Edition, and Professional Edition (Rental).

When multiple scheduler modules have different options, the already embedded information is not overwritten nor deleted.

==== Beispiel ====
When saving a project file with alternate Professional Edition Asprova licenses of serial numbers M and N (hereinafter referred to as # M, # N), the following occurs.
; Lizenz A
: MS + Ressourcensperre
; Lizenz B
: MS + Gruppenzuweisung

{| class="wikitable"
|- align="center"
!colspan="2"|Schritt
|1.||2.||3.
|-
!colspan="2"|Datum
|02.06.2020||03.06.2020||04.06.2020
|-
!colspan="2"|Ereignis
|A erstellt Projekt und speichert||B speichert||A speichert
|-
!rowspan="8"|Option
|Verkaufsauftrag||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|Einkaufsauftrag||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|KPI||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|Optimierungslogik||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|Ereignis||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|Gruppenzuweisung||style="background:#FFBFBF"|Nicht gesetzt||style="background:#E2EFDA"|03.06.2020||03.06.2020
|-
|Zeitbeschränkung MAX||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt||style="background:#FFBFBF"|Nicht gesetzt
|-
|Ressourcensperre||style="background:#E2EFDA"|02.06.2020||02.06.2020||style="background:#E2EFDA"|04.06.2020
|-
|colspan="5"|''Grüne Zellen enthalten das letzte Speicherdatum.''
|-
|}

<hr>
<div align="right">Hilfe Nummer: 3000</div>

Formeln

2020-10-23T12:58:18Z

FW: /* Datentyp Objekt */

{{DISPLAYTITLE:Formeln}}
<div align="right">Hilfe Nummer: 741000</div>
<div align="right">[[Zusätzliche Informationen|Zusätzliche Informationen]]</div>
<div align="right">[[Formeleditor|Formeleditor]]</div>
<hr>
Für Eigenschaften mit [Datentyp] "Formel" müssen Formeln in das Eingabefeld eingetragen werden.

== Übersicht ==
Formeln können die folgenden Bestandteile haben:
* Eigenschaften
* Werte
* Operatoren
* Funktionen

=== Beispiel ===
Die folgende Formel ist der [Standardwert] für [Vorgangsbalkentext] des Ressourcen-Gantt-Diagramms:
ME.Operation.Order+'\n'+ME.Operation.OperationOutMainItem+'\n'+ME.Operation.OperationOutMainItemQty

<code>ME.Operation.OperationOutMainItemQty</code>
: Eigenschaft mit der Produktionsmenge des Vorgangs
<code>+</code>
: Additionsoperator (wird hier genutzt um mehrere Strings miteinander zu verbinden)
<code>\n</code>
: String, die einen Zeilenumbruch vorgibt

Bei der Berechnung von Zeiten oder Zeitspannen, sowie beim Definieren von Kapazitätswerten ([Rüsten], [Produktion] und [Abrüsten]) können [[Einheiten in Formeln|Einheiten]] genutzt werden. Es können auch Formeln genutzt werden, die [[Datentyp der Auswertungsergebnisse|mehrere Datentypen]] kombinieren, etwa Zeitspannen und Zahlen. Weitergehende Informationen zur Auswertung von Eigenschaften ohne Werte finden sich [[Eigenschaften ohne Wert auswerten|hier]].

== Eigenschaften ==
=== Lang- und Kurznamen ===
Eigenschaften haben jeweils einen langen- und einen kurzen Namen. Der Kurzname für die [Menge] eines Auftrages ist <code>Qty</code> und der Langname ist <code>Order_Qty</code>. Für den Langnamen werden Klassenname und ein Unterstrich vor den Kurznamen gesetzt. (Um den Langnamen einer Eigenschaft sicher zu bestimmen, nutzen Sie entweder die Klassendefinition in dieser Hilfe oder direkt in Asprova deren [Code].)

Wird eine Eigenschaft über <code>ME</code> etc. referenziert, so ist das Zielobjekt eindeutig, so dass der Kurzname genutzt werden kann. Dies ist meistens der Fall, auch in der Dropdown-Liste der verfügbaren Eigenschaften wird dann der Kurzname verwendet. Wird ein übergeordnetes (<code>PARENT</code>) oder untergeordnetes Objekt (<code>CHILD</code>) referenziert oder ein Sortierschlüssel als Formel definiert, so ist das ist das Zielobjekt nicht eindeutig, da Eigenschaften unterschiedlicher Klassen den gleichen Kurznamen haben können. Hier muss der Langname verwendet werden.

=== ME===
Wenn Sie eine Eigenschaft in einer Formel verwenden, geben Sie zunächst <code>ME</code> ein. <code>ME</code> ist das Objekt, auf das sich die Formel der Eigenschaft mit [Datentyp] "Formel" bezieht. So ist etwa bei der [Gültigkeitsbedingung] einer Hauptnutzungsanweisung in dern Integrierten Stammdaten <code>ME</code> ein Vorgang. Beim [Vorgangsbalkentext] des Ressourcen-Gantt-Diagramms ist <code>ME</code> eine Nutzungsanweisung. Wird nach <code>ME</code> ein Punkt (<code>.</code>) eingegeben, so erscheint eine Dropdown-Liste der verfügbaren Eigenschaften, die durch einen Klick ausgewählt werden können. Natürlich können Sie den Eigenschaftsnamen auch einfach hinter dem Punkt eingeben.

; Beispiel
Um im [Auftragsbalken Formel rechter Text] im Auftrags-Gantt-Diagramm den [Fälligkeitstermin] anzuzeigen, geben Sie <code>ME.LET</code> ein.

<code>ME</code> könnte hier weggelassen werden, der eingegebene Eigenschaftsname wird dann als eine Eigenschaft von <code>ME</code> angesehen. Daher kann <code>ME.LET</code> oder <code>LET</code> eingeben werden und das Ergebnis ist das Gleiche. Aus Gründen der Durchgängigkeit und des leichteren Verständnis, ist diese Vereinfachung jedoch nicht empfohlen.

; Beispiel
Um in der [Vorgangsbalkentextformel] des Ressourcen-Gantt-Diagramm den [Artikelname] des Auftragsartikels zu referenzieren, geben Sie <code>ME.Order.Item.Name</code> ein.

=== OTHER ===
Bei Eigenschaften wie der [Verknüpfungsbedingung], bei denen die Werte zweier Eigenschaften verglichen werden, kann zusätzlich zu <code>ME</code> auch <code>OTHER</code> verwendet werden. <code>OTHER</code> bezieht sich auch auf ein Objekt und kann genauso wie <code>ME</code> verwendet werden.

; Beispiel
Um in der [Verknüpfungsbedingung] eines Artikels festzulegen, dass zu Verknüpfen die [Spezifikation 1] der Aufträge gleich sein muss geben Sie <code>ME.Order.Spec1==OTHER.Order.Spec1</code> ein.

Im [[Formeleditor|Formeleditor]] ist ersichtlich, ob <code>OTHER</code> verwendet werden kann und auf welches Objekt sich <code>OTHER</code> bezieht.

Eine andere Eigenschaft, die sich auf zwei Eigenschaften bezieht ist die [Ofengültigkeitsbedingung] von Ressourcen. Hier können Eigenschaften auch nur über <code>ME</code> und ohne <code>OTHER</code> verglichen werden.

; Beispiel
Die [Ofengültigkeitsbedingung], die die gleichzeitige Zuweisung von Aufträgen des gleichen Kunden erlaubt lautet <code>ME.Order.Customer.Code</code>.

=== HOLDER ===
<code>HOLDER</code> bezieht sich auf das Objekt, zu der die Eigenschaft mit [Datentyp] "Formel" gehört. So ist etwa in der [Gültigkeitsbedingung] einer Hauptnutzungsanweisung in den Integrierten Stammdaten <code>ME</code> ein Vorgang und <code>HOLDER</code> die Hauptnutzungsanweisung. Um sich in der [Gültigkeitsbedingung] auf den [Code] der Ressource der Hauptnutzungsanweisung in der Gültigkeitsbedingung zu beziehen, wird die Formel <code>HOLDER.Resource.Code</code> genutzt.

=== PROJECT ===
<code>PROJECT</code> bezieht sich auf das aktuell genutzte Projekt, so können die Projekteigenschaften referenziert werden. <code>PROJECT</code> ist in allen Formeln nutzbar.

;Beispiel
Um die [Planungsbasiszeit] zu referenzieren wird die Formel <code>PROJECT.BasisTime</code> genutzt.

=== WORKSPACE ===
<code>WORKSPACE</code> bezieht sich auf den Arbeitsplatz des aktuell genutzten Projekt, so können die Arbeitsplatzeigenschaften referenziert werden.<code>WORKSPACE</code> ist in allen Formeln nutzbar.

;Beispiel
Um den Namen der [Projektdatei] zu referenzieren wird die Formel <code>WORKSPACE.ProjectFileName</code> genutzt.

=== TARGET ===
<code>TARGET</code> ist nur als Argument bestimmter interner Funktionen verwendbar. Definieren Sie als erstes Argument der internen Funktion ein Objekt und definieren dann <code>TARGET</code> ab dem zweiten Argument. <code>TARGET</code> verweist auf das Objekt des ersten Arguments.

; Beispiel
Um die Summe der [Menge] aller Aufträge zu berechnen, wird die Formel <code>Sum('Order',TARGET.Qty)</code> genutzt. <code>TARGET</code> steht hier für die Auftragsklasse.

==== Verschachtelung ====
Der Aufruf einer internen Funktion in einer anderen internen Funktion wird Verschachteln genannt. Verschachtelungen können sich über mehrere Ebenen erstrecken.

Angenommen die internen Funktionen A und B akzeptieren beide <code>TARGET</code> als Argument. Wenn B als Argument von A genutzt wird, so referenziert das <code>TARGET</code>-Argument in B das Objektargument in B.

; Beispiel
Es soll die größte [Menge] aller Aufträge mit dem frühesten [Fälligkeitstermin] unter [Aufträge ganz rechts] von <code>ME</code> bestimmt werden:
MaxIF(ME.RightmostOrder,
TARGET.LET==Min(ME.RightmostOrder,
TARGET.LET),
TARGET.Qty
)
Das erste <code>TARGET</code> wird als <code>ME.RightmostOrder</code> ausgewertet, also das erste Argument der <code>MaxIF</code>-Funktion. Das zweite <code>TARGET</code> wird auch als <code>ME.RightmostOrder</code> ausgewertet, aber als das erste Argument der <code>MIN</code>-Funktion.

Akzeptiert eine verschachtelte interne Funktion <code>TARGET</code> nichts als Argument, so kann in dieser trotzdem <code>TARGET</code> genutzt werden, dieses bezieht sich dann aber auf die übergeordnete interne Funktion.

=== INPUT ===
<code>INPUT</code> wird in der [Virtuelle Eigenschaftsformel invers], der [Anzeigeformel], [Inverse Anzeigeformel], [Währung] etc. verwendet. Es bezieht sich prinzipiell auf die in eine Zelle eingegebene String. Weitere Details können der Beschreibung der jeweiligen Eigenschaften entnommen werden.

=== DELETE ===
<code>DELETE</code> wird verwendet, um Eigenschaftswerte zu löschen. Alternativ kann auch <code><nowiki>''</nowiki></code> verwendet werden.

; Beispiel
Der Name der Eigenschaft wird mit <code>ME.Name=DELETE</code> oder <code>ME.Name=<nowiki>''</nowiki></code> gelöscht.

; Hinweis
: Vor Version 15.0 wurde mit <code><nowiki>''</nowiki></code> ein ''NULL''-Zeichen eingefügt, ab Version 15.0 wird der Wert vollständig gelöscht, so dass das Verhalten genau dem von <code>DELETE</code> entspricht.

=== Eigenschaften mit mehreren Werten ===
Wenn eine Eigenschaft über mehrere Werte verfügt, können Sie hinter der Eigenschaft <code>[n]</code> eingegeben, wobei ''n'' der Index des gewünschten Eigenschaftswerts ist.
; Beispiel
Um den zweiten [Kommentar] eines Auftrages zu referenzieren nutzen Sie die Formel <code>ME.Order.Comments[2]</code>.

Wenn Sie für ''n'' 0 angeben, wird das letzte Element ausgegeben. Wenn etwa [Kommentar] "a;b;c" ist, würde "c" zurückgegeben.

Wenn Sie kein [n] anfügen werden alle Werte zurückgegeben, wenn die Werte Strings sind. Ansonsten wird der letzte Eigenschaftswert zurückgegeben. Wenn etwa [Kommentar] "a;b;c" ist, würde "a;b;c" zurückgegeben. Um auch bei andere Datentypen alle Werte zurückzugeben, kann die interne Funktion <code>StrProps()</code> genutzt werden.

==== Werte lesen, setzen und löschen ====
Das Lesen, Setzen und Löschen bei Eigenschaften mit mehreren Werten hängt von der genutzten Asprova-Version und den Projekteinstellungen ab.

In den folgenden Tabellen ist die Anzahl der bereits in der Eigenschaft [Prop] gesetzten Werte N und es gilt 1 ≤ n ≤ N.

{| class="wikitable"
|+ Ab Version 15.2 (und [Verhalten beim Setzen mehrerer Daten] "Unabhängig vom Datentyp")
|-
!rowspan="2"|Aktion
!rowspan="2"|Formel
!colspan="2"|Datentyp
!rowspan="2"|Kommentar
|-
!String!!Andere
|-
|rowspan="3"|Lesen||style="background: #DAEEF3"|<code>ME.Prop[n]</code>||style="background: #FFFF99" colspan="2" align="center"|n-te||rowspan="2"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop</code>||style="background: #B8CCE4" align="center"|alle||style="background: #D8E4BC" align="center"|letzte||Strings nutzen ; als Trennzeichen
|-
|rowspan="3"|Löschen||style="background: #DAEEF3"|<code>ME.Prop[n]=DELETE</code>||style="background: #FFFF99" colspan="2" align="center"|n-te||rowspan="7"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=DELETE</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop=DELETE</code>||style="background: #B8CCE4" colspan="2" align="center"|alle
|-
|rowspan="2"|Ändern||style="background: #DAEEF3"|<code>ME.Prop[n]=x</code>||style="background: #FFFF99" colspan="2" align="center"|n-te
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=x</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|Löschen & hinzufügen||style="background: #DAEEF3"|<code>ME.Prop=x</code>||style="background: #B7DEE8" colspan="2" align="center"|alle löschen & einen hinzufügen
|-
|Hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[]=x</code>||style="background: #FCD5B4" colspan="2" align="center"|hinzufügen
|-
|}

{| class="wikitable"
|+ Vor Version 15.2 (oder [Verhalten beim Setzen mehrerer Daten] "Je nach Datentyp (altes Verhalten)")
|-
!rowspan="2"|Aktion
!rowspan="2"|Formel
!colspan="4"|Datentyp
!rowspan="2"|Kommentar
|-
!String!!Objekt (x ist Objekt)!!Objekt (x ist String)!!Andere
|-
|rowspan="3"|Lesen||style="background: #DAEEF3"|<code>ME.Prop[n]</code>||style="background: #FFFF99" colspan="4" align="center"|n-te||rowspan="2"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]</code>||style="background: #D8E4BC" colspan="4" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop</code>||style="background: #B8CCE4" align="center"|alle||style="background: #D8E4BC" align="center" colspan="3"|letzte||Strings nutzen ; als Trennzeichen
|-
|rowspan="3"|Löschen||style="background: #DAEEF3"|<code>ME.Prop[n]=DELETE</code>||style="background: #FFFF99" colspan="4" align="center"|n-te||rowspan="5"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=DELETE</code>||style="background: #D8E4BC" colspan="4" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop=DELETE</code>||style="background: #B8CCE4" colspan="4" align="center"|alle
|-
|Ändern||style="background: #DAEEF3"|<code>ME.Prop[n]=x</code>||style="background: #FFFF99" colspan="4" align="center"|n-te
|-
|rowspan="2"|Ändern & hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[0]=x</code>||style="background: #FCD5B4" colspan="2" align="center"|hinzufügen||style="background: #D8E4BC" align="center"|letzte ändern||style="background: #FCD5B4" align="center"|hinzufügen
|-
|style="background: #DAEEF3"|<code>ME.Prop=x</code>||style="background: #FF99CC" colspan="2" align="center"|alle ändern||style="background: #B7DEE8" align="center"|alle löschen & einen hinzufügen||style="background: #FF99CC" align="center"|alle ändern||Wenn bei 'alle ändern' N = 0, dann einen hinzufügen
|-
|Hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[]=x</code>||style="background: #FCD5B4" colspan="4" align="center"|hinzufügen||Nur ab Version 15.2
|-
|}

==== Datentyp Objekt ====
Für Eigenschaften mit [Datentyp] "Objekt" mit mehreren Werten, kann statt dem Index der [Code] der Objekte verwendet werden, um einen bestimmten Wert zu adressieren. Der [Code] ist ein String und die Werte der Eigenschaft werden nach einem passenden String durchsucht. Der Vergleich der Objekte mit dem String erfolgt in der Reihenfolge [Code] → [Anzeigename] → [Alias].

; Beispiel
Um auf die Nutzungsanweisung mit [Code] "S1" der Produktionsaufgabe eines Vorganges zuzugreifen, nutzen Sie die Formel <code>ME.ProductionTask.UseInstructions['S1']</code>.

Angenommen dem Projekt wurde die benutzerdefinierte Klasse "Meine Klasse" (<code>MyClass</code>) mit der Eigenschaft [Meine Eigenschaft 1] (<code>MyProperty1</code>) hinzugefügt. Auf den Wert von [Meine Eigenschaft 1] des Objekts "ABC" in der Klasse "MyClass" kann mit <code>PROJECT.Child['MyClass'].Child['ABC'].MyClassUser_MyProperty1</code> zugegriffen werden.

Weitere Informationen zu benutzerdefinierten Klassen finden Sie unter [[Hinzufügen einer neuen Klassendefinition|Hinzufügen einer neuen Klassendefinition]].

[[Datei:UserClassTable.png]]

[[Datei:UserClassPropEditor.png]]

== Werte ==
Häufig werden Werte wie Zahlen und Strings in Formeln verwendet. Benutzen Sie in Formeln folgende Formatierungen.

{| class="wikitable"
|+ Formatierung von Werten in Formeln
|-
!Datentyp!!Beschreibung!!Beispiel
|-
|Zahl||Kann direkt eingegeben werden||123
|-
|String||Wird mit einfachen Anführungszeichen umschlossen||'123'
|-
|Datum||Wird mit Rauten umschlossen||#2020/06/01 12:00:00#
|-
|Bool||Direkte Eingabe des Werts||TRUE, FALSE
|-
|}

=== Steuerzeichen in Strings ===
In Strings ist "\", zusammen mit dem nachfolgenden Zeichen, ein Steuerzeichen.

{| class="wikitable"
|+ Verwendung von Steuerzeichen
|-
!Formel!!Rückgabewert!!Beschreibung
|-
|<code>'\\'</code>||\||Wird als ein umgekehrter Schrägstrich ausgegeben
|-
|<code>'\n'</code>||↵||Fügt einen Zeilenumbruch ein
|-
|<code>'\''</code>||'||Wird als einfaches Anführungszeichen ausgegeben
|-
|}

== Operatoren ==
{| class="wikitable"
|+ Verfügbare Operatoren
|-
!Operator!!Bedeutung!!Kommentar
|+||Addition, Verbindung von (Zeichen-)Ketten||
|-
|-||Subtraktion||
|-
|*||Multiplikation||
|-
|/||Division||
|-
|^||Potenzierung||
|-
|%||Modulo||Rest der Division
|-
|&&||AND||Logisches UND
|-
|<nowiki>||</nowiki>||OR||Logisches ODER
|-
|==||Gleich||Vergleich
|-
|!=||Ungleich||Vergleich
|-
|>||Größer||Vergleich
|-
|>=||Größer oder gleich||Vergleich
|-
|<||Kleiner||Vergleich
|-
|<=||Kleiner oder gleich||Vergleich
|-
|(, )||Klammern||
|-
|=||Zuweisung||Setzen von Werten
|-
|}

Die Operatoren werden in der folgenden Reihenfolge ausgewertet:
# ^
# *, /, %
# +, -
# ==, !=, >, <, >=, <=
# &&, ||
# =

Inhalte in Klammern werden zuerst ausgewertet.

=== Kurzschlussauswertung ===
Asprova nutzt [https://de.wikipedia.org/wiki/Kurzschlussauswertung Kurzschlussauswertung] zur schnelleren Auswertung von Formeln. Durch eine entsprechende Formelstruktur kann diese Funktionalität optimal genutzt werden. Weitere Informationen dazu finden Sie [[Beschleunigung der Fomelauswertung|hier]].

== Funktionen ==
In Formeln können Sie interne und benutzerdefinierte Funktionen verwenden. Die Funktion zum Beziehen der, auf einen Vorgang anzuwendenden, [Spezifikation 1] lautet <code>GetApplicableSpec(1,ME.Operation)</code>.

Bei der Nutzung von Funktionen achten Sie bitte auf die korrekte Schreibweise von Funktionsnamen und Argumenten. Weitergehende Informationen zu Asprovas internen Funktionen finden sich [[Interne Funktionen|hier]].

=== IF ===
Die interne Funktion <code>IF()</code> ermöglicht die Bewertung von Vorgängen mit der folgenden Formel:
IF(Bedingung,
falls <code>TRUE</code>,
falls <code>FALSE</code>
)

; Beispiel
Ist die [Startzeit] vor dem 1. Juni 2020, so wird der erste [Kommentar] auf "ABC" gesetzt, sonst auf "XYZ":
ME.Comments=IF(ME.StartTime<=#2020/06/01,
'ABC',
'XYZ'
)
oder
IF(ME.StartTime<=#2020/06/01,
ME.Comments='ABC',
ME.Comments='XYZ'
)

Ab Version 13.1 können mehrere Bedingungen eingegeben werden:
IF(Bedingung 1,
falls <code>TRUE</code>,
Bedingung 2,
falls <code>TRUE</code>,
...
...
Bedingung n,
falls <code>TRUE</code>,
falls <code>FALSE</code>
)

; Beispiel
Bei [Priorität] ab 90 rot, von 50 bis 90 blau und bei weniger als 50 grün:
IF(ME.Order.Priority>=90,
RGB(255,0,0),
ME.Order.Priority<50,
RGB(0,255,0),
RGB(0,0,255)
)

== Weitere Informationen ==
* [[Interne Funktionen]]

<hr>
<div align="right">Hilfe Nummer: 741000</div>

Formeln

2020-10-23T12:56:58Z

FW: /* ME */

{{DISPLAYTITLE:Formeln}}
<div align="right">Hilfe Nummer: 741000</div>
<div align="right">[[Zusätzliche Informationen|Zusätzliche Informationen]]</div>
<div align="right">[[Formeleditor|Formeleditor]]</div>
<hr>
Für Eigenschaften mit [Datentyp] "Formel" müssen Formeln in das Eingabefeld eingetragen werden.

== Übersicht ==
Formeln können die folgenden Bestandteile haben:
* Eigenschaften
* Werte
* Operatoren
* Funktionen

=== Beispiel ===
Die folgende Formel ist der [Standardwert] für [Vorgangsbalkentext] des Ressourcen-Gantt-Diagramms:
ME.Operation.Order+'\n'+ME.Operation.OperationOutMainItem+'\n'+ME.Operation.OperationOutMainItemQty

<code>ME.Operation.OperationOutMainItemQty</code>
: Eigenschaft mit der Produktionsmenge des Vorgangs
<code>+</code>
: Additionsoperator (wird hier genutzt um mehrere Strings miteinander zu verbinden)
<code>\n</code>
: String, die einen Zeilenumbruch vorgibt

Bei der Berechnung von Zeiten oder Zeitspannen, sowie beim Definieren von Kapazitätswerten ([Rüsten], [Produktion] und [Abrüsten]) können [[Einheiten in Formeln|Einheiten]] genutzt werden. Es können auch Formeln genutzt werden, die [[Datentyp der Auswertungsergebnisse|mehrere Datentypen]] kombinieren, etwa Zeitspannen und Zahlen. Weitergehende Informationen zur Auswertung von Eigenschaften ohne Werte finden sich [[Eigenschaften ohne Wert auswerten|hier]].

== Eigenschaften ==
=== Lang- und Kurznamen ===
Eigenschaften haben jeweils einen langen- und einen kurzen Namen. Der Kurzname für die [Menge] eines Auftrages ist <code>Qty</code> und der Langname ist <code>Order_Qty</code>. Für den Langnamen werden Klassenname und ein Unterstrich vor den Kurznamen gesetzt. (Um den Langnamen einer Eigenschaft sicher zu bestimmen, nutzen Sie entweder die Klassendefinition in dieser Hilfe oder direkt in Asprova deren [Code].)

Wird eine Eigenschaft über <code>ME</code> etc. referenziert, so ist das Zielobjekt eindeutig, so dass der Kurzname genutzt werden kann. Dies ist meistens der Fall, auch in der Dropdown-Liste der verfügbaren Eigenschaften wird dann der Kurzname verwendet. Wird ein übergeordnetes (<code>PARENT</code>) oder untergeordnetes Objekt (<code>CHILD</code>) referenziert oder ein Sortierschlüssel als Formel definiert, so ist das ist das Zielobjekt nicht eindeutig, da Eigenschaften unterschiedlicher Klassen den gleichen Kurznamen haben können. Hier muss der Langname verwendet werden.

=== ME===
Wenn Sie eine Eigenschaft in einer Formel verwenden, geben Sie zunächst <code>ME</code> ein. <code>ME</code> ist das Objekt, auf das sich die Formel der Eigenschaft mit [Datentyp] "Formel" bezieht. So ist etwa bei der [Gültigkeitsbedingung] einer Hauptnutzungsanweisung in dern Integrierten Stammdaten <code>ME</code> ein Vorgang. Beim [Vorgangsbalkentext] des Ressourcen-Gantt-Diagramms ist <code>ME</code> eine Nutzungsanweisung. Wird nach <code>ME</code> ein Punkt (<code>.</code>) eingegeben, so erscheint eine Dropdown-Liste der verfügbaren Eigenschaften, die durch einen Klick ausgewählt werden können. Natürlich können Sie den Eigenschaftsnamen auch einfach hinter dem Punkt eingeben.

; Beispiel
Um im [Auftragsbalken Formel rechter Text] im Auftrags-Gantt-Diagramm den [Fälligkeitstermin] anzuzeigen, geben Sie <code>ME.LET</code> ein.

<code>ME</code> könnte hier weggelassen werden, der eingegebene Eigenschaftsname wird dann als eine Eigenschaft von <code>ME</code> angesehen. Daher kann <code>ME.LET</code> oder <code>LET</code> eingeben werden und das Ergebnis ist das Gleiche. Aus Gründen der Durchgängigkeit und des leichteren Verständnis, ist diese Vereinfachung jedoch nicht empfohlen.

; Beispiel
Um in der [Vorgangsbalkentextformel] des Ressourcen-Gantt-Diagramm den [Artikelname] des Auftragsartikels zu referenzieren, geben Sie <code>ME.Order.Item.Name</code> ein.

=== OTHER ===
Bei Eigenschaften wie der [Verknüpfungsbedingung], bei denen die Werte zweier Eigenschaften verglichen werden, kann zusätzlich zu <code>ME</code> auch <code>OTHER</code> verwendet werden. <code>OTHER</code> bezieht sich auch auf ein Objekt und kann genauso wie <code>ME</code> verwendet werden.

; Beispiel
Um in der [Verknüpfungsbedingung] eines Artikels festzulegen, dass zu Verknüpfen die [Spezifikation 1] der Aufträge gleich sein muss geben Sie <code>ME.Order.Spec1==OTHER.Order.Spec1</code> ein.

Im [[Formeleditor|Formeleditor]] ist ersichtlich, ob <code>OTHER</code> verwendet werden kann und auf welches Objekt sich <code>OTHER</code> bezieht.

Eine andere Eigenschaft, die sich auf zwei Eigenschaften bezieht ist die [Ofengültigkeitsbedingung] von Ressourcen. Hier können Eigenschaften auch nur über <code>ME</code> und ohne <code>OTHER</code> verglichen werden.

; Beispiel
Die [Ofengültigkeitsbedingung], die die gleichzeitige Zuweisung von Aufträgen des gleichen Kunden erlaubt lautet <code>ME.Order.Customer.Code</code>.

=== HOLDER ===
<code>HOLDER</code> bezieht sich auf das Objekt, zu der die Eigenschaft mit [Datentyp] "Formel" gehört. So ist etwa in der [Gültigkeitsbedingung] einer Hauptnutzungsanweisung in den Integrierten Stammdaten <code>ME</code> ein Vorgang und <code>HOLDER</code> die Hauptnutzungsanweisung. Um sich in der [Gültigkeitsbedingung] auf den [Code] der Ressource der Hauptnutzungsanweisung in der Gültigkeitsbedingung zu beziehen, wird die Formel <code>HOLDER.Resource.Code</code> genutzt.

=== PROJECT ===
<code>PROJECT</code> bezieht sich auf das aktuell genutzte Projekt, so können die Projekteigenschaften referenziert werden. <code>PROJECT</code> ist in allen Formeln nutzbar.

;Beispiel
Um die [Planungsbasiszeit] zu referenzieren wird die Formel <code>PROJECT.BasisTime</code> genutzt.

=== WORKSPACE ===
<code>WORKSPACE</code> bezieht sich auf den Arbeitsplatz des aktuell genutzten Projekt, so können die Arbeitsplatzeigenschaften referenziert werden.<code>WORKSPACE</code> ist in allen Formeln nutzbar.

;Beispiel
Um den Namen der [Projektdatei] zu referenzieren wird die Formel <code>WORKSPACE.ProjectFileName</code> genutzt.

=== TARGET ===
<code>TARGET</code> ist nur als Argument bestimmter interner Funktionen verwendbar. Definieren Sie als erstes Argument der internen Funktion ein Objekt und definieren dann <code>TARGET</code> ab dem zweiten Argument. <code>TARGET</code> verweist auf das Objekt des ersten Arguments.

; Beispiel
Um die Summe der [Menge] aller Aufträge zu berechnen, wird die Formel <code>Sum('Order',TARGET.Qty)</code> genutzt. <code>TARGET</code> steht hier für die Auftragsklasse.

==== Verschachtelung ====
Der Aufruf einer internen Funktion in einer anderen internen Funktion wird Verschachteln genannt. Verschachtelungen können sich über mehrere Ebenen erstrecken.

Angenommen die internen Funktionen A und B akzeptieren beide <code>TARGET</code> als Argument. Wenn B als Argument von A genutzt wird, so referenziert das <code>TARGET</code>-Argument in B das Objektargument in B.

; Beispiel
Es soll die größte [Menge] aller Aufträge mit dem frühesten [Fälligkeitstermin] unter [Aufträge ganz rechts] von <code>ME</code> bestimmt werden:
MaxIF(ME.RightmostOrder,
TARGET.LET==Min(ME.RightmostOrder,
TARGET.LET),
TARGET.Qty
)
Das erste <code>TARGET</code> wird als <code>ME.RightmostOrder</code> ausgewertet, also das erste Argument der <code>MaxIF</code>-Funktion. Das zweite <code>TARGET</code> wird auch als <code>ME.RightmostOrder</code> ausgewertet, aber als das erste Argument der <code>MIN</code>-Funktion.

Akzeptiert eine verschachtelte interne Funktion <code>TARGET</code> nichts als Argument, so kann in dieser trotzdem <code>TARGET</code> genutzt werden, dieses bezieht sich dann aber auf die übergeordnete interne Funktion.

=== INPUT ===
<code>INPUT</code> wird in der [Virtuelle Eigenschaftsformel invers], der [Anzeigeformel], [Inverse Anzeigeformel], [Währung] etc. verwendet. Es bezieht sich prinzipiell auf die in eine Zelle eingegebene String. Weitere Details können der Beschreibung der jeweiligen Eigenschaften entnommen werden.

=== DELETE ===
<code>DELETE</code> wird verwendet, um Eigenschaftswerte zu löschen. Alternativ kann auch <code><nowiki>''</nowiki></code> verwendet werden.

; Beispiel
Der Name der Eigenschaft wird mit <code>ME.Name=DELETE</code> oder <code>ME.Name=<nowiki>''</nowiki></code> gelöscht.

; Hinweis
: Vor Version 15.0 wurde mit <code><nowiki>''</nowiki></code> ein ''NULL''-Zeichen eingefügt, ab Version 15.0 wird der Wert vollständig gelöscht, so dass das Verhalten genau dem von <code>DELETE</code> entspricht.

=== Eigenschaften mit mehreren Werten ===
Wenn eine Eigenschaft über mehrere Werte verfügt, können Sie hinter der Eigenschaft <code>[n]</code> eingegeben, wobei ''n'' der Index des gewünschten Eigenschaftswerts ist.
; Beispiel
Um den zweiten [Kommentar] eines Auftrages zu referenzieren nutzen Sie die Formel <code>ME.Order.Comments[2]</code>.

Wenn Sie für ''n'' 0 angeben, wird das letzte Element ausgegeben. Wenn etwa [Kommentar] "a;b;c" ist, würde "c" zurückgegeben.

Wenn Sie kein [n] anfügen werden alle Werte zurückgegeben, wenn die Werte Strings sind. Ansonsten wird der letzte Eigenschaftswert zurückgegeben. Wenn etwa [Kommentar] "a;b;c" ist, würde "a;b;c" zurückgegeben. Um auch bei andere Datentypen alle Werte zurückzugeben, kann die interne Funktion <code>StrProps()</code> genutzt werden.

==== Werte lesen, setzen und löschen ====
Das Lesen, Setzen und Löschen bei Eigenschaften mit mehreren Werten hängt von der genutzten Asprova-Version und den Projekteinstellungen ab.

In den folgenden Tabellen ist die Anzahl der bereits in der Eigenschaft [Prop] gesetzten Werte N und es gilt 1 ≤ n ≤ N.

{| class="wikitable"
|+ Ab Version 15.2 (und [Verhalten beim Setzen mehrerer Daten] "Unabhängig vom Datentyp")
|-
!rowspan="2"|Aktion
!rowspan="2"|Formel
!colspan="2"|Datentyp
!rowspan="2"|Kommentar
|-
!String!!Andere
|-
|rowspan="3"|Lesen||style="background: #DAEEF3"|<code>ME.Prop[n]</code>||style="background: #FFFF99" colspan="2" align="center"|n-te||rowspan="2"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop</code>||style="background: #B8CCE4" align="center"|alle||style="background: #D8E4BC" align="center"|letzte||Strings nutzen ; als Trennzeichen
|-
|rowspan="3"|Löschen||style="background: #DAEEF3"|<code>ME.Prop[n]=DELETE</code>||style="background: #FFFF99" colspan="2" align="center"|n-te||rowspan="7"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=DELETE</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop=DELETE</code>||style="background: #B8CCE4" colspan="2" align="center"|alle
|-
|rowspan="2"|Ändern||style="background: #DAEEF3"|<code>ME.Prop[n]=x</code>||style="background: #FFFF99" colspan="2" align="center"|n-te
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=x</code>||style="background: #D8E4BC" colspan="2" align="center"|letzte
|-
|Löschen & hinzufügen||style="background: #DAEEF3"|<code>ME.Prop=x</code>||style="background: #B7DEE8" colspan="2" align="center"|alle löschen & einen hinzufügen
|-
|Hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[]=x</code>||style="background: #FCD5B4" colspan="2" align="center"|hinzufügen
|-
|}

{| class="wikitable"
|+ Vor Version 15.2 (oder [Verhalten beim Setzen mehrerer Daten] "Je nach Datentyp (altes Verhalten)")
|-
!rowspan="2"|Aktion
!rowspan="2"|Formel
!colspan="4"|Datentyp
!rowspan="2"|Kommentar
|-
!String!!Objekt (x ist Objekt)!!Objekt (x ist String)!!Andere
|-
|rowspan="3"|Lesen||style="background: #DAEEF3"|<code>ME.Prop[n]</code>||style="background: #FFFF99" colspan="4" align="center"|n-te||rowspan="2"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]</code>||style="background: #D8E4BC" colspan="4" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop</code>||style="background: #B8CCE4" align="center"|alle||style="background: #D8E4BC" align="center" colspan="3"|letzte||Strings nutzen ; als Trennzeichen
|-
|rowspan="3"|Löschen||style="background: #DAEEF3"|<code>ME.Prop[n]=DELETE</code>||style="background: #FFFF99" colspan="4" align="center"|n-te||rowspan="5"|
|-
|style="background: #DAEEF3"|<code>ME.Prop[0]=DELETE</code>||style="background: #D8E4BC" colspan="4" align="center"|letzte
|-
|style="background: #DAEEF3"|<code>ME.Prop=DELETE</code>||style="background: #B8CCE4" colspan="4" align="center"|alle
|-
|Ändern||style="background: #DAEEF3"|<code>ME.Prop[n]=x</code>||style="background: #FFFF99" colspan="4" align="center"|n-te
|-
|rowspan="2"|Ändern & hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[0]=x</code>||style="background: #FCD5B4" colspan="2" align="center"|hinzufügen||style="background: #D8E4BC" align="center"|letzte ändern||style="background: #FCD5B4" align="center"|hinzufügen
|-
|style="background: #DAEEF3"|<code>ME.Prop=x</code>||style="background: #FF99CC" colspan="2" align="center"|alle ändern||style="background: #B7DEE8" align="center"|alle löschen & einen hinzufügen||style="background: #FF99CC" align="center"|alle ändern||Wenn bei 'alle ändern' N = 0, dann einen hinzufügen
|-
|Hinzufügen||style="background: #DAEEF3"|<code>ME.Prop[]=x</code>||style="background: #FCD5B4" colspan="4" align="center"|hinzufügen||Nur ab Version 15.2
|-
|}

==== Datentyp Objekt ====
Für Eigenschaften mit [Datentyp] "Objekt" mit mehreren Werten, kann statt dem Index der [Code] der Objekte verwendet werden, um einen bestimmten Werte zu adressieren. Der [Code] ist eine String und die Werte der Eigenschaft werden nach einer passenden String durchsucht. Der Vergleich der Objekte mit der String erfolgt in der Reihenfolge [Code] → [Anzeigename] → [Alias].

; Beispiel
Um auf die Nutzungsanweisung mit [Code] "S1" der Produktionsaufgabe eines Vorganges zuzugreifen, nutzen Sie die Formel <code>ME.ProductionTask.UseInstructions['S1']</code>.

Angenommen dem Projekt wurde die benutzerdefinierte Klasse "Meine Klasse" (<code>MyClass</code>) mit der Eigenschaft [Meine Eigenschaft 1] (<code>MyProperty1</code>) hinzugefügt. Auf den Wert von [Meine Eigenschaft 1] des Objekts "ABC" in der Klasse "MyClass" kann mit <code>PROJECT.Child['MyClass'].Child['ABC'].MyClassUser_MyProperty1</code> zugegriffen werden.

Weitere Informationen zu benutzerdefinierten Klassen finden Sie unter [[Hinzufügen einer neuen Klassendefinition|Hinzufügen einer neuen Klassendefinition]].

[[Datei:UserClassTable.png]]

[[Datei:UserClassPropEditor.png]]

== Werte ==
Häufig werden Werte wie Zahlen und Strings in Formeln verwendet. Benutzen Sie in Formeln folgende Formatierungen.

{| class="wikitable"
|+ Formatierung von Werten in Formeln
|-
!Datentyp!!Beschreibung!!Beispiel
|-
|Zahl||Kann direkt eingegeben werden||123
|-
|String||Wird mit einfachen Anführungszeichen umschlossen||'123'
|-
|Datum||Wird mit Rauten umschlossen||#2020/06/01 12:00:00#
|-
|Bool||Direkte Eingabe des Werts||TRUE, FALSE
|-
|}

=== Steuerzeichen in Strings ===
In Strings ist "\", zusammen mit dem nachfolgenden Zeichen, ein Steuerzeichen.

{| class="wikitable"
|+ Verwendung von Steuerzeichen
|-
!Formel!!Rückgabewert!!Beschreibung
|-
|<code>'\\'</code>||\||Wird als ein umgekehrter Schrägstrich ausgegeben
|-
|<code>'\n'</code>||↵||Fügt einen Zeilenumbruch ein
|-
|<code>'\''</code>||'||Wird als einfaches Anführungszeichen ausgegeben
|-
|}

== Operatoren ==
{| class="wikitable"
|+ Verfügbare Operatoren
|-
!Operator!!Bedeutung!!Kommentar
|+||Addition, Verbindung von (Zeichen-)Ketten||
|-
|-||Subtraktion||
|-
|*||Multiplikation||
|-
|/||Division||
|-
|^||Potenzierung||
|-
|%||Modulo||Rest der Division
|-
|&&||AND||Logisches UND
|-
|<nowiki>||</nowiki>||OR||Logisches ODER
|-
|==||Gleich||Vergleich
|-
|!=||Ungleich||Vergleich
|-
|>||Größer||Vergleich
|-
|>=||Größer oder gleich||Vergleich
|-
|<||Kleiner||Vergleich
|-
|<=||Kleiner oder gleich||Vergleich
|-
|(, )||Klammern||
|-
|=||Zuweisung||Setzen von Werten
|-
|}

Die Operatoren werden in der folgenden Reihenfolge ausgewertet:
# ^
# *, /, %
# +, -
# ==, !=, >, <, >=, <=
# &&, ||
# =

Inhalte in Klammern werden zuerst ausgewertet.

=== Kurzschlussauswertung ===
Asprova nutzt [https://de.wikipedia.org/wiki/Kurzschlussauswertung Kurzschlussauswertung] zur schnelleren Auswertung von Formeln. Durch eine entsprechende Formelstruktur kann diese Funktionalität optimal genutzt werden. Weitere Informationen dazu finden Sie [[Beschleunigung der Fomelauswertung|hier]].

== Funktionen ==
In Formeln können Sie interne und benutzerdefinierte Funktionen verwenden. Die Funktion zum Beziehen der, auf einen Vorgang anzuwendenden, [Spezifikation 1] lautet <code>GetApplicableSpec(1,ME.Operation)</code>.

Bei der Nutzung von Funktionen achten Sie bitte auf die korrekte Schreibweise von Funktionsnamen und Argumenten. Weitergehende Informationen zu Asprovas internen Funktionen finden sich [[Interne Funktionen|hier]].

=== IF ===
Die interne Funktion <code>IF()</code> ermöglicht die Bewertung von Vorgängen mit der folgenden Formel:
IF(Bedingung,
falls <code>TRUE</code>,
falls <code>FALSE</code>
)

; Beispiel
Ist die [Startzeit] vor dem 1. Juni 2020, so wird der erste [Kommentar] auf "ABC" gesetzt, sonst auf "XYZ":
ME.Comments=IF(ME.StartTime<=#2020/06/01,
'ABC',
'XYZ'
)
oder
IF(ME.StartTime<=#2020/06/01,
ME.Comments='ABC',
ME.Comments='XYZ'
)

Ab Version 13.1 können mehrere Bedingungen eingegeben werden:
IF(Bedingung 1,
falls <code>TRUE</code>,
Bedingung 2,
falls <code>TRUE</code>,
...
...
Bedingung n,
falls <code>TRUE</code>,
falls <code>FALSE</code>
)

; Beispiel
Bei [Priorität] ab 90 rot, von 50 bis 90 blau und bei weniger als 50 grün:
IF(ME.Order.Priority>=90,
RGB(255,0,0),
ME.Order.Priority<50,
RGB(0,255,0),
RGB(0,0,255)
)

== Weitere Informationen ==
* [[Interne Funktionen]]

<hr>
<div align="right">Hilfe Nummer: 741000</div>