mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 04:27:14 +01:00
1 line
16 KiB
Plaintext
1 line
16 KiB
Plaintext
<strong><span style="font-size:28px;">Formeln</span></strong><br />Mit der Anwendung von Formeln in Xentral können Sie mathematische Operationen mit den verschiedensten Feldern aus Ihren Belegen durchführen. Im Folgenden erläutern wir Ihnen die grundlegenden Einstellungen zur Vorbereitung und zur Anwendung des Formelkonzeptes in Xentral.<br /> <h1>Vorbereitende Einstellungen zur Verwendung von Formeln in Xentral</h1>Grundsätzlich sollten Sie sich im Vorfeld Gedanken machen, welche Felder Sie in die Formeln einbeziehen wollen.<br /><br />Hier bietet Xentral eine Vielzahl von Möglichkeiten. Stellen Sie bitte sicher, dass die benötigten Bereiche entsprechend gepflegt sind. So sollte ein Freifeld mit numerischen Werten gefüllt sein, damit auch mathematische Operationen durchgeführt werden können.<br /><br />In Xentral können Sie grundsätzlich den Preis und die Menge in den Belegen ansprechen. Wenn Sie Freifelder nutzen, bietet sich Ihnen die Möglichkeit Ihre individuellen Ansprüche abzubilden und in Berechnungen mit einzubeziehen.<br />Allgemeine Informationen zu Freifeldern finden Sie im Artikel Freifelder.<br /><br />Um Freifelder in Formeln nutzen zu können, beachten Sie bitte Folgendes:<ul><li>Grundsätzlich wird in den Freifeldern der Inhalt aus den Stammdaten gezogen, sofern diese gepflegt sind.</li><li>Manuelle Anpassungen sind möglich, müssen dann aber in der Positionsliste des Belegs vorgenommen werden.</li></ul><br />Damit können Sie jederzeit auf die Freifelder des Artikels zugreifen und müssen diese nicht zwingend im Beleg neu anlegen.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=1" /><ul><li>Der Haken bei "Freifelder im Artikel einblenden" muss gesetzt sein.</li><li>Anzeige im PDF: Hier können Sie bestimmen wo die Freifelder ausgegeben werden sollen.</li></ul>Das ist für die Berechnung relevant, weil nur die angezeigten Freifelder in die Berechnung miteinbezogen werden.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=2" /><br />Soll der Name des Freifeldes nicht angezeigt werden, so muss die Checkbox bei "Positionen mit Freifelder" leer bleiben. Damit können Sie verhindern, dass zu viel Text in die Beschreibung aufgenommen wird. Brauchen Sie die Beschreibung dennoch, bitte den Haken setzen.<br /><br /><br />Anzeige ohne Haken in der Checkbox "Positionen mit Freifelder":<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=3" /><br /><br />Anzeige mit Haken in der Checkbox "Positionen mit Freifelder":<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=4" /><br /> <h1>Arbeitsweise mit Formeln</h1><h2>Formeln in den Belegen</h2>Sie haben die Möglichkeit eine Formel im Editor zu erstellen und dann als Kürzel zu verwenden. Das dient der Übersichtlichkeit und erlaubt Ihnen die Formeln zentral zu verwalten. Allerdings können Sie die Berechnungen auch direkt in der Artikelbeschreibung durchführen. Grundsätzlich sind die Freifelder, Menge und Preis ansprechbar.<br /><br />Unter Administration → Appstore finden Sie die App "Formeln". Hier können Sie für verschiedene Zwecke Formeln definieren, die Sie über die dazugehörige ID im folgenden als Variable in Xentral nutzen können: {FORMEL1}<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=5" /><br />Nachdem man eine Kennung und einen Namen für die Formel vergeben hat, kann man die Formel über das Edit-Icon hinterlegen.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=6" /><br /><strong>Interpretation</strong>: In diesem Beispiel soll der eingetragene Wert des Artikels aus Freifeld 1 mit der Menge der Position1 aus dem Beleg multipliziert und letztlich durch 1000 geteilt werden, um die Zieleinheit (kW) auszugeben. Hier können die üblichen Rechenoperatoren "*", " / ", " + " und "-" als auch "sin" und "cos" genutzt werden. Bei verschachtelten Formeln ist die Verwendung von Klammern "( )" gemäß den mathematischen Rechengesetzen zu beachten.<br /><br />Die Formel kann dann wie folgt im Angebot, zum Beispiel im Artikelfreitext, hinterlegt und entsprechend ausgegeben werden.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=7" /><br />Dabei wird der Wert dann wie folgt auf dem Beleg, hier im Angebot, ausgegeben.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=8" /><br /><br />Eine Verwendung in den Textvorlagen unter Administration → Einstellungen → Grundeinstellungen → System im Reiter "Textvorlagen" kann analog erfolgen.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=9" /><br /><br />Um in der Positionsansicht der Belege auch auf Mengen und Preise der anderen Positionen zugreifen zu können, ist es nun unter Stammdaten → Artikel in den Details möglich, Formeln auf Preise und Mengen (weiterhin auch Freifelder) zu beziehen:<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=10" /><br /><br />In dem folgenden Beispiel wurde der Artikel als dritte Angebotsposition hinzugefügt und die obenstehende Berechnung für die Menge und den Preis der Position durchgeführt.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=11" /><br /><strong>Interpretation</strong>: Menge der Position1 = 15* Preis der Position1 = 62 = Menge von Position3 (hinzugefügter Pos mit Formeln) geteilt durch 10 → Ergebnis auf 2 Stellen gerundet = 93<h1><br />Rechnen mit einer oder mehreren Variablen</h1>Grundsätzlich ist es in Xentral möglich einzelne Felder aus dem Artikelstamm anzusprechen.Die Syntax dafür ist: {{ARTIKEL:<FELDNAME>}}<br />Ein Feldname kann beispielsweise eine Position im Artikelstamm sein. Hier könnten Sie die Länge des Artikels verwenden.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=12" width="700" /><br />Die dazugehörige Formel sieht dann so aus {{ARTIKEL:HOEHE}}: Ein möglicher Anwendungsfall wäre die Berechnung des Verkaufspreises aufgrund der Fläche eines Artikels. Damit kann man die verschiedenen Felder gemäß der Rechenregeln verarbeiten.<br />In unserem Beispiel muss folgende Formel verwendet werden:<br />{{ARTIKEL:LAENGE*ARTIKEL:REITE/100}}<br /><br />Diese kann man direkt im Artikelstamm hinterlegen und damit sofort den Preis im Beleg berechnen lassen.<br />Artikel → Details<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=13" width="700" /><br /><br />Und erzeugt folgendes Ergebnis:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=14" width="700" /><br /> <h1>Sonderfunktionen</h1>In dieser Rubrik möchten wir Ihnen weitere Möglichkeiten vorstellen, wie Sie mit Formeln arbeiten können. Wenn Ihnen der Umgang mit Spaltenoperationen bekannt ist, wie z.B. aus Excel, haben Sie ausreichende Vorkenntnisse um die Sonderfunktionen zu nutzen. Zu Beginn zeigen wir Ihnen die grundlegenden Formatierungsmöglichkeiten, mit denen Sie das Ergebnis anpassen können. Zum Beispiel können Sie das Ergebnis einer Rechenoperation so ausgeben lassen, dass nur zwei Nachkommastellenangezeigt werden.<br /><br />Die Zahlen sind exemplarisch aufgeführt und können sinngemäß verändert werden:<br />{{format(Zahl,4)}}→ zeigt immer 4 Nachkommastellen an<br />{{round(Zahl,2)}}→ rundet auf 2 Nachkommastellen<br />{{abs(Zahl)}}→ schneidet alle Nachkommastellen ab ohne zu runden<br /><br />Für spezielle Anwendungen stellen wir diese mathematischen Operationen zur Verfügung:<br /><br />{{sin(Bogenmaß)}}→ gibt den Sinuswert des eingegeben Bogenmaß zurück<br />{{cos(Bogenmaß)}}→ gibt den Cosinuswert des eingegeben Bogenmaß zurück<br />{{sqrt(Zahl)}}→ zieht die Quadratwurzel<br />{{wurzel(Radikant, Wurzelexponent}}→ zieht die Wurzel mit beliebigem Radikant und Wurzelexponent<br /><br />In Xentral können Sie erweiterte Spaltenoperationen durchführen. Die Position, in der Formel <strong>POS</strong>: erwartet als Bezug ein Feld mit dem Sie operieren möchten. Im unteren Beispiel haben wir die Position Preis verwendet. Analog verhält es sich zur Position Menge. Folgende Regeln helfen Ihnen alle Möglichkeiten effizient auszuschöpfen:<ul><li>die Schreibweise POS: enthält keine Einschränkungen bezüglich der Position. Alle Positionen werden durchlaufen</li><li>die Schreibweise POS1: bezieht sich nur auf die Position 1</li></ul>{{spaltensumme(POS:preis * POS:menge)}}→ Liefert die Summe aus (POS1:preis * POS1:menge) + (POS2:preis * POS2:menge) + (POS3:preis * POS3:menge) etc.<br />Diese Formel läuft über jedes Element in einem Beleg. Mit diesem Beispiel wäre die Summe das "Gesamt Netto".<br /><br />{{spaltensummebis(POS:preis * POS:menge)}} → Verhält sich wie obige Formel aber liefert die Summe der Spaltenpositionen bis zur eigenen Zeile.<br />Es werden also nicht alle Positionen durchlaufen, sondern nur bis zur eigenen Position (exklusive).<br /><br />{{zwischensumme(POS:preis * POS:menge)}}→ Liefert die Summe aller Positionen zwischen zwei Spezialfeldern.<br /><br />Als Spezialfelder können Sie folgende Auswahl vornehmen:<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=15" width="800" /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=16" width="600" /><br /><br /><br />Beispiel:<br />In Freifeld 1 haben Sie die jeweilige Eingangsspannung eines Servers hinterlegt. Um die Gesamtspannung in der Gruppe auszuwerten, können Sie die Freifelder 1 über alle Positionen addieren.<br />Da Sie Sich aber nur für die Gruppe Sonderausstattung interessieren, benutzen Sie bitte die Formel "zwischensumme(POS:freifeld1)".Tragen Sie wie auf dem Bild die Formel in die Position des Beleges ein.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=17" width="900" /><br />Das Ergebnis sieht auf dem Beleg wie folgt aus:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=18" width="500" /><h1>Verfügbare Variablen</h1>Die folgenden Variablen sind im Formelmodul verfügbar*.<br /><br />Bitte ersetzen Sie jeweils das X durch eine Zahl (bei Referenzierung einer bestimmten Zeile) oder lassen es weg (bei Anwendung der Formel auf die aktuelle Zeile. Alternativ verwenden Sie statt "posX" das Wort "artikel" wenn Sie direkt auf die Artikelstammdaten zugreifen wollen ohne positionsspezifische Modifikationen zu berücksichtigen.<ul><li>posX:id</li><li>posX:auftrag</li><li>posX:artikel</li><li>posX:projekt</li><li>posX:bezeichnung</li><li>posX:beschreibung</li><li>posX:internerkommentar</li><li>posX:nummer</li><li>posX:menge</li><li>posX:preis</li><li>posX:waehrung</li><li>posX:lieferdatum</li><li>posX:vpe</li><li>posX:sort</li><li>posX:status</li><li>posX:umsatzsteuer</li><li>posX:bemerkung</li><li>posX:geliefert</li><li>posX:geliefert_menge</li><li>posX:explodiert</li><li>posX:explodiert_parent</li><li>posX:logdatei</li><li>posX:punkte</li><li>posX:bonuspunkte</li><li>posX:mlmdirektpraemie</li><li>posX:keinrabatterlaubt</li><li>posX:grundrabatt</li><li>posX:rabattsync</li><li>posX:rabatt1 ... posX:rabatt5</li><li>posX:einheit</li><li>posX:webid</li><li>posX:rabatt</li><li>posX:nachbestelltexternereinkauf</li><li>posX:zolltarifnummer</li><li>posX:herkunftsland</li><li>posX:artikelnummerkunde</li><li>posX:freifeld1 ... posX:freifeld40</li><li>posX:lieferdatumkw</li><li>posX:teilprojekt</li><li>posX:steuersatz</li><li>posX:steuertext</li><li>posX:erloese</li><li>posX:erloesefestschreiben</li><li>posX:einkaufspreiswaehrung</li><li>posX:einkaufspreis</li><li>posX:einkaufspreisurspruenglich</li><li>posX:einkaufspreisid</li><li>posX:ekwaehrung</li><li>posX:deckungsbeitrag</li><li>posX:formelmenge</li><li>posX:formelpreis</li><li>posX:ohnepreis</li><li>posX:potentiellerliefertermin</li><li>posX:skontobetrag</li><li>posX:steuerbetrag</li><li>posX:skontosperre</li><li>posX:ausblenden_im_pdf</li><li>posX:kostenstelle</li><li>posX:umsatz_netto_einzeln</li><li>posX:umsatz_netto_gesamt</li><li>posX:umsatz_brutto_einzeln</li><li>posX:umsatz_brutto_gesamt</li><li>posX:zolleinzelwert</li><li>posX:zollgesamtwert</li><li>posX:zollwaehrung</li><li>posX:zolleinzelgewicht</li><li>posX:zollgesamtgewicht</li></ul>Sollte einer der Werte durch das Formelmodul nicht gefüllt werden, kann das an der Belegart liegen - nicht alle Werte sind in allen Belegen verfügbar.<br /> <h1>Anwendungsbeispiele</h1><h2>Formel für die Umrechnung der Stückzahl aus Großpackung für die Produktionsanweisung</h2>Ich habe eine Produktions-Stückliste in der verschiedene Artikel hinterlegt sind, u.a. ein Artikel den es nur als Großpackung (Stifte) im 12er Pck gibt. Für den Produktionsartikel werden nur 8 Stück aus der Großpackung benötigt, wie kann die Stückliste angelegt werden, damit der Mitarbeiter aus dem Lager weiß, dass er 8 Stück entnehmen muss. Würde "8" in die Stückliste eingetragen werden, wären es 8 x 12er Packs statt 8 einzelne Stifte. In der Stückliste selbst müsste für den entsprechende Anteil von einem Pack für das Beispiel 0,666 Stück der Großpackung eingetragen werden. Damit der Lagermitarbeiter sich die tatsächliche Stückzahl nicht ausrechnen muss, kann diese Information mit einer Formel in einem Freifeld zusätzlich im Produktionszettel ausgegeben werden.<br /><br />Hierzu zunächst zwei Artikel Freifelder anlegen, einen für die VPE-Menge des Artikel und einen für die Formel welcher auf dem Produktionszettel ausgegeben werden soll. In dem Großpackungsartikel muss in das eine Feld die untenstehende Formel eingetragen werden und in das andere Freifeld die VPE Menge, welche zur Berechnung in die Formel einfließt.<br /><br />Freifelder anlegen (Administration->Einstellungen->Grundeinstellungen):<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=19" /><br /><br />Formel anlegen:<br />Folgende Formel kann dafür verwendet werden.Formel mit Rundung auf eine ganze Zahl - Freifeld Nummer entsprechend durch die Nummer des freifelds ersetzen(round(pos:menge*artikel:freifeld1,0)<br /><br />Artikel Freifelder befüllen:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=20" /><br /><br />Ansicht der Produktionsanweisung mit entsprechender Stückzahl (aufgerundet):<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=formeln&fileid=21" /> |